keymint 2.4.0__tar.gz → 2.5.0__tar.gz

{keymint-2.4.0/keymint.egg-info → keymint-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keymint
-Version: 2.4.0
+Version: 2.5.0
 Summary: License key validation, activation, and management for Python. Supports node-locking, offline licensing, and hardware fingerprinting.
 Home-page: https://github.com/keymint-dev/keymint-python
 Author: KeyMint
@@ -16,18 +16,14 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Software Distribution
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests>=2.25.0
+Requires-Dist: requests>=2.32.4
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -110,7 +106,7 @@ Keymint provides utilities to uniquely identify machines for node-locking:
 | `update_key`     | Updates an existing license key.                |
 | `block_key`      | Blocks a license key.                           |
 | `unblock_key`    | Unblocks a previously blocked license key.      |
-| `sign_key`       | Signs a key for offline (air-gapped) validation.|
+| `sign_key`       | Signs a key for offline validation using an admin API key.|
 | `floating_checkout` | Checks out a floating license seat.          |
 | `floating_heartbeat`| Sends a heartbeat to keep a session alive.   |
 | `floating_checkin`  | Checks in a session, releasing the seat.     |

{keymint-2.4.0 → keymint-2.5.0}/README.md

@@ -61,7 +61,7 @@ Keymint provides utilities to uniquely identify machines for node-locking:
 | `update_key`     | Updates an existing license key.                |
 | `block_key`      | Blocks a license key.                           |
 | `unblock_key`    | Unblocks a previously blocked license key.      |
-| `sign_key`       | Signs a key for offline (air-gapped) validation.|
+| `sign_key`       | Signs a key for offline validation using an admin API key.|
 | `floating_checkout` | Checks out a floating license seat.          |
 | `floating_heartbeat`| Sends a heartbeat to keep a session alive.   |
 | `floating_checkin`  | Checks in a session, releasing the seat.     |

{keymint-2.4.0 → keymint-2.5.0}/keymint/__init__.py

@@ -17,11 +17,13 @@ class KeyMint:
             'Content-Type': 'application/json'
         }
 
-    def _handle_request(self, method: str, endpoint: str, params: dict | None = None, query_params: dict | None = None, idempotency_key: str | None = None):
+    def _handle_request(self, method: str, endpoint: str, params: dict | None = None, query_params: dict | None = None, idempotency_key: str | None = None, extra_headers: dict | None = None):
         url = f'{self.base_url}{endpoint}'
         headers = self.headers.copy()
         if idempotency_key:
             headers['Idempotency-Key'] = idempotency_key
+        if extra_headers:
+            headers.update(extra_headers)
             
         try:
             if method.upper() == 'GET':
@@ -42,8 +44,9 @@ class KeyMint:
         except requests.exceptions.HTTPError as http_err:
             try:
                 error_data = http_err.response.json()
+                nested_error = error_data.get('error') if isinstance(error_data.get('error'), dict) else {}
                 raise KeyMintApiError(
-                    message=error_data.get('message', 'An API error occurred'),
+                    message=error_data.get('message') or nested_error.get('message') or 'An API error occurred',
                     code=error_data.get('code', -1),
                     status=http_err.response.status_code
                 )
@@ -123,10 +126,12 @@ class KeyMint:
         :returns: The license key details.
         """
         query_params = {
-            'productId': params['productId'],
-            'licenseKey': params['licenseKey']
+            'productId': params['productId']
         }
-        return self._handle_request('GET', '/key', query_params=query_params)
+        return self._handle_request(
+            'GET', '/key', query_params=query_params,
+            extra_headers={'x-license-key': params['licenseKey']}
+        )
 
     def block_key(self, params: BlockKeyParams, idempotency_key: str | None = None) -> BlockKeyResponse:
         """
@@ -288,4 +293,3 @@ class KeyMint:
         except Exception:
             return False
 
-

{keymint-2.4.0 → keymint-2.5.0}/keymint/_version.py

@@ -1,6 +1,6 @@
 """KeyMint Python SDK version information."""
 
-__version__ = "2.4.0"
+__version__ = "2.5.0"
 __author__ = "KeyMint"
 __email__ = "cliff@keymint.dev"
 __url__ = "https://github.com/keymint-dev/keymint-python"

{keymint-2.4.0 → keymint-2.5.0}/keymint/types.py

@@ -30,9 +30,10 @@ class CreateKeyParams(TypedDict):
     heartbeatInterval: int | None
     sessionLeaseDuration: int | None
 
-class CreateKeyResponse(TypedDict):
+class CreateKeyResponse(TypedDict, total=False):
     code: int
     key: str
+    keys: list[str]
 
 class KeyMintApiError(Exception):
     def __init__(self, message: str, code: int, status: int | None = None):
@@ -67,6 +68,7 @@ class DeactivateKeyParams(TypedDict):
 class DeactivateKeyResponse(TypedDict):
     message: str
     code: int
+    devicesRemoved: int
 
 class DeviceDetails(TypedDict):
     hostId: str
@@ -179,11 +181,13 @@ class DeleteCustomerResponse(TypedDict):
 class ToggleCustomerStatusParams(TypedDict):
     customerId: str
 
-class ToggleCustomerStatusResponse(TypedDict):
+class ToggleCustomerStatusResponse(TypedDict, total=False):
     action: str
     status: bool
     message: str
     code: int
