feat(cli): added cli support for project initialization

pyproject.toml

@@ -12,6 +12,11 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
+dependencies = [
+  "pyclack-cli[prompts]==0.4.0",
+  "asyncclick==8.3.0.5",
+  "anyio==4.11.0"
+]
 
 [build-system]
 requires = ["setuptools>=61.0"]
@@ -26,6 +31,9 @@ build-backend = "setuptools.build_meta"
 Repository = "https://github.com/serv-c/servc-python.git"
 Documentation = "https://docs.servc.io/"
 
+[project.scripts]
+servc = "servc.cli:cli"
+
 [tool.semantic_release]
 assets = []
 commit_message = "{version}\n\nAutomatically generated by python-semantic-release"

servc/__main__.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""
+Main entry point for the servc CLI when run as a module.
+This allows the package to be executed with: python -m servc
+"""
+
+import asyncio
+from servc.cli import cli, click
+
+
+def main():
+    """Main entry point for the CLI."""
+    try:
+        asyncio.run(cli())
+    except KeyboardInterrupt:
+        click.secho("Operation cancelled.", fg="red")
+    except Exception as e:
+        click.secho(f"{e}", fg="red")
+        raise
+
+
+if __name__ == "__main__":
+    main()

servc/cli/__init__.py

@@ -0,0 +1,21 @@
+
+import asyncclick as click
+
+from servc.cli.config import config
+from servc.cli.commands import init
+
+
+@click.group()
+@config
+async def cli(ctx):
+    """servc CLI - A tool for servc services.
+
+    Create and manage servc projects.
+
+    Common commands:
+
+      init    Initialize a new servc project
+    """
+    pass
+
+cli.add_command(init)

servc/cli/commands/__init__.py

@@ -0,0 +1 @@
+from servc.cli.commands.init import cli as init

servc/cli/commands/init/__init__.py

@@ -0,0 +1 @@
+from servc.cli.commands.init.src import cli