MeowCat 1.2.35__py3-none-any.whl

meowcat/__init__.py

@@ -0,0 +1,40 @@
+"""meowcat — An agent framework built on the biological blueprint of a cat. Depends on pydantic>=2.0 + anyio>=4.0, zero meowagent imports."""
+# (c) 2025-2026 Axonant. MIT License.
+
+from __future__ import annotations
+
+import importlib
+import pathlib
+import re
+
+from meowcat._exports import __all__, _LAZY_MAP, _SUBMODULES
+
+# -- Version (eager — tiny and universally accessed) ----------------------
+_pyproject = pathlib.Path(__file__).resolve().parent.parent / "pyproject.toml"
+_match = re.search(r'^version\s*=\s*["\']([^"\']+)["\']',
+                   _pyproject.read_text(encoding="utf-8"), re.MULTILINE)
+__version__ = _match.group(1) if _match else "0.0.0"
+
+
+def __getattr__(name: str):
+    """PEP 562 lazy import — only loads a module on first access.
+
+    ``import meowcat`` costs ~2 ms instead of ~80 ms because nothing
+    beyond ``_exports.py`` + ``__init__.py`` is imported eagerly.
+    """
+    # Submodule access: meowcat.anatomy, meowcat.biology, meowcat.organ_roles
+    if name in _SUBMODULES:
+        module = importlib.import_module(f"meowcat.{name}")
+        globals()[name] = module
+        return module
+
+    # Named symbol access: meowcat.CatBase, meowcat.Nervous, etc.
+    entry = _LAZY_MAP.get(name)
+    if entry is not None:
+        mod_path, attr = entry
+        module = importlib.import_module(mod_path)
+        value = getattr(module, attr)
+        globals()[name] = value
+        return value
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

meowcat/__main__.py

@@ -0,0 +1,82 @@
+"""python -m meowcat new <name> -- cat project scaffolding.
+
+Comparable to Flask ``flask new`` / FastAPI ``fastapi new`` -- minimal.
+"""
+# (c) 2025-2026 Axonant. MIT License.
+
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+TEMPLATES: dict[str, str] = {
+    "cat.py": '''"""{{name}} -- your custom cat."""
+from meowcat import Colony
+from meowcat.defaults import create_cat
+from meowcat.defaults.stores import InMemorySharedStore
+
+
+class EchoCerebrum:
+    name = "echo_cerebrum"
+
+    async def generate(self, prompt, system_prompt=None, temperature=0.7, max_tokens=None):
+        return f"[Echo] Received: {prompt[:200]}"
+
+    async def stream_generate(self, prompt, system_prompt=None, temperature=0.7, max_tokens=None):
+        yield f"[Echo] {prompt[:200]}"
+
+    def reload_config(self):
+        pass
+
+    def diagnose(self):
+        return {"echo": True}
+
+
+async def main() -> None:
+    colony = Colony("{{name}}-colony", storage=InMemorySharedStore())
+    cat = create_cat("{{name}}", container=colony, cerebrum=EchoCerebrum())
+    await cat.start()
+    result = await cat.run_loop("conversation", message="Hello!")
+    print(result)
+    await cat.shutdown()
+''',
+    "main.py": '''"""{{name}} entry point."""
+import asyncio
+from cat import main
+
+if __name__ == "__main__":
+    asyncio.run(main())
+''',
+}
+
+
+def new_project(name: str, target_dir: Path | None = None) -> Path:
+    """Generate meowcat skeleton project."""
+    dir_ = (target_dir or Path.cwd()) / name
+    dir_.mkdir(parents=True, exist_ok=True)
+
+    for filename, template in TEMPLATES.items():
+        content = template.replace("{{name}}", name)
+        (dir_ / filename).write_text(content)
+
+    print(f"Created {dir_}/")
+    print(f"  {name}/cat.py")
+    print(f"  {name}/main.py")
+    print(f"\ncd {name} && python main.py")
+    return dir_
+
+
+def main() -> None:
+    """python -m meowcat CLI entry point."""
+    if len(sys.argv) < 3 or sys.argv[1] != "new":
+        print("Usage: python -m meowcat new <project-name>")
+        print("Example: python -m meowcat new my-cat")
+        sys.exit(1)
+
+    name = sys.argv[2]
+    new_project(name)
+
+
+if __name__ == "__main__":
+    main()