+    customerName: str
+    active: bool
 
 class CustomerLicenseKey(TypedDict):
     id: str
@@ -210,6 +214,8 @@ class FloatingCheckoutParams(TypedDict):
     deviceTag: str | None
     userIdentifier: str | None
     apiKey: str | None
+    timestamp: Any | None
+    signature: str | None
 
 class FloatingCheckoutResponse(TypedDict):
     code: int
@@ -278,5 +284,4 @@ class SignKeyParams(TypedDict):
     ttl: int | None
 
 class SignKeyResponse(TypedDict):
-    code: int
-    file: dict[str, Any]  # { signedKey, keyId, publicKeyFingerprint }
+    file: str  # Serialized signed license file returned by the API

{keymint-2.4.0 → keymint-2.5.0/keymint.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keymint
-Version: 2.4.0
+Version: 2.5.0
 Summary: License key validation, activation, and management for Python. Supports node-locking, offline licensing, and hardware fingerprinting.
 Home-page: https://github.com/keymint-dev/keymint-python
 Author: KeyMint
@@ -16,18 +16,14 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Software Distribution
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests>=2.25.0
+Requires-Dist: requests>=2.32.4
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -110,7 +106,7 @@ Keymint provides utilities to uniquely identify machines for node-locking:
 | `update_key`     | Updates an existing license key.                |
 | `block_key`      | Blocks a license key.                           |
 | `unblock_key`    | Unblocks a previously blocked license key.      |
-| `sign_key`       | Signs a key for offline (air-gapped) validation.|
+| `sign_key`       | Signs a key for offline validation using an admin API key.|
 | `floating_checkout` | Checks out a floating license seat.          |
 | `floating_heartbeat`| Sends a heartbeat to keep a session alive.   |
 | `floating_checkin`  | Checks in a session, releasing the seat.     |

{keymint-2.4.0 → keymint-2.5.0}/keymint.egg-info/SOURCES.txt

@@ -10,4 +10,5 @@ keymint.egg-info/PKG-INFO
 keymint.egg-info/SOURCES.txt
 keymint.egg-info/dependency_links.txt
 keymint.egg-info/requires.txt
-keymint.egg-info/top_level.txt
+keymint.egg-info/top_level.txt
+tests/test_contracts.py

{keymint-2.4.0 → keymint-2.5.0}/keymint.egg-info/requires.txt

@@ -1,4 +1,4 @@
-requests>=2.25.0
+requests>=2.32.4
 
 [dev]
 pytest>=6.0

{keymint-2.4.0 → keymint-2.5.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="keymint",
-    version="2.4.0",
+    version="2.5.0",
     author="KeyMint",
     author_email="cliff@keymint.dev",
     description="License key validation, activation, and management for Python. Supports node-locking, offline licensing, and hardware fingerprinting.",
@@ -26,19 +26,15 @@ setup(
         "Topic :: System :: Software Distribution",
         "License :: OSI Approved :: MIT License",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.6",
-        "Programming Language :: Python :: 3.7",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
         "Operating System :: OS Independent",
     ],
     keywords="license-key validation activation node-lock hardware-id copy-protection product-key drm offline-licensing keymint license licensing api",
-    python_requires='>=3.6',
+    python_requires='>=3.10',
     install_requires=[
-        'requests>=2.25.0',
+        'requests>=2.32.4',
     ],
     extras_require={
         'dev': [

keymint-2.5.0/tests/test_contracts.py

@@ -0,0 +1,52 @@
+from unittest.mock import Mock, patch
+
+import pytest
+import requests
+
+from keymint import KeyMint, KeyMintApiError
+
+
+def response(payload, status=200):
+    result = Mock()
+    result.json.return_value = payload
+    result.status_code = status
+    if status >= 400:
+        error = requests.exceptions.HTTPError()
+        error.response = result
+        result.raise_for_status.side_effect = error
+    return result
+
+
+@patch("keymint.requests.get")
+def test_get_key_uses_header_not_query(mock_get):
+    mock_get.return_value = response({"code": 0, "data": {"license": {"productId": "product 123"}}})
+
+    KeyMint("readonly_test").get_key({"productId": "product 123", "licenseKey": "secret/license+key"})
+
+    _, kwargs = mock_get.call_args
+    assert kwargs["params"] == {"productId": "product 123"}
+    assert kwargs["headers"]["x-license-key"] == "secret/license+key"
+    assert "licenseKey" not in kwargs["params"]
+
+
+@patch("keymint.requests.post")
+def test_sign_key_returns_serialized_file(mock_post):
+    mock_post.return_value = response({"file": '{"signedKey":"signature","keyId":"key_123"}'})
+
+    result = KeyMint("admin_test").sign_key({
+        "productId": "product_123", "licenseKey": "license_123", "hostId": "host_123"
+    })
+
+    assert isinstance(result["file"], str)
+
+
+@patch("keymint.requests.post")
+def test_nested_error_preserves_server_message(mock_post):
+    mock_post.return_value = response({
+        "success": False,
+        "error": {"code": "CUSTOMER_EMAIL_EXISTS", "message": "Customer email already exists in team"},
+        "code": 1,
+    }, 409)
+
+    with pytest.raises(KeyMintApiError, match="Customer email already exists in team"):
+        KeyMint("admin_test").create_key({"productId": "product_123"})