opensecureconf-client 2.3.0__tar.gz → 2.3.1__tar.gz

{opensecureconf_client-2.3.0/opensecureconf_client.egg-info → opensecureconf_client-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensecureconf-client
-Version: 2.3.0
+Version: 2.3.1
 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 → opensecureconf_client-2.3.1/opensecureconf_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensecureconf-client
-Version: 2.3.0
+Version: 2.3.1
 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 → opensecureconf_client-2.3.1}/opensecureconf_client.py

@@ -13,6 +13,7 @@ Enhanced Features:
 - Enhanced input validation
 - Health check utilities
 - Support for multiple value types (dict, str, int, bool, list)
+- Category and environment support
 """
 
 from typing import Any, Dict, List, Optional, Union
@@ -68,14 +69,12 @@ class OpenSecureConfClient:
         ...     enable_retry=True,
         ...     log_level="INFO"
         ... )
-        >>> # Dict value
-        >>> config = client.create("database", {"host": "localhost", "port": 5432})
+        >>> # Dict value with category and environment
+        >>> config = client.create("database", {"host": "localhost", "port": 5432}, 
+        ...                         category="config", environment="production")
         >>> # 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)
+        >>> config = client.create("api_token", "secret-token-123", 
+        ...                         category="auth", environment="staging")
     """
 
     def __init__(
@@ -350,7 +349,8 @@ class OpenSecureConfClient:
         self,
         key: str,
         value: Union[Dict[str, Any], str, int, bool, list],
-        category: Optional[str] = None
+        category: Optional[str] = None,
+        environment: Optional[str] = None
     ) -> Dict[str, Any]:
         """
         Create a new encrypted configuration entry.
@@ -359,6 +359,7 @@ class OpenSecureConfClient:
             key: Unique configuration key (1-255 characters)
             value: Configuration data (dict, string, int, bool, or list - will be encrypted)
             category: Optional category for grouping (max 100 characters)
+            environment: Optional environment identifier (max 100 characters)
 
         Returns:
             Dictionary containing the created configuration with fields:
@@ -366,22 +367,23 @@ class OpenSecureConfClient:
             - key: Configuration key
             - value: Configuration value (decrypted)
             - category: Configuration category (if set)
+            - environment: Environment identifier (if set)
 
         Raises:
             ConfigurationExistsError: If configuration key already exists
             ValueError: If key is invalid
 
         Example:
-            >>> # Dict value
-            >>> config = client.create("database", {"host": "localhost", "port": 5432}, "prod")
+            >>> # Dict value with category and environment
+            >>> config = client.create("database", {"host": "localhost", "port": 5432}, 
+            ...                         category="config", environment="production")
             >>> # String value
-            >>> config = client.create("api_token", "secret-token-123", "auth")
+            >>> config = client.create("api_token", "secret-123", 
+            ...                         category="auth", environment="staging")
             >>> # Integer value
-            >>> config = client.create("max_retries", 3)
+            >>> config = client.create("max_retries", 3, environment="production")
             >>> # Boolean value
-            >>> config = client.create("debug_enabled", False)
-            >>> # List value
-            >>> config = client.create("allowed_ips", ["192.168.1.1", "10.0.0.1"])
+            >>> config = client.create("debug", False, category="settings", environment="dev")
         """
         # Enhanced validation
         if not key or not isinstance(key, str):
@@ -390,8 +392,10 @@ class OpenSecureConfClient:
             raise ValueError("Key must be between 1 and 255 characters")
         if category and len(category) > 100:
             raise ValueError("Category must be max 100 characters")
+        if environment and len(environment) > 100:
+            raise ValueError("Environment must be max 100 characters")
 
-        payload = {"key": key, "value": value, "category": category}
+        payload = {"key": key, "value": value, "category": category, "environment": environment}
         return self._make_request("POST", "/configs", json=payload)
 
     def read(self, key: str) -> Dict[str, Any]:
@@ -412,6 +416,7 @@ class OpenSecureConfClient:
         Example:
             >>> config = client.read("database")
             >>> print(config["value"])  # Could be any supported type
+            >>> print(config["environment"])  # e.g., "production"
         """
         if not key or not isinstance(key, str):
             raise ValueError("Key must be a non-empty string")
@@ -422,7 +427,8 @@ class OpenSecureConfClient:
         self,
         key: str,
         value: Union[Dict[str, Any], str, int, bool, list],
-        category: Optional[str] = None
+        category: Optional[str] = None,
+        environment: Optional[str] = None
     ) -> Dict[str, Any]:
         """
         Update an existing configuration entry with new encrypted value.
@@ -431,6 +437,7 @@ class OpenSecureConfClient:
             key: Configuration key to update
             value: New configuration data (dict, string, int, bool, or list - will be encrypted)
             category: Optional new category
+            environment: Optional new environment
 
         Returns:
             Dictionary containing the updated configuration with decrypted value
@@ -441,18 +448,19 @@ class OpenSecureConfClient:
 
         Example:
             >>> # 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)
