find-life 0.1.0__tar.gz

find_life-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: find-life
+Version: 0.1.0
+Summary: Taxonomic name search.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.3.3
+Requires-Dist: httpx>=0.28.1

find_life-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "find-life"
+version = "0.1.0"
+description = "Taxonomic name search."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "click>=8.3.3",
+    "httpx>=0.28.1",
+]
+
+[project.scripts]
+find-life = "find_life.cli:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[build-system]
+requires = ["setuptools>=61.0"] # Use a common build backend
+build-backend = "setuptools.build_meta"

find_life-0.1.0/setup.cfg

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

find_life-0.1.0/src/find_life/cli.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import click
+
+from find_life.init import run_init
+from find_life.search import run_search
+
+
+@click.group()
+def cli() -> None:
+    """find-life: taxonomic name search."""
+
+
+@cli.command()
+@click.argument("name")
+@click.option(
+    "--scientific",
+    "mode",
+    flag_value="scientific",
+    help="Search scientific names only.",
+)
+@click.option(
+    "--common", "mode", flag_value="common", help="Search vernacular names only."
+)
+@click.option(
+    "-f",
+    "--format",
+    "output_fmt",
+    type=click.Choice(["text", "table", "json"], case_sensitive=False),
+    default="text",
+    show_default=True,
+    help="Output format.",
+)
+def search(name: str, mode: str | None, output_fmt: str) -> None:
+    """Search taxonomic units by scientific or common name."""
+    run_search(name, mode, output_fmt)
+
+
+@cli.command()
+def init() -> None:
+    """Re-run setup: reset API key, change mode, or reconfigure."""
+    run_init()
+
+
+# TODO coming soon!
+# @cli.command()
+# def suggest() -> None:
+#     """Open a pre-filled issue with query context."""
+#     click.echo("suggest")

find_life-0.1.0/src/find_life/init.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import json
+import secrets
+import socket
+from datetime import datetime
+from pathlib import Path
+
+import click
+import httpx
+
+BASE_URL = "https://find-life.org"
+CONFIG_DIR = Path.home() / ".find-life"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+def load_config() -> dict:
+    CONFIG_DIR.mkdir(exist_ok=True)
+    if not CONFIG_FILE.exists():
+        return {}
+    return json.loads(CONFIG_FILE.read_text())
+
+
+def save_config(token: str) -> None:
+    CONFIG_DIR.mkdir(exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps({"find-life-token": token}, indent=2))
+
+
+def make_token_name() -> str:
+    host = socket.gethostname().split(".")[0]
+    date = datetime.now().strftime("%Y%m%d")
+    suffix = secrets.token_hex(4)
+    return f"{host}-{date}-{suffix}"
+
+
+def provision_token(token: str) -> str:
+    response = httpx.post(f"{BASE_URL}/api", json={"token": token}, timeout=10)
+    response.raise_for_status()
+    result = response.json()["token"]
+    click.echo(f"New token created, saved to {CONFIG_FILE}")
+    return result
+
+
+def ensure_token() -> str:
+    config = load_config()
+    token = config.get("find-life-token", "")
+    today = datetime.now().strftime("%Y%m%d")
+    if token and today in token:
+        return token
+    token = provision_token(make_token_name())
+    save_config(token)
+    return token
+
+
+def run_init() -> None:
+    try:
+        token = provision_token(make_token_name())
+        save_config(token)
+    except httpx.HTTPStatusError as e:
+        click.echo(f"Request failed: {e.response.status_code} {e.response.text}")
+    except httpx.RequestError as e:
+        click.echo(f"Connection failed: {e}")

find_life-0.1.0/src/find_life/search.py

