scrapebadger-cli 0.26.0__tar.gz → 0.27.0__tar.gz

{scrapebadger_cli-0.26.0 → scrapebadger_cli-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scrapebadger-cli
-Version: 0.26.0
+Version: 0.27.0
 Summary: ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line
 Author: ScrapeBadger Team
 License: MIT
@@ -169,3 +169,48 @@ scrapebadger bestbuy search "laptop"
 Run `scrapebadger <api> --help` to list product, review, store, availability and
 reference commands for that API. Each command supports `--help` for its exact
 parameters. Requests use your API key's existing permissions and credit balance.
+
+### GitHub public profiles
+
+Prepared for the GitHub API rollout. Use a login or @handle, not a URL.
+All modes cost 10 credits per successful request. `--year` is overview-only,
+`--page` repositories-only, and `--next-page-token` stars-only (users only).
+
+```bash
+scrapebadger github profile sindresorhus --year 2024
+scrapebadger github profile rails --tab repositories --page 2
+scrapebadger github profile sindresorhus --tab stars --next-page-token OPAQUE_TOKEN
+```
+
+These examples are representative; see https://docs.scrapebadger.com/github/profiles.
+
+### AutoScout24 vehicle search
+
+Search vehicle cards across eight European marketplaces. Listing detail is not included.
+
+```bash
+scrapebadger autoscout24 search --market de --make volkswagen --model golf --price-max 20000
+scrapebadger autoscout24 search --market it --make volkswagen --model golf --sort-by price_asc --page 2
+scrapebadger autoscout24 filters --market de --make volkswagen
+scrapebadger autoscout24 markets
+```
+
+Ranges use `--price-min/--price-max` (EUR), `--mileage-min/--mileage-max` (km),
+`--year-min/--year-max` (first registration) and `--power-min/--power-max` (kW).
+Use `--help` for fuel, transmission, body, seller, condition and postcode/radius filters.
+Follow the response's `next_page`; the source caps browsing at 200 pages per query.
+## Brave Search
+
+```bash
+scrapebadger brave search "coffee machine" --country de --ui-language de-de --freshness week
+scrapebadger brave images "golden retriever" --count 10
+scrapebadger brave videos "espresso tutorial" --page 2
+scrapebadger brave news "technology" --count 10
+scrapebadger brave autocomplete "coff"
+scrapebadger brave locales
+```
+
+Web/video `--page` is a 1-based native page ordinal; `--count` trims one source
+page without changing its boundaries. Images/news return an initial batch.
+JSON output preserves the complete response, including rich blocks and native
+query alteration metadata. Use `brave locales` for country/UI-language codes.

{scrapebadger_cli-0.26.0 → scrapebadger_cli-0.27.0}/README.md

@@ -147,3 +147,48 @@ scrapebadger bestbuy search "laptop"
 Run `scrapebadger <api> --help` to list product, review, store, availability and
 reference commands for that API. Each command supports `--help` for its exact
 parameters. Requests use your API key's existing permissions and credit balance.
+
+### GitHub public profiles
+
+Prepared for the GitHub API rollout. Use a login or @handle, not a URL.
+All modes cost 10 credits per successful request. `--year` is overview-only,
+`--page` repositories-only, and `--next-page-token` stars-only (users only).
+
+```bash
+scrapebadger github profile sindresorhus --year 2024
+scrapebadger github profile rails --tab repositories --page 2
+scrapebadger github profile sindresorhus --tab stars --next-page-token OPAQUE_TOKEN
+```
+
+These examples are representative; see https://docs.scrapebadger.com/github/profiles.
+
+### AutoScout24 vehicle search
+
+Search vehicle cards across eight European marketplaces. Listing detail is not included.
+
+```bash
+scrapebadger autoscout24 search --market de --make volkswagen --model golf --price-max 20000
+scrapebadger autoscout24 search --market it --make volkswagen --model golf --sort-by price_asc --page 2
+scrapebadger autoscout24 filters --market de --make volkswagen
+scrapebadger autoscout24 markets
+```
+
+Ranges use `--price-min/--price-max` (EUR), `--mileage-min/--mileage-max` (km),
+`--year-min/--year-max` (first registration) and `--power-min/--power-max` (kW).
+Use `--help` for fuel, transmission, body, seller, condition and postcode/radius filters.
+Follow the response's `next_page`; the source caps browsing at 200 pages per query.
+## Brave Search
+
+```bash
+scrapebadger brave search "coffee machine" --country de --ui-language de-de --freshness week
+scrapebadger brave images "golden retriever" --count 10
+scrapebadger brave videos "espresso tutorial" --page 2
+scrapebadger brave news "technology" --count 10
+scrapebadger brave autocomplete "coff"
+scrapebadger brave locales
+```
+
+Web/video `--page` is a 1-based native page ordinal; `--count` trims one source
+page without changing its boundaries. Images/news return an initial batch.
+JSON output preserves the complete response, including rich blocks and native
+query alteration metadata. Use `brave locales` for country/UI-language codes.

{scrapebadger_cli-0.26.0 → scrapebadger_cli-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "scrapebadger-cli"
-version = "0.26.0"
+version = "0.27.0"
 description = "ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line"
 requires-python = ">=3.10"
 license = {text = "MIT"}

scrapebadger_cli-0.27.0/src/scrapebadger_cli/commands/autoscout24.py

@@ -0,0 +1,88 @@
+"""AutoScout24 vehicle listing search commands."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+FMT = typer.Option("json", "--output", "-o", help="Output format: json, csv, table, markdown")
+FIELDS = typer.Option(None, "--fields", "-f", help="Comma-separated response fields")
+
+
+@app.command()
+def search(
+    market: str = typer.Option("de", "--market", help="de, at, be, es, fr, it, lu or nl"),
+    make: str | None = typer.Option(None, "--make", help="Native make slug, e.g. volkswagen"),
+    model: str | None = typer.Option(
+        None, "--model", help="Native model slug, e.g. golf; requires make"
+    ),
+    price_min: int | None = typer.Option(None, "--price-min", help="price min"),
+    price_max: int | None = typer.Option(None, "--price-max", help="price max"),
+    mileage_min: int | None = typer.Option(None, "--mileage-min", help="mileage min"),
+    mileage_max: int | None = typer.Option(None, "--mileage-max", help="mileage max"),
+    year_min: int | None = typer.Option(None, "--year-min", help="year min"),
+    year_max: int | None = typer.Option(None, "--year-max", help="year max"),
+    power_min: int | None = typer.Option(None, "--power-min", help="Minimum power in kW"),
+    power_max: int | None = typer.Option(None, "--power-max", help="Maximum power in kW"),
+    fuel_type: str | None = typer.Option(None, "--fuel-type", help="fuel type"),
+    transmission: str | None = typer.Option(None, "--transmission", help="transmission"),
+    body_type: str | None = typer.Option(None, "--body-type", help="body type"),
+    seller_type: str | None = typer.Option(None, "--seller-type", help="seller type"),
+    condition: str | None = typer.Option(None, "--condition", help="condition"),
+    zip: str | None = typer.Option(None, "--zip", help="zip"),
+    radius: int | None = typer.Option(None, "--radius", help="radius"),
+    sort_by: str = typer.Option("best_match", "--sort-by", help="sort by"),
+    page: int = typer.Option(1, "--page", help="Page 1–200; follow next_page"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search live vehicle listings. 5 credits; genuine empty results free."""
+    data = api_get(
+        "/v1/autoscout24/search",
+        {
+            "market": market,
+            "make": make,
+            "model": model,
+            "price_min": price_min,
+            "price_max": price_max,
+            "mileage_min": mileage_min,
+            "mileage_max": mileage_max,
+            "year_min": year_min,
+            "year_max": year_max,
+            "power_min": power_min,
+            "power_max": power_max,
+            "fuel_type": fuel_type,
+            "transmission": transmission,
+            "body_type": body_type,
+            "seller_type": seller_type,
+            "condition": condition,
+            "zip": zip,
+            "radius": radius,
+            "sort_by": sort_by,
+            "page": page,
+        },
+    )
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def filters(
+    market: str = typer.Option("de", "--market"),
+    make: str | None = typer.Option(None, "--make"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Current native vehicle filters. 2 credits."""
+    render(
+        api_get("/v1/autoscout24/filters", {"market": market, "make": make}),
+        fmt,
+        fields,
+        preserve_envelope=True,
+    )
+
+
+@app.command()
+def markets(fmt: str = FMT, fields: str | None = FIELDS) -> None:
+    """List eight supported European marketplaces. Free."""
+    render(api_get("/v1/autoscout24/markets"), fmt, fields, preserve_envelope=True)

scrapebadger_cli-0.27.0/src/scrapebadger_cli/commands/brave.py

@@ -0,0 +1,163 @@
+"""Native Brave Search commands; page ordinals and locale controls match the API."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+FMT = typer.Option("json", "--output", "-o", help="Output: json, csv, table, markdown")
+FIELDS = typer.Option(None, "--fields", "-f", help="Comma-separated response fields")
+
+
+@app.command()
+def search(
+    query: str = typer.Argument(..., help="Search keywords"),
+    country: str = typer.Option(
+        "us", "--country", help="Result region; use locales for valid codes"
+    ),
+    ui_language: str = typer.Option(
+        "en-us", "--ui-language", help="UI-label language; does not restrict result language"
+    ),
+    safe_search: str = typer.Option("moderate", "--safe-search", help="off, moderate, strict"),
+    page: int = typer.Option(1, "--page", help="1-based native page ordinal (1–10)"),
+    count: int = typer.Option(
+        20, "--count", help="Trim one source page/batch; does not change page boundaries"
+    ),
+    freshness: str = typer.Option("any", "--freshness", help="any, day, week, month, year"),
+    spellcheck: bool = typer.Option(
+        False, "--spellcheck/--no-spellcheck", help="Allow native spelling correction"
+    ),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search native Brave web results and rich blocks. Page is a 1-based native page; count trims one page. Seven credits."""
+    data = api_get(
+        "/v1/brave/search",
+        {
+            "query": query,
+            "country": country,
+            "ui_language": ui_language,
+            "safe_search": safe_search,
+            "page": page,
+            "count": count,
+            "freshness": freshness,
+            "spellcheck": spellcheck,
+        },
+    )
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def images(
+    query: str = typer.Argument(..., help="Search keywords"),
+    country: str = typer.Option(
+        "us", "--country", help="Result region; use locales for valid codes"
+    ),
+    ui_language: str = typer.Option(
+        "en-us", "--ui-language", help="UI-label language; does not restrict result language"
+    ),
+    safe_search: str = typer.Option("moderate", "--safe-search", help="off, moderate, strict"),
+    count: int = typer.Option(
+        50, "--count", help="Trim one source page/batch; does not change page boundaries"
+    ),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search the initial native Brave image batch. Count trims the batch; no pagination. Seven credits."""
+    data = api_get(
+        "/v1/brave/images",
+        {
+            "query": query,
+            "country": country,
+            "ui_language": ui_language,
+            "safe_search": safe_search,
+            "count": count,
+        },
+    )
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def videos(
+    query: str = typer.Argument(..., help="Search keywords"),
+    country: str = typer.Option(
+        "us", "--country", help="Result region; use locales for valid codes"
+    ),
+    ui_language: str = typer.Option(
+        "en-us", "--ui-language", help="UI-label language; does not restrict result language"
+    ),
+    safe_search: str = typer.Option("moderate", "--safe-search", help="off, moderate, strict"),
+    page: int = typer.Option(1, "--page", help="1-based native page ordinal (1–10)"),
+    count: int = typer.Option(
+        50, "--count", help="Trim one source page/batch; does not change page boundaries"
+    ),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search native Brave videos using 1-based page ordinals. Count trims one page. Seven credits."""
+    data = api_get(
+        "/v1/brave/videos",
+        {
+            "query": query,
+            "country": country,
+            "ui_language": ui_language,
+            "safe_search": safe_search,
+            "page": page,
+            "count": count,
+        },
+    )
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def news(
+    query: str = typer.Argument(..., help="Search keywords"),
+    country: str = typer.Option(
+        "us", "--country", help="Result region; use locales for valid codes"
+    ),
+    ui_language: str = typer.Option(
+        "en-us", "--ui-language", help="UI-label language; does not restrict result language"
+    ),
+    safe_search: str = typer.Option("moderate", "--safe-search", help="off, moderate, strict"),
+    count: int = typer.Option(
+        35, "--count", help="Trim one source page/batch; does not change page boundaries"
+    ),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search the initial native Brave news batch. Relative source ages stay display strings. Seven credits."""
+    data = api_get(
+        "/v1/brave/news",
+        {
+            "query": query,
+            "country": country,
+            "ui_language": ui_language,
+            "safe_search": safe_search,
+            "count": count,
+        },
+    )
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def locales(
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """List native Brave country and UI-language choices. Free."""
+    data = api_get("/v1/brave/locales")
+    render(data, fmt, fields, preserve_envelope=True)
+
+
+@app.command()
+def autocomplete(
+    query: str = typer.Argument(..., help="Partial search query"),
+    country: str = typer.Option("us", "--country", help="Native region code; see locales"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get native Brave search-box suggestions and entity metadata. Two credits."""
+    data = api_get("/v1/brave/autocomplete", {"query": query, "country": country})
+    render(data, fmt, fields, preserve_envelope=True)

scrapebadger_cli-0.27.0/src/scrapebadger_cli/commands/github.py

@@ -0,0 +1,40 @@
+"""GitHub public profile commands."""
+
+from enum import Enum
+from urllib.parse import quote
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+
+class ProfileTab(str, Enum):
+    overview = "overview"
+    repositories = "repositories"
+    stars = "stars"
+
+
+@app.command()
+def profile(
+    username: str = typer.Argument(..., help="GitHub login or @handle, not a profile URL"),
+    tab: ProfileTab = typer.Option(
+        ProfileTab.overview, "--tab", help="Profile tab; stars is user-only"
+    ),
+    year: int | None = typer.Option(None, "--year", help="Overview only: whole calendar year"),
+    page: int | None = typer.Option(None, "--page", min=1, help="Repositories only: page number"),
+    next_page_token: str | None = typer.Option(
+        None, "--next-page-token", help="Stars only: opaque next-page token"
+    ),
+    fmt: str = typer.Option("json", "--output", "-o", help="json, csv, table, markdown"),
+    fields: str | None = typer.Option(None, "--fields", "-f", help="Comma-separated output fields"),
+) -> None:
+    """Get a public user or organization profile. All tabs cost 10 credits."""
+    params = {"tab": tab.value, "year": year, "page": page, "next_page_token": next_page_token}
+    data = api_get(
+        f"/v1/github/profiles/{quote(username, safe='')}",
+        {key: value for key, value in params.items() if value is not None},
+    )
+    render(data, fmt, fields, preserve_envelope=True)

{scrapebadger_cli-0.26.0 → scrapebadger_cli-0.27.0}/src/scrapebadger_cli/main.py

@@ -12,10 +12,12 @@ from scrapebadger_cli.commands import (
     app_store,
     asos,
     auth,
+    autoscout24,
     baidu,
     bestbuy,
     bing,
     booking,
+    brave,
     chatgpt,
     copilot,
     depop,
@@ -24,6 +26,7 @@ from scrapebadger_cli.commands import (
     etsy,
     facebook,
     gemini,
+    github,
     google,
     google_play,
     gumtree,
@@ -75,6 +78,7 @@ def _main(
 
 app.add_typer(twitter.app, name="twitter", help="Twitter/X data commands")
 app.add_typer(reddit.app, name="reddit", help="Reddit data commands")
+app.add_typer(github.app, name="github", help="GitHub public profile commands")
 app.add_typer(instagram.app, name="instagram", help="Instagram data commands")
 app.add_typer(stream.app, name="stream", help="Real-time streaming commands")
 app.add_typer(vinted.app, name="vinted", help="Vinted marketplace commands")
@@ -97,6 +101,7 @@ app.add_typer(youtube.app, name="youtube", help="YouTube commands")
 app.add_typer(zillow.app, name="zillow", help="Zillow real-estate commands")
 app.add_typer(web.app, name="web", help="Web scraping commands")
 app.add_typer(google.app, name="google", help="Google scraper commands")
+app.add_typer(brave.app, name="brave", help="Brave native web, image, video and news search")
 app.add_typer(bing.app, name="bing", help="Bing search engine commands")
 app.add_typer(yahoo.app, name="yahoo", help="Yahoo search engine commands")
 app.add_typer(baidu.app, name="baidu", help="Baidu search engine commands")
@@ -116,6 +121,7 @@ app.add_typer(apartments.app, name="apartments", help="Apartments.com rental com
 app.add_typer(linkedin.app, name="linkedin", help="LinkedIn public data commands")
 app.add_typer(chatgpt.app, name="chatgpt", help="ChatGPT LLM scraping commands")
 app.add_typer(perplexity.app, name="perplexity", help="Perplexity AI answer-engine commands")
+app.add_typer(autoscout24.app, name="autoscout24", help="AutoScout24 vehicle search commands")
 app.add_typer(copilot.app, name="copilot", help="Microsoft Copilot answer-engine commands")
 app.add_typer(gemini.app, name="gemini", help="Google Gemini LLM commands")
 app.add_typer(

{scrapebadger_cli-0.26.0 → scrapebadger_cli-0.27.0}/src/scrapebadger_cli/output.py

@@ -13,14 +13,25 @@ console = Console()
 OutputFormat = str  # "json" | "csv" | "table" | "markdown"
 
 
-def render(data: Any, fmt: str = "json", fields: str | None = None) -> None:
+def render(
+    data: Any,
+    fmt: str = "json",
+    fields: str | None = None,
+    *,
+    preserve_envelope: bool = False,
+) -> None:
     """Render API response in the chosen format.
 
     Args:
         data: The API response (dict or list).
         fmt: Output format — json, csv, table, markdown.
         fields: Comma-separated field names to include (optional).
+        preserve_envelope: Keep JSON metadata for products with paginated/rich responses.
     """
+    if fmt == "json" and preserve_envelope and fields is None:
+        _render_json(data, data)
+        return
+
     rows = _normalize_rows(data)
     selected_fields = fields.split(",") if fields else None
 

scrapebadger_cli-0.27.0/tests/conftest.py

@@ -0,0 +1,6 @@
+"""Collect CLI regressions from the monorepo without requiring an editable install."""
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))

scrapebadger_cli-0.27.0/tests/test_autoscout24_commands.py

@@ -0,0 +1,76 @@
+import json
+from unittest.mock import Mock
+
+import pytest
+from scrapebadger_cli.commands import autoscout24
+from typer.testing import CliRunner
+
+
+def test_vehicle_ranges_and_pagination_reach_gateway(monkeypatch):
+    call = Mock(return_value={"results": []})
+    monkeypatch.setattr(autoscout24, "api_get", call)
+    monkeypatch.setattr(autoscout24, "render", Mock())
+    result = CliRunner().invoke(
+        autoscout24.app,
+        [
+            "search",
+            "--market",
+            "it",
+            "--make",
+            "volkswagen",
+            "--model",
+            "golf",
+            "--price-min",
+            "0",
+            "--price-max",
+            "20000",
+            "--mileage-max",
+            "80000",
+            "--year-min",
+            "2018",
+            "--power-min",
+            "75",
+            "--fuel-type",
+            "diesel",
+            "--seller-type",
+            "private",
+            "--sort-by",
+            "price_asc",
+            "--page",
+            "2",
+        ],
+    )
+    assert result.exit_code == 0, result.output
+    path, params = call.call_args.args
+    assert path == "/v1/autoscout24/search"
+    assert params["price_min"] == 0
+    assert params["market"] == "it" and params["page"] == 2
+    assert params["model"] == "golf" and params["power_min"] == 75
+    assert params["sort_by"] == "price_asc" and params["seller_type"] == "private"
+
+
+def test_markets_remains_a_static_reference_call(monkeypatch):
+    call = Mock(return_value={"markets": []})
+    monkeypatch.setattr(autoscout24, "api_get", call)
+    monkeypatch.setattr(autoscout24, "render", Mock())
+    result = CliRunner().invoke(autoscout24.app, ["markets"])
+    assert result.exit_code == 0, result.output
+    call.assert_called_once_with("/v1/autoscout24/markets")
+
+
+@pytest.mark.parametrize("count", [0, 1, 2])
+def test_json_preserves_pagination_for_every_row_count(monkeypatch, count):
+    data = {
+        "results": [{"id": str(index), "price": 10000} for index in range(count)],
+        "market": "de",
+        "total_results": 43,
+        "total_pages": 3,
+        "page": 2 if count else 5,
+        "has_next_page": bool(count),
+        "next_page": 3 if count else None,
+        "page_size": 20,
+    }
+    monkeypatch.setattr(autoscout24, "api_get", Mock(return_value=data))
+    result = CliRunner().invoke(autoscout24.app, ["search"])
+    assert result.exit_code == 0, result.output
+    assert json.loads(result.stdout) == data

scrapebadger_cli-0.27.0/tests/test_brave.py

@@ -0,0 +1,117 @@
+"""CLI adapters must preserve native controls, false values, and full response JSON."""
+
+import json
+from unittest.mock import Mock
+
+import pytest
+from scrapebadger_cli.commands import brave
+from typer.testing import CliRunner
+
+
+@pytest.mark.parametrize(
+    ("args", "endpoint", "expected"),
+    [
+        (
+            [
+                "search",
+                "café & tea",
+                "--country",
+                "de",
+                "--ui-language",
+                "de-de",
+                "--safe-search",
+                "strict",
+                "--page",
+                "2",
+                "--count",
+                "5",
+                "--freshness",
+                "week",
+                "--no-spellcheck",
+            ],
+            "search",
+            {
+                "query": "café & tea",
+                "country": "de",
+                "ui_language": "de-de",
+                "safe_search": "strict",
+                "page": 2,
+                "count": 5,
+                "freshness": "week",
+                "spellcheck": False,
+            },
+        ),
+        (
+            ["images", "cats", "--count", "7"],
+            "images",
+            {
+                "query": "cats",
+                "country": "us",
+                "ui_language": "en-us",
+                "safe_search": "moderate",
+                "count": 7,
+            },
+        ),
+        (
+            ["videos", "coffee", "--page", "2"],
+            "videos",
+            {
+                "query": "coffee",
+                "country": "us",
+                "ui_language": "en-us",
+                "safe_search": "moderate",
+                "page": 2,
+                "count": 50,
+            },
+        ),
+        (
+            ["news", "tech"],
+            "news",
+            {
+                "query": "tech",
+                "country": "us",
+                "ui_language": "en-us",
+                "safe_search": "moderate",
+                "count": 35,
+            },
+        ),
+        (
+            ["autocomplete", "coff", "--country", "de"],
+            "autocomplete",
+            {"query": "coff", "country": "de"},
+        ),
+        (["locales"], "locales", None),
+    ],
+)
+def test_brave_commands(monkeypatch, args, endpoint, expected):
+    payload = {
+        "results": [{"title": "Café", "additive": {"value": 0}}],
+        "query_info": {"altered": False},
+    }
+    get = Mock(return_value=payload)
+    output = Mock()
+    monkeypatch.setattr(brave, "api_get", get)
+    monkeypatch.setattr(brave, "render", output)
+    result = CliRunner().invoke(brave.app, args)
+    assert result.exit_code == 0, result.output
+    if expected is None:
+        get.assert_called_once_with(f"/v1/brave/{endpoint}")
+    else:
+        get.assert_called_once_with(f"/v1/brave/{endpoint}", expected)
+    output.assert_called_once_with(payload, "json", None, preserve_envelope=True)
+
+
+@pytest.mark.parametrize("count", [0, 1, 2])
+def test_json_retains_envelope_for_every_result_count(monkeypatch, count):
+    payload = {
+        "results": [{"title": "Café", "url": f"https://example.org/{i}"} for i in range(count)],
+        "result_count": count,
+        "query_info": {"applied_preferences": {"external_fallback": False}},
+        "page": 2,
+        "next_page": 3 if count else None,
+        "rich_blocks": {"infobox": {"title": "Coffee"}},
+    }
+    monkeypatch.setattr(brave, "api_get", Mock(return_value=payload))
+    result = CliRunner().invoke(brave.app, ["search", "coffee", "--page", "2"])
+    assert result.exit_code == 0, result.output
+    assert json.loads(result.stdout) == payload

scrapebadger_cli-0.27.0/tests/test_github.py

@@ -0,0 +1,69 @@
+"""Offline GitHub profile request and raw-output contract."""
+
+import json
+from unittest.mock import Mock
+
+import pytest
+from scrapebadger_cli.commands import github
+from scrapebadger_cli.main import app
+from typer.testing import CliRunner
+
+
+@pytest.mark.parametrize(
+    ("options", "expected"),
+    [
+        ([], {"tab": "overview"}),
+        (["--year", "2024"], {"tab": "overview", "year": 2024}),
+        (["--tab", "repositories", "--page", "2"], {"tab": "repositories", "page": 2}),
+        (
+            ["--tab", "stars", "--next-page-token", "a+/=&?雪"],
+            {"tab": "stars", "next_page_token": "a+/=&?雪"},
+        ),
+    ],
+)
+def test_registered_profile_forwards_inputs_and_preserves_output(monkeypatch, options, expected):
+    payload = {"profile": {"login": "octocat"}, "new_source_field": {"count": 0}}
+    call, render = Mock(return_value=payload), Mock()
+    monkeypatch.setattr(github, "api_get", call)
+    monkeypatch.setattr(github, "render", render)
+    result = CliRunner().invoke(
+        app, ["github", "profile", "@octocat", *options, "--output", "json", "--fields", "profile"]
+    )
+    assert result.exit_code == 0, result.output
+    call.assert_called_once_with("/v1/github/profiles/%40octocat", expected)
+    render.assert_called_once_with(payload, "json", "profile", preserve_envelope=True)
+
+
+def test_username_cannot_change_request_path(monkeypatch):
+    call = Mock(return_value={})
+    monkeypatch.setattr(github, "api_get", call)
+    monkeypatch.setattr(github, "render", Mock())
+    result = CliRunner().invoke(app, ["github", "profile", "user/a?b&c"])
+    assert result.exit_code == 0, result.output
+    # The API rejects malformed usernames; the adapter must still keep one segment.
+    assert call.call_args.args[0] == "/v1/github/profiles/user%2Fa%3Fb%26c"
+
+
+@pytest.mark.parametrize("options", [["--tab", "search"], ["--tab", "repositories", "--page", "0"]])
+def test_invalid_cli_options_do_not_call_api(monkeypatch, options):
+    call = Mock()
+    monkeypatch.setattr(github, "api_get", call)
+    result = CliRunner().invoke(app, ["github", "profile", "octocat", *options])
+    assert result.exit_code != 0
+    call.assert_not_called()
+
+
+@pytest.mark.parametrize("count", [0, 1, 2])
+def test_json_profile_output_preserves_card_rows_and_pagination(monkeypatch, count):
+    payload = {
+        "profile": {"login": "octocat", "is_organization": False},
+        "repositories": [{"full_name": f"octocat/repo{i}"} for i in range(count)],
+        "pagination": {"page": 2, "has_next": True, "next_page": 3},
+        "additive_source_metadata": {"exact": True},
+    }
+    monkeypatch.setattr(github, "api_get", Mock(return_value=payload))
+    result = CliRunner().invoke(
+        app, ["github", "profile", "octocat", "--tab", "repositories", "--page", "2"]
+    )
+    assert result.exit_code == 0, result.output
+    assert json.loads(result.output) == payload