+            >>> config = client.update("database", {"host": "db.example.com", "port": 5432},
+            ...                        environment="production")
+            >>> # Update with string and change environment
+            >>> config = client.update("api_token", "new-token-456", environment="staging")
         """
         if not key or not isinstance(key, str):
             raise ValueError("Key must be a non-empty string")
         if category and len(category) > 100:
             raise ValueError("Category must be max 100 characters")
+        if environment and len(environment) > 100:
+            raise ValueError("Environment must be max 100 characters")
 
-        payload = {"value": value, "category": category}
+        payload = {"value": value, "category": category, "environment": environment}
         return self._make_request("PUT", f"/configs/{key}", json=payload)
 
     def delete(self, key: str) -> Dict[str, str]:
@@ -479,24 +487,35 @@ class OpenSecureConfClient:
 
         return self._make_request("DELETE", f"/configs/{key}")
 
-    def list_all(self, category: Optional[str] = None) -> List[Dict[str, Any]]:
+    def list_all(self, category: Optional[str] = None, environment: Optional[str] = None) -> List[Dict[str, Any]]:
         """
-        List all configurations with optional category filter.
+        List all configurations with optional category and environment filters.
         All values are automatically decrypted.
 
         Args:
             category: Optional filter by category
+            environment: Optional filter by environment
 
         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")
-            >>> for config in configs:
-            ...     print(f"{config['key']}: {config['value']}")
-        """
-        params = {"category": category} if category else {}
+            >>> # List all
+            >>> configs = client.list_all()
+            >>> # Filter by category
+            >>> prod_configs = client.list_all(category="production")
+            >>> # Filter by environment
+            >>> staging_configs = client.list_all(environment="staging")
+            >>> # Filter by both
+            >>> configs = client.list_all(category="database", environment="production")
+        """
+        params = {}
+        if category:
+            params["category"] = category
+        if environment:
+            params["environment"] = environment
+
         return self._make_request("GET", "/configs", params=params)
 
     # ========================================================================
@@ -512,7 +531,8 @@ class OpenSecureConfClient:
         Create multiple configurations in batch.
 
         Args:
-            configs: List of configuration dictionaries with 'key', 'value', and optional 'category'
+            configs: List of configuration dictionaries with 'key', 'value', 
+                    and optional 'category' and 'environment'
                     Value can be dict, str, int, bool, or list
             ignore_errors: If True, continue on errors and return partial results
 
@@ -525,9 +545,12 @@ class OpenSecureConfClient:
 
         Example:
             >>> configs = [
-            ...     {"key": "db1", "value": {"host": "localhost"}, "category": "prod"},
-            ...     {"key": "token", "value": "secret-123", "category": "auth"},
-            ...     {"key": "retries", "value": 3, "category": "config"}
+            ...     {"key": "db1", "value": {"host": "localhost"}, 
+            ...      "category": "db", "environment": "production"},
+            ...     {"key": "token", "value": "secret-123", 
+            ...      "category": "auth", "environment": "staging"},
+            ...     {"key": "retries", "value": 3, 
+            ...      "category": "config", "environment": "production"}
             ... ]
             >>> results = client.bulk_create(configs)
             >>> print(f"Created {len(results)} configurations")
@@ -548,7 +571,8 @@ class OpenSecureConfClient:
                 result = self.create(
                     key=config["key"],
                     value=config["value"],
-                    category=config.get("category")
+                    category=config.get("category"),
+                    environment=config.get("environment")
                 )
                 results.append(result)
                 self.logger.info(f"Bulk create: created '{config['key']}'")
@@ -692,23 +716,25 @@ class OpenSecureConfClient:
         try:
             return self.read(key)
         except ConfigurationNotFoundError:
-            return {"key": key, "value": default, "category": None}
+            return {"key": key, "value": default, "category": None, "environment": None}
 
-    def count(self, category: Optional[str] = None) -> int:
+    def count(self, category: Optional[str] = None, environment: Optional[str] = None) -> int:
         """
-        Count total configurations, optionally filtered by category.
+        Count total configurations, optionally filtered by category and/or environment.
 
         Args:
             category: Optional category filter
+            environment: Optional environment filter
 
         Returns:
             Number of configurations
 
         Example:
             >>> total = client.count()
-            >>> prod_count = client.count(category="production")
+            >>> prod_count = client.count(environment="production")
+            >>> db_prod_count = client.count(category="database", environment="production")
         """
-        configs = self.list_all(category=category)
+        configs = self.list_all(category=category, environment=environment)
         return len(configs)
 
     def list_categories(self) -> List[str]:
@@ -730,6 +756,26 @@ class OpenSecureConfClient:
                 categories.add(cat)
         return sorted(list(categories))
 
+    def list_environments(self) -> List[str]:
+        """
+        Get list of all unique environments.
+
+        Returns:
+            List of environment names
+
+        Example:
+            >>> environments = client.list_environments()
+            >>> print(f"Environments: {', '.join(environments)}")
+            Environments: production, staging, development
+        """
+        configs = self.list_all()
+        environments = set()
+        for config in configs:
+            env = config.get("environment")
+            if env:
+                environments.add(env)
+        return sorted(list(environments))
+
     # ========================================================================
     # SESSION MANAGEMENT
     # ========================================================================

{opensecureconf_client-2.3.0 → opensecureconf_client-2.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opensecureconf-client"
-version = "2.3.0"
+version = "2.3.1"
 description = "Python client library for OpenSecureConf encrypted configuration management API with clustering support"
 readme = "README.md"  # Updated to use the complete README
 requires-python = ">=3.8"