@@ -0,0 +1,152 @@
+from __future__ import annotations
+
+import json as json_mod
+import shutil
+import textwrap
+
+import click
+import httpx
+
+from find_life.init import BASE_URL, ensure_token
+
+_GRAY, _RESET, _BOLD = "\033[37m", "\033[0m", "\033[1m"
+
+
+def _print_paleo(paleo: dict) -> None:
+    first, last = paleo.get("firstAppearance"), paleo.get("lastAppearance")
+    if first and last:
+        click.echo(f"\n{_BOLD}First appeared:{_RESET} {first} – {last} Ma")
+
+
+def _print_wikipedia(wikipedia: dict) -> None:
+    if wikipedia.get("extract"):
+        term_w = shutil.get_terminal_size().columns
+        wrapped = textwrap.fill(
+            wikipedia["extract"],
+            width=term_w,
+            initial_indent=f"\n{_BOLD}Wikipedia:{_RESET} ",
+            subsequent_indent="           ",
+        )
+        click.echo(wrapped)
+    if wikipedia.get("source"):
+        click.echo(f"{_BOLD}Source:{_RESET}    {wikipedia['source']}")
+
+
+def _print_text(
+    taxonomy: dict, wikipedia: dict | None = None, paleo: dict | None = None
+) -> None:
+    parents = list(reversed(taxonomy.get("parents", [])))
+    subject = {"rank": taxonomy["rank"], "name": taxonomy["name"]}
+    children = taxonomy.get("children", [])
+
+    click.echo(f"\n{_BOLD}Taxonomy:{_RESET}")
+
+    for i, row in enumerate(parents):
+        indent = "  " * i
+        branch = "" if i == 0 else "└─ "
+        click.echo(f"{_GRAY}{indent}{branch}{row['name']}  ({row['rank']}){_RESET}")
+
+    subject_indent = "  " * len(parents)
+    subject_prefix = f"{subject_indent}└─ " if parents else ""
+    click.echo(
+        f"{_BOLD}{subject_prefix}▶  {subject['name']}  ({subject['rank']}){_RESET}"
+    )
+
+    child_indent = "  " * (len(parents) + 1)
+    for i, row in enumerate(children):
+        branch = "└─" if i == len(children) - 1 else "├─"
+        click.echo(f"{child_indent}{branch} {row['name']}  ({row['rank']})")
+
+    if paleo:
+        _print_paleo(paleo)
+    if wikipedia:
+        _print_wikipedia(wikipedia)
+
+
+def _print_table(
+    taxonomy: dict, wikipedia: dict | None = None, paleo: dict | None = None
+) -> None:
+    rows: list[tuple[str, str, str]] = [
+        ("", "Name", taxonomy["name"]),
+        ("", "Rank", taxonomy["rank"]),
+    ]
+    for p in reversed(taxonomy.get("parents", [])):
+        rows.append(("Parents", p["rank"], p["name"]))
+    for c in taxonomy.get("children", []):
+        rows.append(("Children", c["rank"], c["name"]))
+    if paleo:
+        first, last = paleo.get("firstAppearance"), paleo.get("lastAppearance")
+        if first:
+            rows.append(("Paleo", "First appearance", f"{first} Ma"))
+        if last:
+            rows.append(("", "Last appearance", f"{last} Ma"))
+    if wikipedia:
+        if wikipedia.get("extract"):
+            rows.append(("Wikipedia", "Extract", wikipedia["extract"]))
+        if wikipedia.get("source"):
+            rows.append(("Wikipedia", "Source", wikipedia["source"]))
+
+    sec_w = max(len(r[0]) for r in rows)
+    field_w = max(len(r[1]) for r in rows)
+    term_w = shutil.get_terminal_size().columns
+    value_w = max(term_w - sec_w - field_w - 6, 40)
+
+    click.echo(f"{'Section':<{sec_w}}  {'Field':<{field_w}}  Value")
+    click.echo("-" * min(shutil.get_terminal_size().columns, 80))
+
+    prev_section = None
+    for section, field, value in rows:
+        sec_label = section if section != prev_section else ""
+        wrapped = textwrap.wrap(value, width=value_w) or [""]
+        click.echo(f"{sec_label:<{sec_w}}  {field:<{field_w}}  {wrapped[0]}")
+        indent = " " * (sec_w + field_w + 6)
+        for line in wrapped[1:]:
+            click.echo(f"{indent}{line}")
+        prev_section = section
+
+
+def run_search(name: str, mode: str | None, output_fmt: str) -> None:
+    try:
+        token = ensure_token()
+    except httpx.RequestError as e:
+        click.echo(f"Connection failed: {e}")
+        return
+
+    def fetch(action: str) -> dict | None:
+        response = httpx.get(
+            f"{BASE_URL}/api",
+            params={"action": action, "q": name},
+            headers={"x-find-life-token": token},
+        )
+        response.raise_for_status()
+        data = response.json()
+        return data if data.get("id") else None
+
+    try:
+        data = fetch(mode) if mode else (fetch("scientific") or fetch("common"))
+        if not data:
+            click.echo(f"No results found for {name!r}")
+            return
+        taxonomy = data.get("taxonomy")
+        if not taxonomy:
+            click.echo(f"ID: {data['id']}")
+            return
+        if output_fmt == "json":
+            click.echo(
+                json_mod.dumps(
+                    {
+                        "taxonomy": taxonomy,
+                        "paleo": data.get("paleo"),
+                        "wikipedia": data.get("wikipedia"),
+                    },
+                    indent=2,
+                )
+            )
+        elif output_fmt == "table":
+            _print_table(taxonomy, data.get("wikipedia"), data.get("paleo"))
+        else:
+            _print_text(taxonomy, data.get("wikipedia"), data.get("paleo"))
+    except httpx.HTTPStatusError as e:
+        click.echo(f"Request failed: {e.response.status_code} {e.response.text}")
+    except httpx.RequestError as e:
+        click.echo(f"Connection failed: {e}")

find_life-0.1.0/src/find_life.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: find-life
+Version: 0.1.0
+Summary: Taxonomic name search.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.3.3
+Requires-Dist: httpx>=0.28.1

find_life-0.1.0/src/find_life.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/find_life/__init__.py
+src/find_life/cli.py
+src/find_life/init.py
+src/find_life/search.py
+src/find_life.egg-info/PKG-INFO
+src/find_life.egg-info/SOURCES.txt
+src/find_life.egg-info/dependency_links.txt
+src/find_life.egg-info/entry_points.txt
+src/find_life.egg-info/requires.txt
+src/find_life.egg-info/top_level.txt

find_life-0.1.0/src/find_life.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

find_life-0.1.0/src/find_life.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+find-life = find_life.cli:cli

find_life-0.1.0/src/find_life.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click>=8.3.3
+httpx>=0.28.1

find_life-0.1.0/src/find_life.egg-info/top_level.txt

@@ -0,0 +1 @@
+find_life