opensecureconf-client 2.0.2__py3-none-any.whl → 2.3.0__py3-none-any.whl

{opensecureconf_client-2.0.2.dist-info → opensecureconf_client-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensecureconf-client
-Version: 2.0.2
+Version: 2.3.0
 Summary: Python client library for OpenSecureConf encrypted configuration management API with clustering support
 Author-email: Alessandro Pioli <alessandro.pioli+apioli-pypi@gmail.com>
 Maintainer-email: Alessandro Pioli <alessandro.pioli+apioli-pypi@gmail.com>

opensecureconf_client-2.3.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+opensecureconf_client.py,sha256=9BfhPk3C7hFUy0wEB8P2-Xn69Zfrr8v2fhQmk4nEwqQ,27630
+opensecureconf_client-2.3.0.dist-info/licenses/LICENSE,sha256=mvMdzinneV_-L01ddrHOBgbutNS8tjT1m7loT7VTWbI,1073
+opensecureconf_client-2.3.0.dist-info/METADATA,sha256=d5bjvHAT8Vb6VQDDRTpjmOSDRcMQNy26U4eInosp0HY,33865
+opensecureconf_client-2.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+opensecureconf_client-2.3.0.dist-info/top_level.txt,sha256=J7NP3hD92OUdqseJLlbzgPuG_ovqkURRyw7iBJJeDVE,22
+opensecureconf_client-2.3.0.dist-info/RECORD,,

{opensecureconf_client-2.0.2.dist-info → opensecureconf_client-2.3.0.dist-info}/WHEEL

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

opensecureconf_client.py

@@ -12,9 +12,10 @@ Enhanced Features:
 - Batch operations
 - Enhanced input validation
 - Health check utilities
+- Support for multiple value types (dict, str, int, bool, list)
 """
 
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, Union
 import logging
 import time
 import requests
@@ -22,7 +23,6 @@ from requests.adapters import HTTPAdapter
 from requests.exceptions import Timeout, RequestException
 from urllib3.util.retry import Retry
 
-
 # ============================================================================
 # EXCEPTIONS
 # ============================================================================
@@ -30,23 +30,18 @@ from urllib3.util.retry import Retry
 class OpenSecureConfError(Exception):
     """Base exception for OpenSecureConf client errors."""
 
-
 class AuthenticationError(OpenSecureConfError):
     """Raised when authentication fails (invalid or missing user key)."""
 
-
 class ConfigurationNotFoundError(OpenSecureConfError):
     """Raised when a requested configuration key does not exist."""
 
-
 class ConfigurationExistsError(OpenSecureConfError):
     """Raised when attempting to create a configuration that already exists."""
 
-
 class ClusterError(OpenSecureConfError):
     """Raised when cluster operations fail."""
 
-
 # ============================================================================
 # CLIENT
 # ============================================================================
@@ -73,9 +68,14 @@ class OpenSecureConfClient:
         ...     enable_retry=True,
         ...     log_level="INFO"
         ... )
+        >>> # Dict value
         >>> config = client.create("database", {"host": "localhost", "port": 5432})
-        >>> print(config["value"])
-        {'host': 'localhost', 'port': 5432}
+        >>> # String value
+        >>> config = client.create("api_token", "secret-token-123")
+        >>> # Int value
+        >>> config = client.create("max_connections", 100)
+        >>> # Bool value
+        >>> config = client.create("debug_mode", True)
     """
 
     def __init__(
@@ -171,12 +171,10 @@ class OpenSecureConfClient:
             "x-user-key": self.user_key,
             "Content-Type": "application/json"
         }
-
         if self.api_key:
             headers["X-API-Key"] = self.api_key
 
         self._session.headers.update(headers)
-
         self.logger.info(f"Client initialized for {self.base_url}")
 
     def _make_request(self, method: str, endpoint: str, **kwargs) -> Any:
@@ -208,7 +206,6 @@ class OpenSecureConfClient:
         try:
             response = self._session.request(method, url, **kwargs)
             duration = time.time() - start_time
-
             self.logger.info(
                 f"{method} {endpoint} - Status: {response.status_code} - Duration: {duration:.3f}s"
             )
@@ -295,7 +292,7 @@ class OpenSecureConfClient:
         Example:
             >>> info = client.get_service_info()
             >>> print(info["version"])
-            2.1.0
+            2.2.0
         """
         return self._make_request("GET", "/")
 
@@ -350,9 +347,9 @@ class OpenSecureConfClient:
     # ========================================================================
 
     def create(
-        self, 
-        key: str, 
-        value: Dict[str, Any], 
+        self,
+        key: str,
+        value: Union[Dict[str, Any], str, int, bool, list],
         category: Optional[str] = None
     ) -> Dict[str, Any]:
         """
@@ -360,7 +357,7 @@ class OpenSecureConfClient:
 
         Args:
             key: Unique configuration key (1-255 characters)
-            value: Configuration data as dictionary (will be encrypted)
+            value: Configuration data (dict, string, int, bool, or list - will be encrypted)
             category: Optional category for grouping (max 100 characters)
 
         Returns:
@@ -372,22 +369,25 @@ class OpenSecureConfClient:
 
         Raises:
             ConfigurationExistsError: If configuration key already exists
-            ValueError: If key or value is invalid
+            ValueError: If key is invalid
 
         Example:
-            >>> config = client.create(
-            ...     key="database",
-            ...     value={"host": "localhost", "port": 5432},
-            ...     category="production"
-            ... )
+            >>> # Dict value
+            >>> config = client.create("database", {"host": "localhost", "port": 5432}, "prod")
+            >>> # String value
+            >>> config = client.create("api_token", "secret-token-123", "auth")
+            >>> # Integer value
+            >>> config = client.create("max_retries", 3)
+            >>> # Boolean value
+            >>> config = client.create("debug_enabled", False)
+            >>> # List value
+            >>> config = client.create("allowed_ips", ["192.168.1.1", "10.0.0.1"])
         """
         # Enhanced validation
         if not key or not isinstance(key, str):
             raise ValueError("Key must be a non-empty string")
         if len(key) > 255:
             raise ValueError("Key must be between 1 and 255 characters")
-        if not isinstance(value, dict):
-            raise ValueError("Value must be a dictionary")
         if category and len(category) > 100:
             raise ValueError("Category must be max 100 characters")
 
@@ -403,6 +403,7 @@ class OpenSecureConfClient:
 
         Returns:
             Dictionary containing the configuration with decrypted value
+            The value can be dict, str, int, bool, or list depending on what was stored
 
         Raises:
             ConfigurationNotFoundError: If configuration key does not exist
@@ -410,8 +411,7 @@ class OpenSecureConfClient:
 
         Example:
             >>> config = client.read("database")
-            >>> print(config["value"]["host"])
-            localhost
+            >>> print(config["value"])  # Could be any supported type
         """
         if not key or not isinstance(key, str):
             raise ValueError("Key must be a non-empty string")
@@ -419,9 +419,9 @@ class OpenSecureConfClient:
         return self._make_request("GET", f"/configs/{key}")
 
     def update(
-        self, 
-        key: str, 
-        value: Dict[str, Any], 
+        self,
+        key: str,
+        value: Union[Dict[str, Any], str, int, bool, list],
         category: Optional[str] = None
     ) -> Dict[str, Any]:
         """
@@ -429,7 +429,7 @@ class OpenSecureConfClient:
 
         Args:
             key: Configuration key to update
-            value: New configuration data as dictionary (will be encrypted)
+            value: New configuration data (dict, string, int, bool, or list - will be encrypted)
             category: Optional new category
 
         Returns:
@@ -437,18 +437,18 @@ class OpenSecureConfClient:
 
         Raises:
             ConfigurationNotFoundError: If configuration key does not exist
-            ValueError: If parameters are invalid
+            ValueError: If key is invalid
 
         Example:
-            >>> config = client.update(
-            ...     key="database",
-            ...     value={"host": "db.example.com", "port": 5432}
-            ... )
+            >>> # Update with dict
+            >>> config = client.update("database", {"host": "db.example.com", "port": 5432})
+            >>> # Update with string
+            >>> config = client.update("api_token", "new-token-456")
+            >>> # Update with int
+            >>> config = client.update("timeout", 60)
         """
         if not key or not isinstance(key, str):
             raise ValueError("Key must be a non-empty string")
-        if not isinstance(value, dict):
-            raise ValueError("Value must be a dictionary")
         if category and len(category) > 100:
             raise ValueError("Category must be max 100 characters")
 
@@ -489,6 +489,7 @@ class OpenSecureConfClient:
 
         Returns:
             List of configuration dictionaries with decrypted values
+            Each value can be dict, str, int, bool, or list
 
         Example:
             >>> configs = client.list_all(category="production")
@@ -503,8 +504,8 @@ class OpenSecureConfClient:
     # ========================================================================
 
     def bulk_create(
-        self, 
-        configs: List[Dict[str, Any]], 
+        self,
+        configs: List[Dict[str, Any]],
         ignore_errors: bool = False
     ) -> List[Dict[str, Any]]:
         """
@@ -512,6 +513,7 @@ class OpenSecureConfClient:
 
         Args:
             configs: List of configuration dictionaries with 'key', 'value', and optional 'category'
+                    Value can be dict, str, int, bool, or list
             ignore_errors: If True, continue on errors and return partial results
 
         Returns:
@@ -524,7 +526,8 @@ class OpenSecureConfClient:
         Example:
             >>> configs = [
             ...     {"key": "db1", "value": {"host": "localhost"}, "category": "prod"},
-            ...     {"key": "db2", "value": {"host": "remote"}, "category": "prod"}
+            ...     {"key": "token", "value": "secret-123", "category": "auth"},
+            ...     {"key": "retries", "value": 3, "category": "config"}
             ... ]
             >>> results = client.bulk_create(configs)
             >>> print(f"Created {len(results)} configurations")
@@ -562,8 +565,8 @@ class OpenSecureConfClient:
         return results
 
     def bulk_read(
-        self, 
-        keys: List[str], 
+        self,
+        keys: List[str],
         ignore_errors: bool = False
     ) -> List[Dict[str, Any]]:
         """
@@ -577,7 +580,7 @@ class OpenSecureConfClient:
             List of configuration dictionaries
 
         Example:
-            >>> configs = client.bulk_read(["db1", "db2", "api"])
+            >>> configs = client.bulk_read(["db1", "token", "retries"])
             >>> print(f"Retrieved {len(configs)} configurations")
         """
         if not isinstance(keys, list):
@@ -604,8 +607,8 @@ class OpenSecureConfClient:
         return results
 
     def bulk_delete(
-        self, 
-        keys: List[str], 
+        self,
+        keys: List[str],
         ignore_errors: bool = False
     ) -> Dict[str, Any]:
         """
@@ -666,25 +669,25 @@ class OpenSecureConfClient:
             return False
 
     def get_or_default(
-        self, 
-        key: str, 
-        default: Dict[str, Any]
+        self,
+        key: str,
+        default: Union[Dict[str, Any], str, int, bool, list]
     ) -> Dict[str, Any]:
         """
         Get configuration value or return default if not found.
 
         Args:
             key: Configuration key to retrieve
-            default: Default value to return if key not found
+            default: Default value to return if key not found (any supported type)
 
         Returns:
-            Configuration dictionary or default value
+            Configuration dictionary or default value wrapped in dict format
 
         Example:
-            >>> config = client.get_or_default(
-            ...     "database", 
-            ...     {"host": "localhost", "port": 5432}
-            ... )
+            >>> # Dict default
+            >>> config = client.get_or_default("database", {"host": "localhost", "port": 5432})
+            >>> # String default
+            >>> config = client.get_or_default("token", "default-token")
         """
         try:
             return self.read(key)

opensecureconf_client-2.0.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-opensecureconf_client.py,sha256=hb7GGTHoRjMdK0KACtYkZUUlqbxPHVVidLDZkFqMB9o,26560
-opensecureconf_client-2.0.2.dist-info/licenses/LICENSE,sha256=mvMdzinneV_-L01ddrHOBgbutNS8tjT1m7loT7VTWbI,1073
-opensecureconf_client-2.0.2.dist-info/METADATA,sha256=2xWbal_tTrf3yaYysEqgsedMmqCnhqcDl-kSj0Zyprs,33865
-opensecureconf_client-2.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-opensecureconf_client-2.0.2.dist-info/top_level.txt,sha256=J7NP3hD92OUdqseJLlbzgPuG_ovqkURRyw7iBJJeDVE,22
-opensecureconf_client-2.0.2.dist-info/RECORD,,