diffbot-python 0.2.0__py3-none-any.whl → 0.2.3__py3-none-any.whl

diffbot/__init__.py

@@ -2,7 +2,12 @@
 diffbot - Python client library for the Diffbot APIs.
 """
 
-__version__ = "0.1.0"
+from importlib.metadata import PackageNotFoundError, version as _version
+
+try:
+    __version__ = _version("diffbot-python")
+except PackageNotFoundError:  # not installed (e.g. running from a source tree)
+    __version__ = "0.0.0"
 
 from ._auth import resolve_token
 from .client import Diffbot, DiffbotAsync

diffbot/cli/__init__.py

@@ -11,7 +11,7 @@ from rich.markdown import Markdown
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from datetime import datetime
 
-from diffbot import CrawlEventType, AuthError, ExtractionError, APIError
+from diffbot import __version__, CrawlEventType, AuthError, ExtractionError, APIError
 
 from ._common import get_client
 
@@ -28,6 +28,7 @@ def print_markdown(text):
 
 
 @click.group()
+@click.version_option(__version__, "-V", "--version", prog_name="db")
 def main():
     """
     Diffbot 🤖 Structure the world's knowledge.

{diffbot_python-0.2.0.dist-info → diffbot_python-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: diffbot-python
-Version: 0.2.0
+Version: 0.2.3
 Summary: Python client library for Diffbot APIs
 Project-URL: Homepage, https://github.com/diffbot/diffbot-python
 Project-URL: Documentation, https://github.com/diffbot/diffbot-python#readme
@@ -15,6 +15,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -25,7 +26,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.9
 Requires-Dist: click>=8.1.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
@@ -40,11 +41,19 @@ Python client library for [Diffbot](https://www.diffbot.com) APIs.
 
 ## Installation
 
+Install the [standalone CLI binary](#standalone-binary) for [agentic use](#how-to-use-with-an-agent):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh
+```
+
+If you prefer, the full Python library can also be installed with pip:
+
 ```bash
 python3 -m pip install diffbot-python
 ```
 
-Or, for local development:
+For local development:
 
 ```bash
 pip install -e ".[dev]"
@@ -237,6 +246,22 @@ uv tool install .
 
 This drops a `db` executable into `~/.local/bin` (ensure it is on your `PATH`). Use `--force` to reinstall or upgrade after changes, or `--editable` to have source edits take effect immediately. Alternatively, a plain `pip install .` (or `pip install -e .`) also installs the `db` entry point into the active environment.
 
+### Standalone binary
+
+Every release also ships a self-contained `db` binary for Linux (x86_64 and aarch64) and macOS (Apple Silicon) as a Python-free option. The installer detects your platform, verifies the SHA256 checksum, and installs (or upgrades) `db` into `~/.local/bin`:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh
+```
+
+Pin a specific release or install location with flags (or the `DB_VERSION` / `DB_INSTALL_DIR` environment variables); re-running the installer upgrades an existing install in place:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh -s -- --version v0.2.1 --bin-dir ~/bin
+```
+
+### How to use
+
 ```bash
 export DIFFBOT_API_TOKEN=your-token-here
 
@@ -251,6 +276,12 @@ db entities "Apple CEO Tim Cook announced record quarterly earnings."
 db entities "Apple CEO Tim Cook announced record quarterly earnings." -f dql
 ```
 
+### How to use with an agent
+Once installed, this library will work alongside [`diffbot-skills`](https://github.com/diffbot/diffbot-skills) to enable your agent full access to structuring web knowledge with Diffbot. Diffbot Agent Skills even unlocks some additional skills like crafting DQL from natural language. 
+
+`diffbot-skills` will pick up or install this library automatically. 
+
+
 ## Tests
 
 Run the mock test suite:

{diffbot_python-0.2.0.dist-info → diffbot_python-0.2.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-diffbot/__init__.py,sha256=hyIdyzIjXYvM2XXE20bDggIcJkTC7aR5s--LdLGFXOI,619
+diffbot/__init__.py,sha256=OUDi3bVvKowQAQB4m8I4t761ct4pC-3de461qPI4Zok,827
 diffbot/_auth.py,sha256=dzNMWqIjtG3YtRBb_EKpPRiBxvZgogxvoE0ABLvzfOk,1251
 diffbot/ask.py,sha256=iNv613j4CoIfdDTOE-pl9KUkjqI-2AxGDMR1prm3DGM,1853
 diffbot/client.py,sha256=G6vYUEDEaIqjJXcIRxAjwS_cvaXvM7KdQFVMIedkgUY,11315
@@ -9,14 +9,14 @@ diffbot/kg.py,sha256=my-5vR4Vbe3LHzBDYVHLHo99KTtyiRXCT5625glsrlQ,3930
 diffbot/nlp.py,sha256=lZJW4MkjhVklIEM2OBfhc8LvresXTy7RsuImPteYsOA,1153
 diffbot/ontology.py,sha256=GWD5m2rz7ECWY6RrO1TeN3kk3DYTgmEHz6gFKASMvAU,6283
 diffbot/web_search.py,sha256=RSaEK0pdAdLgtilc500Mf2MNmJ1DmiYYmIlBQBWvOpE,1356
-diffbot/cli/__init__.py,sha256=UVGD3uevKTHmqEdbDhhR2PzO6-3i0xu8d7D_94jLLRo,16488
+diffbot/cli/__init__.py,sha256=TLUrl6q5DHdzNMnsBFcbcV8yRMzt8Pl-lIrZl1QJQwc,16571
 diffbot/cli/__main__.py,sha256=5BjNuyet8AY-POwoF5rGt722rHQ7tJ0Vf0UFUfzzi-I,58
 diffbot/cli/_common.py,sha256=_s8WRukzSX3krjJW6HJmT7_3hEjNyv1i_y45tm81b2A,654
 diffbot/cli/dql.py,sha256=iIMaGysMWTScnbAHAdWei2iVUJpMV5lA1pk1E9uQg4s,11439
 diffbot/cli/entities.py,sha256=tsHKexF0b6NnsoUEZJUS2rJidTIE8lt6xrcSenPbwtY,5630
 diffbot/cli/ontology.py,sha256=cLuRQ0KTsOJnFCXdG_zIX9J1ODK8ThPznWVDDEpO1pg,2055
-diffbot_python-0.2.0.dist-info/METADATA,sha256=LooJOiHWS4HP8JlLvackJ2JEauezwZ2qe39xCgyhk2c,7402
-diffbot_python-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-diffbot_python-0.2.0.dist-info/entry_points.txt,sha256=FCxJhrbl7VNEsTK7zl7qYvXID7gQ1_wxhiw5_Vllb_M,40
-diffbot_python-0.2.0.dist-info/licenses/LICENSE,sha256=UZlamI1XGeiG0Mit8dsHssNhOuMGKfmNOp5qpf1533w,1063
-diffbot_python-0.2.0.dist-info/RECORD,,
+diffbot_python-0.2.3.dist-info/METADATA,sha256=PJgy6eJ8WIWEB3q2LjQv6ghRID2567FPTrTTqf5QY-M,8834
+diffbot_python-0.2.3.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+diffbot_python-0.2.3.dist-info/entry_points.txt,sha256=FCxJhrbl7VNEsTK7zl7qYvXID7gQ1_wxhiw5_Vllb_M,40
+diffbot_python-0.2.3.dist-info/licenses/LICENSE,sha256=UZlamI1XGeiG0Mit8dsHssNhOuMGKfmNOp5qpf1533w,1063
+diffbot_python-0.2.3.dist-info/RECORD,,

{diffbot_python-0.2.0.dist-info → diffbot_python-0.2.3.dist-info}/WHEEL

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