moleg-api 0.1.0__tar.gz

moleg_api-0.1.0/LICENSE

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

moleg_api-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: moleg-api
+Version: 0.1.0
+Summary: Task-level Python interface for loading Korean legal sources from law.go.kr
+Author: MOLEG-API maintainers
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tjdwls101010/MOLEG-API
+Project-URL: Documentation, https://github.com/tjdwls101010/MOLEG-API/tree/main/docs
+Project-URL: Repository, https://github.com/tjdwls101010/MOLEG-API
+Project-URL: Issues, https://github.com/tjdwls101010/MOLEG-API/issues
+Keywords: korea,law,legislation,moleg,law.go.kr
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: psycopg[binary]<4,>=3.2; extra == "dev"
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest<9,>=8; extra == "test"
+Dynamic: license-file
+
+# MOLEG-API
+
+MOLEG-API is a task-level Python interface for loading Korean legal sources from
+[law.go.kr](https://www.law.go.kr/). It is designed for applications and agent
+systems that need normalized legal context without memorizing individual MOLEG
+OpenAPI `target` values, identifier rules, or response-shape quirks.
+
+The Python package name is `moleg-api`; import it as `moleg_api`.
+
+This is not a complete wrapper around every law.go.kr endpoint. The public
+interface is intentionally small and deep: search or plan first, then load the
+selected legal source text, authority detail, delegated rule context, or
+annex/form body.
+
+## Install
+
+After the package is published:
+
+```bash
+pip install moleg-api
+```
+
+From a repository checkout:
+
+```bash
+python -m pip install .
+```
+
+Live law.go.kr calls require an OpenAPI credential in `MOLEG_OC`:
+
+```bash
+export MOLEG_OC="your-law-go-kr-oc"
+```
+
+## Quick Example
+
+```python
+from moleg_api import MolegApi
+
+api = MolegApi()
+
+hits = api.search_laws("자동차관리법", basis="effective", display=5)
+selected = hits[0].identity
+
+article = api.get_article(selected, "제26조", basis="effective")
+print(article.text)
+```
+
+For broader questions, use a staged bundle and inspect deferred follow-ups:
+
+```python
+bundle = api.load_legal_context_bundle(
+    query="자동차 방치 처리 기준",
+    mode="question",
+    budget="standard",
+)
+
+for lookup in bundle.deferred:
+    if lookup.interface == "load_administrative_rule_context":
+        rule_context = api.load_followup(lookup)
+        break
+```
+
+Public dataclasses serialize recursively:
+
+```python
+payload = bundle.to_dict()                  # omits raw source payloads
+debug_payload = bundle.to_dict(include_raw=True)
+json_text = bundle.to_json_string()
+```
+
+## What It Covers
+
+- Current and promulgated statutes
+- Statute articles, including moved/deleted article status
+- Supplementary provisions
+- Law history and before/after text comparison
+- Delegated rules and legal hierarchy
+- Administrative rules, notices, directives, and established rules
+- Law and administrative-rule annex/form body loading
+- MOLEG official interpretations and ministry first-instance interpretations
+- Ordinary court cases and Constitutional Court decisions
+- Query expansion and comparable-mechanism discovery
+- Staged context bundles with executable follow-up lookups
+
+## Documentation
+
+- [Quickstart](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/quickstart.md)
+- [API guide](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/api-guide.md)
+- [Follow-up lookups](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/followups.md)
+- [Source coverage and limits](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/source-coverage.md)
+- [Documentation map](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/README.md)
+
+Consumer-specific notes for a future legislative-expert skill remain in
+[docs/SKILL-INTEGRATION.md](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/SKILL-INTEGRATION.md)
+and
+[docs/SKILL-AUTHOR-COOKBOOK.md](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/SKILL-AUTHOR-COOKBOOK.md).
+They are examples of one integration, not the package's general-purpose
+contract.
+
+## Status
+
+The package is alpha (`0.1.x`). The interface is ready for package-level
+experimentation, but law.go.kr live behavior can vary by source, credential, and
+endpoint availability. Treat search results as candidates until selected detail
+loaders have retrieved source text.
+
+This package is a legal-source loader, not legal advice.

moleg_api-0.1.0/README.md

@@ -0,0 +1,108 @@
+# MOLEG-API
+
+MOLEG-API is a task-level Python interface for loading Korean legal sources from
+[law.go.kr](https://www.law.go.kr/). It is designed for applications and agent
+systems that need normalized legal context without memorizing individual MOLEG
+OpenAPI `target` values, identifier rules, or response-shape quirks.
+
+The Python package name is `moleg-api`; import it as `moleg_api`.
+
+This is not a complete wrapper around every law.go.kr endpoint. The public
+interface is intentionally small and deep: search or plan first, then load the
+selected legal source text, authority detail, delegated rule context, or
+annex/form body.
+
+## Install
+
+After the package is published:
+
+```bash
+pip install moleg-api
+```
+
+From a repository checkout:
+
+```bash
+python -m pip install .
+```
+
+Live law.go.kr calls require an OpenAPI credential in `MOLEG_OC`:
+
+```bash
+export MOLEG_OC="your-law-go-kr-oc"
+```
+
+## Quick Example
+
+```python
+from moleg_api import MolegApi
+
+api = MolegApi()
+
+hits = api.search_laws("자동차관리법", basis="effective", display=5)
+selected = hits[0].identity
+
+article = api.get_article(selected, "제26조", basis="effective")
+print(article.text)
+```
+
+For broader questions, use a staged bundle and inspect deferred follow-ups:
+
+```python
+bundle = api.load_legal_context_bundle(
+    query="자동차 방치 처리 기준",
+    mode="question",
+    budget="standard",
+)
+
+for lookup in bundle.deferred:
+    if lookup.interface == "load_administrative_rule_context":
+        rule_context = api.load_followup(lookup)
+        break
+```
+
+Public dataclasses serialize recursively:
+
+```python
+payload = bundle.to_dict()                  # omits raw source payloads
+debug_payload = bundle.to_dict(include_raw=True)
+json_text = bundle.to_json_string()
+```
+
+## What It Covers
+
+- Current and promulgated statutes
+- Statute articles, including moved/deleted article status
+- Supplementary provisions
+- Law history and before/after text comparison
+- Delegated rules and legal hierarchy
+- Administrative rules, notices, directives, and established rules
+- Law and administrative-rule annex/form body loading
+- MOLEG official interpretations and ministry first-instance interpretations
+- Ordinary court cases and Constitutional Court decisions
+- Query expansion and comparable-mechanism discovery
+- Staged context bundles with executable follow-up lookups
+
+## Documentation
+
+- [Quickstart](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/quickstart.md)
+- [API guide](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/api-guide.md)
+- [Follow-up lookups](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/followups.md)
+- [Source coverage and limits](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/source-coverage.md)
+- [Documentation map](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/README.md)
+
+Consumer-specific notes for a future legislative-expert skill remain in
+[docs/SKILL-INTEGRATION.md](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/SKILL-INTEGRATION.md)
+and
+[docs/SKILL-AUTHOR-COOKBOOK.md](https://github.com/tjdwls101010/MOLEG-API/blob/main/docs/SKILL-AUTHOR-COOKBOOK.md).
+They are examples of one integration, not the package's general-purpose
+contract.
+
+## Status
+
+The package is alpha (`0.1.x`). The interface is ready for package-level
+experimentation, but law.go.kr live behavior can vary by source, credential, and
+endpoint availability. Treat search results as candidates until selected detail
+loaders have retrieved source text.
+
+This package is a legal-source loader, not legal advice.

moleg_api-0.1.0/moleg_api/__init__.py

@@ -0,0 +1,133 @@
+"""Public MOLEG-API interface."""
+
+from .errors import (
+    AmbiguousLawError,
+    MolegApiError,
+    NoResultError,
+    ParseFailureError,
+    RateLimitError,
+    RetryExhaustedError,
+    SourceApiError,
+    UnsupportedFormatError,
+)
+from .laws import MolegApi
+from .models import (
+    AdministrativeRuleArticleText,
+    AdministrativeRuleContext,
+    AdministrativeRuleHit,
+    AdministrativeRuleIdentity,
+    AdministrativeRuleText,
+    Ambiguity,
+    AnnexFormSource,
+    AnnexFormHit,
+    AnnexFormIdentity,
+    AnnexFormText,
+    AnnexSearchScope,
+    AnnexType,
+    ArticleContext,
+    ArticleReference,
+    ArticleText,
+    AuthorityContext,
+    Basis,
+    BundleBudget,
+    BundleMode,
+    BundleRequestMode,
+    BundleRequest,
+    CandidateContext,
+    CaseCourt,
+    ContextGap,
+    DeferredLookup,
+    DelegatedRule,
+    DelegationGraph,
+    HistoryEvent,
+    InterpretationHit,
+    InterpretationIdentity,
+    InterpretationSearchSource,
+    InterpretationText,
+    JudicialDecisionHit,
+    JudicialDecisionIdentity,
+    JudicialDecisionText,
+    FollowUpSearch,
+    LegalArticleCandidate,
+    LegalContextBundle,
+    LegalLawCandidate,
+    LegalQueryExpansion,
+    LegalTermCandidate,
+    LoadedContext,
+    LawDiff,
+    LawDiffChange,
+    LawHit,
+    LawHistory,
+    LawIdentity,
+    LawStructure,
+    LawStructureNode,
+    LawText,
+    SupplementaryProvision,
+    StructuredTableData,
+)
+from .source import LawGoKrClient
+
+__all__ = [
+    "AmbiguousLawError",
+    "AdministrativeRuleArticleText",
+    "AdministrativeRuleContext",
+    "AdministrativeRuleHit",
+    "AdministrativeRuleIdentity",
+    "AdministrativeRuleText",
+    "Ambiguity",
+    "AnnexFormSource",
+    "AnnexFormHit",
+    "AnnexFormIdentity",
+    "AnnexFormText",
+    "AnnexSearchScope",
+    "AnnexType",
+    "ArticleContext",
+    "ArticleReference",
+    "ArticleText",
+    "AuthorityContext",
+    "Basis",
+    "BundleBudget",
+    "BundleMode",
+    "BundleRequestMode",
+    "BundleRequest",
+    "CandidateContext",
+    "CaseCourt",
+    "ContextGap",
+    "DeferredLookup",
+    "DelegatedRule",
+    "DelegationGraph",
+    "HistoryEvent",
+    "InterpretationHit",
+    "InterpretationIdentity",
+    "InterpretationSearchSource",
+    "InterpretationText",
+    "JudicialDecisionHit",
+    "JudicialDecisionIdentity",
+    "JudicialDecisionText",
+    "FollowUpSearch",
+    "LegalArticleCandidate",
+    "LegalContextBundle",
+    "LegalLawCandidate",
+    "LegalQueryExpansion",
+    "LegalTermCandidate",
+    "LoadedContext",
+    "LawGoKrClient",
+    "LawDiff",
+    "LawDiffChange",
+    "LawHit",
+    "LawHistory",
+    "LawIdentity",
+    "LawStructure",
+    "LawStructureNode",
+    "LawText",
+    "MolegApi",
+    "MolegApiError",
+    "NoResultError",
+    "ParseFailureError",
+    "RateLimitError",
+    "RetryExhaustedError",
+    "SourceApiError",
+    "SupplementaryProvision",
+    "StructuredTableData",
+    "UnsupportedFormatError",
+]

moleg_api-0.1.0/moleg_api/errors.py

@@ -0,0 +1,49 @@
+"""MOLEG-API error model."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class MolegApiError(Exception):
+    """Base error for MOLEG-API public-interface failures."""
+
+
+class NoResultError(MolegApiError):
+    """The source API returned no usable result for the requested legal task."""
+
+
+class AmbiguousLawError(MolegApiError):
+    """The request matched multiple plausible law identities."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        kind: str | None = None,
+        candidates: list[Any] | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.message = message
+        self.kind = kind
+        self.candidates = list(candidates or [])
+
+
+class UnsupportedFormatError(MolegApiError):
+    """The source endpoint cannot provide a supported response format."""
+
+
+class SourceApiError(MolegApiError):
+    """The source law.go.kr API failed or returned an invalid response."""
+
+
+class RateLimitError(SourceApiError):
+    """The source law.go.kr API rate limited the request."""
+
+
+class RetryExhaustedError(SourceApiError):
+    """Retryable source failures continued through all allowed attempts."""
+
+
+class ParseFailureError(MolegApiError):
+    """A source response could not be normalized into the public model."""