tradera-cli 0.1.0__tar.gz

tradera_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johnny W
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tradera_cli-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: tradera-cli
+Version: 0.1.0
+Summary: CLI for Tradera web endpoints
+Author: Johnny W
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Paatsu/tradera-cli
+Project-URL: Repository, https://github.com/Paatsu/tradera-cli
+Project-URL: Issues, https://github.com/Paatsu/tradera-cli/issues
+Keywords: cli,tradera,marketplace,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Dynamic: license-file
+
+# tradera-cli
+
+Fast CLI for searching public Tradera listings from the terminal.
+
+Designed for scripts, agents, and quick lookups with structured output.
+
+## Install
+
+From PyPI:
+
+```bash
+pip install tradera-cli
+```
+
+With `uv`:
+
+```bash
+uv tool install tradera-cli
+```
+
+With `pipx`:
+
+```bash
+pipx install tradera-cli
+```
+
+Upgrade:
+
+```bash
+pip install --upgrade tradera-cli
+```
+
+## Usage
+
+### Search listings
+
+```bash
+tradera search "iphone"
+tradera search "pokemon" --page 2 --page-size 20
+tradera search "kamera" --sort AddedOn --format json
+tradera search "klocka" --country SE --lang sv --format jsonl
+```
+
+### Get item details
+
+```bash
+tradera item 717898129
+tradera item 717898129 --format json
+tradera item "https://www.tradera.com/item/340186/717885898/iphone-12-pro"
+```
+
+### Browse categories
+
+```bash
+tradera categories --level 1
+tradera categories --level 2 --lang sv --format json
+```
+
+## Output formats
+
+| Format | Description | Best for |
+|---|---|---|
+| `table` (default) | Human-readable table | Interactive terminal use |
+| `json` | Pretty JSON object | `jq`, scripts, integrations |
+| `jsonl` | One JSON object per line | Streaming/log pipelines |
+
+## Common options
+
+Search command (`tradera search`) supports:
+
+| Option | Description |
+|---|---|
+| `--page` | Page number (default: `1`) |
+| `--page-size` | Results per page (default: `50`) |
+| `--sort` | Sort mode (default: `Relevance`) |
+| `--lang` | Language code (default: `sv`) |
+| `--country` | Shipping country code (default: `SE`) |
+| `--no-translate` | Disable automatic translation preference |
+| `--format` | Output format: `table`, `json`, `jsonl` |
+
+## Development
+
+From source:
+
+```bash
+git clone https://github.com/Paatsu/tradera-cli.git
+cd tradera-cli
+pip install -e .[dev]
+```
+
+Build distributions:
+
+```bash
+python -m build
+```
+
+Check the package metadata before upload:
+
+```bash
+python -m twine check dist/*
+```
+
+Run tests:
+
+```bash
+pytest -q
+```
+
+## Agent integration
+
+Examples for automation:
+
+```bash
+# Take first 3 listings as JSON
+tradera search "iphone" --format json | jq '.items[:3]'
+
+# Stream listings line-by-line
+tradera search "lego" --format jsonl
+
+# Pull one item as machine-readable JSON
+tradera item 717898129 --format json
+```
+
+## Notes
+
+- Uses web endpoints from Tradera's frontend.
+- Anonymous client token is fetched automatically when needed.
+- Endpoint behavior can change over time.

tradera_cli-0.1.0/README.md

@@ -0,0 +1,128 @@
+# tradera-cli
+
+Fast CLI for searching public Tradera listings from the terminal.
+
+Designed for scripts, agents, and quick lookups with structured output.
+
+## Install
+
+From PyPI:
+
+```bash
+pip install tradera-cli
+```
+
+With `uv`:
+
+```bash
+uv tool install tradera-cli
+```
+
+With `pipx`:
+
+```bash
+pipx install tradera-cli
+```
+
+Upgrade:
+
+```bash
+pip install --upgrade tradera-cli
+```
+
+## Usage
+
+### Search listings
+
+```bash
+tradera search "iphone"
+tradera search "pokemon" --page 2 --page-size 20
+tradera search "kamera" --sort AddedOn --format json
+tradera search "klocka" --country SE --lang sv --format jsonl
+```
+
+### Get item details
+
+```bash
+tradera item 717898129
+tradera item 717898129 --format json
+tradera item "https://www.tradera.com/item/340186/717885898/iphone-12-pro"
+```
+
+### Browse categories
+
+```bash
+tradera categories --level 1
+tradera categories --level 2 --lang sv --format json
+```
+
+## Output formats
+
+| Format | Description | Best for |
+|---|---|---|
+| `table` (default) | Human-readable table | Interactive terminal use |
+| `json` | Pretty JSON object | `jq`, scripts, integrations |
+| `jsonl` | One JSON object per line | Streaming/log pipelines |
+
+## Common options
+
+Search command (`tradera search`) supports:
+
+| Option | Description |
+|---|---|
+| `--page` | Page number (default: `1`) |
+| `--page-size` | Results per page (default: `50`) |
+| `--sort` | Sort mode (default: `Relevance`) |
+| `--lang` | Language code (default: `sv`) |
+| `--country` | Shipping country code (default: `SE`) |
+| `--no-translate` | Disable automatic translation preference |
+| `--format` | Output format: `table`, `json`, `jsonl` |
+
+## Development
+
+From source:
+
+```bash
+git clone https://github.com/Paatsu/tradera-cli.git
+cd tradera-cli
+pip install -e .[dev]
+```
+
+Build distributions:
+
+```bash
+python -m build
+```
+
+Check the package metadata before upload:
+
+```bash
+python -m twine check dist/*
+```
+
+Run tests:
+
+```bash
+pytest -q
+```
+
+## Agent integration
+
+Examples for automation:
+
+```bash
+# Take first 3 listings as JSON
+tradera search "iphone" --format json | jq '.items[:3]'
+
+# Stream listings line-by-line
+tradera search "lego" --format jsonl
+
+# Pull one item as machine-readable JSON
+tradera item 717898129 --format json
+```
+
+## Notes
+
+- Uses web endpoints from Tradera's frontend.
+- Anonymous client token is fetched automatically when needed.
+- Endpoint behavior can change over time.

