blackant-sdk 1.0.2__py3-none-any.whl

blackant/utils/logging.py

@@ -0,0 +1,337 @@
+# src/blackant/utils/logging.py
+"""BlackAnt SDK Logging module.
+
+This module provides unified logging functionality for the entire BlackAnt SDK.
+Supports colorized console output, file logging, and request tracking.
+"""
+
+import logging
+import sys
+import threading
+import re
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Dict, Union
+from colorama import Fore, Style, init
+
+init(autoreset=True)
+
+
+class CustomFormatter(logging.Formatter):
+    """Custom formatter with colorized log levels and abbreviated level names."""
+
+    LEVEL_ABBREVIATIONS = {
+        logging.DEBUG: "DBG",
+        logging.INFO: "INF",
+        logging.WARNING: "WAR",
+        logging.ERROR: "ERR",
+        logging.CRITICAL: "CRT",
+    }
+
+    LEVEL_COLORS = {
+        logging.DEBUG: Fore.WHITE,
+        logging.INFO: Fore.CYAN,
+        logging.WARNING: Fore.YELLOW,
+        logging.ERROR: Fore.RED,
+        logging.CRITICAL: Fore.LIGHTRED_EX,
+    }
+
+    def __init__(self, use_colors: bool = True, include_request_id: bool = True):
+        self.use_colors = use_colors
+        self.include_request_id = include_request_id
+
+        if include_request_id:
+            template = (
+                "[{asctime}].[{name}].[{levelname}].[{request_id}] -> "
+                "{message} \t || {module}:{funcName}"
+            )
+        else:
+            template = "[{asctime}].[{name}].[{levelname}] -> {message} \t || {module}:{funcName}"
+
+        super().__init__(template, style="{", datefmt="%Y-%m-%d %H:%M:%S")
+
+    def format(self, record: logging.LogRecord) -> str:
+        if self.include_request_id:
+            request_id = getattr(record, "request_id", "NO-REQ-ID")
+            record.request_id = request_id
+
+        level_abbr = self.LEVEL_ABBREVIATIONS.get(record.levelno, record.levelname[:3])
+
+        if self.use_colors:
+            color = self.LEVEL_COLORS.get(record.levelno, "")
+            levelname_colored = f"{color}{level_abbr}{Style.RESET_ALL}"
+            msg_colored = f"{color}{record.getMessage()}{Style.RESET_ALL}"
+        else:
+            levelname_colored = level_abbr
+            msg_colored = record.getMessage()
+
+        record_copy = logging.makeLogRecord(record.__dict__)
+        record_copy.levelname = levelname_colored
+        record_copy.msg = msg_colored
+
+        return super().format(record_copy)
+
+
+class SensitiveDataFilter(logging.Filter):  # pylint: disable=too-few-public-methods
+    """Filter to scrub sensitive data from log messages."""
+
+    DEFAULT_PATTERNS = [
+        r"Bearer\s+[A-Za-z0-9\-_]+",
+        r'token["\s:=]+[A-Za-z0-9\-_\.]+',
+        r'password["\s:=]+\S+',
+        r'api_key["\s:=]+[A-Za-z0-9\-_]+',
+        r"Authorization:\s*[^\s]+",
+        r"X-API-Key:\s*[^\s]+",
+    ]
+
+    def __init__(self, patterns: Optional[list] = None):
+        super().__init__()
+        self.patterns = patterns or self.DEFAULT_PATTERNS
+        self._compiled_patterns = [re.compile(pattern, re.IGNORECASE) for pattern in self.patterns]
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        message = record.getMessage()
+        for pattern in self._compiled_patterns:
+            message = pattern.sub("[REDACTED]", message)
+
+        record.msg = message
+        record.args = ()
+
+        return True
+
+
+class RequestIdFilter(logging.Filter):
+    """Filter that adds request ID context to log records."""
+
+    def __init__(self):
+        super().__init__()
+        self._local = threading.local()
+
+    def set_request_id(self, request_id: str):
+        self._local.request_id = request_id
+
+    def clear_request_id(self):
+        if hasattr(self._local, "request_id"):
+            delattr(self._local, "request_id")
+
+    def get_request_id(self) -> Optional[str]:
+        return getattr(self._local, "request_id", None)
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        request_id = self.get_request_id()
+        record.request_id = request_id or "NO-REQ-ID"
+        return True
+
+
+class LoggerManager:  # pylint: disable=too-many-instance-attributes
+    """Central logger manager for the BlackAnt SDK."""
+
+    def __init__(  # pylint: disable=too-many-arguments
+        self,
+        app_name: str = "BlackAnt",
+        default_log_file: Optional[str] = None,
+        log_level: Union[str, int] = logging.INFO,
+        enable_colors: bool = True,
+        enable_request_tracking: bool = True,
+        enable_sensitive_filter: bool = True,
+    ):
+        self.app_name = app_name
+        self.enable_colors = enable_colors
+        self.enable_request_tracking = enable_request_tracking
+        self.enable_sensitive_filter = enable_sensitive_filter
+
+        if default_log_file is None:
+            timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+            default_log_file = f"{app_name.lower()}_{timestamp}.log"
+
+        self.log_file = Path(default_log_file)
+
+        self.request_id_filter = RequestIdFilter() if enable_request_tracking else None
+        self.sensitive_filter = SensitiveDataFilter() if enable_sensitive_filter else None
+
+        self._setup_root_logger(log_level)
+
+        self._module_loggers: Dict[str, logging.Logger] = {}
+
+    def _setup_root_logger(self, log_level: Union[str, int]):
+        root_logger = logging.getLogger(self.app_name)
+        root_logger.setLevel(log_level)
+        root_logger.propagate = False
+
+        for handler in root_logger.handlers[:]:
+            root_logger.removeHandler(handler)
+
+        console_handler = self._create_console_handler()
+        root_logger.addHandler(console_handler)
+
+        file_handler = self._create_file_handler(self.log_file)
+        root_logger.addHandler(file_handler)
+
+        self.root_logger = root_logger
+
+    def _create_console_handler(self) -> logging.StreamHandler:
+        handler = logging.StreamHandler(sys.stdout)
+        handler.setLevel(logging.INFO)
+
+        formatter = CustomFormatter(
+            use_colors=self.enable_colors, include_request_id=self.enable_request_tracking
+        )
+        handler.setFormatter(formatter)
+
+        if self.request_id_filter:
+            handler.addFilter(self.request_id_filter)
+
+        if self.sensitive_filter:
+            handler.addFilter(self.sensitive_filter)
+
+        return handler
+
+    def _create_file_handler(self, log_file: Path) -> logging.FileHandler:
+        log_file.parent.mkdir(parents=True, exist_ok=True)
+
+        handler = logging.FileHandler(log_file, mode="w", encoding="utf-8")
+        handler.setLevel(logging.DEBUG)
+
+        formatter = CustomFormatter(
+            use_colors=False, include_request_id=self.enable_request_tracking
+        )
+        handler.setFormatter(formatter)
+
+        if self.request_id_filter:
+            handler.addFilter(self.request_id_filter)
+
+        if self.sensitive_filter:
+            handler.addFilter(self.sensitive_filter)
+
+        return handler
+
+    def get_logger(self, name: str) -> logging.Logger:
+        full_name = f"{self.app_name}.{name}" if name else self.app_name
+
+        if full_name not in self._module_loggers:
+            logger = logging.getLogger(full_name)
+            logger.setLevel(self.root_logger.level)
+
+            if not logger.handlers:
+                logger.parent = self.root_logger
+
+            self._module_loggers[full_name] = logger
+
+        return self._module_loggers[full_name]
+
+    def set_request_id(self, request_id: str):
+        if self.request_id_filter:
+            self.request_id_filter.set_request_id(request_id)
+
+    def clear_request_id(self):
+        if self.request_id_filter:
+            self.request_id_filter.clear_request_id()
+
+    def update_log_file(self, new_log_file: Union[str, Path]):
+        new_path = Path(new_log_file)
+
+        for handler in self.root_logger.handlers[:]:
+            if isinstance(handler, logging.FileHandler):
+                self.root_logger.removeHandler(handler)
+                handler.close()
+
+        new_file_handler = self._create_file_handler(new_path)
+        self.root_logger.addHandler(new_file_handler)
+
+        self.log_file = new_path
+        self.root_logger.info("Log file updated to: %s", new_path)
+
+    def set_level(self, level: Union[str, int]):
+        self.root_logger.setLevel(level)
+        for logger in self._module_loggers.values():
+            logger.setLevel(level)
+
+    def enable_debug_mode(self):
+        self.set_level(logging.DEBUG)
+
+        for handler in self.root_logger.handlers:
+            if isinstance(handler, logging.StreamHandler) and handler.stream == sys.stdout:
+                handler.setLevel(logging.DEBUG)
+
+
+_logger_manager: Optional[LoggerManager] = None
+
+
+def init_logging(  # pylint: disable=too-many-arguments
+    app_name: str = "BlackAnt",
+    log_file: Optional[str] = None,
+    log_level: Union[str, int] = logging.INFO,
+    enable_colors: bool = True,
+    enable_request_tracking: bool = True,
+    enable_sensitive_filter: bool = True,
+) -> LoggerManager:
+    global _logger_manager  # pylint: disable=global-statement,invalid-name
+
+    _logger_manager = LoggerManager(
+        app_name=app_name,
+        default_log_file=log_file,
+        log_level=log_level,
+        enable_colors=enable_colors,
+        enable_request_tracking=enable_request_tracking,
+        enable_sensitive_filter=enable_sensitive_filter,
+    )
+
+    return _logger_manager
+
+
+def get_logger(name: str = "") -> logging.Logger:
+    global _logger_manager  # pylint: disable=global-statement,invalid-name
+
+    if _logger_manager is None:
+        _logger_manager = init_logging()
+
+    return _logger_manager.get_logger(name)
+
+
+def set_request_id(request_id: str):
+    if _logger_manager:
+        _logger_manager.set_request_id(request_id)
+
+
+def clear_request_id():
+    if _logger_manager:
+        _logger_manager.clear_request_id()
+
+
+def update_log_file(new_log_file: Union[str, Path]):
+    if _logger_manager:
+        _logger_manager.update_log_file(new_log_file)
+
+
+def set_log_level(level: Union[str, int]):
+    if _logger_manager:
+        _logger_manager.set_level(level)
+
+
+def enable_debug_mode():
+    if _logger_manager:
+        _logger_manager.enable_debug_mode()
+
+
+def gb_to_mb(gigabytes: float) -> int:
+    return int(gigabytes * 1024)
+
+
+if __name__ == "__main__":
+    init_logging(app_name="BlackAnt-Demo", log_level="DEBUG")
+
+    main_logger = get_logger("main")
+    http_logger = get_logger("http")
+
+    main_logger.debug("Debug message")
+    main_logger.info("Info message")
+    main_logger.warning("Warning message")
+    main_logger.error("Error message")
+
+    set_request_id("req_demo_12345")
+    http_logger.info("Message with request ID")
+
+    clear_request_id()
+    main_logger.info("Message without request ID")
+
+    http_logger.info("Token test: Bearer secret_token_123")

