law4devs 0.1.0__py3-none-any.whl

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",
+]

law4devs/_http.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+import json
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any
+
+from ._version import __version__
+from .exceptions import Law4DevsError, NotFoundError, RateLimitError, ServerError, ValidationError
+
+DEFAULT_BASE_URL = "https://api.law4devs.eu/api/v1"
+
+
+class HTTPClient:
+    def __init__(
+        self,
+        base_url: str = DEFAULT_BASE_URL,
+        api_key: str | None = None,
+        timeout: int = 30,
+        max_retries: int = 3,
+    ):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self._headers: dict[str, str] = {
+            "Accept": "application/json",
+            "User-Agent": f"law4devs-python/{__version__}",
+        }
+        if api_key:
+            self._headers["X-API-Key"] = api_key
+
+    def get(self, path: str, params: dict[str, Any] | None = None) -> Any:
+        """Make a GET request with automatic retry on 429/5xx."""
+        url = self.base_url + path
+        if params:
+            clean = {k: str(v) for k, v in params.items() if v is not None}
+            if clean:
+                url += "?" + urllib.parse.urlencode(clean)
+
+        last_exc: Exception | None = None
+        for attempt in range(self.max_retries):
+            try:
+                req = urllib.request.Request(url, headers=self._headers)
+                with urllib.request.urlopen(req, timeout=self.timeout) as resp:
+                    return json.loads(resp.read())
+            except urllib.error.HTTPError as exc:
+                body: dict = {}
+                try:
+                    body = json.loads(exc.read())
+                except Exception:
+                    pass
+                msg = body.get("error", {}).get("message", str(exc))
+                status = exc.code
+                if status == 404:
+                    raise NotFoundError(msg, status) from exc
+                if status == 400:
+                    raise ValidationError(msg, status) from exc
+                if status == 429:
+                    if attempt < self.max_retries - 1:
+                        time.sleep(2 ** attempt)
+                        last_exc = exc
+                        continue
+                    raise RateLimitError(msg, status) from exc
+                if status >= 500:
+                    if attempt < self.max_retries - 1:
+                        time.sleep(2 ** attempt)
+                        last_exc = exc
+                        continue
+                    raise ServerError(msg, status) from exc
+                raise Law4DevsError(msg, status) from exc
+            except urllib.error.URLError as exc:
+                if attempt < self.max_retries - 1:
+                    time.sleep(2 ** attempt)
+                    last_exc = exc
+                    continue
+                raise Law4DevsError(f"Request failed: {exc}") from exc
+
+        raise Law4DevsError("Max retries exceeded") from last_exc

law4devs/_pagination.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import Generic, Iterator, List, TypeVar
+
+T = TypeVar("T")
+
+@dataclass
+class PageMeta:
+    api_version: str
+    total: int
+    page: int
+    per_page: int
+    pages: int
+
+@dataclass
+class PageLinks:
+    next: str | None
+    prev: str | None
+
+@dataclass
+class Page(Generic[T]):
+    data: List[T]
+    meta: PageMeta
+    links: PageLinks
+
+    def __iter__(self) -> Iterator[T]:
+        return iter(self.data)
+
+    def __len__(self) -> int:
+        return len(self.data)

law4devs/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

