Skip to content

Commit d31a027

Browse files
easySSP-deveasySSP-dev
committed
Initial commit
0 parents  commit d31a027

17 files changed

Lines changed: 1577 additions & 0 deletions

‎.github/workflows/lint-and-tests.yml‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
name: Run Ruff and Mypy Checks and Tests
2+
3+
on:
4+
push:
5+
branches:
6+
- '**' # Triggers on all branches but not tag push
7+
pull_request: # Triggers on all PRs
8+
9+
jobs:
10+
lint:
11+
name: Run Ruff and Mypy
12+
runs-on: ubuntu-latest
13+
14+
steps:
15+
- name: Checkout code
16+
uses: actions/checkout@v3
17+
18+
- name: Set up Python
19+
uses: actions/setup-python@v4
20+
with:
21+
python-version: '3.11'
22+
23+
- name: Install dependencies
24+
run: |
25+
python -m pip install --upgrade pip
26+
pip install uv
27+
uv sync --group lint
28+
29+
- name: Run Ruff
30+
run: |
31+
uv run --frozen python -m ruff check
32+
33+
- name: Run Mypy
34+
run: |
35+
uv run --frozen python -m mypy
36+
37+
test:
38+
runs-on: ubuntu-latest
39+
needs: ['lint']
40+
41+
steps:
42+
- uses: actions/checkout@v4
43+
44+
- name: Set up Python
45+
uses: actions/setup-python@v5
46+
with:
47+
python-version: '3.11'
48+
49+
- name: Install dependencies
50+
run: |
51+
python -m pip install --upgrade pip
52+
pip install uv
53+
uv sync
54+
uv sync --group test
55+
56+
- name: Run Tests
57+
run: |
58+
uv run --frozen python -m pytest

