vism-lib 0.1.1__tar.gz

vism_lib-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Author Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vism_lib-0.1.1/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: vism_lib
+Version: 0.1.1
+Summary: Library for vism CA and ACME
+Author-email: atrivisc <atrivisc.shawl130@passmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Author Name
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/atrivisc/vism-lib
+Project-URL: Repository, https://github.com/atrivisc/vism-lib.git
+Project-URL: Bug Tracker, https://github.com/atrivisc/vism-lib/issues
+Keywords: vism
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-pkcs11>=0.9.3
+Requires-Dist: yaml-pydantic-dataclass>=0.1.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: starlette>=0.52.1
+Dynamic: license-file
+
+# vism-lib

vism_lib-0.1.1/README.md

@@ -0,0 +1 @@
+# vism-lib

vism_lib-0.1.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vism_lib"
+version = "0.1.1"
+authors = [
+  { name="atrivisc", email="atrivisc.shawl130@passmail.com" },
+]
+description = "Library for vism CA and ACME"
+readme = "README.md"
+requires-python = ">=3.14"
+license = { file = "LICENSE" }
+keywords = ["vism"]
+dependencies = [
+    "python-pkcs11>=0.9.3",
+    "yaml-pydantic-dataclass>=0.1.1",
+    "pydantic>=2.12.5",
+    "starlette>=0.52.1"
+
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/atrivisc/vism-lib"
+"Repository" = "https://github.com/atrivisc/vism-lib.git"
+"Bug Tracker" = "https://github.com/atrivisc/vism-lib/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]

vism_lib-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vism_lib-0.1.1/src/vism_lib/config.py

@@ -0,0 +1,72 @@
+"""Shared configuration classes for VISM components."""
+
+import logging
+from dataclasses import field
+from pydantic import field_validator
+from pydantic.dataclasses import dataclass
+from yaml_dataclass import YamlConfigCached
+
+from lib.logs import LoggingConfig
+
+shared_logger = logging.getLogger("vism_shared")
+
+@dataclass
+class DatabaseConfig:
+    """Database connection configuration."""
+
+    data_validation_key: str
+    host: str
+    port: int
+    database: str
+    username: str
+    password: str
+    driver: str = "postgresql+psycopg2"
+
+    @field_validator("host")
+    @classmethod
+    def host_must_be_valid(cls, v):
+        if not v:
+            raise ValueError("database host can not be empty.")
+
+        return v
+
+    @field_validator("port")
+    @classmethod
+    def port_must_be_valid(cls, v):
+        """Validate that port is in valid range."""
+        if v < 1 or v > 65535:
+            raise ValueError("Port must be between 1 and 65535")
+        return v
+
+@dataclass
+class DataExchange:
+    """Configuration for data exchange module."""
+
+    module: str
+    validation_key: str = None
+
+@dataclass
+class Security:
+    """Security configuration including validation and encryption."""
+
+    data_exchange: DataExchange = None
+    chroot_base_dir: str = None
+
+@dataclass
+class S3Config:
+    """Configuration for s3."""
+
+    bucket: str
+    endpoint: str
+    access_key: str
+    secret_key: str
+    region: str = ""
+
+@dataclass
+class VismConfig(YamlConfigCached):
+    """Base configuration class for VISM components."""
+
+    security: Security = field(default_factory=Security)
+    logging: LoggingConfig = field(default_factory=LoggingConfig)
+    database: DatabaseConfig = None
+    s3: S3Config = None

vism_lib-0.1.1/src/vism_lib/controller.py

@@ -0,0 +1,53 @@
+"""Base controller class for VISM components."""
+
+import asyncio
+
+from yaml_dataclass import YamlConfigCached
+
+from lib.config import shared_logger, DataExchange
+from lib.database import VismDatabase
+from lib.logs import setup_logger, SensitiveDataFilter
+from lib.s3 import AsyncS3Client
+
+
+class Controller:
+    """Base controller class for managing modules and configuration."""
+
+    configClass = YamlConfigCached
+    databaseClass = VismDatabase
+
+    def __init__(self):
+        self.config = self.configClass.read_config()
+        self.setup_logging()
+        self.database = self.databaseClass(self.config.database)
+        self.s3 = AsyncS3Client(self.config.s3)
+        self.data_exchange_module = None
+
+        self._shutdown_event = asyncio.Event()
+
+    def __post_init__(self):
+        self.setup_logging()
+
+    def setup_logging(self):
+        """Set up logging configuration."""
+        shared_logger.info("Setting up logging")
+        setup_logger(self.config.logging)
+
+    def shutdown(self):
+        """Initiates shutdown of the CA."""
+        shared_logger.info("Received shutdown signal, shutting down")
+        self._shutdown_event.set()
+
+    async def setup_data_exchange_module(self) -> DataExchange:
+        """Set up the data exchange module from configuration."""
+        data_exchange_module_imports = __import__(
+            f'modules.{self.config.security.data_exchange.module}',
+            fromlist=['Module', 'ModuleConfig']
+        )
+
+        SensitiveDataFilter.SENSITIVE_PATTERNS.update(
+            data_exchange_module_imports.LOGGING_SENSITIVE_PATTERNS
+        )
+
+        self.data_exchange_module = data_exchange_module_imports.Module(self)
+        return self.data_exchange_module

vism_lib-0.1.1/src/vism_lib/database.py

@@ -0,0 +1,189 @@
+"""Shared database models and utilities for VISM components."""
+
+import json
+from contextlib import contextmanager
+from datetime import datetime
+from typing import Any, Generator, Type
+from uuid import UUID, uuid4
+from sqlalchemy import Uuid, String, DateTime, func
+from sqlalchemy import ColumnExpressionArgument
+from sqlalchemy.orm import (
+    MappedAsDataclass,
+    DeclarativeBase,
+    Mapped,
+    mapped_column,
+    sessionmaker,
+    Session
+)
+from sqlalchemy.engine import URL, create_engine
+from lib.config import shared_logger, DatabaseConfig
+from sqlalchemy.exc import OperationalError, StatementError
+from sqlalchemy.orm.query import Query as _Query
+
+from lib.data.validation import DataValidation
+from lib.errors import VismDatabaseException
+
+
+class Base(MappedAsDataclass, DeclarativeBase):
+    """Base class for all database entities with common fields."""
+
+    id: Mapped[UUID] = mapped_column(
+        Uuid, primary_key=True, default=uuid4, init=False
+    )
+    signature: Mapped[str] = mapped_column(
+        String, nullable=True, default=None, init=False
+    )
+
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime,
+        server_default=func.now(),
+        init=False
+    )
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime,
+        server_default=func.now(),
+        onupdate=func.now(),
+        init=False
+    )
+
+    def to_dict(self) -> dict[str, Any]:
+        """Convert entity to dictionary representation."""
+        raise NotImplementedError()
+
+    def validate(self, validation_module: DataValidation) -> bool:
+        """Validate entity signature using validation module."""
+        shared_logger.info(
+            "Validating %s %s",
+            self.__class__.__name__,
+            self.id
+        )
+        data_bytes = json.dumps(self.to_dict()).encode("utf-8")
+        data_signature = validation_module.sign(data_bytes)
+        return data_signature == self.signature
+
+
+    def sign(self, validation_module: DataValidation) -> str:
+        """Sign entity data using validation module."""
+        shared_logger.info(
+            "Signing %s %s",
+            self.__class__.__name__,
+            self.id
+        )
+        data_bytes = json.dumps(self.to_dict()).encode("utf-8")
+        data_signature = validation_module.sign(data_bytes)
+        return data_signature
+
+class RetryingQuery(_Query):
+    __max_retry_count__ = 3
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def __iter__(self):
+        attempts = 0
+        while True:
+            attempts += 1
+            try:
+                return super().__iter__()
+            except OperationalError as ex:
+                if "server closed the connection unexpectedly" not in str(ex):
+                    raise
+                if attempts <= self.__max_retry_count__:
+                    continue
+                else:
+                    raise
+            except StatementError as ex:
+                if "reconnect until invalid transaction is rolled back" not in str(ex):
+                    raise
+                self.session.rollback()
+
+
+class VismDatabase:
+    """Database interface for VISM operations."""
+
+    def __init__(self, database_config: DatabaseConfig):
+        shared_logger.debug("Initializing database")
+        self.db_url = URL.create(
+            drivername=database_config.driver,
+            username=database_config.username,
+            password=database_config.password,
+            host=database_config.host,
+            port=database_config.port,
+            database=database_config.database
+        )
+
+        self.engine = create_engine(self.db_url, echo=False, pool_pre_ping=True)
+        self.session_maker = sessionmaker(bind=self.engine, query_cls=RetryingQuery)
+        self._create_tables()
+
+        self.validation_module = DataValidation(validation_key=database_config.data_validation_key)
+
+    def get(
+            self,
+            obj_type: Type[Base],
+            *criterion: ColumnExpressionArgument[bool],
+            multiple: bool = False
+    ):
+        """
+        Get entity or entities from database by criteria.
+
+        Args:
+            obj_type: Type of entity to retrieve
+            *criterion: Filter criteria
+            multiple: Whether to return multiple results
+
+        Returns:
+            Single entity, list of entities, or None
+        """
+        with self._get_session() as session:
+            objs: list[Base] = session.query(obj_type).filter(*criterion).all()
+            for obj in objs:
+                if not obj.validate(self.validation_module):
+                    raise VismDatabaseException("Object has invalid signature")
+            if not multiple:
+                if len(objs) == 0:
+                    return None
+                if len(objs) > 1:
+                    raise VismDatabaseException("Multiple objects found.")
+                return objs[0]
+            return objs
+
+    def save_to_db(self, obj: Base):
+        """
+        Save entity to database with signature.
+
+        Args:
+            obj: Entity to save
+
+        Returns:
+            Saved entity with updated signature
+        """
+        with self._get_session() as session:
+            merged = session.merge(obj)
+            session.flush()
+            merged.signature = merged.sign(self.validation_module)
+            merged = session.merge(merged)
+            session.flush()
+            shared_logger.info(
+                "Saved %s %s to database",
+                merged.__class__.__name__,
+                merged.id
+            )
+            return merged
+
+    def _create_tables(self):
+        """Create all database tables."""
+        Base.metadata.create_all(self.engine)
+
+    @contextmanager
+    def _get_session(self) -> Generator[Session, Any, None]:
+        """Get database session with automatic commit/rollback."""
+        session = self.session_maker(expire_on_commit=False)
+        try:
+            yield session
+            session.commit()
+        except Exception:
+            session.rollback()
+            raise
+        finally:
+            session.close()

