tinycontracts 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

tinycontracts/cli.py

@@ -1,42 +1,120 @@
-# cli.py - typer entry point
+# cli.py - fast startup with lazy imports
 import sys
-from pathlib import Path
 
-import typer
-import uvicorn
-from rich.console import Console
-from rich.panel import Panel
-from rich.table import Table
 
-from tinycontracts.server import create_app
+def main():
+    # fast path for --help and --version (no heavy imports)
+    args = sys.argv[1:]
+
+    if not args or args[0] in ("--help", "-h"):
+        print("""tc - serve data files as a rest api
+
+usage: tc <folder> [options]
+
+arguments:
+  folder              folder containing json/csv/parquet files
+
+options:
+  -p, --port PORT     port to serve on (default: 4242)
+  -H, --host HOST     host to bind to (default: 127.0.0.1)
+  -v, --version       show version
+  -h, --help          show this help""")
+        return
+
+    if args[0] in ("--version", "-v"):
+        print("tinycontracts v0.1.2")
+        return
+
+    # parse args manually for fast path
+    path = None
+    port = 4242
+    host = "127.0.0.1"
+
+    i = 0
+    while i < len(args):
+        arg = args[i]
+        if arg in ("-p", "--port"):
+            port = int(args[i + 1])
+            i += 2
+        elif arg in ("-H", "--host"):
+            host = args[i + 1]
+            i += 2
+        elif arg.startswith("-"):
+            print(f"error: unknown option {arg}")
+            sys.exit(1)
+        else:
+            path = arg
+            i += 1
+
+    if not path:
+        print("error: missing folder path\nusage: tc <folder>")
+        sys.exit(1)
+
+    # now import heavy deps
+    from pathlib import Path
+    from rich.console import Console
 
-console = Console()
+    console = Console()
+    folder = Path(path)
 
-app = typer.Typer(
-    name="tc",
-    help="serve a folder of json/csv/parquet files as a rest api",
-    no_args_is_help=True,
-    add_completion=False,
-)
+    if not folder.exists():
+        console.print(f"\n  [red]error:[/red] path not found: [bold]{folder}[/bold]")
+        console.print("  [dim]make sure the path exists and try again[/dim]\n")
+        sys.exit(1)
 
+    if not folder.is_dir():
+        console.print(f"\n  [red]error:[/red] not a folder: [bold]{folder}[/bold]")
+        console.print("  [dim]tc needs a folder path, not a file[/dim]\n")
+        sys.exit(1)
+
+    data_files = (
+        list(folder.glob("*.json"))
+        + list(folder.glob("*.csv"))
+        + list(folder.glob("*.parquet"))
+    )
+    if not data_files:
+        console.print(
+            f"\n  [yellow]warning:[/yellow] no data files in [bold]{folder}[/bold]"
+        )
+        console.print("  [dim]add .json, .csv, or .parquet files[/dim]\n")
+
+    # lazy import heavy deps with spinner
+    with console.status("[cyan]loading...[/cyan]", spinner="dots"):
+        from tinycontracts.server import create_app
+        import uvicorn
+
+        try:
+            fastapi_app = create_app(folder)
+            resources = (
+                list(fastapi_app.state.resources.keys())
+                if hasattr(fastapi_app.state, "resources")
+                else []
+            )
+        except PermissionError:
+            console.print(f"\n  [red]error:[/red] permission denied: [bold]{folder}[/bold]")
+            console.print("  [dim]check file permissions and try again[/dim]\n")
+            sys.exit(1)
+        except Exception as e:
+            console.print(f"\n  [red]error:[/red] failed to load data: {e}\n")
+            sys.exit(1)
+
+    # print banner
+    from rich.panel import Panel
+    from rich.table import Table
 
-def print_banner(host: str, port: int, resources: list[str], folder: Path):
-    # header
     console.print()
     console.print(
         Panel.fit(
-            "[bold cyan]tinycontracts[/bold cyan]  [dim]v0.1.0[/dim]",
+            "[bold cyan]tinycontracts[/bold cyan]  [dim]v0.1.2[/dim]",
             border_style="cyan",
         )
     )
     console.print()
 
-    # server info
     console.print(f"  [dim]folder:[/dim]  {folder.resolve()}")
     console.print(f"  [dim]server:[/dim]  [green]http://{host}:{port}[/green]")
     console.print()
 
