fontcase 0.1.0__py3-none-any.whl

fontcase/__init__.py

@@ -0,0 +1,11 @@
+"""fontcase: catálogo offline de fontes do Google Fonts."""
+from .catalog import (
+    all_fonts, categories, by_category, get, search,
+    css_url, css_import, css_font_family, random_font,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "all_fonts", "categories", "by_category", "get", "search",
+    "css_url", "css_import", "css_font_family", "random_font",
+]

fontcase/catalog.py

@@ -0,0 +1,70 @@
+from __future__ import annotations
+import json, random
+from functools import lru_cache
+from importlib import resources
+from typing import Dict, List, Optional
+
+
+@lru_cache(maxsize=1)
+def all_fonts() -> List[Dict]:
+    """Retorna todas as fontes do catálogo."""
+    text = resources.files("fontcase").joinpath("data/catalog.json").read_text(encoding="utf-8")
+    return json.loads(text)
+
+
+def categories() -> List[str]:
+    """Lista de categorias, em ordem alfabética."""
+    return sorted({f["category"] for f in all_fonts()})
+
+
+def by_category(category: str) -> List[Dict]:
+    """Fontes de uma categoria."""
+    return [f for f in all_fonts() if f["category"] == category]
+
+
+def get(family: str) -> Optional[Dict]:
+    """Busca uma fonte pelo nome exato (sem diferenciar maiúsculas)."""
+    fam = family.strip().lower()
+    for f in all_fonts():
+        if f["family"].lower() == fam or f["slug"] == fam:
+            return f
+    return None
+
+
+def search(query: str = "", category: Optional[str] = None) -> List[Dict]:
+    """Busca por trecho do nome, com filtro opcional de categoria."""
+    q = query.strip().lower()
+    return [
+        f for f in all_fonts()
+        if q in f["family"].lower() and (category is None or f["category"] == category)
+    ]
+
+
+def _need(family: str) -> Dict:
+    font = get(family)
+    if font is None:
+        raise KeyError(f"Fonte não encontrada: {family!r}")
+    return font
+
+
+def css_url(family: str) -> str:
+    """URL do CSS do Google Fonts."""
+    return _need(family)["css"]
+
+
+def css_import(family: str) -> str:
+    """Linha @import pronta para colar em um CSS."""
+    return f"@import url('{css_url(family)}');"
+
+
+def css_font_family(family: str) -> str:
+    """Valor para a propriedade font-family."""
+    return _need(family)["css_stack"]
+
+
+def random_font(category: Optional[str] = None) -> Dict:
+    """Uma fonte aleatória, opcionalmente dentro de uma categoria."""
+    pool = by_category(category) if category else all_fonts()
+    if not pool:
+        raise ValueError(f"Categoria sem fontes: {category!r}")
+    return random.choice(pool)

fontcase/cli.py

@@ -0,0 +1,39 @@
+import argparse
+from . import catalog
+
+
+def main(argv=None) -> int:
+    p = argparse.ArgumentParser(prog="fontcase", description="Catálogo de fontes")
+    sub = p.add_subparsers(dest="cmd", required=True)
+    sub.add_parser("categories", help="lista categorias")
+    s = sub.add_parser("search", help="busca fontes")
+    s.add_argument("query", nargs="?", default="")
+    s.add_argument("-c", "--category")
+    sh = sub.add_parser("show", help="mostra detalhes e CSS de uma fonte")
+    sh.add_argument("family")
+    r = sub.add_parser("random", help="fonte aleatória")
+    r.add_argument("-c", "--category")
+    a = p.parse_args(argv)
+
+    if a.cmd == "categories":
+        for c in catalog.categories():
+            print(c)
+    elif a.cmd == "search":
+        for f in catalog.search(a.query, a.category):
+            print(f"{f['family']}  [{f['category']}]")
+    elif a.cmd == "show":
+        f = catalog.get(a.family)
+        if not f:
+            print("Fonte não encontrada")
+            return 1
+        print(f"{f['family']} ({f['category']})\n{f['page']}\n")
+        print(catalog.css_import(a.family))
+        print(f"font-family: {f['css_stack']};")
+    elif a.cmd == "random":
+        f = catalog.random_font(a.category)
+        print(f"{f['family']}  [{f['category']}]")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())