vism_lib-0.1.1/src/vism_lib/errors.py

@@ -0,0 +1,63 @@
+"""Shared exception classes for VISM components."""
+
+import logging
+
+shared_logger = logging.getLogger("vism_shared")
+
+
+class VismBreakingException(SystemExit):
+    """Critical exception that causes system exit."""
+
+    log_level = logging.CRITICAL
+    include_traceback = True
+
+    def __init__(self, message: str, *args):
+        super().__init__(message, *args)
+        self._log_error(message, *args)
+
+    def _log_error(self, message: str, *args):
+        shared_logger.log(
+            self.log_level,
+            "%s: %s",
+            self.__class__.__name__,
+            message,
+            exc_info=self.include_traceback,
+            *args
+        )
+
+
+class VismException(RuntimeError):
+    """Base exception class for VISM errors."""
+
+    log_level = logging.ERROR
+    include_traceback = False
+
+    def __init__(self, message: str, *args):
+        super().__init__(message, *args)
+        self._log_error(message, *args)
+
+    def _log_error(self, message: str, *args):
+        shared_logger.log(
+            self.log_level,
+            "%s: %s",
+            self.__class__.__name__,
+            message,
+            exc_info=self.include_traceback,
+            *args
+        )
+
+
+class VismDatabaseException(VismException):
+    """Exception raised for database-related errors."""
+
+
+class ChrootWriteFileExists(VismException):
+    """Exception raised when attempting to write to an existing file."""
+
+
+class ChrootWriteToFileException(VismException):
+    """Exception raised when writing to a file fails."""
+
+
+class ChrootOpenFileException(VismException):
+    """Exception raised when opening a file fails."""

