blocket-toolkit 0.1.0__tar.gz → 0.1.2__tar.gz

blocket_toolkit-0.1.2/.claude-plugin/marketplace.json

@@ -0,0 +1,24 @@
+{
+  "name": "dojje-skills",
+  "description": "Agent Skills by dojje. Portable SKILL.md skills that work in Claude Code, Codex, opencode, Copilot, Cursor and other Agent Skills compatible agents.",
+  "owner": {
+    "name": "Daniel Hidefjäll",
+    "url": "https://github.com/dojje"
+  },
+  "plugins": [
+    {
+      "name": "blocket-toolkit",
+      "source": "./",
+      "skills": ["./skills/blocket-toolkit"],
+      "strict": false,
+      "version": "0.1.2",
+      "description": "Search all of Blocket.se from the terminal: general items (torget), cars, boats, motorcycles and single ad details, with compact JSON output.",
+      "author": {
+        "name": "Daniel Hidefjäll",
+        "url": "https://github.com/dojje"
+      },
+      "category": "search",
+      "tags": ["blocket", "marketplace", "sweden", "second-hand", "cli", "cars", "boats", "motorcycles"]
+    }
+  ]
+}

{blocket_toolkit-0.1.0 → blocket_toolkit-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: blocket-toolkit
-Version: 0.1.0
+Version: 0.1.2
 Summary: Search all of Blocket.se from the terminal: general items, cars, boats and motorcycles.
 Project-URL: Homepage, https://github.com/dojje/blocket-toolkit
 Project-URL: Repository, https://github.com/dojje/blocket-toolkit
@@ -29,12 +29,19 @@ Description-Content-Type: text/markdown
 
 # blocket-toolkit
 
+[![PyPI](https://img.shields.io/pypi/v/blocket-toolkit)](https://pypi.org/project/blocket-toolkit/)
+[![Python](https://img.shields.io/pypi/pyversions/blocket-toolkit)](https://pypi.org/project/blocket-toolkit/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-6E56CF)](https://agentskills.io)
+
 Search **all of Blocket.se** from the terminal: general items (*torget*), cars, boats
 and motorcycles, with clean JSON output that is easy to pipe into other tools or hand
 to an LLM.
 
 Built on top of the [`blocket-api`](https://pypi.org/project/blocket_api/) Python
-package.
+package. Published to PyPI with
+[PEP 740 attestations](https://pypi.org/project/blocket-toolkit/) generated by GitHub
+Actions.
 
 ## Features
 
@@ -46,6 +53,7 @@ package.
 - **Self-documenting enums**: every category, subcategory, region, brand and model can
   be listed or resolved by name *or* by Blocket's internal id.
 - **Pagination**: `--page`, `-n/--limit`, or `--all`.
+- **Ships with an [Agent Skill](https://agentskills.io)** so an AI agent can drive it.
 
 ## Install
 
@@ -61,6 +69,28 @@ cd blocket-toolkit
 uv venv && uv pip install -e '.[dev]'
 ```
 
+## Use it as an agent skill
+
+[`skills/blocket-toolkit/SKILL.md`](skills/blocket-toolkit/SKILL.md) is an
+[Agent Skills](https://agentskills.io/specification) package, so an agent can pick up
+the tool and drive it on its own.
+
+```bash
+gh skill install dojje/blocket-toolkit blocket-toolkit   # GitHub CLI 2.90+
+npx skills add dojje/blocket-toolkit                    # npx skills
+```
+
+Claude Code, through the bundled plugin marketplace:
+
+```
+/plugin marketplace add dojje/blocket-toolkit
+/plugin install blocket-toolkit@dojje-skills
+```
+
+Anywhere else: clone the repo and symlink `skills/blocket-toolkit` into your agent's
+skills directory (`~/.config/opencode/skills/`, `~/.claude/skills/` or
+`~/.agents/skills/`). The skill needs the `blocket-toolkit` command on `PATH`.
+
 ## Quick start
 
 ```bash

{blocket_toolkit-0.1.0 → blocket_toolkit-0.1.2}/README.md

@@ -1,11 +1,18 @@
 # blocket-toolkit
 
+[![PyPI](https://img.shields.io/pypi/v/blocket-toolkit)](https://pypi.org/project/blocket-toolkit/)
+[![Python](https://img.shields.io/pypi/pyversions/blocket-toolkit)](https://pypi.org/project/blocket-toolkit/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-6E56CF)](https://agentskills.io)
+
 Search **all of Blocket.se** from the terminal: general items (*torget*), cars, boats
 and motorcycles, with clean JSON output that is easy to pipe into other tools or hand
 to an LLM.
 
 Built on top of the [`blocket-api`](https://pypi.org/project/blocket_api/) Python
-package.
+package. Published to PyPI with
+[PEP 740 attestations](https://pypi.org/project/blocket-toolkit/) generated by GitHub
+Actions.
 
 ## Features
 
@@ -17,6 +24,7 @@ package.
 - **Self-documenting enums**: every category, subcategory, region, brand and model can
   be listed or resolved by name *or* by Blocket's internal id.
 - **Pagination**: `--page`, `-n/--limit`, or `--all`.
+- **Ships with an [Agent Skill](https://agentskills.io)** so an AI agent can drive it.
 
 ## Install
 
@@ -32,6 +40,28 @@ cd blocket-toolkit
 uv venv && uv pip install -e '.[dev]'
 ```
 
+## Use it as an agent skill
+
+[`skills/blocket-toolkit/SKILL.md`](skills/blocket-toolkit/SKILL.md) is an
+[Agent Skills](https://agentskills.io/specification) package, so an agent can pick up
+the tool and drive it on its own.
+
+```bash
+gh skill install dojje/blocket-toolkit blocket-toolkit   # GitHub CLI 2.90+
+npx skills add dojje/blocket-toolkit                    # npx skills
+```
+
+Claude Code, through the bundled plugin marketplace:
+
+```
+/plugin marketplace add dojje/blocket-toolkit
+/plugin install blocket-toolkit@dojje-skills
+```
+
+Anywhere else: clone the repo and symlink `skills/blocket-toolkit` into your agent's
+skills directory (`~/.config/opencode/skills/`, `~/.claude/skills/` or
+`~/.agents/skills/`). The skill needs the `blocket-toolkit` command on `PATH`.
+
 ## Quick start
 
 ```bash

{blocket_toolkit-0.1.0 → blocket_toolkit-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "blocket-toolkit"
-version = "0.1.0"
+version = "0.1.2"
 description = "Search all of Blocket.se from the terminal: general items, cars, boats and motorcycles."
 readme = "README.md"
 requires-python = ">=3.10"

{blocket_toolkit-0.1.0 → blocket_toolkit-0.1.2}/skills/blocket-toolkit/SKILL.md

@@ -2,6 +2,7 @@
 name: blocket-toolkit
 description: Search all of Blocket.se (Swedish marketplace) from the terminal. Covers general items (torget), cars, boats, motorcycles and full ad details. Use when the user wants to find, search, compare or look up anything on Blocket, including begagnade prylar, fynd, priser, bilar, båtar, motorcyklar and annonsdetaljer. Output is JSON by default.
 license: MIT
+compatibility: Requires the blocket-toolkit CLI on PATH (uv tool install blocket-toolkit) and network access to blocket.se
 ---
 
 # blocket-toolkit

blocket_toolkit-0.1.2/src/blocket_toolkit/__init__.py

@@ -0,0 +1,12 @@
+"""blocket-toolkit: search all of Blocket.se from the terminal."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .client import BlocketClient, Page
+
+try:
+    __version__ = version("blocket-toolkit")
+except PackageNotFoundError:
+    __version__ = "0.0.0.dev0"
+
+__all__ = ["BlocketClient", "Page", "__version__"]

blocket_toolkit-0.1.2/tests/test_version.py

@@ -0,0 +1,19 @@
+import re
+from importlib.metadata import version
+from pathlib import Path
+
+from blocket_toolkit import __version__
+
+
+def test_version_matches_installed_metadata():
+    assert __version__ == version("blocket-toolkit")
+
+
+def test_pyproject_version_matches_installed_metadata():
+    root = Path(__file__).resolve().parents[1]
+    pyproject = (root / "pyproject.toml").read_text(encoding="utf-8")
+    declared = re.search(r'^version = "([^"]+)"', pyproject, re.MULTILINE).group(1)
+    assert declared == version("blocket-toolkit"), (
+        "pyproject version and the installed distribution disagree; "
+        "reinstall the project after bumping the version"
+    )

blocket_toolkit-0.1.0/src/blocket_toolkit/__init__.py

@@ -1,6 +0,0 @@
-"""blocket-toolkit: search all of Blocket.se from the terminal."""
-
-from .client import BlocketClient, Page
-
-__version__ = "0.1.0"
-__all__ = ["BlocketClient", "Page", "__version__"]