langchain-asimov 0.0.0__py3-none-any.whl → 0.0.1__py3-none-any.whl

langchain_asimov/__init__.py

@@ -1 +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/_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/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/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.dist-info → langchain_asimov-0.0.1.dist-info}/METADATA

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

@@ -0,0 +1,9 @@
+langchain_asimov/__init__.py,sha256=AmAOI5niX9_L9ShANIPkdUQv04YJcg6B3qwK0QuUKbI,374
+langchain_asimov/_version.py,sha256=vgltXBYF55vNcC2regxjGN0_cbebmm8VgcDdQaDapWQ,511
+langchain_asimov/document_loaders.py,sha256=qqhmy_VPMAmCEofaMB7NGs0LO0N_KhbJU-ibAzwjfmA,2433
+langchain_asimov/errors.py,sha256=AVE6eFujm-Iwdwr0czDkJSh6usNPdRBCsOKPWhof8oc,1251
+langchain_asimov/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_asimov-0.0.1.dist-info/METADATA,sha256=8R3koHXXyZz0FTlOyVYJoA-HbDnVdEvzRuOjMHu4gsY,1530
+langchain_asimov-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+langchain_asimov-0.0.1.dist-info/licenses/UNLICENSE,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
+langchain_asimov-0.0.1.dist-info/RECORD,,

langchain_asimov-0.0.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-langchain_asimov/__init__.py,sha256=HNo12SN3s2UpenK7tK8xb4bSf4LpPpN0ZJGO34YM6cY,74
-langchain_asimov/_version.py,sha256=PqNGih23TQ8yvpw6AfE0jq7D_RYFgeG1E-CSVJ9Dntw,511
-langchain_asimov-0.0.0.dist-info/METADATA,sha256=A9b3ta2BEgtCx_yNlNeQ0r1DMZYlqGuzAw2mcRWwxGA,1083
-langchain_asimov-0.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-langchain_asimov-0.0.0.dist-info/licenses/UNLICENSE,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
-langchain_asimov-0.0.0.dist-info/RECORD,,