tradera_cli-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tradera-cli"
+version = "0.1.0"
+description = "CLI for Tradera web endpoints"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "Johnny W" },
+]
+keywords = ["cli", "tradera", "marketplace", "terminal"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Internet",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "requests>=2.32.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Paatsu/tradera-cli"
+Repository = "https://github.com/Paatsu/tradera-cli"
+Issues = "https://github.com/Paatsu/tradera-cli/issues"
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2.2",
+  "pytest>=8.0.0",
+  "pytest-cov>=5.0.0",
+  "twine>=5.1.1",
+]
+
+[project.scripts]
+tradera = "tradera_cli.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["tradera_cli*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

tradera_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tradera_cli-0.1.0/tests/test_api.py

@@ -0,0 +1,246 @@
+from __future__ import annotations
+
+import requests
+import pytest
+
+from tradera_cli.api import TraderaApiError, TraderaClient, parse_item_id
+
+
+class FakeResponse:
+    def __init__(
+        self,
+        status_code: int = 200,
+        reason: str = "OK",
+        headers: dict[str, str] | None = None,
+        json_data: object | None = None,
+        text: str = "",
+        bad_json: bool = False,
+    ) -> None:
+        self.status_code = status_code
+        self.reason = reason
+        self.headers = headers or {}
+        self._json_data = json_data
+        self.text = text
+        self._bad_json = bad_json
+
+    def json(self) -> object:
+        if self._bad_json:
+            raise ValueError("bad json")
+        return self._json_data
+
+
+class FakeSession:
+    def __init__(
+        self,
+        request_results: list[FakeResponse | Exception] | None = None,
+        post_results: list[FakeResponse | Exception] | None = None,
+    ) -> None:
+        self.request_results = request_results or []
+        self.post_results = post_results or []
+        self.request_calls: list[dict[str, object]] = []
+        self.post_calls: list[dict[str, object]] = []
+        self.cookies: dict[str, str] = {}
+        self.headers: dict[str, str] = {}
+
+    def request(self, method: str, url: str, **kwargs: object) -> FakeResponse:
+        self.request_calls.append({"method": method, "url": url, **kwargs})
+        result = self.request_results.pop(0)
+        if isinstance(result, Exception):
+            raise result
+        return result
+
+    def post(self, url: str, **kwargs: object) -> FakeResponse:
+        self.post_calls.append({"url": url, **kwargs})
+        result = self.post_results.pop(0)
+        if isinstance(result, Exception):
+            raise result
+        return result
+
+
+def test_request_returns_json_and_sets_content_type() -> None:
+    client = TraderaClient()
+    fake = FakeSession(
+        request_results=[
+            FakeResponse(headers={"content-type": "application/json"}, json_data={"ok": True})
+        ]
+    )
+    client.session = fake
+
+    result = client._request("POST", "/public", json={"a": 1})
+
+    assert result == {"ok": True}
+    assert fake.request_calls[0]["headers"] == {"content-type": "application/json"}
+
+
+def test_request_returns_text_for_non_json_response() -> None:
+    client = TraderaClient()
+    fake = FakeSession(request_results=[FakeResponse(headers={"content-type": "text/html"}, text="hello")])
+    client.session = fake
+
+    result = client._request("GET", "/public")
+
+    assert result == "hello"
+
+
+def test_request_ensures_token_and_retries_on_401(monkeypatch: pytest.MonkeyPatch) -> None:
+    client = TraderaClient()
+    fake = FakeSession(
+        request_results=[
+            FakeResponse(status_code=401, reason="Unauthorized", headers={"content-type": "application/json"}),
+            FakeResponse(headers={"content-type": "application/json"}, json_data={"ok": 1}),
+        ]
+    )
+    client.session = fake
+
+    calls: list[bool] = []
+
+    def fake_ensure(force: bool = False) -> None:
+        calls.append(force)
+
+    monkeypatch.setattr(client, "_ensure_client_token", fake_ensure)
+
+    result = client._request("GET", "/api/webapi/discover/web/independent-search")
+
+    assert result == {"ok": 1}
+    assert calls == [False, True]
+
+
+def test_request_raises_for_http_error() -> None:
+    client = TraderaClient()
+    fake = FakeSession(request_results=[FakeResponse(status_code=500, reason="Server Error")])
+    client.session = fake
+
+    with pytest.raises(TraderaApiError, match="500 Server Error"):
+        client._request("GET", "/public")
+
+
+def test_request_wraps_request_exception() -> None:
+    client = TraderaClient()
+    fake = FakeSession(request_results=[requests.RequestException("boom")])
+    client.session = fake
+
+    with pytest.raises(TraderaApiError, match="Request failed"):
+        client._request("GET", "/public")
+
+
+def test_request_wraps_retry_exception(monkeypatch: pytest.MonkeyPatch) -> None:
+    client = TraderaClient()
+    fake = FakeSession(
+        request_results=[
+            FakeResponse(status_code=400, reason="Bad Request"),
+            requests.RequestException("retry boom"),
+        ]
+    )
+    client.session = fake
+    monkeypatch.setattr(client, "_ensure_client_token", lambda force=False: None)
+
+    with pytest.raises(TraderaApiError, match="Request retry failed"):
+        client._request("GET", "/ajax/item/123")
+
+
+def test_request_raises_on_bad_json() -> None:
+    client = TraderaClient()
+    fake = FakeSession(request_results=[FakeResponse(headers={"content-type": "application/json"}, bad_json=True)])
+    client.session = fake
+
+    with pytest.raises(TraderaApiError, match="Invalid JSON response"):
+        client._request("GET", "/public")
+
+
+def test_ensure_client_token_skips_when_cookie_exists() -> None:
+    client = TraderaClient()
+    fake = FakeSession()
+    fake.cookies["trd_at"] = "token"
+    client.session = fake
+
+    client._ensure_client_token()
+
+    assert fake.post_calls == []
+
+
+def test_ensure_client_token_success_and_force() -> None:
+    client = TraderaClient()
+    fake = FakeSession(post_results=[FakeResponse(status_code=200)])
+    fake.cookies["trd_at"] = "token"
+    client.session = fake
+
+    client._ensure_client_token(force=True)
+
+    assert len(fake.post_calls) == 1
+
+
+def test_ensure_client_token_wraps_request_exception() -> None:
+    client = TraderaClient()
+    fake = FakeSession(post_results=[requests.RequestException("nope")])
+    client.session = fake
+
+    with pytest.raises(TraderaApiError, match="Failed to establish anonymous client token"):
+        client._ensure_client_token()
+
+
+def test_ensure_client_token_raises_on_http_error() -> None:
+    client = TraderaClient()
+    fake = FakeSession(post_results=[FakeResponse(status_code=500)])
+    client.session = fake
+
+    with pytest.raises(TraderaApiError, match="Failed to establish anonymous client token"):
+        client._ensure_client_token()
+
+
+def test_search_builds_payload() -> None:
+    client = TraderaClient()
+    captured: dict[str, object] = {}
+
+    def fake_request(method: str, path: str, **kwargs: object) -> dict[str, object]:
+        captured["method"] = method
+        captured["path"] = path
+        captured["json"] = kwargs["json"]
+        return {"items": []}
+
+    client._request = fake_request  # type: ignore[method-assign]
+
+    result = client.search("kamera", page=2, page_size=10, sort_by="EndDate")
+
+    assert result == {"items": []}
+    assert captured["method"] == "POST"
+    assert captured["path"] == "/api/webapi/discover/web/independent-search"
+    payload = captured["json"]
+    assert isinstance(payload, dict)
+    assert payload["query"] == "kamera"
+    assert payload["page"] == 2
+    assert payload["pageSize"] == 10
+    assert payload["sortBy"] == "EndDate"
+
+
+def test_item_returns_dict_or_raises() -> None:
+    client = TraderaClient()
+    client._request = lambda *_args, **_kwargs: {"itemId": 123}  # type: ignore[method-assign]
+    assert client.item(123)["itemId"] == 123
+
+    client._request = lambda *_args, **_kwargs: "not a dict"  # type: ignore[method-assign]
+    with pytest.raises(TraderaApiError, match="Unexpected item response"):
+        client.item(123)
+
+
+def test_categories_calls_expected_path() -> None:
+    client = TraderaClient()
+    captured: dict[str, str] = {}
+
+    def fake_request(method: str, path: str, **_kwargs: object) -> list[dict[str, object]]:
+        captured["method"] = method
+        captured["path"] = path
+        return [{"id": 1}]
+
+    client._request = fake_request  # type: ignore[method-assign]
+
+    result = client.categories(level=2, lang="en")
+
+    assert result == [{"id": 1}]
+    assert captured == {"method": "GET", "path": "/api/categories/2?languageCodeIso2=en&next=1"}
+
+
+def test_parse_item_id_from_digits_and_url_and_invalid() -> None:
+    assert parse_item_id("123456") == 123456
+    assert parse_item_id("https://www.tradera.com/item/123456789/test") == 123456789
+    with pytest.raises(ValueError, match="Could not parse item id"):
+        parse_item_id("https://www.tradera.com/item/no-id")