discolike-cli 0.1.0__tar.gz → 0.2.0__tar.gz

discolike_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DiscoLike Inc.
+
+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.

{discolike_cli-0.1.0 → discolike_cli-0.2.0}/PKG-INFO

@@ -1,30 +1,38 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: discolike-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Official CLI for the DiscoLike API
 Project-URL: Homepage, https://www.discolike.com
 Project-URL: Documentation, https://docs.discolike.com
 Project-URL: Repository, https://github.com/Discolike/discolike-python
+Project-URL: Changelog, https://github.com/Discolike/discolike-python/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Discolike/discolike-python/issues
 Author-email: DiscoLike <support@discolike.com>
 License-Expression: MIT
+License-File: LICENSE
 Keywords: business-data,cli,discolike,enrichment
 Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
 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.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: discolike>=0.1.0
+Requires-Dist: discolike==0.2.0
 Requires-Dist: rich>=13.0
 Requires-Dist: typer>=0.12
 Description-Content-Type: text/markdown
 
 # discolike-cli
 
-Official CLI for the [DiscoLike API](https://www.discolike.com) — the `discolike` command from your terminal. Built on the [`discolike`](https://pypi.org/project/discolike/) SDK.
+Official CLI for the [DiscoLike API](https://discolike.com) — the `discolike` command from your terminal. Built on the [`discolike`](https://pypi.org/project/discolike/) SDK.
 
 ## Installation
 
@@ -51,7 +59,7 @@ Prompts for an API key (or pass `--api-key`) and verifies it against your accoun
 ## Quickstart
 
 ```bash
-discolike discover --icp-text "managed IT services for SMBs" --country US --max-records 25
+discolike discover --icp-prompt "managed IT services for SMBs" --country US --max-records 25
 discolike match "Stripe Inc" --city "San Francisco"
 discolike match --file companies.csv --name-column company_name --wait
 discolike count --phrase-match "book a demo" --country US
@@ -59,7 +67,7 @@ discolike company data stripe.com
 discolike extract https://stripe.com/enterprise
 ```
 
-Top-level commands: `discover`, `count`, `match`, `extract`, `validate-icp`, `append`, `segment` — plus `auth`, `company`, `contacts`, `discogen`, `queries`, and `account` command groups.
+Top-level commands: `discover`, `count`, `match`, `extract`, `validate-icp`, `append`, `segment` — plus `auth`, `company`, `contacts`, `discogen`, `queries`, `account`, `search-providers`, and `llm-providers` command groups.
 
 ### Conventions
 

{discolike_cli-0.1.0 → discolike_cli-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # discolike-cli
 
-Official CLI for the [DiscoLike API](https://www.discolike.com) — the `discolike` command from your terminal. Built on the [`discolike`](https://pypi.org/project/discolike/) SDK.
+Official CLI for the [DiscoLike API](https://discolike.com) — the `discolike` command from your terminal. Built on the [`discolike`](https://pypi.org/project/discolike/) SDK.
 
 ## Installation
 
@@ -27,7 +27,7 @@ Prompts for an API key (or pass `--api-key`) and verifies it against your accoun
 ## Quickstart
 
 ```bash
-discolike discover --icp-text "managed IT services for SMBs" --country US --max-records 25
+discolike discover --icp-prompt "managed IT services for SMBs" --country US --max-records 25
 discolike match "Stripe Inc" --city "San Francisco"
 discolike match --file companies.csv --name-column company_name --wait
 discolike count --phrase-match "book a demo" --country US
@@ -35,7 +35,7 @@ discolike company data stripe.com
 discolike extract https://stripe.com/enterprise
 ```
 
-Top-level commands: `discover`, `count`, `match`, `extract`, `validate-icp`, `append`, `segment` — plus `auth`, `company`, `contacts`, `discogen`, `queries`, and `account` command groups.
+Top-level commands: `discover`, `count`, `match`, `extract`, `validate-icp`, `append`, `segment` — plus `auth`, `company`, `contacts`, `discogen`, `queries`, `account`, `search-providers`, and `llm-providers` command groups.
 
 ### Conventions
 

{discolike_cli-0.1.0 → discolike_cli-0.2.0}/pyproject.toml

@@ -4,14 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "discolike-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Official CLI for the DiscoLike API"
 readme = "README.md"
 license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 authors = [{ name = "DiscoLike", email = "support@discolike.com" }]
 dependencies = [
-  "discolike>=0.1.0",
+  "discolike==0.2.0",
   "typer>=0.12",
   "rich>=13.0",
 ]
@@ -25,6 +26,11 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: OS Independent",
+  "Environment :: Console",
+  "Topic :: Utilities",
+  "Typing :: Typed",
 ]
 
 [project.scripts]
@@ -34,12 +40,16 @@ discolike = "discolike_cli.main:app"
 Homepage = "https://www.discolike.com"
 Documentation = "https://docs.discolike.com"
 Repository = "https://github.com/Discolike/discolike-python"
+Changelog = "https://github.com/Discolike/discolike-python/blob/main/CHANGELOG.md"
+Issues = "https://github.com/Discolike/discolike-python/issues"
 
 [tool.uv.sources]
+discolike-testkit = { workspace = true }
 discolike = { workspace = true }
 
 [dependency-groups]
 dev = [
+  "discolike-testkit",
   "pytest>=8",
   "pytest-asyncio>=0.24",
   "ruff>=0.8",

{discolike_cli-0.1.0 → discolike_cli-0.2.0}/src/discolike_cli/_output.py

@@ -60,21 +60,39 @@ def _normalize(data: Any) -> Any:  # noqa: ANN401 -- accepts arbitrary JSON-seri
     return data
 
 
-def _is_flat_dict(value: Any) -> bool:  # noqa: ANN401 -- runtime-narrowed via isinstance, not a fixed shape
-    return isinstance(value, dict) and not any(isinstance(v, (dict, list)) for v in value.values())
+TABLE_CELL_MAX_CHARS = 80
+TABLE_MAX_COLUMNS = 8
+_SCALAR_TYPES = (str, int, float, bool, type(None))
+
+
+def _scalar_columns(rows: list[dict[str, Any]]) -> list[str]:
+    columns = [column for column in rows[0] if all(isinstance(row.get(column), _SCALAR_TYPES) for row in rows)]
+    return columns[:TABLE_MAX_COLUMNS]
 
 
 def _qualifies_for_table(data: Any) -> bool:  # noqa: ANN401 -- runtime-narrowed via isinstance, not a fixed shape
-    return isinstance(data, list) and len(data) > 0 and all(_is_flat_dict(item) for item in data)
+    return (
+        isinstance(data, list)
+        and len(data) > 0
+        and all(isinstance(item, dict) for item in data)
+        and len(_scalar_columns(data)) > 0
+    )
+
+
+def _cell(value: Any) -> str:  # noqa: ANN401 -- scalar JSON value, narrowed by _scalar_columns
+    text = "" if value is None else str(value)
+    if len(text) > TABLE_CELL_MAX_CHARS:
+        return text[: TABLE_CELL_MAX_CHARS - 1] + "…"
+    return text
 
 
 def _render_table(rows: list[dict[str, Any]]) -> None:
     table = Table()
-    columns = list(rows[0].keys())
+    columns = _scalar_columns(rows)
     for column in columns:
-        table.add_column(column)
+        table.add_column(column, overflow="ellipsis", no_wrap=True)
     for row in rows:
-        table.add_row(*(str(row.get(column, "")) for column in columns))
+        table.add_row(*(_cell(row.get(column)) for column in columns))
     Console().print(table)
 
 
@@ -117,7 +135,7 @@ def handle_errors(fn: Callable[P, R]) -> Callable[P, R]:
     return wrapper
 
 
-def run_job(job: SupportsWait, *, wait: bool, timeout: float) -> None:
+def run_job(job: SupportsWait, *, wait: bool, timeout: float, fmt: str | None = None) -> None:
     if not wait:
         emit(
             {
@@ -132,4 +150,4 @@ def run_job(job: SupportsWait, *, wait: bool, timeout: float) -> None:
         sys.stderr.write(f"progress: {status.progress}%\n")
 
     final = job.wait(timeout=timeout, on_poll=_on_poll)
-    emit(final.results if final.results is not None else final.to_dict())
+    emit(final.results if final.results is not None else final.to_dict(), fmt=fmt)

discolike_cli-0.2.0/src/discolike_cli/account.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+import typer
+
+from discolike_cli._output import emit
+from discolike_cli._output import handle_errors
+
+FORMAT_HELP = "Output format: json or table (table auto-selected on a TTY; falls back to JSON for non-tabular data)."
+
+app = typer.Typer(help="Account usage and quota.")
+
+
+@app.command("usage")
+@handle_errors
+def usage_command(
+    ctx: typer.Context,
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Month-to-date usage: requests, records, and spend."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).account.usage(), fmt=fmt)

discolike_cli-0.2.0/src/discolike_cli/auth.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import json
+import sys
+from typing import Any
+
+import typer
+
+from discolike._config import KEYS_URL
+from discolike._config import delete_config
+from discolike._config import load_config
+from discolike._config import resolve_api_key
+from discolike._config import save_config
+from discolike_cli._output import emit
+from discolike_cli._output import handle_errors
+
+app = typer.Typer(help="Manage API credentials: log in, check key status, log out.")
+
+MASKED_VISIBLE_CHARS = 4
+
+SOURCE_OPTION = "option"
+SOURCE_ENV = "env"
+SOURCE_CONFIG = "config"
+
+
+def _mask(key: str) -> str:
+    return "…" + key[-MASKED_VISIBLE_CHARS:]
+
+
+def _global_key_source(ctx: typer.Context) -> str:
+    # typer vendors click without re-exporting ParameterSource, so match on the enum member name.
+    source = ctx.find_root().get_parameter_source("api_key")
+    return SOURCE_ENV if source is not None and source.name == "ENVIRONMENT" else SOURCE_OPTION
+
+
+def _verify(ctx: typer.Context, *, api_key: str) -> None:
+    from discolike_cli.main import build_client
+
+    kwargs: dict[str, Any] = {"api_key": api_key}
+    base_url = ctx.obj.get("base_url")
+    if base_url is not None:
+        kwargs["base_url"] = base_url
+    build_client(**kwargs).account.usage()
+
+
+@app.command()
+@handle_errors
+def login(
+    ctx: typer.Context,
+    api_key: str | None = typer.Option(None, help=f"API key. Create one at {KEYS_URL}. Prompted for if omitted."),
+) -> None:
+    """Verify an API key and save it to the local config file."""
+    # An ambient DISCOLIKE_API_KEY must not silently become the saved key; only an explicit flag may.
+    passed_globally = ctx.obj.get("api_key") if _global_key_source(ctx) == SOURCE_OPTION else None
+    key = api_key or passed_globally or typer.prompt("API key", hide_input=True)
+    _verify(ctx, api_key=key)
+    save_config({"auth_method": "api_key", "api_key": key})
+    print(json.dumps({"logged_in": True, "source": "api_key"}), file=sys.stderr)
+
+
+@app.command()
+@handle_errors
+def status(ctx: typer.Context) -> None:
+    """Show which API key is in use (option, env, or config) and verify it against the API."""
+    key = ctx.obj.get("api_key")
+    source = _global_key_source(ctx)
+    if not key:
+        key = load_config().get("api_key")
+        source = SOURCE_CONFIG
+    if not key:
+        resolve_api_key(None)
+    _verify(ctx, api_key=str(key))
+    emit({"source": source, "api_key": _mask(str(key)), "valid": True})
+
+
+@app.command()
+@handle_errors
+def logout() -> None:
+    """Delete saved credentials from the local config file."""
+    delete_config()
+    emit({"logged_out": True})

discolike_cli-0.2.0/src/discolike_cli/company.py

@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+import typer
+
+from discolike_cli._output import emit
+from discolike_cli._output import handle_errors
+
+FORMAT_HELP = "Output format: json or table (table auto-selected on a TTY; falls back to JSON for non-tabular data)."
+DOMAIN_HELP = "Company domain, e.g. stripe.com"
+MATCH_HELP = "Domain match mode, e.g. loose"
+
+app = typer.Typer(
+    help="Company profiles by domain: firmographics, scores, growth, redirects, vendors, subsidiaries, and public links."
+)
+
+
+@app.command()
+@handle_errors
+def data(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Full company profile (firmographics) for a domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.data(domain=domain), fmt=fmt)
+
+
+@app.command()
+@handle_errors
+def score(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Company score for a domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.score(domain=domain), fmt=fmt)
+
+
+@app.command()
+@handle_errors
+def growth(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Growth signals for a domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.growth(domain=domain), fmt=fmt)
+
+
+@app.command()
+@handle_errors
+def redirects(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    match: str | None = typer.Option(None, "--match", help=MATCH_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Domain redirects for a company domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.redirects(domain=domain, match=match), fmt=fmt)
+
+
+@app.command()
+@handle_errors
+def vendors(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    match: str | None = typer.Option(None, "--match", help=MATCH_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Vendors associated with a company domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.vendors(domain=domain, match=match), fmt=fmt)
+
+
+@app.command()
+@handle_errors
+def subsidiaries(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    match: str | None = typer.Option(None, "--match", help=MATCH_HELP),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Subsidiaries of a company domain."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.subsidiaries(domain=domain, match=match), fmt=fmt)
+
+
+@app.command(name="public-links")
+@handle_errors
+def public_links(
+    ctx: typer.Context,
+    domain: str = typer.Argument(..., help=DOMAIN_HELP),
+    source: str = typer.Option(..., "--source", help="Public link source, e.g. crunchbase"),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Public profile links for a domain from a given source."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.public_links(domain=domain, source=source), fmt=fmt)
+
+
+@handle_errors
+def extract_command(
+    ctx: typer.Context,
+    url: str = typer.Argument(..., help="Page URL to extract content from"),
+    fmt: str | None = typer.Option(None, "--format", help=FORMAT_HELP),
+) -> None:
+    """Extract page content from a URL."""
+    from discolike_cli.main import get_client
+
+    emit(get_client(ctx).companies.extract(url=url), fmt=fmt)