blackant/utils/request_id.py

@@ -0,0 +1,13 @@
+import uuid
+import time
+
+
+class RequestIdGenerator:  # pylint: disable=too-few-public-methods
+    def __init__(self, header_name="X-Request-ID"):
+        self.header_name = header_name
+        self._counter = 0
+
+    def generate_id(self):
+        self._counter += 1
+        timestamp = int(time.time() * 1000)
+        return f"req_{timestamp}_{self._counter}_{uuid.uuid4().hex[:8]}"

blackant/utils/store.py

@@ -0,0 +1,50 @@
+"""Runtime data storage module for BlackAnt SDK.
+
+Provides thread-safe storage using threading.local() for storing
+data across different modules and components.
+"""
+
+from typing import Any
+import threading
+
+from ..patterns.singleton import Singleton
+
+
+class Store(metaclass=Singleton):  # pylint: disable=too-few-public-methods
+    """Base class for runtime data storage.
+
+    Thread-safe storage implementation using threading.local().
+    All specific stores (auth tokens, request IDs) inherit from this class.
+    """
+
+    __tls = threading.local()
+
+    def _get(self, name: str):
+        """Get data from thread-local storage.
+
+        Args:
+            name (str): Attribute name to retrieve.
+
+        Returns:
+            Any or None: Attribute value or None if not set.
+        """
+        if not hasattr(self.__tls, name):
+            return None
+        return self.__tls.__getattribute__(name)
+
+    def _set(self, name: str, value: Any):
+        """Set data in thread-local storage.
+
+        Args:
+            name (str): Attribute name to set.
+            value (Any): Value to store.
+        """
+        self.__tls.__setattr__(name, value)
+
+    def _del(self, name: str):
+        """Delete data from thread-local storage.
+
+        Args:
+            name (str): Attribute name to delete.
+        """
+        self.__tls.__delattr__(name)

