kctl-api 0.2.0__py3-none-any.whl

kctl_api/core/utils.py

@@ -0,0 +1,109 @@
+"""Shared utility functions."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+# Known apps in the kodemeio-fastapi monorepo
+KNOWN_APPS: dict[str, dict[str, str]] = {
+    "api-main": {"type": "API", "port": "8000", "module": "kodemeio_api_main"},
+    "ai-main": {"type": "AI API", "port": "8010", "module": "kodemeio_ai_main"},
+    "odoo-mm": {"type": "Integration", "port": "8003", "module": "kodemeio_odoo_mm"},
+    "plane-mm": {"type": "Integration", "port": "8004", "module": "kodemeio_plane_mm"},
+    "webhook-github": {"type": "Webhook", "port": "8005", "module": "kodemeio_webhook_github"},
+    "webhook-chatwoot": {"type": "Webhook", "port": "8006", "module": "kodemeio_webhook_chatwoot"},
+    "events-sync": {"type": "Events", "port": "", "module": "kodemeio_events_sync"},
+    "agent-main": {"type": "Agent", "port": "", "module": "kodemeio_agent_main"},
+    "etl-main": {"type": "ETL", "port": "", "module": "kodemeio_etl_main"},
+    "mcp-main": {"type": "MCP", "port": "", "module": "kodemeio_mcp_main"},
+    "scheduler-main": {"type": "Scheduler", "port": "", "module": "kodemeio_scheduler_main"},
+    "stream-main": {"type": "Stream", "port": "8002", "module": "kodemeio_stream_main"},
+    "ctl-main": {"type": "CLI", "port": "", "module": "kodemeio_cli_main"},
+    "tenant-ai-main": {"type": "Tenant AI", "port": "", "module": "kodemeio_tenant_ai_main"},
+}
+
+
+def service_status_color(status: str) -> str:
+    """Return Rich color markup for service status."""
+    colors = {
+        "running": "[green]running[/green]",
+        "healthy": "[green]healthy[/green]",
+        "unhealthy": "[red]unhealthy[/red]",
+        "stopped": "[dim]stopped[/dim]",
+        "starting": "[yellow]starting[/yellow]",
+        "error": "[red]error[/red]",
+        "ok": "[green]ok[/green]",
+    }
+    return colors.get(status.lower(), status)
+
+
+def role_color(role: str) -> str:
+    """Return Rich color markup for user role."""
+    colors = {
+        "admin": "[bold red]admin[/bold red]",
+        "user": "[cyan]user[/cyan]",
+    }
+    return colors.get(role.lower(), role)
+
+
+def tier_color(tier: str) -> str:
+    """Return Rich color markup for user tier."""
+    colors = {
+        "admin": "[bold red]admin[/bold red]",
+        "premium": "[bold yellow]premium[/bold yellow]",
+        "user": "[cyan]user[/cyan]",
+        "free": "[dim]free[/dim]",
+    }
+    return colors.get(tier.lower(), tier)
+
+
+def find_project_root() -> Path:
+    """Find the kodemeio-fastapi project root.
+
+    Resolution order:
+    1. Walk up from CWD looking for markers (pyproject.toml with kodemeio-fastapi, docker-compose.yml + apps/)
+    2. Read ``project_root`` from config profile (~/.config/kodemeio/config.yaml)
+    3. Fall back to CWD
+    """
+    # 1. CWD walk (fast, no config I/O)
+    cwd = Path.cwd()
+    for parent in [cwd, *cwd.parents]:
+        pyproject = parent / "pyproject.toml"
+        if pyproject.exists():
+            try:
+                content = pyproject.read_text()
+                if 'name = "kodemeio-fastapi"' in content:
+                    return parent
+            except Exception:
+                pass
+        if (parent / "docker-compose.yml").exists() and (parent / "apps").is_dir():
+            return parent
+
+    # 2. Config profile fallback
+    try:
+        from kctl_api.core.config import get_project_root_from_config
+
+        config_root = get_project_root_from_config()
+        if config_root is not None:
+            return config_root
+    except Exception:
+        pass
+
+    # 3. CWD fallback
+    return cwd
+
+
+def human_size(size_bytes: int | float) -> str:
+    """Format byte count as human-readable string."""
+    for unit in ("B", "KB", "MB", "GB", "TB"):
+        if abs(size_bytes) < 1024:
+            return f"{size_bytes:.1f} {unit}"
+        size_bytes /= 1024
+    return f"{size_bytes:.1f} PB"
+
+
+def mask_secret(value: str, show_chars: int = 4) -> str:
+    """Mask a secret string, showing only the last N characters."""
+    if not value or len(value) <= show_chars:
+        return "***"
+    return f"***{value[-show_chars:]}"

kctl_api-0.2.0.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: kctl-api
+Version: 0.2.0
+Summary: Kodemeio API CLI - manage your FastAPI platform
+Author-email: Kodemeio <dev@kodeme.io>
+License-Expression: MIT
+Keywords: api,cli,fastapi,kodemeio,rest
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: kctl-lib>=0.4.0
+Provides-Extra: all
+Requires-Dist: asyncpg>=0.30.0; extra == 'all'
+Requires-Dist: redis>=5.0.0; extra == 'all'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'all'
+Provides-Extra: db
+Requires-Dist: asyncpg>=0.30.0; extra == 'db'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'db'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.14.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.35.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0.0; extra == 'redis'

kctl_api-0.2.0.dist-info/RECORD

@@ -0,0 +1,66 @@
+kctl_api/__init__.py,sha256=Vlkbhn3ncthEoN2V5MLQn_eeMajEIW9Hh0LbHX8JJIE,57
+kctl_api/__main__.py,sha256=zxgO82u5ch50ue_nnR-X7JfCFzpM0hr88sq5FFAp4bo,82
+kctl_api/cli.py,sha256=InWwpo1KXciTHQW3Z6YNdknEHUGTsPCcWawsJit14FE,9113
+kctl_api/commands/__init__.py,sha256=fNB66xHJTlbQl3f7UQralX19ZSDz6P1mWY9gcnGnw-o,35
+kctl_api/commands/ai.py,sha256=dqkT-QmfJEHEnmzyA0CuiCPruowBjtQ3nAuNaK3OTT4,8100
+kctl_api/commands/aliases.py,sha256=wjK_Pk03BDPJNj6_U3-9fRCF3I1RI0hDvZx2plPyuMc,3026
+kctl_api/commands/apps.py,sha256=YLgD6j_pN5n78q-yjuPBqn8iQNhBYYfq9NGJvjI_3w8,5154
+kctl_api/commands/auth.py,sha256=nmWvqQarf1lQcyhpzG2rl3R44hc1gKyKR6Cy1FVZ24c,10278
+kctl_api/commands/automation.py,sha256=U6t21LmAPl8pwvGE4H-I_xCz47lIoNmRv-hn2ZyHt7c,7845
+kctl_api/commands/build_cmd.py,sha256=Om2wllEfl-TDdI3voleuMmeHyMwvcjB_Flrgh4qUcZg,2805
+kctl_api/commands/clean.py,sha256=lObvQMwRa7Urr2cg1496lqekR4UodWjVtT3ABmnDQt4,6568
+kctl_api/commands/config_cmd.py,sha256=5-duFy9mOKCFJCgWzYno73YiAGG0AkiUtrHg8glWXkI,14510
+kctl_api/commands/dashboard.py,sha256=7E1_whoQcYHRC5pGKt_eN5tLZ4e5W8YfPK8LmvXnyEU,4808
+kctl_api/commands/db.py,sha256=QI-V9lo9S0qOGqFifX7jE45RDvlCMNT7jFfIOx3VBj4,20069
+kctl_api/commands/deploy.py,sha256=VYeu20I4PJdqBHK75JVWO3QyAn1hQdqSp-id7oYQeRI,3070
+kctl_api/commands/deps.py,sha256=iqQVTfmqxwcbfSPiJGf8y-PkiAASAQEiShAfJocW6bk,9991
+kctl_api/commands/dev.py,sha256=G6RYlaFDMJBHeGrNJmmjAsAeu-mrHT32AzJvPy-ljlI,4803
+kctl_api/commands/docker_cmd.py,sha256=G1JQpy3zTLuhUGLunDNy6Z96njqUlLa6oQuSnpMV3SI,7524
+kctl_api/commands/doctor_cmd.py,sha256=wrtqVDrbB0NekGQth7Cj1Ip72HluU3wkM6-Jp8e3OsM,9170
+kctl_api/commands/env.py,sha256=ZhjLlfEZQQ058B7SbmXXK8lrCfd2W03B89BqkLm1qs4,10092
+kctl_api/commands/files.py,sha256=wEjvUuwmdhmx_jdj94aXRC5Buf3GqNTwj9-aqaIF6tU,8348
+kctl_api/commands/fmt_cmd.py,sha256=3R1qHRSe9ubwsfupFkWko1PHBTX5XpD02TVE1qpE9RU,1732
+kctl_api/commands/health.py,sha256=KQpoKVqjKEfLAtGXS00K6bpofCyZAOlBsx0foqjcOUg,16159
+kctl_api/commands/jobs.py,sha256=liM0FfkQdaMxPjSPMZbgOfSQNAheQwNxzPkgfvFM6gE,5286
+kctl_api/commands/lint_cmd.py,sha256=5I1P0JdKSjgtIhH-K8pj3o_vO2nkY7EbnQ8sYcA7sBI,2375
+kctl_api/commands/logs.py,sha256=aYuThlOHIaFJuWsJRPEfnSIZKLi_pISVl9lhaDvlyr8,9146
+kctl_api/commands/marketplace.py,sha256=4xIGZ9QjMHVklpc4FHxcY41trvkRCInRiwGAb_RaOrM,10153
+kctl_api/commands/monitor_cmd.py,sha256=27xCojDxGjFIuhIcXgD3nBWE8XZbeUHQPQMQny9lIjc,8797
+kctl_api/commands/notifications.py,sha256=LFLd8d9rY_MytfQI_a7UoDIBX3yPqEcz88QxmFPRor4,4466
+kctl_api/commands/odoo_proxy.py,sha256=swMvBUMHubOfvdVWuB9Z5gpJ1ThM0IEoIQt5IX4oBVE,6104
+kctl_api/commands/openapi.py,sha256=lYiedbo3oC8PoNjNeygCCuYLitwphWnG_u6e_7jH_Z0,10552
+kctl_api/commands/perf.py,sha256=m8cdZfWFTyKaeSEIYD6odN0H6tLrencePkGYBTF5Gg4,10919
+kctl_api/commands/rate_limit.py,sha256=r5YE1TTUwypTSWZacjPT0LtU3cS7yMpVNCud3-sm74g,7570
+kctl_api/commands/realtime.py,sha256=D6c46aSnsLp1S0r_Y8ATIMJ2qQbesTvmzuzNEDOZMqo,3248
+kctl_api/commands/redis_cmd.py,sha256=i4ISRaXYKs0Z-nMVJo4C2MqtT9SuTyG4Xf2JXOQAQ4s,19194
+kctl_api/commands/routes_cmd.py,sha256=5TaDVF5OV--JoookRjPynaERPNuUpHMCoiCHzsswXfU,9247
+kctl_api/commands/saas.py,sha256=Mz3S_b1gydiDq-aKSXNmOCezfeU-be19Vm4bcKcnCGI,4710
+kctl_api/commands/scaffold.py,sha256=zg1l-niKLOZfM_tBDcTgQepaN3BCv2kmMzsm-gCMuI0,12720
+kctl_api/commands/security_cmd.py,sha256=4j29fMbDMO8LZ89qphYqWTGnV0GwQOkSc9gNcjQhw4U,12022
+kctl_api/commands/services.py,sha256=66fq1imKJa5acRF96sWoOohfNCpIdCcsLSck61Ff9gE,6216
+kctl_api/commands/shell.py,sha256=95jqn1u4WSp36zMgaNu5mXptkNnKDAmel8Lx9_ahA38,5336
+kctl_api/commands/skill_cmd.py,sha256=8SxwdX3e8flNOqYheu4tY6HZcJ592VBXxuPFk8STIgw,1772
+kctl_api/commands/streams.py,sha256=2i-JWV--JVWK8KCCH1au-wjuD6ztLkD12aOqBNgZIQ4,10071
+kctl_api/commands/stripe_cmd.py,sha256=segH1LsyPZp2oE7vcKHBmIOnQrCtCTH8uHZFkrTOtks,3497
+kctl_api/commands/tenant_ai.py,sha256=lJ1Ucn0AfBqcobSvIMNCOWTThE6FTJNhP_ZgcL0szSM,5473
+kctl_api/commands/test_cmd.py,sha256=C0CKOwUuYG-xZNEo9sDYq0lNY7t7dLo35YjfSmgnfBU,3256
+kctl_api/commands/users.py,sha256=R0X7prMNgngzljYEQ55I88mhF9kzZ1TSz1U7hMDTvdQ,10039
+kctl_api/commands/webhooks.py,sha256=1ae0TzT50es6cvXqf6dQp26g2jogcsOL5Rd9aotjoQg,2245
+kctl_api/commands/workflows.py,sha256=NgJwF5RzqyL4hmGCUoy7a_cUWyvURlLD_sSAMhy3UOM,4059
+kctl_api/commands/ws.py,sha256=Nf4wq_TuT7jEsF3u5mh7JQykh3rXnGhyh_dSXRpHwtk,11858
+kctl_api/core/__init__.py,sha256=1E1CQ_u3wHjRaO3ZJ531KP1r_ZaCjz1nvvcg_0t5Vbw,40
+kctl_api/core/async_client.py,sha256=cQXfu7CnJFeu1b7of0cc0afBYnH9aC7YcPvc0wGuYgs,4097
+kctl_api/core/callbacks.py,sha256=te9QQ3qObkKZbdToH5r3OSK5RPkN-E7pt7xaoTFtRN0,2978
+kctl_api/core/client.py,sha256=Q2yYCoKwmLwUSck0DBG1yxeYF8VPuzyh2jxvhQeh3V8,6845
+kctl_api/core/config.py,sha256=Izk2nH85K311QYN01X1FA6x7hutnMUIMSNGKY0zbKGw,7745
+kctl_api/core/db.py,sha256=-dm1oVGA4Evg7nWTb9U-g90Pq-gMQ4CjdczQD3Rv_RA,1843
+kctl_api/core/exceptions.py,sha256=FRU2C2u2BuWVeqXUNfajsQ9bZu_7x-psDTOdQ_e5NEg,1155
+kctl_api/core/output.py,sha256=irTgk_u3pGmOEViFXq1Tr10SFB0qFqiAc9hwpig7Dw8,110
+kctl_api/core/plugins.py,sha256=8yOowxgD7ykeraDSyWw3zMqCgNSKYRuzV5bW9366tdg,847
+kctl_api/core/redis.py,sha256=GC5ZP8SuSZ1GD76V2W-DHHStfPKKHdMxkZOdb1kL-qs,932
+kctl_api/core/resolve.py,sha256=_7FdRQbFOJyFWnWwGCw-7Ox3638G0eNzr3PnPWlZ3jM,1297
+kctl_api/core/utils.py,sha256=o7bZLOA_33pUtsdp3kFu_lXqEiySNAH3qS3xAH2y1ZY,4072
+kctl_api-0.2.0.dist-info/METADATA,sha256=WwDI6Wood7eexcgg6lLZNdqIVl7dNnxqod4rd0YAupw,1354
+kctl_api-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+kctl_api-0.2.0.dist-info/entry_points.txt,sha256=rkHu58uDHn-s_Fjj4_JyGzjlkAqdhOe-ptvjXCZwDRw,47
+kctl_api-0.2.0.dist-info/RECORD,,

kctl_api-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

kctl_api-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kctl-api = kctl_api.cli:_run