diffbot-python 0.2.0__tar.gz → 0.2.3__tar.gz

{diffbot_python-0.2.0 → diffbot_python-0.2.3}/PKG-INFO

@@ -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 → diffbot_python-0.2.3}/README.md

@@ -5,11 +5,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]"
@@ -202,6 +210,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
 
@@ -216,6 +240,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 → diffbot_python-0.2.3}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "diffbot-python"
-version = "0.2.0"
+version = "0.2.3"
 description = "Python client library for Diffbot APIs"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.9"
 license = "MIT"
 license-files = ["LICEN[CS]E*"]
 authors = [
@@ -30,6 +30,7 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",

{diffbot_python-0.2.0 → diffbot_python-0.2.3}/src/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_python-0.2.0 → diffbot_python-0.2.3}/src/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.