‎.github/workflows/python-publish.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Publish to PyPI
2+
3+
on:
4+
release:
5+
types: [published]
6+
7+
jobs:
8+
build-and-publish:
9+
runs-on: ubuntu-latest
10+
11+
steps:
12+
- name: Checkout code
13+
uses: actions/checkout@v4
14+
15+
- name: Set up Python
16+
uses: actions/setup-python@v5
17+
with:
18+
python-version: '3.11'
19+
20+
- name: Install dependencies
21+
run: |
22+
python -m pip install --upgrade pip
23+
pip install build twine
24+
25+
- name: Build package
26+
run: python -m build
27+
28+
- name: Publish to PyPI
29+
env:
30+
TWINE_USERNAME: __token__
31+
TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
32+
run: |
33+
twine check dist/*
34+
twine upload dist/*

‎.gitignore‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
.idea/
2+
venv/
3+
/dist/

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 eXXcellent solutions
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README-pypi.md‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
![easyssp-logo-light](https://raw.githubusercontent.com/exxcellent/easyssp-auth-client-python/refs/heads/master/images/logo-light.png#gh-light-mode-only)
2+
3+
# easySSP Import-Export Python Client
4+
5+
This is the official Python client for the **Import/Export API** of the easySSP. This client simplifies the process of
6+
importing and exporting `.ssp` and `.ssd` model files through the API, enabling easy programmatic access for integration
7+
into your workflows.
8+
9+
---
10+
11+
## ✨ Features
12+
13+
- 📤 Import `.ssp` and `.ssd` files into the easySSP platform
14+
- 🔎 View imported models directly in easySSP
15+
- 📥 Export `.ssp` files from easySSP for use in other tools or storage
16+
17+
---
18+
19+
## 📦 Installation
20+
21+
```bash
22+
pip install easyssp-import-export-client
23+
```
24+
25+
Or clone and install from source:
26+
27+
```bash
28+
git clone https://github.com/exxcellent/easyssp-import-export-client-python.git
29+
cd easyssp-import-export-client-python
30+
pip install -e .
31+
```
32+
33+
## Tests
34+
35+
Execute `pytest` or `python -m pytest` to run the tests.
36+
37+
## 📁 Project Structure
38+
39+
```bash
40+
easyssp_import_export/
41+
├── __init__.py
42+
├── client/
43+
│ ├── __init__.py
44+
│ └── import_export_client.py # Importing and exporting .ssp/.ssd files
45+
│
46+
├── models/
47+
│ ├── __init__.py
48+
│ └── upload_response.py # Info about the uploaded .ssp/.ssd file
49+
```
50+
51+
## 📖 API Reference
52+
53+
This client is built against the official **Import/Export API** specification, available as an OpenAPI (Swagger)
54+
document.
55+
56+
You can explore the full API documentation here:
57+
👉 [**Import/Export API**](https://apps.exxcellent.de/easy-ssp/docs/integration-api/v1/import-export/index.html)
58+
59+
## 📚 Examples Repository & Extended Documentation
60+
61+
Looking for working demos? Check out the Import/Export Client Examples Repository here:
62+
👉 [**Import/Export Client Examples Repository**](https://github.com/exxcellent/easyssp-import-export-examples-python)
63+
64+
It includes:
65+
66+
- Real-world examples for importing and exporting .ssp/.ssd files
67+
- Usage patterns for authentication and error handling
68+
69+
It's the best place to explore how the client works in action and how to integrate it into your own workflows.
70+
71+
## 🛠️ Requirements
72+
73+
- Python 3.11+
74+
- easyssp Pro Edition Account
75+
76+
Install dependencies using uv:
77+
78+
```bash
79+
pip install uv
80+
uv sync
81+
```
82+
83+
## 🤝 Contributing
84+
85+
This module is maintained as part of the easySSP ecosystem. If you find issues or want to suggest improvements, please
86+
open an issue or submit a pull request.
87+
88+
## 📄 License
89+
90+
This project is licensed under the MIT License.

‎README.md‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
![easyssp-logo-light](https://raw.githubusercontent.com/exxcellent/easyssp-auth-client-python/refs/heads/master/images/logo-light.png#gh-light-mode-only)
2+
![easyssp-logo-dark](https://raw.githubusercontent.com/exxcellent/easyssp-auth-client-python/refs/heads/master/images/logo-dark.png#gh-dark-mode-only)
3+
4+
# easySSP Import-Export Python Client
5+
6+
This is the official Python client for the **Import/Export API** of the easySSP. This client simplifies the process of
7+
importing and exporting `.ssp` and `.ssd` model files through the API, enabling easy programmatic access for integration
8+
into your workflows.
9+
10+
---
11+
12+
## ✨ Features
13+
14+
- 📤 Import `.ssp` and `.ssd` files into the easySSP platform
15+
- 🔎 View imported models directly in easySSP
16+
- 📥 Export `.ssp` files from easySSP for use in other tools or storage
17+
18+
---
19+
20+
## 📦 Installation
21+
22+
```bash
23+
pip install easyssp-import-export-client
24+
```
25+
26+
Or clone and install from source:
27+
28+
```bash
29+
git clone https://github.com/exxcellent/easyssp-import-export-client-python.git
30+
cd easyssp-import-export-client-python
31+
pip install -e .
32+
```
33+
34+
## Tests
35+
36+
Execute `pytest` or `python -m pytest` to run the tests.
37+
38+
## 📁 Project Structure
39+
40+
```bash
41+
easyssp_import_export/
42+
├── __init__.py
43+
├── client/
44+
│ ├── __init__.py
45+
│ └── import_export_client.py # Importing and exporting .ssp/.ssd files
46+
│
47+
├── models/
48+
│ ├── __init__.py
49+
│ └── upload_response.py # Info about the uploaded .ssp/.ssd file
50+
```
51+
52+
## 📖 API Reference
53+
54+
This client is built against the official **Import/Export API** specification, available as an OpenAPI (Swagger)
55+
document.
56+
57+
You can explore the full API documentation here:
58+
👉 [**Import/Export API**](https://apps.exxcellent.de/easy-ssp/docs/integration-api/v1/import-export/index.html)
59+
or in the `docs` directory in this project.
60+
61+
## 📚 Examples Repository & Extended Documentation
62+
63+
Looking for working demos? Check out the Import/Export Client Examples Repository here:
64+
👉 [**Import/Export Client Examples Repository**](https://github.com/exxcellent/easyssp-import-export-examples-python)
65+
66+
It includes:
67+
68+
- Real-world examples for importing and exporting .ssp/.ssd files
69+
- Usage patterns for authentication and error handling
70+
71+
It's the best place to explore how the client works in action and how to integrate it into your own workflows.
72+
73+
## 🛠️ Requirements
74+
75+
- Python 3.11+
76+
- easyssp Pro Edition Account
77+
78+
Install dependencies using uv:
79+
80+
```bash
81+
pip install uv
82+
uv sync
83+
```
84+
85+
## 🤝 Contributing
86+
87+
This module is maintained as part of the easySSP ecosystem. If you find issues or want to suggest improvements, please
88+
open an issue or submit a pull request.
89+
90+
## 📄 License
91+
92+
This project is licensed under the MIT License.

0 commit comments

Comments
 (0)