-    # endpoints table
     if resources:
         table = Table(show_header=True, header_style="bold", box=None, padding=(0, 2))
         table.add_column("endpoint", style="green")
@@ -57,59 +135,6 @@ def print_banner(host: str, port: int, resources: list[str], folder: Path):
     console.print("  [dim]press ctrl+c to stop[/dim]")
     console.print()
 
-
-@app.command()
-def serve(
-    path: str = typer.Argument(..., help="folder containing data files"),
-    port: int = typer.Option(4242, "--port", "-p", help="port to serve on"),
-    host: str = typer.Option("127.0.0.1", "--host", "-H", help="host to bind to"),
-):
-    """serve data files as a rest api"""
-    folder = Path(path)
-
-    # validate folder exists
-    if not folder.exists():
-        console.print(f"\n  [red]error:[/red] path not found: [bold]{folder}[/bold]")
-        console.print(f"  [dim]make sure the path exists and try again[/dim]\n")
-        raise typer.Exit(1)
-
-    # validate it's a directory
-    if not folder.is_dir():
-        console.print(f"\n  [red]error:[/red] not a folder: [bold]{folder}[/bold]")
-        console.print(f"  [dim]tc needs a folder path, not a file[/dim]\n")
-        raise typer.Exit(1)
-
-    # check for data files
-    data_files = (
-        list(folder.glob("*.json"))
-        + list(folder.glob("*.csv"))
-        + list(folder.glob("*.parquet"))
-    )
-    if not data_files:
-        console.print(
-            f"\n  [yellow]warning:[/yellow] no data files in [bold]{folder}[/bold]"
-        )
-        console.print("[dim]add .json, .csv, or .parquet files[/dim]\n")
-
-    # create app
-    try:
-        fastapi_app = create_app(folder)
-        resources = (
-            list(fastapi_app.state.resources.keys())
-            if hasattr(fastapi_app.state, "resources")
-            else []
-        )
-    except PermissionError:
-        console.print(f"\n  [red]error:[/red] permission denied: [bold]{folder}[/bold]")
-        console.print("[dim]check file permissions and try again[/dim]\n")
-        raise typer.Exit(1)
-    except Exception as e:
-        console.print(f"\n  [red]error:[/red] failed to load data: {e}\n")
-        raise typer.Exit(1)
-
-    # print startup banner
-    print_banner(host, port, resources, folder)
-
     # run server
     try:
         uvicorn.run(fastapi_app, host=host, port=port, log_level="warning")