law4devs/client.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+from ._http import HTTPClient, DEFAULT_BASE_URL
+from .resources.frameworks import FrameworksResource
+from .resources.articles import ArticlesResource
+from .resources.recitals import RecitalsResource
+from .resources.requirements import RequirementsResource
+from .resources.tags import TagsResource
+from .resources.compliance import ComplianceResource
+from .resources.annexes import AnnexesResource
+from .resources.search import SearchResource
+
+
+class Law4DevsClient:
+    """Official Python client for the Law4Devs EU Regulatory Compliance API.
+
+    Usage::
+
+        from law4devs import Law4DevsClient
+
+        client = Law4DevsClient()
+        frameworks = client.frameworks.list()
+        cra = client.frameworks.get("cra")
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        api_key: str | None = None,
+        timeout: int = 30,
+        max_retries: int = 3,
+    ) -> None:
+        self._http = HTTPClient(
+            base_url=base_url,
+            api_key=api_key,
+            timeout=timeout,
+            max_retries=max_retries,
+        )
+        self.frameworks = FrameworksResource(self._http)
+        self.articles = ArticlesResource(self._http)
+        self.recitals = RecitalsResource(self._http)
+        self.requirements = RequirementsResource(self._http)
+        self.tags = TagsResource(self._http)
+        self.compliance = ComplianceResource(self._http)
+        self.annexes = AnnexesResource(self._http)
+        self.search = SearchResource(self._http)

law4devs/exceptions.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+class Law4DevsError(Exception):
+    """Base exception for all SDK errors."""
+    def __init__(self, message: str, status_code: int | None = None):
+        super().__init__(message)
+        self.status_code = status_code
+
+class NotFoundError(Law4DevsError):
+    """Raised when a resource is not found (404)."""
+
+class ValidationError(Law4DevsError):
+    """Raised for invalid request parameters (400)."""
+
+class RateLimitError(Law4DevsError):
+    """Raised when rate limit is exceeded (429)."""
+
+class ServerError(Law4DevsError):
+    """Raised for server-side errors (5xx)."""

law4devs/models/__init__.py

@@ -0,0 +1,19 @@
+from .framework import Framework, FrameworkDetail
+from .article import Article, ArticleSummary, ArticleParagraph
+from .recital import Recital
+from .requirement import Requirement
+from .tag import Tag
+from .compliance import ComplianceDeadline
+from .annex import Annex, AnnexSummary
+from .search import SearchResult
+
+__all__ = [
+    "Framework", "FrameworkDetail",
+    "Article", "ArticleSummary", "ArticleParagraph",
+    "Recital",
+    "Requirement",
+    "Tag",
+    "ComplianceDeadline",
+    "Annex", "AnnexSummary",
+    "SearchResult",
+]

law4devs/models/annex.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+
+@dataclass
+class AnnexSummary:
+    id: int
+    framework_slug: str
+    annex_number: str
+    title: str
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> AnnexSummary:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            annex_number=str(d.get("annex_number", "")),
+            title=d.get("title", ""),
+        )
+
+
+@dataclass
+class Annex(AnnexSummary):
+    content: str = ""
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Annex:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            annex_number=str(d.get("annex_number", "")),
+            title=d.get("title", ""),
+            content=d.get("content", ""),
+        )

law4devs/models/article.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import List
+from .tag import Tag
+
+
+@dataclass
+class ArticleParagraph:
+    paragraph_ref: str
+    content: str
+    position: int
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> ArticleParagraph:
+        return cls(
+            paragraph_ref=d.get("paragraph_ref", ""),
+            content=d.get("content", ""),
+            position=d.get("position", 0),
+        )
+
+
+@dataclass
+class ArticleSummary:
+    id: int
+    framework_slug: str
+    article_number: int
+    title: str
+    position: int
+    paragraph_count: int
+    tags: List[Tag]
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> ArticleSummary:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            article_number=int(d.get("article_number", 0)),
+            title=d.get("title", ""),
+            position=d.get("position", 0),
+            paragraph_count=d.get("paragraph_count", 0),
+            tags=[Tag._from_dict(t) if isinstance(t, dict) else t for t in d.get("tags", [])],
+        )
+
+
+@dataclass
+class Article(ArticleSummary):
+    content: str = ""
+    paragraphs: List[ArticleParagraph] = field(default_factory=list)
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Article:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            article_number=int(d.get("article_number", 0)),
+            title=d.get("title", ""),
+            position=d.get("position", 0),
+            paragraph_count=d.get("paragraph_count", 0),
+            tags=[Tag._from_dict(t) if isinstance(t, dict) else t for t in d.get("tags", [])],
+            content=d.get("content", ""),
+            paragraphs=[ArticleParagraph._from_dict(p) for p in d.get("paragraphs", [])],
+        )

law4devs/models/compliance.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+
+@dataclass
+class ComplianceDeadline:
+    id: int
+    framework_slug: str
+    article_number: str | None
+    paragraph_ref: str | None
+    deadline_date: str
+    deadline_type: str
+    description: str | None
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> ComplianceDeadline:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            article_number=d.get("article_number"),
+            paragraph_ref=d.get("paragraph_ref"),
+            deadline_date=d.get("deadline_date", ""),
+            deadline_type=d.get("deadline_type", ""),
+            description=d.get("description"),
+        )

law4devs/models/framework.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+
+@dataclass
+class Framework:
+    id: int
+    slug: str
+    name: str
+    short_name: str
+    celex_number: str
+    description: str | None
+    is_active: bool
+    status: str
+    expected_articles: int
+    expected_recitals: int
+    last_synced_at: str | None
+    created_at: str
+    article_count: int
+    recital_count: int
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Framework:
+        return cls(
+            id=d["id"],
+            slug=d["slug"],
+            name=d["name"],
+            short_name=d.get("short_name", ""),
+            celex_number=d.get("celex_number", ""),
+            description=d.get("description"),
+            is_active=d.get("is_active", True),
+            status=d.get("status", "active"),
+            expected_articles=d.get("expected_articles", 0),
+            expected_recitals=d.get("expected_recitals", 0),
+            last_synced_at=d.get("last_synced_at"),
+            created_at=d.get("created_at", ""),
+            article_count=d.get("article_count", 0),
+            recital_count=d.get("recital_count", 0),
+        )
+
+
+@dataclass
+class FrameworkDetail(Framework):
+    eurlex_url: str = ""
+    requirement_count: int = 0
+    annex_count: int = 0
+    tag_count: int = 0
+    coverage: dict | None = None
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> FrameworkDetail:
+        return cls(
+            id=d["id"],
+            slug=d["slug"],
+            name=d["name"],
+            short_name=d.get("short_name", ""),
+            celex_number=d.get("celex_number", ""),
+            description=d.get("description"),
+            is_active=d.get("is_active", True),
+            status=d.get("status", "active"),
+            expected_articles=d.get("expected_articles", 0),
+            expected_recitals=d.get("expected_recitals", 0),
+            last_synced_at=d.get("last_synced_at"),
+            created_at=d.get("created_at", ""),
+            article_count=d.get("article_count", 0),
+            recital_count=d.get("recital_count", 0),
+            eurlex_url=d.get("eurlex_url", ""),
+            requirement_count=d.get("requirement_count", 0),
+            annex_count=d.get("annex_count", 0),
+            tag_count=d.get("tag_count", 0),
+            coverage=d.get("coverage"),
+        )

law4devs/models/recital.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+
+@dataclass
+class Recital:
+    id: int
+    framework_slug: str
+    recital_number: int
+    content: str
+    position: int
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Recital:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            recital_number=int(d.get("recital_number", 0)),
+            content=d.get("content", ""),
+            position=d.get("position", 0),
+        )

law4devs/models/requirement.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import List
+from .tag import Tag
+
+
+@dataclass
+class Requirement:
+    id: int
+    framework_slug: str
+    article_number: int | None
+    paragraph_ref: str | None
+    paragraph_content: str | None
+    requirement_text: str
+    requirement_type: str
+    compliance_deadline: str | None
+    linked_article_numbers: List[int]
+    stakeholder_roles: List[str]
+    tags: List[Tag]
+    created_at: str
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Requirement:
+        return cls(
+            id=d["id"],
+            framework_slug=d.get("framework_slug", d.get("framework", {}).get("slug", "")),
+            article_number=d.get("article_number"),
+            paragraph_ref=d.get("paragraph_ref"),
+            paragraph_content=d.get("paragraph_content"),
+            requirement_text=d.get("requirement_text", ""),
+            requirement_type=d.get("requirement_type", "general"),
+            compliance_deadline=d.get("compliance_deadline"),
+            linked_article_numbers=d.get("linked_article_numbers", []),
+            stakeholder_roles=d.get("stakeholder_roles", []),
+            tags=[Tag._from_dict(t) if isinstance(t, dict) else t for t in d.get("tags", [])],
+            created_at=d.get("created_at", ""),
+        )

law4devs/models/search.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+from dataclasses import dataclass
+
+
+@dataclass
+class SearchResult:
+    type: str
+    framework_slug: str
+    framework_name: str
+    article_number: int | None
+    recital_number: int | None
+    paragraph_ref: str | None
+    title: str | None
+    requirement_type: str | None
+    match_context: str
+    url: str
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> SearchResult:
+        fw = d.get("framework", {})
+        return cls(
+            type=d.get("type", ""),
+            framework_slug=d.get("framework_slug", fw.get("slug", "")),
+            framework_name=d.get("framework_name", fw.get("name", "")),
+            article_number=d.get("article_number"),
+            recital_number=d.get("recital_number"),
+            paragraph_ref=d.get("paragraph_ref"),
+            title=d.get("title"),
+            requirement_type=d.get("requirement_type"),
+            match_context=d.get("match_context", ""),
+            url=d.get("url", ""),
+        )

law4devs/models/tag.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+from dataclasses import dataclass
+from typing import List
+
+
+@dataclass
+class Tag:
+    id: int
+    slug: str
+    name: str
+    description: str | None
+    keywords: List[str]
+    color: str
+    created_at: str
+
+    @classmethod
+    def _from_dict(cls, d: dict) -> Tag:
+        return cls(
+            id=d["id"],
+            slug=d["slug"],
+            name=d["name"],
+            description=d.get("description"),
+            keywords=d.get("keywords", []),
+            color=d.get("color", ""),
+            created_at=d.get("created_at", ""),
+        )

law4devs/resources/__init__.py

@@ -0,0 +1,21 @@
+from ._base import BaseResource
+from .frameworks import FrameworksResource
+from .articles import ArticlesResource
+from .recitals import RecitalsResource
+from .requirements import RequirementsResource
+from .tags import TagsResource
+from .compliance import ComplianceResource
+from .annexes import AnnexesResource
+from .search import SearchResource
+
+__all__ = [
+    "BaseResource",
+    "FrameworksResource",
+    "ArticlesResource",
+    "RecitalsResource",
+    "RequirementsResource",
+    "TagsResource",
+    "ComplianceResource",
+    "AnnexesResource",
+    "SearchResource",
+]

law4devs/resources/_base.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Any, Iterator, TypeVar
+
+if TYPE_CHECKING:
+    from law4devs._http import HTTPClient
+
+T = TypeVar("T")
+
+
+class BaseResource:
+    def __init__(self, http: HTTPClient) -> None:
+        self._http = http
+
+    def _page_params(self, page: int | None, per_page: int | None) -> dict[str, Any]:
+        params: dict[str, Any] = {}
+        if page is not None:
+            params["page"] = page
+        if per_page is not None:
+            params["per_page"] = per_page
+        return params
+
+    def _parse_page(self, raw: dict, item_factory) -> Any:
+        from law4devs._pagination import Page, PageMeta, PageLinks
+        meta_raw = raw.get("meta", {})
+        links_raw = raw.get("links", {})
+        return Page(
+            data=[item_factory(item) for item in raw.get("data", [])],
+            meta=PageMeta(
+                api_version=meta_raw.get("api_version", "1.0"),
+                total=meta_raw.get("total", 0),
+                page=meta_raw.get("page", 1),
+                per_page=meta_raw.get("per_page", 20),
+                pages=meta_raw.get("pages", 0),
+            ),
+            links=PageLinks(
+                next=links_raw.get("next"),
+                prev=links_raw.get("prev"),
+            ),
+        )
+
+    def _iter_pages(self, list_fn, *args, per_page: int = 20, **kwargs) -> Iterator:
+        """Auto-paginate through all pages and yield individual items."""
+        page = 1
+        while True:
+            result = list_fn(*args, page=page, per_page=per_page, **kwargs)
+            yield from result.data
+            if not result.links.next:
+                break
+            page += 1

law4devs/resources/annexes.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.annex import Annex, AnnexSummary
+from .._pagination import Page
+
+
+class AnnexesResource(BaseResource):
+    def list(self, framework_slug: str, *, page: int | None = None, per_page: int | None = None) -> Page[AnnexSummary]:
+        raw = self._http.get(f"/frameworks/{framework_slug}/annexes", params=self._page_params(page, per_page))
+        return self._parse_page(raw, AnnexSummary._from_dict)
+
+    def iter(self, framework_slug: str, *, per_page: int = 20) -> Iterator[AnnexSummary]:
+        """Iterate over all annexes for a framework across all pages."""
+        return self._iter_pages(self.list, framework_slug, per_page=per_page)
+
+    def get(self, framework_slug: str, annex_number: int | str) -> Annex:
+        raw = self._http.get(f"/frameworks/{framework_slug}/annexes/{annex_number}")
+        return Annex._from_dict(raw.get("data", raw))

law4devs/resources/articles.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.article import Article, ArticleSummary
+from .._pagination import Page
+
+
+class ArticlesResource(BaseResource):
+    def list(self, framework_slug: str, *, page: int | None = None, per_page: int | None = None) -> Page[ArticleSummary]:
+        raw = self._http.get(f"/frameworks/{framework_slug}/articles", params=self._page_params(page, per_page))
+        return self._parse_page(raw, ArticleSummary._from_dict)
+
+    def iter(self, framework_slug: str, *, per_page: int = 20) -> Iterator[ArticleSummary]:
+        """Iterate over all articles for a framework across all pages."""
+        return self._iter_pages(self.list, framework_slug, per_page=per_page)
+
+    def get(self, framework_slug: str, article_number: int | str) -> Article:
+        raw = self._http.get(f"/frameworks/{framework_slug}/articles/{article_number}")
+        return Article._from_dict(raw.get("data", raw))
+
+    def related(self, framework_slug: str, article_number: int | str, *, page: int | None = None, per_page: int | None = None) -> Page[ArticleSummary]:
+        raw = self._http.get(f"/frameworks/{framework_slug}/articles/{article_number}/related", params=self._page_params(page, per_page))
+        return self._parse_page(raw, ArticleSummary._from_dict)

law4devs/resources/compliance.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.compliance import ComplianceDeadline
+from .._pagination import Page
+
+
+class ComplianceResource(BaseResource):
+    def deadlines(self, *, framework_slug: str | None = None, page: int | None = None, per_page: int | None = None) -> Page[ComplianceDeadline]:
+        if framework_slug:
+            path = f"/frameworks/{framework_slug}/compliance/deadlines"
+        else:
+            path = "/compliance/deadlines"
+        params = self._page_params(page, per_page)
+        raw = self._http.get(path, params=params)
+        return self._parse_page(raw, ComplianceDeadline._from_dict)
+
+    def iter_deadlines(self, *, framework_slug: str | None = None, per_page: int = 20) -> Iterator[ComplianceDeadline]:
+        """Iterate over all compliance deadlines across all pages."""
+        return self._iter_pages(self.deadlines, framework_slug=framework_slug, per_page=per_page)

law4devs/resources/frameworks.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+from typing import Any, Iterator
+from ._base import BaseResource
+from ..models.framework import Framework, FrameworkDetail
+from .._pagination import Page
+
+
+class FrameworksResource(BaseResource):
+    def list(self, *, page: int | None = None, per_page: int | None = None) -> Page[Framework]:
+        raw = self._http.get("/frameworks", params=self._page_params(page, per_page))
+        return self._parse_page(raw, Framework._from_dict)
+
+    def iter(self, *, per_page: int = 20) -> Iterator[Framework]:
+        """Iterate over all frameworks across all pages."""
+        return self._iter_pages(self.list, per_page=per_page)
+
+    def get(self, slug: str) -> FrameworkDetail:
+        raw = self._http.get(f"/frameworks/{slug}")
+        return FrameworkDetail._from_dict(raw.get("data", raw))
+
+    def stats(self, slug: str) -> dict:
+        return self._http.get(f"/frameworks/{slug}/stats")
+
+    def changelog(self, slug: str, *, page: int | None = None, per_page: int | None = None) -> dict:
+        return self._http.get(f"/frameworks/{slug}/changelog", params=self._page_params(page, per_page))

law4devs/resources/recitals.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.recital import Recital
+from .._pagination import Page
+
+
+class RecitalsResource(BaseResource):
+    def list(self, framework_slug: str, *, page: int | None = None, per_page: int | None = None) -> Page[Recital]:
+        raw = self._http.get(f"/frameworks/{framework_slug}/recitals", params=self._page_params(page, per_page))
+        return self._parse_page(raw, Recital._from_dict)
+
+    def iter(self, framework_slug: str, *, per_page: int = 20) -> Iterator[Recital]:
+        """Iterate over all recitals for a framework across all pages."""
+        return self._iter_pages(self.list, framework_slug, per_page=per_page)
+
+    def get(self, framework_slug: str, recital_number: int | str) -> Recital:
+        raw = self._http.get(f"/frameworks/{framework_slug}/recitals/{recital_number}")
+        return Recital._from_dict(raw.get("data", raw))

law4devs/resources/requirements.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.requirement import Requirement
+from .._pagination import Page
+
+
+class RequirementsResource(BaseResource):
+    def list(self, *, framework_slug: str | None = None, page: int | None = None, per_page: int | None = None) -> Page[Requirement]:
+        if framework_slug:
+            path = f"/frameworks/{framework_slug}/requirements"
+        else:
+            path = "/requirements"
+        params = self._page_params(page, per_page)
+        raw = self._http.get(path, params=params)
+        return self._parse_page(raw, Requirement._from_dict)
+
+    def iter(self, *, framework_slug: str | None = None, per_page: int = 20) -> Iterator[Requirement]:
+        """Iterate over all requirements across all pages."""
+        return self._iter_pages(self.list, framework_slug=framework_slug, per_page=per_page)

law4devs/resources/search.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from ._base import BaseResource
+from ..models.search import SearchResult
+from .._pagination import Page
+
+
+class SearchResource(BaseResource):
+    def query(self, q: str, *, framework: str | None = None, result_type: str | None = None, page: int | None = None, per_page: int | None = None) -> Page[SearchResult]:
+        params: dict = {"q": q}
+        if framework:
+            params["framework"] = framework
+        if result_type:
+            params["type"] = result_type
+        params.update(self._page_params(page, per_page))
+        raw = self._http.get("/search", params=params)
+        return self._parse_page(raw, SearchResult._from_dict)

law4devs/resources/tags.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+from typing import Iterator
+from ._base import BaseResource
+from ..models.tag import Tag
+from .._pagination import Page
+
+
+class TagsResource(BaseResource):
+    def list(self, *, page: int | None = None, per_page: int | None = None) -> Page[Tag]:
+        raw = self._http.get("/tags", params=self._page_params(page, per_page))
+        return self._parse_page(raw, Tag._from_dict)
+
+    def iter(self, *, per_page: int = 20) -> Iterator[Tag]:
+        """Iterate over all tags across all pages."""
+        return self._iter_pages(self.list, per_page=per_page)
+
+    def get(self, slug: str) -> Tag:
+        raw = self._http.get(f"/tags/{slug}")
+        return Tag._from_dict(raw.get("data", raw))

law4devs-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,30 @@
+law4devs/__init__.py,sha256=PBIDVDEHgF3osGzmDwHNLlnFIi96ElT5OPUEFVJwC7w,836
+law4devs/_http.py,sha256=V4EwXVJeP_igZIjiljZDBcue8qAP55_mwlVT5-t6_kE,2985
+law4devs/_pagination.py,sha256=OAjssCGmvQxVJbFZVksJwZ2fqB_DCWViOV0p1whQauE,547
+law4devs/_version.py,sha256=QTYqXqSTHFRkM9TEgpDFcHvwLbvqHDqvqfQ9EiXkcAM,23
+law4devs/client.py,sha256=tvVgfVFyTOYcyMM26jtCfINKqk81SqON39313qHnkHg,1557
+law4devs/exceptions.py,sha256=f02RtKJokKVICCN_yJ6YwHX_sMJ5aA2AFMUzZQemyMg,612
+law4devs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+law4devs/models/__init__.py,sha256=_xdC3j4pzYeKbuRWsiDM1pCWRPaXdrC2SIktHUL8OwU,539
+law4devs/models/annex.py,sha256=PBYaEvdpgis7glfncKvP0P-Y_P0waMExPgiQXvrRjvg,890
+law4devs/models/article.py,sha256=4mL99Mi2ExNn_Me6cCRottVK5UXsXs5xeTjkf5zFgRE,1908
+law4devs/models/compliance.py,sha256=a5w0ly10JNnyQxTs317D4GLT-k8XlYIzylZL1XCJ0GY,755
+law4devs/models/framework.py,sha256=QKMA1vHxxVQrTBPI1ov2JKvFDHPy4rahQGa-Ml1Bywg,2315
+law4devs/models/recital.py,sha256=nGqNQXFrQORFLHe2dC5CPYB6PV94_MCgrw8ln_Dl8iA,546
+law4devs/models/requirement.py,sha256=uc9qscBf1UbA6JPg9LcmzJFCMLUa_q2S4TV4DbRvnPs,1315
+law4devs/models/search.py,sha256=I9zWSiNReN3Uwq8Frgx6wBCIuhKons2aiXNE4d1dY0E,993
+law4devs/models/tag.py,sha256=7SJ1xKIg_a25lk8NIcFuFXdF8OB3ddkUMbChxlBOrHs,589
+law4devs/resources/__init__.py,sha256=nuiyaPvQGu0lYa7kxhtwVyvxiKbZ-mSmKH-DpdiVxKs,574
+law4devs/resources/_base.py,sha256=1CVy4WXptVZ4CGdld03SUrN5mkHsQXLAQ0amfAM6pQ4,1686
+law4devs/resources/annexes.py,sha256=6jOZRZ6_Cnl7j5hh5un_XQN8qaD__vM-REgMxHfPo8U,962
+law4devs/resources/articles.py,sha256=mARXWBAFNJ5-v66P42OICm6-ngNeRUnt5AKHA5iZ6Oo,1341
+law4devs/resources/compliance.py,sha256=O0Rn-IsTVtahfuimoP27T_8Uc5ECdhBAssCh6S-e4gw,978
+law4devs/resources/frameworks.py,sha256=POaJvYVF-j56ypYEn8-ql_kkAb2knyqT7j7KW2WOr1o,1134
+law4devs/resources/recitals.py,sha256=AOQDmmTgOiNjK2PunIzDbZ6PynHm0fVo0nSefe_bwkc,949
+law4devs/resources/requirements.py,sha256=PSCaBK85KkIPswYw9NdB6KKdxuvCz4O4uLoYGWZvZqE,909
+law4devs/resources/search.py,sha256=3Y1rbCbIxeKNKLgU84AnIO3hAtLAe4haVa515Byiq14,684
+law4devs/resources/tags.py,sha256=XlfAHFyxtZi2GLf_0CBRDGQPolvlGIQD53blGCHztNA,727
+law4devs-0.1.0.dist-info/METADATA,sha256=5BlmWYwYX0DiJv8z3EqmfV4pW4cFN7wv3PvCnJFoHzY,6345
+law4devs-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+law4devs-0.1.0.dist-info/licenses/LICENSE,sha256=p8gNxtKvHogeIY8HF6FZY28sIeFIDnxkYlI_NRNDQnk,1086
+law4devs-0.1.0.dist-info/RECORD,,

law4devs-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

law4devs-0.1.0.dist-info/licenses/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.