blackant_sdk-1.0.2.dist-info/METADATA

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: blackant-sdk
+Version: 1.0.2
+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
+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.
+
+
+......

blackant_sdk-1.0.2.dist-info/RECORD

@@ -0,0 +1,70 @@
+blackant/__init__.py,sha256=THZWaFP_eIFEDVsIQC5HSCY9k2nGeR1TQ3rNhdlScEM,746
+blackant/client.py,sha256=dsF-vPDzhv8Bx_OoakP4NC5dnbYRfkB4MHXcIAsIr9I,15180
+blackant/exceptions.py,sha256=6y9FwBlO_ntYmVyJfrhKVUUnAHaA0wkyJx2WtddU1Ts,2845
+blackant/auth/__init__.py,sha256=Ax1FqQsZNucr4CEUCqeZkrnbWN8Fx72IHFg3PZzbd2A,289
+blackant/auth/blackant_auth.py,sha256=eLZ2T17kxRyl54LII1roGsyxkM-hMAWyqgi_HowwSLQ,19113
+blackant/auth/keycloak_manager.py,sha256=6ubCAC8lR-6d5UyEXdX4X7aKTo3NF3N1kZ5KnPUcOOA,11708
+blackant/auth/request_id.py,sha256=vWh-GX6f7aQAgvj2XINqn_8gJVgQ0a3bk_B3JqrtGaQ,1396
+blackant/auth/role_assignment.py,sha256=Y14FIxSys9ICrYkVEERW3t2IyUyZwGODalXLV6kmD0c,14865
+blackant/auth/tokens.py,sha256=A8fdd4a6KS24PmuiHvNgJCH5UJRGNfgm8wO6Q0hY4vE,1498
+blackant/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+blackant/config/docker_config.py,sha256=80VM0kvUV-AWbzB2qDCFOHog9MDklsXdfsB3wEFRtX0,15049
+blackant/config/keycloak_admin_config.py,sha256=a4de2bCd_PjuCXajQIzZko7YaPJVmifQlvNVK8M3iTU,3370
+blackant/docker/__init__.py,sha256=RtBjt7fX4cUjszHtlH6izgFOXPDqhCUYU7NOUALQCF0,362
+blackant/docker/builder.py,sha256=pGOyHTVvZLn9hTFu-VX2V4YGo2e2aur2l95i3ZdHp6s,24728
+blackant/docker/client.py,sha256=i0JG7FCBeR9-gstom1rMTwc4ZCKVmMj0QIxyEXi_7fg,37405
+blackant/docker/dao.py,sha256=bNtGhArc3kzD19QpeYoXNYvRwr7Bk3NsQ0DirohlYdA,17258
+blackant/docker/registry.py,sha256=lGTECoCAklMe5-oD9bJDM1q9wq35YYDt6TM7hQdyM1I,5813
+blackant/http/__init__.py,sha256=s54aPP80f6AWCEq2XS97CM2Z8-mAKamKaAlZgWy6-vE,207
+blackant/http/client.py,sha256=DacZlA3MMNS6Ys0tWSNXT57avwN5Dr5PpX6Iekji5es,4597
+blackant/patterns/__init__.py,sha256=iOEhKRqynyPbMNqDn1nHVWF6BoEq1htKtjjlJbmHp8U,48
+blackant/patterns/singleton.py,sha256=LpNrQ5ct_tl9HIhDE4x7UDamezaMBDeiyDHXe9LwosU,610
+blackant/services/__init__.py,sha256=UAPWaWiaPJ5XlvWtsqLO16eQkrkVAj4xzeeoyE9o3Vk,278
+blackant/services/dao.py,sha256=4qm0MFIO2c0lkOUqOC8Fyp0tcF4MbBkF7RNcBdpuIWU,15187
+blackant/services/registry.py,sha256=RPSTRPtKxa53NXxBVzW0TAdK3z8ai_ObnS47YjKCuE8,23473
+blackant/utils/__init__.py,sha256=tzO_ZleysoT7Yf7kpI_io4udNAeH7c9cxwJqydEF5jA,130
+blackant/utils/initialization.py,sha256=pe0fVfeV0mQkYdYJPoashTBTSNs4wQHtNEtABR2Jw7I,846
+blackant/utils/logging.py,sha256=c1bNgWido4j1mD6p8l8pVhYCZgWfarP-R439pBOrIP8,10700
+blackant/utils/request_id.py,sha256=RzuiIhlyVWLbAnSWmFh9pfwzPzLPxkLs3i8dyCxY92I,383
+blackant/utils/store.py,sha256=Vewqt42Ne5e_m9DTxEnxA3afyhsyrNbuPrq4Y0v5P90,1348
+calculation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+calculation/base.py,sha256=648e38zekvKsv4a7DL2skcjWX8ed7FDwSy6I3ubG7j4,529
+calculation/errors.py,sha256=h5jZmvA76RApr4vIUqkyTYmjk3NzxknUjlWqNZDelcU,46
+calculation/loader.py,sha256=Jrt3dadpgU2b-UhNhZrdAuFGN2gzyrlcgnHNjbGtXk8,8005
+calculation/impl/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+calculation/impl/my_calculation.py,sha256=dsi5pDfgiCGOCZ7Rivjs7n5fiBCuB9Q8GOT4VR5v-0U,5054
+calculation/impl/simple_calc.py,sha256=xhTlEt8oIz-oHDxtT_Iz3zSPjTl23a_XleC8kJUYdeU,1245
+calculation/impl/test.py,sha256=_P06owSXxM9cK3FeeyYPXi17Km3-n394C_LYfMhUlbA,13
+calculation/impl/test_calc.py,sha256=iSr4OUsupJpnug8SVl32-qWiLjP3iGrJc8I4W7JfAJk,954
+notifinations/__init__.py,sha256=eOVctP2iedEe94bzz01B_0hqhNr8pFq9j7Qq9a2xK5o,175
+notifinations/mail_sender.py,sha256=bx3jRShq4EjPesfIzP6vfmdB8XL8fi0ilMnURhWy_YY,7958
+storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+storage/errors.py,sha256=ja71c2WQbtsamIRbFO4ea66Lr7SpIh8kWhf0h7gValI,187
+storage/factory.py,sha256=ki2lYvA5JrxWQVZ3WX3Tykldo1q6F-20eAKudMo5Iig,905
+storage/interface.py,sha256=87pQJ3uW8EJ4uLMi07iQxPaVM0HhUTXrshcUlRFSSM4,420
+storage/minio.py,sha256=VxP6JNa_ktuY-0LB8-jvDGb9dm193pBgD3JFmKJOVhY,3985
+task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+task/dao.py,sha256=Qs7-ACKWtWaWTwV1nuoRMOHXQObj_Z9vWNI-SPTvNaI,1012
+task/errors.py,sha256=O6Uwj2benf3bs6AKtdkrPCtP_jPXWTS5nepUWEy3NZM,163
+task/log_adapter.py,sha256=HmXpus2fYuRcPlUgSMFByqj7HZoFwQ2ABv28sEZ3uPk,323
+task/resource.py,sha256=n0rOvOu4tYD9v9zEFxl-pZmp9NjqT-8Cqzb3ErEq68g,3307
+task/task.py,sha256=_b0P-lM9LtLZxvmRIHWgrecziG_TuaUTVZifFs7hv2s,13314
+task/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+task/parsers/base.py,sha256=VUpZrPJPTnwAvPzxqvI0MgkzEW-550996izlFGJm2uI,249
+task/parsers/callback.py,sha256=dgQFc3n3tlGcd7qhK_BYe-RRXxh3OLHznHiaqzGCwgw,1038
+task/parsers/cmd_args.py,sha256=lUjZD6T27elvx1qQdia0WiXlXjLIgGeztB10MK6PqH8,1684
+task/parsers/freetext.py,sha256=KA5g1tyb648RXHpl8XY6h-UVAvWNrEnZiuJt7bw8QFM,545
+task/parsers/objects.py,sha256=fQcRVEQjQ1UxlWrt6kEfqzH3JaQqFX_ON4ign_omuZ0,1555
+task/parsers/request.py,sha256=dfV1ow8e1tb1Cdmb0FBIagGCynFHfNWftBX40I10QAE,1859
+task/states/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+task/states/base.py,sha256=xsh2CoLoOcAcjpQrZri8F9sYbBv8StdCMl-9hJqRQsE,263
+task/states/error.py,sha256=19Vpvvmx-qHG2zgtGfHK7ULHx6ZCisMdcPNVPSNDZDA,1766
+task/states/idle.py,sha256=3JYb8-_eJ5NlirMWOaEh_OUP7HtjqqyBIQye-nzoRYQ,326
+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.2.dist-info/METADATA,sha256=uzdQjvqBJNSYM414ju-eN0aHA7JbSiMWCdi4hfRZUkg,3615
+blackant_sdk-1.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+blackant_sdk-1.0.2.dist-info/top_level.txt,sha256=MZZ_UBTnah0fs9yzTmlavd4Z0HuJDD3alhfGlB79ZIE,48
+blackant_sdk-1.0.2.dist-info/RECORD,,

blackant_sdk-1.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

blackant_sdk-1.0.2.dist-info/top_level.txt

@@ -0,0 +1,5 @@
+blackant
+calculation
+notifinations
+storage
+task

calculation/base.py

@@ -0,0 +1,26 @@
+import abc
+
+
+class CalculationBase:
+    def __init__(self, logger):
+        self._logger = logger
+
+    @abc.abstractproperty
+    def result(self):
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def set_up(self):
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def run(self):
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def tear_down(self):
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def stop(self):
+        raise NotImplementedError

calculation/errors.py

@@ -0,0 +1,2 @@
+class CalculationError(Exception):
+    pass