blackant-sdk 1.0.3__py3-none-any.whl → 1.0.4__py3-none-any.whl

blackant/cli.py

@@ -61,7 +61,7 @@ def get_client(user: Optional[str] = None, password: Optional[str] = None,
 
 
 @click.group()
-@click.version_option(version="1.0.3", prog_name="blackant")
+@click.version_option(version="1.0.4", prog_name="blackant")
 def main():
     """BlackAnt SDK - Command Line Interface
 

blackant_sdk-1.0.4.dist-info/METADATA

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: blackant-sdk
+Version: 1.0.4
+Summary: Python SDK for Docker operations with automatic authentication through BlackAnt platform
+Author-email: Balázs Milán <milan.balazs@uni-obuda.hu>
+Maintainer-email: BlackAnt Development Team <dev@blackant.app>
+License: Proprietary - Óbudai Egyetem
+Project-URL: Homepage, https://env.blackant.app/systemdevelopers/blackant_sdk
+Project-URL: Documentation, https://docs.blackant.app
+Project-URL: Repository, https://env.blackant.app/systemdevelopers/blackant_sdk
+Project-URL: Bug Tracker, https://env.blackant.app/systemdevelopers/blackant_sdk/-/issues
+Keywords: docker,sdk,authentication,blackant,container,orchestration,swarm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: flask>=2.3.2
+Requires-Dist: flask-restful>=0.3.10
+Requires-Dist: waitress>=2.1.2
+Requires-Dist: minio>=6.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: docker>=4.4.3
+Requires-Dist: urllib3<2.0
+Requires-Dist: gunicorn>=21.2.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: python-keycloak>=3.0.0
+Requires-Dist: PyJWT>=2.8.0
+Requires-Dist: click>=8.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: sphinx>=5.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx>=5.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
+
+# BlackAnt SDK
+
+Python SDK for Docker operations with automatic authentication through the BlackAnt platform.
+
+## Features
+
+- Automatic authentication with BlackAnt platform
+- Build Docker images on remote daemon
+- Push images to private registry
+- Service management (list, status, delete)
+- Both Python API and CLI interface
+
+## Installation
+
+```bash
+pip install blackant-sdk
+```
+
+## Quick Start
+
+### Python API
+
+```python
+from blackant import BlackAntClient
+
+# Initialize client
+client = BlackAntClient(
+    user="your-username",
+    password="your-password",
+    base_url="https://your-blackant-instance.com"
+)
+
+# Authenticate
+if client.authenticate():
+    print("Connected to BlackAnt!")
+
+# Build and push a service
+result = client.build_service(
+    service_name="my-calculation",
+    impl_path="./src/calculation/impl",
+    tag="v1.0.0",
+    push=True
+)
+
+print(f"Image: {result['full_image']}")
+
+# List services
+services = client.list_services()
+for svc in services:
+    print(f"  - {svc['name']}: {svc['status']}")
+```
+
+### Command Line Interface (CLI)
+
+```bash
+# Set credentials via environment variables
+export BLACKANT_USER=your-username
+export BLACKANT_PASSWORD=your-password
+export BLACKANT_URL=https://your-blackant-instance.com
+
+# Test connection
+blackant login
+
+# Build and push
+blackant build --name my-calculation --path ./src/calculation/impl --tag v1.0.0
+
+# List services
+blackant list
+
+# Get service status
+blackant status my-calculation
+
+# Delete service
+blackant delete my-calculation
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `BLACKANT_USER` | Username for authentication | - |
+| `BLACKANT_PASSWORD` | Password for authentication | - |
+| `BLACKANT_URL` | BlackAnt platform base URL | `https://dev.blackant.app` |
+
+## API Reference
+
+### BlackAntClient
+
+The main client class providing all SDK functionality.
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `authenticate()` | Authenticate with BlackAnt platform |
+| `test_connection()` | Test if connection is working |
+| `build_service(...)` | Build Docker image and optionally push |
+| `list_services()` | List all registered services |
+| `get_service(name)` | Get service details |
+| `get_service_status(name)` | Get service status |
+| `delete_service(name)` | Delete a service |
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `blackant login` | Test connection and authenticate |
+| `blackant build` | Build Docker image and push to registry |
+| `blackant list` | List all registered services |
+| `blackant status <name>` | Get status of a service |
+| `blackant info <name>` | Get detailed service information |
+| `blackant delete <name>` | Delete a service |
+
+Use `blackant <command> --help` for detailed options.
+
+## Requirements
+
+- Python 3.11+
+- Access to a BlackAnt platform instance
+- Valid BlackAnt credentials
+
+## License
+
+Proprietary - Obuda University, John von Neumann Faculty of Informatics
+
+---
+
+## About
+
+<p align="center">
+  <img src="https://nik.uni-obuda.hu/wp-content/uploads/2025/10/NIK_logo_header.png" alt="NIK Logo" width="300"/>
+</p>
+
+This SDK is developed and maintained by the **BlackAnt Development Team** at:
+
+**Obuda University - John von Neumann Faculty of Informatics**
+*(Óbudai Egyetem - Neumann János Informatikai Kar)*
+
+| | |
+|---|---|
+| Address | 1034 Budapest, Bécsi út 96/B, Hungary |
+| Phone | +36 1 666 5520 |
+| Email | titkarsag@nik.uni-obuda.hu |
+| Web | [nik.uni-obuda.hu](https://nik.uni-obuda.hu) |
+
+## Support
+
+For SDK issues and questions, contact the BlackAnt Development Team at dev@blackant.app

{blackant_sdk-1.0.3.dist-info → blackant_sdk-1.0.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 blackant/__init__.py,sha256=THZWaFP_eIFEDVsIQC5HSCY9k2nGeR1TQ3rNhdlScEM,746
-blackant/cli.py,sha256=ni6nsdtacieiJCvpbRU3MQ2K8sMTnMLbGa0-uiaxc54,10284
+blackant/cli.py,sha256=Ksnh2rGusb1MbDcFpnMgTbePaDG9JIcv1OIquPD4zNc,10284
 blackant/client.py,sha256=dsF-vPDzhv8Bx_OoakP4NC5dnbYRfkB4MHXcIAsIr9I,15180
 blackant/exceptions.py,sha256=6y9FwBlO_ntYmVyJfrhKVUUnAHaA0wkyJx2WtddU1Ts,2845
 blackant/auth/__init__.py,sha256=Ax1FqQsZNucr4CEUCqeZkrnbWN8Fx72IHFg3PZzbd2A,289
@@ -65,8 +65,8 @@ task/states/ready.py,sha256=kMpC6qY_IGkLc1JpaH_jf_NcZgC4vyLzoEZhYMDOwZA,1967
 task/states/running.py,sha256=HVkkZlC7xOV5M3NnJAf4SWyVE5JqT2LhZokIbRyskbQ,773
 task/states/set_up.py,sha256=NsoEGKVL_E3hQFIm3p3Bv6uC7J0DOPzTc8UZrMEVR1g,1634
 task/states/tear_down.py,sha256=xq6xSC2Q_Yuky047kRP4fSwM992PILIOYBZbOl1RIDA,1050
-blackant_sdk-1.0.3.dist-info/METADATA,sha256=QoSnJZIBnpCxNT0fUwGwyWfqSLb6VI6LpMfVZ5Q4Lws,3643
-blackant_sdk-1.0.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-blackant_sdk-1.0.3.dist-info/entry_points.txt,sha256=_0tArMbYqVL7laiHsKiwsfx2Lh-QyD24xHrRMLpg0ig,47
-blackant_sdk-1.0.3.dist-info/top_level.txt,sha256=MZZ_UBTnah0fs9yzTmlavd4Z0HuJDD3alhfGlB79ZIE,48
-blackant_sdk-1.0.3.dist-info/RECORD,,
+blackant_sdk-1.0.4.dist-info/METADATA,sha256=bRKLI5GYD4a2inCI8Xs9OPtQ0nkHaOSMQIRt335CWJQ,5723
+blackant_sdk-1.0.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+blackant_sdk-1.0.4.dist-info/entry_points.txt,sha256=_0tArMbYqVL7laiHsKiwsfx2Lh-QyD24xHrRMLpg0ig,47
+blackant_sdk-1.0.4.dist-info/top_level.txt,sha256=MZZ_UBTnah0fs9yzTmlavd4Z0HuJDD3alhfGlB79ZIE,48
+blackant_sdk-1.0.4.dist-info/RECORD,,

blackant_sdk-1.0.3.dist-info/METADATA

@@ -1,118 +0,0 @@
-Metadata-Version: 2.4
-Name: blackant-sdk
-Version: 1.0.3
-Summary: Python SDK for Docker operations with automatic authentication through BlackAnt platform
-Author-email: Balázs Milán <milan.balazs@uni-obuda.hu>
-Maintainer-email: BlackAnt Development Team <dev@blackant.app>
-License: Proprietary - Óbudai Egyetem
-Project-URL: Homepage, https://env.blackant.app/systemdevelopers/blackant_sdk
-Project-URL: Documentation, https://docs.blackant.app
-Project-URL: Repository, https://env.blackant.app/systemdevelopers/blackant_sdk
-Project-URL: Bug Tracker, https://env.blackant.app/systemdevelopers/blackant_sdk/-/issues
-Keywords: docker,sdk,authentication,blackant,container,orchestration,swarm
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Distributed Computing
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: flask>=2.3.2
-Requires-Dist: flask-restful>=0.3.10
-Requires-Dist: waitress>=2.1.2
-Requires-Dist: minio>=6.0.0
-Requires-Dist: requests>=2.31.0
-Requires-Dist: docker>=4.4.3
-Requires-Dist: urllib3<2.0
-Requires-Dist: gunicorn>=21.2.0
-Requires-Dist: colorama>=0.4.6
-Requires-Dist: python-keycloak>=3.0.0
-Requires-Dist: PyJWT>=2.8.0
-Requires-Dist: click>=8.1.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: sphinx>=5.0.0; extra == "dev"
-Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "dev"
-Provides-Extra: test
-Requires-Dist: pytest>=7.0.0; extra == "test"
-Requires-Dist: pytest-cov>=4.0.0; extra == "test"
-Requires-Dist: pytest-mock>=3.10.0; extra == "test"
-Provides-Extra: docs
-Requires-Dist: sphinx>=5.0.0; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
-
-# Python REST API docker template
-
-A simple template to implement REST APIs using Python Flask & docker.
-
-## Build arguments
-
-### INSTALL_DEBUG_TOOLS
-
-If it's set to True, ptvsd is installed during build to be able to do live debugging.
-
-## Environment variables
-
-### CALCULATION_NAME
-
-Name of the calculation. Mandatory parameter.
-
-### SERVER_PORT
-
-Port which on the server runs. Default: 5000
-
-### DEBUG_MODE
-
-A switch to select between debug and release mode. If it is set to True, a Flask server will be started in debug mode and a ptvsd server. Otherwise, it is served using gevent production server. Default: False
-
-### OBJECT_STORAGE_URL
-
-Url for the object storage. Mandatory if the code uses object storage.
-
-### OBJECT_STORAGE_ACCESS_KEY
-
-Public key for the object storage.
-
-### OBJECT_STORAGE_SECRET_KEY
-
-Private key for the object storage.
-
-### SCHEDULER_URL
-
-Callback url of the scheduler.
-
-## Commands
-
-### Build
-
-```sh
-docker-compose build
-```
-
-### Run
-
-```sh
-docker-compose up
-```
-
-### Create task
-
-You can use the tools/send_request.py script to send a simple request to the calculation container.
-
-### Debug
-
-If you use Visual Studio Code, there is a debug configuration called Python: Remote Attach which will start a debug session and connect to your running container.
-
-## Documentation
-
-Full HTML and PDF documentation can be generated from any revision using the generate_documentation job in the CI.
-After the job have run successfully, the artifacts are stored for one day.
-If it's necessary it can be rerun any time.
-
-
-......