sunlicense 0.0.1__tar.gz

sunlicense-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hapangama
+
+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.

sunlicense-0.0.1/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: sunlicense
+Version: 0.0.1
+Summary: Official SunLicense client for Python — licence key management and validation for indie software developers.
+Author-email: Hapangama <kasun@hapangama.com>
+License: MIT
+Project-URL: Homepage, https://sunlicense.com
+Project-URL: Documentation, https://docs.sunlicense.hapangama.com
+Project-URL: Repository, https://github.com/sunlicense-com/sunlicense-py
+Project-URL: Issues, https://github.com/sunlicense-com/sunlicense-py/issues
+Keywords: license,licence,licensing,license-key,activation,drm,anti-piracy,sunlicense
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# SunLicense — Python Client
+
+Official Python client for [SunLicense](https://sunlicense.com), a licence management and
+anti-piracy system for indie software developers.
+
+SunLicense issues, validates and revokes licence keys for Minecraft plugins, Discord bots,
+FiveM scripts, desktop apps and other paid software — with marketplace automation for
+BuiltByBit and Polymart.
+
+> **Early release.** Licence validation works today. The wider client surface — activations,
+> entitlements and offline verification — is in active development.
+
+## Install
+
+```bash
+pip install sunlicense
+```
+
+No dependencies — standard library only.
+
+## Usage
+
+```python
+from sunlicense import SunLicense
+
+client = SunLicense(
+    base_url="https://your-instance.example.com",
+    token="optional-api-token",
+)
+
+result = client.validate("LICENCE-KEY-HERE")
+
+if result.valid:
+    print("Licence is valid")
+else:
+    print("Rejected:", result.status, result.data)
+```
+
+Pass extra context as keyword arguments:
+
+```python
+result = client.validate("LICENCE-KEY-HERE", product="my-plugin", host="server-01")
+```
+
+### `SunLicense(...)`
+
+| Argument | Type | Default | Description |
+|---|---|---|---|
+| `base_url` | `str` | — | **Required.** Base URL of your SunLicense instance |
+| `token` | `str` | `None` | API token, if your endpoint requires one |
+| `timeout` | `float` | `10.0` | Request timeout in seconds |
+
+### `validate(license_key, **context) -> ValidationResult`
+
+Returns a named tuple with `valid` (`bool`), `status` (`int`) and `data` (parsed JSON or
+`None`).
+
+## Requirements
+
+Python 3.8 or newer.
+
+## Other clients
+
+SunLicense also provides clients for **Java**, **JavaScript**, **PHP** and **Lua**.
+
+## Links
+
+- Website — https://sunlicense.com
+- Documentation — https://docs.sunlicense.hapangama.com
+- Issues — https://github.com/sunlicense-com/sunlicense-py/issues
+
+## Licence
+
+MIT © Hapangama

sunlicense-0.0.1/README.md

@@ -0,0 +1,74 @@
+# SunLicense — Python Client
+
+Official Python client for [SunLicense](https://sunlicense.com), a licence management and
+anti-piracy system for indie software developers.
+
+SunLicense issues, validates and revokes licence keys for Minecraft plugins, Discord bots,
+FiveM scripts, desktop apps and other paid software — with marketplace automation for
+BuiltByBit and Polymart.
+
+> **Early release.** Licence validation works today. The wider client surface — activations,
+> entitlements and offline verification — is in active development.
+
+## Install
+
+```bash
+pip install sunlicense
+```
+
+No dependencies — standard library only.
+
+## Usage
+
+```python
+from sunlicense import SunLicense
+
+client = SunLicense(
+    base_url="https://your-instance.example.com",
+    token="optional-api-token",
+)
+
+result = client.validate("LICENCE-KEY-HERE")
+
+if result.valid:
+    print("Licence is valid")
+else:
+    print("Rejected:", result.status, result.data)
+```
+
+Pass extra context as keyword arguments:
+
+```python
+result = client.validate("LICENCE-KEY-HERE", product="my-plugin", host="server-01")
+```
+
+### `SunLicense(...)`
+
+| Argument | Type | Default | Description |
+|---|---|---|---|
+| `base_url` | `str` | — | **Required.** Base URL of your SunLicense instance |
+| `token` | `str` | `None` | API token, if your endpoint requires one |
+| `timeout` | `float` | `10.0` | Request timeout in seconds |
+
+### `validate(license_key, **context) -> ValidationResult`
+
+Returns a named tuple with `valid` (`bool`), `status` (`int`) and `data` (parsed JSON or
+`None`).
+
+## Requirements
+
+Python 3.8 or newer.
+
+## Other clients
+
+SunLicense also provides clients for **Java**, **JavaScript**, **PHP** and **Lua**.
+
+## Links
+
+- Website — https://sunlicense.com
+- Documentation — https://docs.sunlicense.hapangama.com
+- Issues — https://github.com/sunlicense-com/sunlicense-py/issues
+
+## Licence
+
+MIT © Hapangama

sunlicense-0.0.1/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "sunlicense"
+version = "0.0.1"
+description = "Official SunLicense client for Python — licence key management and validation for indie software developers."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Hapangama", email = "kasun@hapangama.com" }]
+keywords = [
+    "license",
+    "licence",
+    "licensing",
+    "license-key",
+    "activation",
+    "drm",
+    "anti-piracy",
+    "sunlicense",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Security",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://sunlicense.com"
+Documentation = "https://docs.sunlicense.hapangama.com"
+Repository = "https://github.com/sunlicense-com/sunlicense-py"
+Issues = "https://github.com/sunlicense-com/sunlicense-py/issues"
+
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

sunlicense-0.0.1/setup.cfg

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

sunlicense-0.0.1/src/sunlicense/__init__.py

@@ -0,0 +1,107 @@
+"""SunLicense — official Python client.
+
+Early release. Licence validation works against the SunLicense REST API; the wider
+client surface (activations, entitlements, offline verification) is in development.
+
+Docs: https://docs.sunlicense.hapangama.com
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from typing import Any, Dict, NamedTuple, Optional
+
+__version__ = "0.0.1"
+__all__ = ["SunLicense", "ValidationResult", "__version__"]
+
+
+class ValidationResult(NamedTuple):
+    """Outcome of a licence validation call."""
+
+    valid: bool
+    status: int
+    data: Optional[Any]
+
+
+class SunLicense:
+    """A SunLicense API client.
+
+    Example:
+        >>> client = SunLicense(base_url="https://your-instance.example.com")
+        >>> result = client.validate("LICENCE-KEY-HERE")
+        >>> if result.valid:
+        ...     print("ok")
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        token: Optional[str] = None,
+        timeout: float = 10.0,
+    ) -> None:
+        """
+        Args:
+            base_url: Base URL of your SunLicense instance.
+            token: API token, if your endpoint requires one.
+            timeout: Request timeout in seconds.
+        """
+        if not base_url:
+            raise ValueError('SunLicense: "base_url" is required')
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+        self.timeout = timeout
+
+    def validate(
+        self,
+        license_key: str,
+        **context: Any,
+    ) -> ValidationResult:
+        """Validate a licence key.
+
+        Args:
+            license_key: The licence key to check.
+            **context: Optional extra fields, e.g. ``product=...``, ``host=...``.
+
+        Returns:
+            A :class:`ValidationResult`.
+
+        Raises:
+            ValueError: If ``license_key`` is empty.
+            urllib.error.URLError: On network failure.
+        """
+        if not license_key:
+            raise ValueError('SunLicense: "license_key" is required')
+
+        payload: Dict[str, Any] = {"license": license_key, **context}
+        headers = {"Content-Type": "application/json"}
+        if self.token:
+            headers["Authorization"] = "Bearer " + self.token
+
+        request = urllib.request.Request(
+            self.base_url + "/api/v2/license/validate",
+            data=json.dumps(payload).encode("utf-8"),
+            headers=headers,
+            method="POST",
+        )
+
+        try:
+            with urllib.request.urlopen(request, timeout=self.timeout) as response:
+                body = response.read().decode("utf-8", errors="replace")
+                return ValidationResult(
+                    valid=200 <= response.status < 300,
+                    status=response.status,
+                    data=_maybe_json(body),
+                )
+        except urllib.error.HTTPError as error:
+            body = error.read().decode("utf-8", errors="replace")
+            return ValidationResult(valid=False, status=error.code, data=_maybe_json(body))
+
+
+def _maybe_json(body: str) -> Optional[Any]:
+    """Parse *body* as JSON, returning None when it isn't valid JSON."""
+    try:
+        return json.loads(body)
+    except ValueError:
+        return None

sunlicense-0.0.1/src/sunlicense.egg-info/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: sunlicense
+Version: 0.0.1
+Summary: Official SunLicense client for Python — licence key management and validation for indie software developers.
+Author-email: Hapangama <kasun@hapangama.com>
+License: MIT
+Project-URL: Homepage, https://sunlicense.com
+Project-URL: Documentation, https://docs.sunlicense.hapangama.com
+Project-URL: Repository, https://github.com/sunlicense-com/sunlicense-py
+Project-URL: Issues, https://github.com/sunlicense-com/sunlicense-py/issues
+Keywords: license,licence,licensing,license-key,activation,drm,anti-piracy,sunlicense
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# SunLicense — Python Client
+
+Official Python client for [SunLicense](https://sunlicense.com), a licence management and
+anti-piracy system for indie software developers.
+
+SunLicense issues, validates and revokes licence keys for Minecraft plugins, Discord bots,
+FiveM scripts, desktop apps and other paid software — with marketplace automation for
+BuiltByBit and Polymart.
+
+> **Early release.** Licence validation works today. The wider client surface — activations,
+> entitlements and offline verification — is in active development.
+
+## Install
+
+```bash
+pip install sunlicense
+```
+
+No dependencies — standard library only.
+
+## Usage
+
+```python
+from sunlicense import SunLicense
+
+client = SunLicense(
+    base_url="https://your-instance.example.com",
+    token="optional-api-token",
+)
+
+result = client.validate("LICENCE-KEY-HERE")
+
+if result.valid:
+    print("Licence is valid")
+else:
+    print("Rejected:", result.status, result.data)
+```
+
+Pass extra context as keyword arguments:
+
+```python
+result = client.validate("LICENCE-KEY-HERE", product="my-plugin", host="server-01")
+```
+
+### `SunLicense(...)`
+
+| Argument | Type | Default | Description |
+|---|---|---|---|
+| `base_url` | `str` | — | **Required.** Base URL of your SunLicense instance |
+| `token` | `str` | `None` | API token, if your endpoint requires one |
+| `timeout` | `float` | `10.0` | Request timeout in seconds |
+
+### `validate(license_key, **context) -> ValidationResult`
+
+Returns a named tuple with `valid` (`bool`), `status` (`int`) and `data` (parsed JSON or
+`None`).
+
+## Requirements
+
+Python 3.8 or newer.
+
+## Other clients
+
+SunLicense also provides clients for **Java**, **JavaScript**, **PHP** and **Lua**.
+
+## Links
+
+- Website — https://sunlicense.com
+- Documentation — https://docs.sunlicense.hapangama.com
+- Issues — https://github.com/sunlicense-com/sunlicense-py/issues
+
+## Licence
+
+MIT © Hapangama

sunlicense-0.0.1/src/sunlicense.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+src/sunlicense/__init__.py
+src/sunlicense.egg-info/PKG-INFO
+src/sunlicense.egg-info/SOURCES.txt
+src/sunlicense.egg-info/dependency_links.txt
+src/sunlicense.egg-info/top_level.txt

sunlicense-0.0.1/src/sunlicense.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sunlicense-0.0.1/src/sunlicense.egg-info/top_level.txt

@@ -0,0 +1 @@
+sunlicense