law4devs 0.1.0__tar.gz

law4devs-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,18 @@
+name: Publish to PyPI
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}

law4devs-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,15 @@
+name: Tests
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "${{ matrix.python-version }}"
+      - run: pip install -e ".[dev]"
+      - run: pytest

law4devs-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+.env
+.venv
+venv/
+env/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.egg

law4devs-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] — Unreleased
+
+### Added
+- Initial release with full coverage of the Law4Devs REST API
+- `FrameworksResource`, `ArticlesResource`, `RecitalsResource`, `RequirementsResource`
+- `TagsResource`, `ComplianceResource`, `AnnexesResource`, `SearchResource`
+- Auto-pagination via `iter()` generators on all list resources
+- Zero runtime dependencies (stdlib urllib only)
+- Full type annotations with dataclasses

law4devs-0.1.0/LICENSE

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

law4devs-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: law4devs
+Version: 0.1.0
+Summary: Official Python SDK for the Law4Devs EU Regulatory Compliance API
+Project-URL: Homepage, https://law4devs.eu
+Project-URL: Documentation, https://docs.law4devs.eu/sdks/python
+Author-email: law4devs <sdk@law4devs.eu>
+Maintainer-email: Sofiane Hamlaoui <contact@law4devs.eu>
+License: MIT
+License-File: LICENSE
+Keywords: ai-act,compliance,cra,eu,gdpr,law4devs,nis2,regulatory
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# law4devs
+
+Official Python SDK for the [Law4Devs](https://law4devs.eu) EU Regulatory Compliance API.
+
+Access structured, developer-friendly data for EU regulations — GDPR, Cyber Resilience Act, NIS2, AI Act, and more.
+
+## Installation
+
+```bash
+pip install law4devs
+```
+
+Python 3.9+ required. Zero runtime dependencies (stdlib urllib only).
+
+## Quick Start
+
+```python
+from law4devs import Law4DevsClient
+
+client = Law4DevsClient()
+
+# List all frameworks
+page = client.frameworks.list()
+for fw in page:
+    print(fw.slug, fw.name)
+
+# Get framework detail
+cra = client.frameworks.get("cra")
+print(cra.name, cra.requirement_count)
+
+# Fetch a specific article
+article = client.articles.get("cra", 13)
+print(article.title, article.content)
+```
+
+## Authentication
+
+The public API tier does not require authentication. Authenticated tiers provide higher rate limits:
+
+```python
+client = Law4DevsClient(api_key="your-api-key")
+```
+
+## Resources
+
+### Frameworks
+
+```python
+page = client.frameworks.list(page=1, per_page=10)
+print(page.meta.total, page.meta.pages)
+
+cra = client.frameworks.get("cra")
+
+for fw in client.frameworks.iter():
+    print(fw.slug)
+```
+
+### Articles
+
+```python
+page = client.articles.list("cra", per_page=20)
+art = client.articles.get("cra", 13)
+related = client.articles.related("cra", 13)
+
+for art in client.articles.iter("cra"):
+    print(art.article_number, art.title)
+```
+
+### Recitals
+
+```python
+page = client.recitals.list("cra")
+recital = client.recitals.get("cra", 10)
+
+for recital in client.recitals.iter("cra"):
+    print(recital.recital_number, recital.content[:80])
+```
+
+### Requirements
+
+```python
+page = client.requirements.list()
+page = client.requirements.list(framework_slug="cra")
+
+for req in client.requirements.iter(framework_slug="cra"):
+    print(req.requirement_type, req.requirement_text[:60])
+```
+
+### Compliance Deadlines
+
+```python
+page = client.compliance.deadlines()
+page = client.compliance.deadlines(framework_slug="nis2")
+
+for d in client.compliance.iter_deadlines(framework_slug="nis2"):
+    print(d.deadline_date, d.description)
+```
+
+### Tags
+
+```python
+page = client.tags.list()
+tag = client.tags.get("security")
+
+for tag in client.tags.iter():
+    print(tag.slug, tag.name)
+```
+
+### Annexes
+
+```python
+page = client.annexes.list("cra")
+annex = client.annexes.get("cra", "I")
+
+for annex in client.annexes.iter("cra"):
+    print(annex.annex_number, annex.title)
+```
+
+### Search
+
+```python
+results = client.search.query("vulnerability reporting")
+results = client.search.query("audit", framework="gdpr")
+results = client.search.query("encryption", result_type="requirement")
+```
+
+## Auto-Pagination
+
+All list resources support `iter()` which automatically fetches all pages:
+
+```python
+all_articles = list(client.articles.iter("cra"))
+
+for art in client.articles.iter("cra", per_page=50):
+    process(art)
+```
+
+## Error Handling
+
+```python
+from law4devs import Law4DevsClient, NotFoundError, RateLimitError, Law4DevsError
+
+client = Law4DevsClient()
+
+try:
+    fw = client.frameworks.get("nonexistent")
+except NotFoundError as e:
+    print(f"Not found: {e} (status {e.status_code})")
+except RateLimitError:
+    print("Rate limited — slow down requests")
+except Law4DevsError as e:
+    print(f"API error: {e}")
+```
+
+### Exception Hierarchy
+
+| Exception | HTTP Status | Description |
+|-----------|-------------|-------------|
+| `Law4DevsError` | any | Base exception |
+| `NotFoundError` | 404 | Resource not found |
+| `ValidationError` | 400 | Invalid request parameters |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 5xx | Server-side error |
+
+## Configuration
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `base_url` | `https://api.law4devs.eu/api/v1` | API base URL |
+| `api_key` | `None` | API key for authenticated tiers |
+| `timeout` | `30` | Request timeout in seconds |
+| `max_retries` | `3` | Retries on 429/5xx with exponential backoff |
+
+## Available Frameworks
+
+| Slug | Name | CELEX | Status |
+|------|------|-------|--------|
+| `cra` | Cyber Resilience Act | 32024R2847 | active |
+| `nis2` | NIS2 Directive | 32022L2555 | active |
+| `dora` | Digital Operational Resilience Act | 32022R2554 | active |
+| `gdpr` | General Data Protection Regulation | 32016R0679 | active |
+| `ai_act` | AI Act | 32024R1689 | active |
+| `eidas` | eIDAS Regulation | 32014R0910 | active |
+| `dsa` | Digital Services Act | 32022R2065 | active |
+| `dma` | Digital Markets Act | 32022R1925 | active |
+| `data_act` | Data Act | 32023R2854 | active |
+| `dga` | Data Governance Act | 32022R0868 | active |
+| `eidas2` | European Digital Identity Regulation | 32024R1183 | active |
+| `cer` | Critical Entities Resilience Directive | 32022L2557 | active |
+| `psd2` | Payment Services Directive 2 | 32015L2366 | active |
+| `mica` | Markets in Crypto-Assets Regulation | 32023R1114 | active |
+| `cybersecurity_act` | Cybersecurity Act | 32019R0881 | active |
+| `eprivacy` | ePrivacy Directive | 32002L0058 | active |
+| `red` | Radio Equipment Directive | 32014L0053 | active |
+| `csrd` | Corporate Sustainability Reporting Dir. | 32022L2464 | active |
+| `nis1` | NIS Directive (Original) | 32016L1148 | superseded |
+
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Law4Devs API](https://law4devs.eu)
+- [API Reference](https://docs.law4devs.eu)
+- [PyPI](https://pypi.org/project/law4devs/)

law4devs-0.1.0/README.md

@@ -0,0 +1,207 @@
+# law4devs
+
+Official Python SDK for the [Law4Devs](https://law4devs.eu) EU Regulatory Compliance API.
+
+Access structured, developer-friendly data for EU regulations — GDPR, Cyber Resilience Act, NIS2, AI Act, and more.
+
+## Installation
+
+```bash
+pip install law4devs
+```
+
+Python 3.9+ required. Zero runtime dependencies (stdlib urllib only).
+
+## Quick Start
+
+```python
+from law4devs import Law4DevsClient
+
+client = Law4DevsClient()
+
+# List all frameworks
+page = client.frameworks.list()
+for fw in page:
+    print(fw.slug, fw.name)
+
+# Get framework detail
+cra = client.frameworks.get("cra")
+print(cra.name, cra.requirement_count)
+
+# Fetch a specific article
+article = client.articles.get("cra", 13)
+print(article.title, article.content)
+```
+
+## Authentication
+
+The public API tier does not require authentication. Authenticated tiers provide higher rate limits:
+
+```python
+client = Law4DevsClient(api_key="your-api-key")
+```
+
+## Resources
+
+### Frameworks
+
+```python
+page = client.frameworks.list(page=1, per_page=10)
+print(page.meta.total, page.meta.pages)
+
+cra = client.frameworks.get("cra")
+
+for fw in client.frameworks.iter():
+    print(fw.slug)
+```
+
+### Articles
+
+```python
+page = client.articles.list("cra", per_page=20)
+art = client.articles.get("cra", 13)
+related = client.articles.related("cra", 13)
+
+for art in client.articles.iter("cra"):
+    print(art.article_number, art.title)
+```
+
+### Recitals
+
+```python
+page = client.recitals.list("cra")
+recital = client.recitals.get("cra", 10)
+
+for recital in client.recitals.iter("cra"):
+    print(recital.recital_number, recital.content[:80])
+```
+
+### Requirements
+
+```python
+page = client.requirements.list()
+page = client.requirements.list(framework_slug="cra")
+
+for req in client.requirements.iter(framework_slug="cra"):
+    print(req.requirement_type, req.requirement_text[:60])
+```
+
+### Compliance Deadlines
+
+```python
+page = client.compliance.deadlines()
+page = client.compliance.deadlines(framework_slug="nis2")
+
+for d in client.compliance.iter_deadlines(framework_slug="nis2"):
+    print(d.deadline_date, d.description)
+```
+
+### Tags
+
+```python
+page = client.tags.list()
+tag = client.tags.get("security")
+
+for tag in client.tags.iter():
+    print(tag.slug, tag.name)
+```
+
+### Annexes
+
+```python
+page = client.annexes.list("cra")
+annex = client.annexes.get("cra", "I")
+
+for annex in client.annexes.iter("cra"):
+    print(annex.annex_number, annex.title)
+```
+
+### Search
+
+```python
+results = client.search.query("vulnerability reporting")
+results = client.search.query("audit", framework="gdpr")
+results = client.search.query("encryption", result_type="requirement")
+```
+
+## Auto-Pagination
+
+All list resources support `iter()` which automatically fetches all pages:
+
+```python
+all_articles = list(client.articles.iter("cra"))
+
+for art in client.articles.iter("cra", per_page=50):
+    process(art)
+```
+
+## Error Handling
+
+```python
+from law4devs import Law4DevsClient, NotFoundError, RateLimitError, Law4DevsError
+
+client = Law4DevsClient()
+
+try:
+    fw = client.frameworks.get("nonexistent")
+except NotFoundError as e:
+    print(f"Not found: {e} (status {e.status_code})")
+except RateLimitError:
+    print("Rate limited — slow down requests")
+except Law4DevsError as e:
+    print(f"API error: {e}")
+```
+
+### Exception Hierarchy
+
+| Exception | HTTP Status | Description |
+|-----------|-------------|-------------|
+| `Law4DevsError` | any | Base exception |
+| `NotFoundError` | 404 | Resource not found |
+| `ValidationError` | 400 | Invalid request parameters |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 5xx | Server-side error |
+
+## Configuration
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `base_url` | `https://api.law4devs.eu/api/v1` | API base URL |
+| `api_key` | `None` | API key for authenticated tiers |
+| `timeout` | `30` | Request timeout in seconds |
+| `max_retries` | `3` | Retries on 429/5xx with exponential backoff |
+
+## Available Frameworks
+
+| Slug | Name | CELEX | Status |
+|------|------|-------|--------|
+| `cra` | Cyber Resilience Act | 32024R2847 | active |
+| `nis2` | NIS2 Directive | 32022L2555 | active |
+| `dora` | Digital Operational Resilience Act | 32022R2554 | active |
+| `gdpr` | General Data Protection Regulation | 32016R0679 | active |
+| `ai_act` | AI Act | 32024R1689 | active |
+| `eidas` | eIDAS Regulation | 32014R0910 | active |
+| `dsa` | Digital Services Act | 32022R2065 | active |
+| `dma` | Digital Markets Act | 32022R1925 | active |
+| `data_act` | Data Act | 32023R2854 | active |
+| `dga` | Data Governance Act | 32022R0868 | active |
+| `eidas2` | European Digital Identity Regulation | 32024R1183 | active |
+| `cer` | Critical Entities Resilience Directive | 32022L2557 | active |
+| `psd2` | Payment Services Directive 2 | 32015L2366 | active |
+| `mica` | Markets in Crypto-Assets Regulation | 32023R1114 | active |
+| `cybersecurity_act` | Cybersecurity Act | 32019R0881 | active |
+| `eprivacy` | ePrivacy Directive | 32002L0058 | active |
+| `red` | Radio Equipment Directive | 32014L0053 | active |
+| `csrd` | Corporate Sustainability Reporting Dir. | 32022L2464 | active |
+| `nis1` | NIS Directive (Original) | 32016L1148 | superseded |
+
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Law4Devs API](https://law4devs.eu)
+- [API Reference](https://docs.law4devs.eu)
+- [PyPI](https://pypi.org/project/law4devs/)

law4devs-0.1.0/examples/compliance_report.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""
+Law4Devs Python SDK — Compliance Report Example
+
+Generates a compliance report for all active frameworks.
+
+Usage:
+    python examples/compliance_report.py
+"""
+
+import os
+from law4devs import Law4DevsClient
+
+BASE_URL = os.environ.get("LAW4DEVS_BASE_URL")
+client = Law4DevsClient(base_url=BASE_URL) if BASE_URL else Law4DevsClient()
+
+
+def generate_report():
+    print("=" * 60)
+    print("EU REGULATORY COMPLIANCE REPORT")
+    print("=" * 60)
+    print()
+
+    frameworks = [fw for fw in client.frameworks.iter() if fw.status == "active"]
+    print(f"Active frameworks: {len(frameworks)}")
+    print()
+
+    for fw in frameworks:
+        print(f"── {fw.name} ({fw.slug.upper()}) ──")
+        print(f"   Articles: {fw.article_count}")
+
+        req_page = client.requirements.list(framework_slug=fw.slug, per_page=1)
+        print(f"   Total requirements: {req_page.meta.total}")
+
+        deadlines_page = client.compliance.deadlines(framework_slug=fw.slug)
+        if deadlines_page.data:
+            print("   Deadlines:")
+            for d in sorted(deadlines_page.data, key=lambda x: x.deadline_date):
+                print(f"     {d.deadline_date}: {d.description or d.deadline_type}")
+        else:
+            print("   Deadlines: none recorded")
+        print()
+
+    print("=" * 60)
+    print("Report complete.")
+
+
+if __name__ == "__main__":
+    generate_report()

law4devs-0.1.0/examples/quickstart.py

@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+"""
+Law4Devs Python SDK — Quick Start Example
+
+Run against a live API:
+    python examples/quickstart.py
+
+Or a local dev server:
+    LAW4DEVS_BASE_URL=http://localhost:5000/api/v1 python examples/quickstart.py
+"""
+
+import os
+from law4devs import Law4DevsClient
+
+BASE_URL = os.environ.get("LAW4DEVS_BASE_URL")
+client = Law4DevsClient(base_url=BASE_URL) if BASE_URL else Law4DevsClient()
+
+# List all frameworks
+print("=== EU Regulatory Frameworks ===")
+page = client.frameworks.list()
+print(f"Total frameworks: {page.meta.total}")
+for fw in page:
+    status = " (superseded)" if fw.status == "superseded" else ""
+    print(f"  [{fw.slug}] {fw.name}{status}")
+print()
+
+# Get framework detail
+print("=== CRA Detail ===")
+cra = client.frameworks.get("cra")
+print(f"Name:         {cra.name}")
+print(f"Articles:     {cra.article_count}")
+print(f"Requirements: {cra.requirement_count}")
+print(f"EUR-Lex URL:  {cra.eurlex_url}")
+print()
+
+# Auto-paginate all articles
+print("=== CRA Articles (auto-paginated) ===")
+all_articles = list(client.articles.iter("cra"))
+print(f"Fetched {len(all_articles)} articles")
+for art in all_articles[:3]:
+    print(f"  Article {art.article_number}: {art.title}")
+if len(all_articles) > 3:
+    print(f"  ... and {len(all_articles) - 3} more")
+print()
+
+# Compliance deadlines
+print("=== CRA Compliance Deadlines ===")
+deadlines = client.compliance.deadlines(framework_slug="cra")
+for d in deadlines:
+    print(f"  {d.deadline_date} [{d.deadline_type}] {d.description or ''}")
+print()
+
+# Search
+print("=== Search: 'vulnerability' in CRA ===")
+results = client.search.query("vulnerability", framework="cra")
+print(f"Found {results.meta.total} results")
+for r in results:
+    print(f"  [{r.type}] {r.title or r.match_context[:60]}")

law4devs-0.1.0/law4devs/__init__.py

@@ -0,0 +1,48 @@
+from ._version import __version__
+from .client import Law4DevsClient
+from .exceptions import (
+    Law4DevsError,
+    NotFoundError,
+    ValidationError,
+    RateLimitError,
+    ServerError,
+)
+from .models import (
+    Framework,
+    FrameworkDetail,
+    Article,
+    ArticleSummary,
+    ArticleParagraph,
+    Recital,
+    Requirement,
+    Tag,
+    ComplianceDeadline,
+    Annex,
+    AnnexSummary,
+    SearchResult,
+)
+
+
+__all__ = [
+    "Law4DevsClient",
+    "__version__",
+    # Exceptions
+    "Law4DevsError",
+    "NotFoundError",
+    "ValidationError",
+    "RateLimitError",
+    "ServerError",
+    # Models
+    "Framework",
+    "FrameworkDetail",
+    "Article",
+    "ArticleSummary",
+    "ArticleParagraph",
+    "Recital",
+    "Requirement",
+    "Tag",
+    "ComplianceDeadline",
+    "Annex",
+    "AnnexSummary",
+    "SearchResult",
+]