langchain-asimov 0.0.0__tar.gz → 0.0.1__tar.gz

{langchain_asimov-0.0.0 → langchain_asimov-0.0.1}/.gitignore

@@ -34,4 +34,7 @@ dist/
 *.egg-info/
 
 # hatch-vcs artifacts
-src/*/_version.py
+**/_version.py
+
+# MkDocs artifacts
+.cache/

{langchain_asimov-0.0.0 → langchain_asimov-0.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-asimov
-Version: 0.0.0
+Version: 0.0.1
 Summary: LangChain integration with the ASIMOV platform.
 Project-URL: Homepage, https://github.com/asimov-platform
 Project-URL: Repository, https://github.com/asimov-platform/langchain-asimov
@@ -11,11 +11,32 @@ Author-email: ASIMOV Protocol <support@asimov.so>
 License-Expression: Unlicense
 License-File: UNLICENSE
 Requires-Python: >=3.9
-Requires-Dist: langchain>=0.3
+Requires-Dist: langchain-core>=0.3
+Requires-Dist: pyld>=2
 Description-Content-Type: text/markdown
 
 # LangChain ASIMOV Integration
 
 [![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
-[![Compatibility](https://img.shields.io/pypi/pyversions/langchain-asimov.svg)](https://pypi.python.org/pypi/langchain-asimov)
+[![Compatibility](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fasimov-platform%2Flangchain-asimov%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml)](https://pypi.python.org/pypi/langchain-asimov)
 [![Package](https://img.shields.io/pypi/v/langchain-asimov.svg)](https://pypi.python.org/pypi/langchain-asimov)
+
+## 👉 Examples
+
+### Fetching DuckDuckGo Results
+
+```bash
+export SERPAPI_KEY="..."
+```
+
+```python
+from langchain_asimov import AsimovLoader
+
+search = AsimovLoader(
+    module="serpapi",
+    url="https://duckduckgo.com/?q=Isaac+Asimov"
+)
+
+for result in search.lazy_load():
+    print(result)
+```

langchain_asimov-0.0.1/README.md

@@ -0,0 +1,25 @@
+# LangChain ASIMOV Integration
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Compatibility](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fasimov-platform%2Flangchain-asimov%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml)](https://pypi.python.org/pypi/langchain-asimov)
+[![Package](https://img.shields.io/pypi/v/langchain-asimov.svg)](https://pypi.python.org/pypi/langchain-asimov)
+
+## 👉 Examples
+
+### Fetching DuckDuckGo Results
+
+```bash
+export SERPAPI_KEY="..."
+```
+
+```python
+from langchain_asimov import AsimovLoader
+
+search = AsimovLoader(
+    module="serpapi",
+    url="https://duckduckgo.com/?q=Isaac+Asimov"
+)
+
+for result in search.lazy_load():
+    print(result)
+```

langchain_asimov-0.0.1/VERSION

@@ -0,0 +1 @@
+0.0.1

langchain_asimov-0.0.1/docs/document_loaders.md

@@ -0,0 +1,7 @@
+---
+title: langchain_asimov.document_loaders
+---
+
+This module contains the `AsimovLoader` class.
+
+::: langchain_asimov.document_loaders

langchain_asimov-0.0.1/docs/errors.md

@@ -0,0 +1,7 @@
+---
+title: langchain_asimov.errors
+---
+
+This module contains the `AsimovModuleNotFound` class.
+
+::: langchain_asimov.errors

langchain_asimov-0.0.1/docs/index.md

@@ -0,0 +1,5 @@
+---
+title: langchain_asimov
+---
+
+::: langchain_asimov

langchain_asimov-0.0.1/langchain_asimov/__init__.py

@@ -0,0 +1,14 @@
+# This is free and unencumbered software released into the public domain.
+
+"""LangChain integration with the ASIMOV platform."""
+
+from ._version import __version__, __version_tuple__
+from .document_loaders import AsimovLoader
+from .errors import AsimovModuleNotFound
+
+__all__ = [
+    'AsimovLoader',
+    'AsimovModuleNotFound',
+    '__version__',
+    '__version_tuple__',
+]

{langchain_asimov-0.0.0/src → langchain_asimov-0.0.1}/langchain_asimov/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.0'
-__version_tuple__ = version_tuple = (0, 0, 0)
+__version__ = version = '0.0.1'
+__version_tuple__ = version_tuple = (0, 0, 1)

langchain_asimov-0.0.1/langchain_asimov/document_loaders.py

@@ -0,0 +1,79 @@
+# This is free and unencumbered software released into the public domain.
+
+"""ASIMOV document loader."""
+
+from __future__ import annotations # for Python 3.9
+
+import json
+import logging
+import subprocess
+from .errors import AsimovModuleNotFound
+from langchain_core.document_loaders.base import BaseLoader
+from langchain_core.documents import Document
+from pyld import jsonld
+from typing import Any, Iterator, cast, override
+
+logger = logging.getLogger(__file__)
+
+JSONLD_CONTEXT = {
+    "@version": 1.1,
+    "know": "https://know.dev/",
+    "xsd": "http://www.w3.org/2001/XMLSchema#",
+}
+
+class AsimovLoader(BaseLoader):
+    """
+    ASIMOV document loader integration.
+
+    Setup:
+        Install ``langchain-asimov``:
+
+        ```bash
+        pip install -U langchain-asimov
+        ```
+
+    Instantiate:
+        ```python
+        from langchain_asimov import AsimovLoader
+
+        loader = AsimovLoader(
+            module="serpapi",
+            url="https://duckduckgo.com/?q=Isaac+Asimov"
+        )
+        ```
+    """
+    def __init__(self, module: str, url: str, **kwargs: Any) -> None:
+        self.module = module
+        self.url = url
+
+    @override
+    def lazy_load(self) -> Iterator[Document]:
+        try:
+            result = subprocess.run(
+                [f"asimov-{self.module}-importer", self.url],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+            )
+            result.check_returncode()
+            output = json.loads(result.stdout)
+            output = cast(dict, jsonld.flatten(output, JSONLD_CONTEXT))
+            for resource in output["@graph"]:
+                resource_id = resource["@id"]
+                page_content = describe(resource)
+                yield Document(page_content, id=resource_id, metadata=resource)
+        except FileNotFoundError as error:
+            #logger.exception(error)
+            raise AsimovModuleNotFound(self.module) from (error if __debug__ else None)
+        except subprocess.CalledProcessError as error:
+            #logger.exception(error)
+            raise error # TODO
+        except json.decoder.JSONDecodeError as error:
+            #logger.exception(error)
+            raise error # TODO
+        except jsonld.JsonLdError as error:
+            #logger.exception(error)
+            raise error # TODO
+
+def describe(resource: dict) -> str:
+    return resource["know:summary"]["@value"] # TODO

langchain_asimov-0.0.1/langchain_asimov/errors.py

@@ -0,0 +1,33 @@
+# This is free and unencumbered software released into the public domain.
+
+from __future__ import annotations # for Python 3.9
+
+class AsimovModuleNotFound(Exception):
+    """Exception raised when a module cannot be found or imported.
+
+    Attributes:
+        module_name: The name of the module that was not found
+        message: Explanation of the error
+    """
+
+    def __init__(self, module_name: str, message: str | None = None) -> None:
+        """Initializes the `AsimovModuleNotFound` exception.
+
+        Args:
+            module_name: The name of the module that was not found
+            message: Optional custom error message. If not provided,
+                    a default message will be generated.
+        """
+        self.module_name = module_name
+        if message is None:
+            message = f"Module '{module_name}' not found"
+        self.message = message
+        super().__init__(self.message)
+
+    def __str__(self) -> str:
+        """Returns a string representation of the exception."""
+        return self.message
+
+    def __repr__(self) -> str:
+        """Returns a detailed string representation of the exception."""
+        return f"{self.__class__.__name__}(module_name={self.module_name!r}, message={self.message!r})"

{langchain_asimov-0.0.0 → langchain_asimov-0.0.1}/pyproject.toml

@@ -11,11 +11,9 @@ description = "LangChain integration with the ASIMOV platform."
 readme = "README.md"
 license = "Unlicense"
 license-files = ["UNLICENSE"]
-authors = [
-    { name = "ASIMOV Protocol", email = "support@asimov.so" }
-]
+authors = [{ name = "ASIMOV Protocol", email = "support@asimov.so" }]
 requires-python = ">=3.9"
-dependencies = ["langchain>=0.3"]
+dependencies = ["langchain-core>=0.3", "PyLD>=2"]
 dynamic = ["version"]
 
 [project.urls]
@@ -26,14 +24,24 @@ Releases = "https://github.com/asimov-platform/langchain-asimov/releases"
 Issues = "https://github.com/asimov-platform/langchain-asimov/issues"
 
 [dependency-groups]
+dev = []
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-git-committers-plugin-2>=2.5",
+    "mkdocs-git-revision-date-localized-plugin>=1.2",
+    "mkdocs-llmstxt>=0.2",
+    "mkdocs-material[imaging]>=9.5",
+    "mkdocstrings[python]>=0.29",
+]
 lint = ["ruff"]
-test = []
+test = ["pytest"]
 
 [tool.hatch.version]
 source = "vcs"
+fallback-version = "0.0.0"
 
 [tool.hatch.build.hooks.vcs]
-version-file = "src/langchain_asimov/_version.py"
+version-file = "langchain_asimov/_version.py"
 
 [tool.hatch.build.targets.sdist]
 exclude = [".*"]
@@ -43,3 +51,6 @@ installer = "uv"
 
 [tool.mypy]
 disallow_untyped_defs = true
+
+[tool.uv]
+default-groups = ["dev", "docs"]