@@ -121,14 +146,8 @@ def serve(
             console.print(f"  [dim]try: tc {path} -p {port + 1}[/dim]\n")
         else:
             console.print(f"\n  [red]error:[/red] {e}\n")
-        raise typer.Exit(1)
-
-
-@app.command()
-def version():
-    """show version"""
-    console.print("tinycontracts [cyan]v0.1.0[/cyan]")
+        sys.exit(1)
 
 
 if __name__ == "__main__":
-    app()
+    main()

tinycontracts-0.1.2.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: tinycontracts
+Version: 0.1.2
+Summary: serve a folder of json/csv/parquet files as a rest api
+Author-email: Aditya Kumar <adityakuma0308@gmail.com>
+License-Expression: MIT
+Keywords: api,cli,csv,fastapi,json,parquet,rest
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.128.0
+Requires-Dist: pandas>=3.0.0
+Requires-Dist: pyarrow>=23.0.0
+Requires-Dist: rich>=14.3.2
+Requires-Dist: typer>=0.21.1
+Requires-Dist: uvicorn>=0.40.0
+Description-Content-Type: text/markdown
+
+# tinycontracts
+
+Turn any folder of JSON, CSV, or Parquet files into a REST API instantly.
+
+## Install
+
+```bash
+pip install tinycontracts
+```
+
+## Usage
+
+```bash
+tc ./data
+```
+
+That's it. Your files are now API endpoints.
+
+## Options
+
+```bash
+tc ./data -p 8000           # custom port (default: 4242)
+tc ./data -H 0.0.0.0        # expose to network
+tc --version                # show version
+```
+
+## Example
+
+```
+data/
+  users.json     ->  GET /users
+  orders.csv     ->  GET /orders
+  config.json    ->  GET /config
+```
+
+## Querying
+
+```bash
+# filter
+curl "localhost:4242/users?active=true"
+
+# pagination
+curl "localhost:4242/orders?_limit=10&_offset=20"
+
+# sort
+curl "localhost:4242/orders?_sort=-created_at"
+
+# combine
+curl "localhost:4242/orders?status=pending&_limit=5"
+```
+
+## Endpoints
+
+| Endpoint | Description |
+|----------|-------------|
+| `/{resource}` | List all rows |
+| `/{resource}/{id}` | Get by ID |
+| `/{resource}/_schema` | JSON schema |
+| `/_help` | API documentation |
+| `/_schema` | All schemas |
+| `/docs` | Swagger UI |

{tinycontracts-0.1.0.dist-info → tinycontracts-0.1.2.dist-info}/RECORD

@@ -1,10 +1,10 @@
 tinycontracts/__init__.py,sha256=WEsinRwkR1RI9izRzpTB0MidHLvvZxFE0S6KvkcK2aE,17
-tinycontracts/cli.py,sha256=kir936bXvhjnVRfz4Gm36HmECq3PZLszKrTOvolhwY8,4078
+tinycontracts/cli.py,sha256=6Vhu0BLU2aC89yTlwl17qFJxYnOilSf79OuivCNo4Cs,4620
 tinycontracts/loader.py,sha256=CYgvvdTmuioaQeaTZNxLKy0ndFaCjR-xzQoh61FN5q4,884
 tinycontracts/routes.py,sha256=ZVtr7-Sx1IAJIlK9yHgiFzgUa5Wpodsm90jliopQagM,3840
 tinycontracts/schema.py,sha256=tZjLLvQGKi5H4drZZRNCDWY5SWg4_MnYtJWz5hsw8ng,692
 tinycontracts/server.py,sha256=23gJheNqjPHckSeNlquG-G8viJNrMEVItcYxBg-n-t8,728
-tinycontracts-0.1.0.dist-info/METADATA,sha256=erlssWxzSfTqQ5cf-gOL_kcHuWLRbnDilwUczBcoYkM,1438
-tinycontracts-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-tinycontracts-0.1.0.dist-info/entry_points.txt,sha256=mBH0FJ35wm3PDzo0sK-0XP0NA53XQ93JpMCYXRBEPiI,45
-tinycontracts-0.1.0.dist-info/RECORD,,
+tinycontracts-0.1.2.dist-info/METADATA,sha256=XqFjt4-dRfQU3gbE_sMAiUmBdRUfTsxNDT4dIDlI_gQ,1901
+tinycontracts-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+tinycontracts-0.1.2.dist-info/entry_points.txt,sha256=6hAX2IWHaA63CPW3iJVFSB5t9461mefFZ72LQz2unWw,46
+tinycontracts-0.1.2.dist-info/RECORD,,

tinycontracts-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tc = tinycontracts.cli:main

tinycontracts-0.1.0.dist-info/METADATA

@@ -1,73 +0,0 @@
-Metadata-Version: 2.4
-Name: tinycontracts
-Version: 0.1.0
-Summary: serve a folder of json/csv/parquet files as a rest api
-Author-email: Aditya Kumar <adityakuma0308@gmail.com>
-License-Expression: MIT
-Keywords: api,cli,csv,fastapi,json,parquet,rest
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Framework :: FastAPI
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
-Requires-Python: >=3.11
-Requires-Dist: fastapi>=0.128.0
-Requires-Dist: pandas>=3.0.0
-Requires-Dist: pyarrow>=23.0.0
-Requires-Dist: rich>=14.3.2
-Requires-Dist: typer>=0.21.1
-Requires-Dist: uvicorn>=0.40.0
-Description-Content-Type: text/markdown
-
-# tinycontracts
-
-Turn JSON, CSV, and Parquet files into REST APIs instantly.
-
-## Install
-
-```bash
-uv sync
-```
-
-## Usage
-
-```bash
-tinycontracts serve ./data
-```
-
-This scans `./data` for `.json`, `.csv`, and `.parquet` files and serves them as REST endpoints.
-
-## Example
-
-Given this structure:
-```
-data/
-  users.json
-  orders.csv
-  products.parquet
-```
-
-You get:
-```
-GET /users
-GET /orders
-GET /products
-```
-
-## Filtering
-
-Query any field:
-```
-GET /users?role=admin
-GET /orders?status=shipped&customer_id=123
-```
-
-## Schema
-
-Get the inferred JSON schema:
-```
-GET /users/schema
-```

tinycontracts-0.1.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-tc = tinycontracts.cli:app