walla-cli 0.1.8__tar.gz → 0.1.10__tar.gz

{walla_cli-0.1.8 → walla_cli-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: walla-cli
-Version: 0.1.8
+Version: 0.1.10
 Summary: Wallapop.es CLI - look · offer · talk · sell for humans and agents
 Project-URL: Homepage, https://github.com/berendgort/wallapop-cli
 Project-URL: Repository, https://github.com/berendgort/wallapop-cli
@@ -55,12 +55,21 @@ Description-Content-Type: text/markdown
   Dr. Berend Gort  ·  www.berendgort.dev
 ```
 
-![walla banner](docs/assets/walla-github-banner.jpg)
+[![walla sell demo](docs/assets/walla-demo-preview.gif)](https://github.com/berendgort/wallapop-cli/releases/download/demo/walla-demo.mp4)
 
-**walla** is an unofficial Wallapop.es **CLI + MCP + Python library** for Cursor
-agents and humans: search listings, negotiate, publish a listing, and follow the inbox.
+▶ [Play full demo with sound](https://github.com/berendgort/wallapop-cli/releases/download/demo/walla-demo.mp4)
+· Demo music: [Funkee Monkeee](https://mixkit.co/free-stock-music/funkee-monkeee-1140/) by Michael Ramir C.
+([Mixkit Stock Music Free License](https://mixkit.co/license/#musicFree)).
 
-Not affiliated with Wallapop. Respect ToS and rate limits.
+**walla** turns Claude, GPT, or Cursor into a Wallapop helper that actually
+*does* the work for you. You drop a few photos and answer a couple of
+questions; the agent publishes the listing. When buyers message, it reads
+the chats, replies for you, and negotiates down to your minimum price —
+then shows you the best deal. You only open the Wallapop app to accept.
+No typing chats. No babysitting the inbox.
+
+Unofficial Wallapop.es CLI + MCP + Python library. Not affiliated with
+Wallapop. Respect ToS and rate limits.
 
 ### What this unlocks
 

{walla_cli-0.1.8 → walla_cli-0.1.10}/README.md

@@ -11,12 +11,21 @@
   Dr. Berend Gort  ·  www.berendgort.dev
 ```
 
-![walla banner](docs/assets/walla-github-banner.jpg)
+[![walla sell demo](docs/assets/walla-demo-preview.gif)](https://github.com/berendgort/wallapop-cli/releases/download/demo/walla-demo.mp4)
 
-**walla** is an unofficial Wallapop.es **CLI + MCP + Python library** for Cursor
-agents and humans: search listings, negotiate, publish a listing, and follow the inbox.
+▶ [Play full demo with sound](https://github.com/berendgort/wallapop-cli/releases/download/demo/walla-demo.mp4)
+· Demo music: [Funkee Monkeee](https://mixkit.co/free-stock-music/funkee-monkeee-1140/) by Michael Ramir C.
+([Mixkit Stock Music Free License](https://mixkit.co/license/#musicFree)).
 
-Not affiliated with Wallapop. Respect ToS and rate limits.
+**walla** turns Claude, GPT, or Cursor into a Wallapop helper that actually
+*does* the work for you. You drop a few photos and answer a couple of
+questions; the agent publishes the listing. When buyers message, it reads
+the chats, replies for you, and negotiates down to your minimum price —
+then shows you the best deal. You only open the Wallapop app to accept.
+No typing chats. No babysitting the inbox.
+
+Unofficial Wallapop.es CLI + MCP + Python library. Not affiliated with
+Wallapop. Respect ToS and rate limits.
 
 ### What this unlocks
 

{walla_cli-0.1.8 → walla_cli-0.1.10}/docs/WIRE.md

@@ -29,7 +29,10 @@ Public URL: `https://es.wallapop.com/item/<web_slug>`.
 
 ## Categories
 
-`GET https://api.wallapop.com/api/v3/categories` — top-level tree.
+`GET https://api.wallapop.com/api/v3/categories` — nested tree
+(`subcategories[]`). CLI: `walla categories --find escritorio --json` returns
+`leaf_id` + `root_id`. Sell accepts `--category <leaf-or-name>`; `--root` is
+optional.
 
 ## Auth
 

walla_cli-0.1.10/fixtures/categories.json

@@ -0,0 +1,59 @@
+{
+  "categories": [
+    {
+      "id": 100,
+      "name": "Cars",
+      "path": "",
+      "vertical_id": "cars",
+      "icon": "car",
+      "subcategories": [],
+      "category_leaf_selection_mandatory": false
+    },
+    {
+      "id": 12467,
+      "name": "Hogar y jardín",
+      "path": "",
+      "vertical_id": "consumer_goods",
+      "icon": "home",
+      "subcategories": [
+        {
+          "id": 10125,
+          "name": "Muebles y organización",
+          "parent_id": 12467,
+          "subcategories": [
+            {
+              "id": 24207,
+              "name": "Mesas y mesitas",
+              "parent_id": 10125,
+              "subcategories": [
+                {
+                  "id": 24208,
+                  "name": "Escritorios",
+                  "parent_id": 24207,
+                  "subcategories": []
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "category_leaf_selection_mandatory": false
+    },
+    {
+      "id": 12579,
+      "name": "Deporte y ocio",
+      "path": "",
+      "vertical_id": "consumer_goods",
+      "icon": "ball",
+      "subcategories": [
+        {
+          "id": 10105,
+          "name": "Surf y bodyboard",
+          "parent_id": 12579,
+          "subcategories": []
+        }
+      ],
+      "category_leaf_selection_mandatory": false
+    }
+  ]
+}

{walla_cli-0.1.8 → walla_cli-0.1.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "walla-cli"
-version = "0.1.8"
+version = "0.1.10"
 description = "Wallapop.es CLI - look · offer · talk · sell for humans and agents"
 authors = [{ name = "Dr. Berend Gort", email = "berend.gort@gmail.com" }]
 readme = "README.md"

{walla_cli-0.1.8 → walla_cli-0.1.10}/skills/walla-sell/SKILL.md

@@ -13,6 +13,7 @@ license: MIT
 Do not ask the human to type buyer replies. Desk sends those.
 
 ```bash
+walla categories --find escritorio --json
 walla sell ./shot1.jpg ./shot2.jpg --json
 ```
 
@@ -21,13 +22,13 @@ Ask every question in `data.questions`, then publish once:
 ```bash
 walla sell ./shot1.jpg ./shot2.jpg \
   --title "…" --desc "…" --eur 40 \
-  --category 10105 --root 12579 --condition good \
+  --category escritorio --condition good \
   --floor 35 --yes --json
 ```
 
-`--floor` is the lowest EUR desk may accept. Omit it to hold the asking price.
-Category ids come from `walla categories --json`.
-
+`--category` accepts a leaf id **or** name tokens (`escritorio`, `hogar/muebles`).
+`--root` is optional (derived from the leaf). `--floor` is the lowest EUR desk may
+accept. Omit it to hold the asking price.
 Then:
 
 ```bash

walla_cli-0.1.10/tests/test_categories_find.py

@@ -0,0 +1,58 @@
+"""Category tree find / root resolve."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import pytest
+
+from walla.search.category_find import find_categories, flatten_categories, resolve_root_id
+from walla.search.parse import parse_categories
+from walla.search.pick_category import pick_sell_category
+
+FIX = Path(__file__).resolve().parents[1] / "fixtures"
+
+
+def _roots():
+    raw = json.loads((FIX / "categories.json").read_text(encoding="utf-8"))
+    return parse_categories(raw)
+
+
+def test_parse_nested_categories() -> None:
+    roots = _roots()
+    hogar = next(c for c in roots if c.id == 12467)
+    assert hogar.subcategories
+    assert flatten_categories(roots)
+    assert resolve_root_id(roots, "24208") == "12467"
+    assert resolve_root_id(roots, "10105") == "12579"
+
+
+def test_find_escritorio() -> None:
+    hits = find_categories(_roots(), "escritorio")
+    assert hits
+    assert hits[0].leaf_id == "24208"
+    assert hits[0].root_id == "12467"
+    assert hits[0].is_leaf
+
+
+def test_pick_by_name_and_id() -> None:
+    roots = _roots()
+    by_name = pick_sell_category(roots, category="escritorio")
+    assert by_name.leaf_id == "24208"
+    assert by_name.root_id == "12467"
+    by_id = pick_sell_category(roots, category="24208")
+    assert by_id.leaf_id == "24208"
+    assert by_id.root_id == "12467"
+    forced = pick_sell_category(roots, category="10105", root="12579")
+    assert forced.root_id == "12579"
+
+
+def test_find_empty_and_unknown() -> None:
+    with pytest.raises(ValueError, match="empty"):
+        find_categories(_roots(), "   ")
+    assert find_categories(_roots(), "zzzz-no-such") == []
+    with pytest.raises(ValueError, match="unknown"):
+        resolve_root_id(_roots(), "999999")
+    with pytest.raises(ValueError, match="no category matches"):
+        pick_sell_category(_roots(), category="zzzz-no-such")

{walla_cli-0.1.8 → walla_cli-0.1.10}/tests/test_parsers.py

@@ -36,3 +36,5 @@ def test_parse_categories_fixture() -> None:
     assert len(cats) >= 1
     assert cats[0].id
     assert cats[0].name
+    hogar = next(c for c in cats if c.id == 12467)
+    assert any(s.name == "Muebles y organización" for s in hogar.subcategories)

{walla_cli-0.1.8 → walla_cli-0.1.10}/tests/test_sell.py

@@ -14,6 +14,7 @@ from walla.account.sell_wire import (
     build_item_body,
     missing_sell_fields,
 )
+from walla.core.exceptions import WallaHTTPError
 
 ROOT = Path(__file__).resolve().parents[1]
 FIXTURE = ROOT / "fixtures" / "sell_item_request.json"
@@ -130,6 +131,9 @@ def test_publish_listing_mocked(tmp_path: Path) -> None:
         {"step": {"id": "listing"}},
     ]
     fake_http.get.return_value = {}
+    listing = MagicMock()
+    listing.url = "https://es.wallapop.com/item/test-item-99"
+    listing.web_slug = "test-item-99"
     with (
         patch("walla.account.sell._auth_client", return_value=fake_http),
         patch("walla.account.sell.upload_pictures", return_value=1),
@@ -137,6 +141,7 @@ def test_publish_listing_mocked(tmp_path: Path) -> None:
             "walla.account.sell.create_listing",
             return_value={"id": "abc123", "flags": {}},
         ),
+        patch("walla.account.sell.get_item", return_value=listing),
     ):
         out = publish_listing(
             [photo],
@@ -150,6 +155,7 @@ def test_publish_listing_mocked(tmp_path: Path) -> None:
         )
     assert out["id"] == "abc123"
     assert out["photos"] == 1
+    assert out["url"] == "https://es.wallapop.com/item/test-item-99"
     assert fake_http.post.call_count == 5
 
 
@@ -217,6 +223,9 @@ def test_publish_listing_two_photos(tmp_path: Path) -> None:
     fake_resp.text = ""
     fake_session = MagicMock()
     fake_session.request.return_value = fake_resp
+    listing = MagicMock()
+    listing.url = "https://es.wallapop.com/item/test-item-99"
+    listing.web_slug = "test-item-99"
     with (
         patch("walla.account.sell._auth_client", return_value=fake_http),
         patch("walla.account.sell.upload_pictures", return_value=2),
@@ -224,6 +233,7 @@ def test_publish_listing_two_photos(tmp_path: Path) -> None:
             "walla.account.sell.create_listing",
             return_value={"id": "abc123", "flags": {}},
         ),
+        patch("walla.account.sell.get_item", return_value=listing),
         patch("walla.account.sell._auth_headers", return_value={}),
         patch("walla.account.sell.requests.Session", return_value=fake_session),
         patch("walla.account.sell.CurlMime") as mime_cls,
@@ -243,9 +253,27 @@ def test_publish_listing_two_photos(tmp_path: Path) -> None:
             weight_kg=2,
         )
     assert out["photos"] == 2
+    assert out["url"] == "https://es.wallapop.com/item/test-item-99"
     fake_session.request.assert_called()
 
 
+def test_public_item_url_uses_slug_not_hash() -> None:
+    from walla.account.sell import _public_item_url
+
+    listing = MagicMock()
+    listing.url = ""
+    listing.web_slug = "escritorio-madera-1309402890"
+    with patch("walla.account.sell.get_item", return_value=listing):
+        assert _public_item_url("x6qq0n82pe6y").endswith(
+            "/item/escritorio-madera-1309402890"
+        )
+    with patch(
+        "walla.account.sell.get_item",
+        side_effect=WallaHTTPError("down", status_code=500),
+    ):
+        assert _public_item_url("x6qq0n82pe6y").endswith("/item/x6qq0n82pe6y")
+
+
 def test_assert_item_body_errors() -> None:
     with pytest.raises(ValueError, match="missing"):
         assert_item_body({})