vism_lib-0.1.1/src/vism_lib/logs.py

@@ -0,0 +1,194 @@
+"""Logging configuration and utilities for VISM components."""
+
+import os
+import logging
+import re
+import sys
+import logging.config
+from dataclasses import dataclass
+from typing import ClassVar
+
+
+@dataclass
+class LoggingConfig:
+    """Configuration for the logging system."""
+
+    log_root: str = "vism"
+    log_dir: str = "logs"
+    verbose: bool = False
+    log_file: str = "app.log"
+    error_file: str = "error.log"
+    log_level: str = "DEBUG"
+
+
+class SensitiveDataFilter(logging.Filter): # pylint: disable=too-few-public-methods
+    """Filter to mask sensitive data in log messages."""
+
+    SENSITIVE_PATTERNS = {}
+
+    def filter(self, record):
+        """Filter and mask sensitive data in log record."""
+        for _pattern_name, pattern in self.SENSITIVE_PATTERNS.items():
+            if isinstance(record.msg, str):
+                record.msg = re.sub(
+                    pattern['pattern'],
+                    rf'{pattern["replace"]}',
+                    record.msg
+                )
+            if record.args:
+                record.args = tuple(
+                    re.sub(pattern['pattern'], rf'{pattern["replace"]}', str(arg))
+                    if isinstance(arg, str) else arg
+                    for arg in record.args
+                )
+        return True
+
+class ErrorFilter(logging.Filter):
+    def filter(self, record):
+        return record.levelno <= logging.WARNING
+
+class ColoredFormatter(logging.Formatter):  # pylint: disable=too-few-public-methods
+    """Formatter that adds color codes to log messages."""
+
+    RESET = "\033[0m"
+
+    LEVEL_COLORS = {
+        "DEBUG": "\033[36m",
+        "INFO": "\033[32m",
+        "WARNING": "\033[33m",
+        "ERROR": "\033[31m",
+        "CRITICAL": "\033[41m",
+    }
+
+    def format(self, record):
+        levelname = record.levelname
+        color = self.LEVEL_COLORS.get(levelname, "")
+
+        padded = f"{levelname:<6}"
+
+        if color:
+            record.levelname = f"{color}{padded}{self.RESET}"
+        else:
+            record.levelname = padded
+
+        formatted = super().format(record)
+        record.levelname = levelname
+        return formatted
+
+
+def setup_logger(config: LoggingConfig):
+    """
+    Set up logging configuration with handlers and formatters.
+
+    Args:
+        config: Logging configuration
+    """
+    if not os.path.exists(config.log_dir):
+        os.makedirs(config.log_dir)
+
+    logging_config = {
+        'version': 1,
+        'disable_existing_loggers': False,
+        'filters': {
+            'sensitive_data': {
+                '()': SensitiveDataFilter,
+            },
+            'info_debug_only': {
+                '()': ErrorFilter,
+            }
+        },
+        'formatters': {
+            'verbose': {
+                '()': ColoredFormatter,
+                'format': '%(asctime)s [%(name)-12s] [%(levelname)-7s] %(message)s',
+                'datefmt': '%Y-%m-%d %H:%M:%S',
+            },
+            'simple': {
+                '()': ColoredFormatter,
+                'format': '%(asctime)s [%(levelname)-7s] %(message)s',
+                'datefmt': '%Y-%m-%d %H:%M:%S',
+            },
+            'verbose_error': {
+                '()': ColoredFormatter,
+                'format': '%(asctime)s [%(name)-30s] [%(levelname)-7s] %(message)s',
+                'datefmt': '%Y-%m-%d %H:%M:%S',
+            },
+            'simple_error': {
+                '()': ColoredFormatter,
+                'format': '%(asctime)s [%(levelname)-7s] %(message)s',
+                'datefmt': '%Y-%m-%d %H:%M:%S',
+            },
+        },
+        'handlers': {
+            'file': {
+                'level': f"{config.log_level}",
+                'class': 'logging.FileHandler',
+                'formatter': 'simple' if not config.verbose else 'verbose',
+                'filename': f'{config.log_dir.rstrip("/")}/{config.log_file}',
+                'encoding': 'utf8',
+                'filters': ['sensitive_data', 'info_debug_only']
+            },
+            "stdout_info_debug_only": {
+                "level": f"{config.log_level}",
+                "class": "logging.StreamHandler",
+                "formatter": 'simple' if not config.verbose else 'verbose',
+                "stream": sys.stdout,
+                'filters': ['sensitive_data', 'info_debug_only']
+            },
+            "stdout": {
+                "level": f"{config.log_level}",
+                "class": "logging.StreamHandler",
+                "formatter": 'simple' if not config.verbose else 'verbose',
+                "stream": sys.stdout,
+            },
+            "stderr": {
+                "level": "ERROR",
+                "class": "logging.StreamHandler",
+                "formatter": 'simple_error' if not config.verbose else 'verbose_error',
+                "stream": sys.stderr,
+            },
+            'error_file': {
+                'level': f"ERROR",
+                'class': 'logging.FileHandler',
+                'formatter': 'simple_error' if not config.verbose else 'verbose_error',
+                'filename': f'{config.log_dir.rstrip("/")}/{config.error_file}',
+                'encoding': 'utf8',
+                'filters': ['sensitive_data']
+            },
+        },
+        'loggers': {
+            f'{config.log_root}': {
+                'level': config.log_level,
+                'handlers': ['file', 'error_file', 'stdout_info_debug_only', 'stderr'],
+                "propagate": False,
+            },
+            'vism_shared': {
+                'level': config.log_level,
+                'handlers': ['file', 'error_file', 'stdout_info_debug_only', 'stderr'],
+                "propagate": False,
+            },
+            'vism_module': {
+                'level': config.log_level,
+                'handlers': ['file', 'error_file', 'stdout_info_debug_only', 'stderr'],
+                "propagate": False,
+            },
+            "uvicorn": {
+                "handlers": ["stdout"],
+                "level": "INFO",
+                "propagate": False,
+            },
+            "uvicorn.error": {
+                "handlers": ["stderr"],
+                "level": "INFO",
+                "propagate": False,
+            },
+            "uvicorn.access": {
+                "handlers": ["stdout"],
+                "level": "INFO",
+                "propagate": False,
+            },
+        }
+    }
+
+    logging.config.dictConfig(logging_config)
+    logging.debug("Logging is set up and ready")

vism_lib-0.1.1/src/vism_lib/s3.py

@@ -0,0 +1,80 @@
+from typing import Optional, Dict, Any, Union
+import aioboto3
+from lib.config import S3Config
+from lib.config import shared_logger
+
+class AsyncS3Client:
+    def __init__(self, config: S3Config) -> None:
+        self.bucket_name = config.bucket
+        self._session = aioboto3.Session(
+            aws_access_key_id=config.access_key,
+            aws_secret_access_key=config.secret_key,
+            region_name=config.region,
+        )
+        self._endpoint = config.endpoint
+
+    async def list_files(self, prefix: str) -> list[str]:
+        """
+        List files directly under the given prefix (non-recursive).
+        Returns only objects, not "directories".
+
+        :param prefix: e.g. "folder/" or "" for root.
+        """
+        async with self._session.client("s3", endpoint_url=self._endpoint) as s3:
+            paginator = s3.get_paginator("list_objects_v2")
+
+            results = []
+
+            async for page in paginator.paginate(
+                Bucket=self.bucket_name,
+                Prefix=prefix,
+                Delimiter="/",
+            ):
+                contents = page.get("Contents", [])
+                for obj in contents:
+                    key = obj["Key"]
+                    if key != prefix:
+                        results.append(key)
+
+            return results
+
+    async def upload_bytes(
+        self,
+        data: Union[bytes, bytearray, memoryview],
+        key: str,
+        extra_args: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        shared_logger.info(f"Uploading file {key} to s3")
+        async with self._session.client("s3", endpoint_url=self._endpoint) as s3:
+            extra_args = extra_args or {}
+
+            await s3.put_object(
+                Bucket=self.bucket_name,
+                Key=key,
+                Body=data,
+                **extra_args,
+            )
+
+    async def download_bytes(self, key: str) -> Optional[bytes]:
+        shared_logger.info(f"Downloading file '{key}' from s3")
+        async with self._session.client("s3", endpoint_url=self._endpoint) as s3:
+            try:
+                resp = await s3.get_object(Bucket=self.bucket_name, Key=key)
+            except Exception as e:
+                shared_logger.error(f"Failed to download file '{key}' from s3: {e}")
+                return None
+
+            body = resp["Body"]
+            return await body.read()
+
+    async def exists(self, key: str) -> bool:
+        async with self._session.client("s3", endpoint_url=self._endpoint) as s3:
+            try:
+                await s3.head_object(Bucket=self.bucket_name, Key=key)
+                return True
+            except s3.exceptions.NoSuchKey:
+                return False
+            except Exception as e:
+                if getattr(e, "response", {}).get("ResponseMetadata", {}).get("HTTPStatusCode") == 404:
+                    return False
+                raise

vism_lib-0.1.1/src/vism_lib/util.py

@@ -0,0 +1,79 @@
+"""Utility functions for VISM components."""
+import ipaddress
+import base64
+
+import pkcs11
+from starlette.requests import Request
+
+def is_valid_ip(ip_str):
+    """Check if a string is a valid IP address."""
+    try:
+        ipaddress.ip_address(ip_str)
+        return True
+    except ValueError:
+        return False
+
+
+def is_valid_subnet(subnet_str):
+    """Check if a string is a valid subnet."""
+    try:
+        ipaddress.ip_network(subnet_str, strict=False)
+        return True
+    except ValueError:
+        return False
+
+
+def b64u_decode(data: str) -> bytes:
+    """Decode base64url encoded data."""
+    if data is None:
+        return b""
+
+    if isinstance(data, bytes):
+        data = data.decode("ascii")
+
+    data = data.strip()
+    if data == "":
+        return b""
+
+    rem = len(data) % 4
+    if rem:
+        data += "=" * (4 - rem)
+
+    return base64.urlsafe_b64decode(data)
+
+
+def snake_to_camel(name):
+    """Convert snake_case to camelCase."""
+    split = name.split('_')
+    return split[0] + ''.join(word.capitalize() for word in split[1:])
+
+
+def absolute_url(request: Request, path: str) -> str:
+    """Build absolute URL from request and path."""
+    scheme = request.url.scheme
+    if request.headers.get("X-Forwarded-Proto"):
+        scheme = request.headers.get("X-Forwarded-Proto")
+
+    base = str(request.base_url.replace(scheme=scheme)).rstrip("/")
+    if not path.startswith("/"):
+        path = "/" + path
+
+    return f"{base}{path}"
+
+
+def get_client_ip(request: Request):
+    """Get client IP address from request, respecting X-Forwarded-For."""
+    x_forwarded_for = request.headers.get("X-Forwarded-For")
+    if x_forwarded_for:
+        ip = x_forwarded_for.split(",")[0].strip()
+    else:
+        ip = request.client.host
+    return ip
+
+
+def fix_base64_padding(base64_string):
+    """Fix base64 string padding if missing."""
+    padding_needed = len(base64_string) % 4
+    if padding_needed != 0:
+        base64_string += "=" * (4 - padding_needed)
+    return base64_string

vism_lib-0.1.1/src/vism_lib.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: vism_lib
+Version: 0.1.1
+Summary: Library for vism CA and ACME
+Author-email: atrivisc <atrivisc.shawl130@passmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Author Name
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/atrivisc/vism-lib
+Project-URL: Repository, https://github.com/atrivisc/vism-lib.git
+Project-URL: Bug Tracker, https://github.com/atrivisc/vism-lib/issues
+Keywords: vism
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-pkcs11>=0.9.3
+Requires-Dist: yaml-pydantic-dataclass>=0.1.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: starlette>=0.52.1
+Dynamic: license-file
+
+# vism-lib

vism_lib-0.1.1/src/vism_lib.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+src/vism_lib/__init__.py
+src/vism_lib/config.py
+src/vism_lib/controller.py
+src/vism_lib/database.py
+src/vism_lib/errors.py
+src/vism_lib/logs.py
+src/vism_lib/s3.py
+src/vism_lib/util.py
+src/vism_lib.egg-info/PKG-INFO
+src/vism_lib.egg-info/SOURCES.txt
+src/vism_lib.egg-info/dependency_links.txt
+src/vism_lib.egg-info/requires.txt
+src/vism_lib.egg-info/top_level.txt

vism_lib-0.1.1/src/vism_lib.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

vism_lib-0.1.1/src/vism_lib.egg-info/requires.txt

@@ -0,0 +1,4 @@
+python-pkcs11>=0.9.3
+yaml-pydantic-dataclass>=0.1.1
+pydantic>=2.12.5
+starlette>=0.52.1

vism_lib-0.1.1/src/vism_lib.egg-info/top_level.txt

@@ -0,0 +1 @@
+vism_lib