flowlab 0.1.0__tar.gz

flowlab-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Flowmatic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

flowlab-0.1.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: flowlab
+Version: 0.1.0
+Summary: An API framework on FastAPI that also serves an MCP server and a command runner from the same app, with database, cache, migrations, auth, queues and rate limiting built in.
+Author: Flowmatic, UniForceMusic
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Flowmatic-AI/flowlab
+Project-URL: Repository, https://github.com/Flowmatic-AI/flowlab
+Project-URL: Documentation, https://github.com/Flowmatic-AI/flowlab/tree/main/package/docs
+Project-URL: Issues, https://github.com/Flowmatic-AI/flowlab/issues
+Keywords: fastapi,mcp,typer,framework,database,orm,cache,auth,queue,rate-limit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.135
+Requires-Dist: fastmcp>=3.0
+Requires-Dist: typer>=0.15
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: email-validator>=2.0
+Requires-Dist: bcrypt>=4.0
+Requires-Dist: PyJWT>=2.8
+Provides-Extra: postgres
+Requires-Dist: psycopg[binary]>=3.1; extra == "postgres"
+Provides-Extra: asyncpg
+Requires-Dist: asyncpg>=0.29; extra == "asyncpg"
+Provides-Extra: mysql
+Requires-Dist: mysql-connector-python>=9.0; extra == "mysql"
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == "redis"
+Provides-Extra: valkey
+Requires-Dist: valkey>=6.0; extra == "valkey"
+Provides-Extra: memcached
+Requires-Dist: pymemcache>=4.0; extra == "memcached"
+Provides-Extra: all
+Requires-Dist: psycopg[binary]>=3.1; extra == "all"
+Requires-Dist: asyncpg>=0.29; extra == "all"
+Requires-Dist: mysql-connector-python>=9.0; extra == "all"
+Requires-Dist: redis>=5.0; extra == "all"
+Requires-Dist: valkey>=6.0; extra == "all"
+Requires-Dist: pymemcache>=4.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: psycopg[binary]>=3.1; extra == "dev"
+Requires-Dist: mysql-connector-python>=9.0; extra == "dev"
+Requires-Dist: redis>=5.0; extra == "dev"
+Requires-Dist: valkey>=6.0; extra == "dev"
+Requires-Dist: pymemcache>=4.0; extra == "dev"
+Dynamic: license-file
+
+# flowlab
+
+An API framework like FastAPI that also serves an MCP server at `/mcp` and runs
+console commands, all from one app object. Database, cache, migrations and auth
+are built in.
+
+```bash
+pip install flowlab
+```
+
+```python
+from flowlab import AuthSettings, FlowLab
+
+app = FlowLab(auth_settings=AuthSettings())
+
+
+@app.get("/")
+def index() -> dict[str, str]:
+    return {"message": "Hello"}
+
+
+@app.tool
+def hello(name: str) -> str:
+    return f"Hello, {name}!"
+
+
+@app.command("hello:say")
+def say(name: str) -> None:
+    print(f"Hello, {name}!")
+
+
+if __name__ == "__main__":
+    app.run()
+```
+
+Every migration lives in the project's `migrations/` folder, including the
+ones auth needs. `python main.py auth:install` copies them in (the starter
+project already has them). For extra user fields, pass your own `user_model`;
+see [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md#your-user-model).
+
+```bash
+python main.py auth:install      # once: copies the users and api_keys migrations into migrations/
+python main.py migrations:up
+python main.py server:start      # or: flowlab server:start (loads main:app from the cwd)
+```
+
+## The FlowLab class
+
+`FlowLab(fastapi_settings=None, fastmcp_settings=None, typer_settings=None, *, database_settings=None, cache_settings=None, auth_settings=None, user_model=None, project_dir=None, **kwargs)`
+
+Every settings argument is optional; when it's left out, the settings are read
+from the environment and `.env`.
+
+FlowLab is a singleton: the database, cache, migrator and auth live on the one
+app.
+
+- `FlowLab.instance()` returns the app. Before one is created it raises
+  `FlowLabNotInitialized`, and so do `get_db()`, `get_cache()` and the `DB` /
+  `Cache` dependencies. Creating a second app raises
+  `FlowLabAlreadyInitialized`. `FlowLab.reset()` closes and forgets the app
+  (for tests); `FlowLab.initialized()` says whether one exists.
+- `app.db`, `app.cache`: the open connections. Outside `app.lifespan()` (or a
+  running server / command) they raise `NotConnected`.
+- `app.migrator`: a `Migrator` over the project's `migrations/` folder
+  (`app.migrations_dir`). The package never runs migrations of its own.
+- `app.auth`: the `AuthSettings`. Auth is on when `auth_settings` is passed,
+  which wires its routes, MCP tools and commands; otherwise
+  `app.auth` raises `AuthNotEnabled`.
+- `**kwargs` are passed to `FastAPI(...)`.
+- `project_dir` defaults to the directory of the file that creates the app. A
+  relative sqlite `DB_NAME` and the `migrations/` folder resolve against it.
+- `app` is itself an ASGI app (`uvicorn main:app` works). `app.api` is the
+  FastAPI instance, `app.mcp` the FastMCP server, `app.cli` the Typer app.
+- Routes: `app.get/post/put/patch/delete/api_route`, `app.include_router`,
+  `app.add_middleware`, `app.exception_handler`.
+- MCP: `app.tool`, `app.resource`, `app.prompt`. Served at `MCP_PATH` (`/mcp`)
+  as a stateless JSON route.
+- CLI: `app.command("namespace:verb", lifespan=True)`. Commands run inside the
+  app lifespan (database and cache open) unless `lifespan=False`.
+- `app.lifespan()` is the one lifecycle used by HTTP, MCP and the CLI.
+  `app.add_lifespan(factory)` adds a process-wide client to it. With
+  `CACHE_DRIVER=database`, opening the cache at startup runs
+  `CREATE TABLE IF NOT EXISTS` for `CACHE_TABLE`; there is no migration for it.
+- `app.include_module(module)` adds a module's routers. A module with
+  migration templates gets a `<name>:install` command that copies the ones the
+  project doesn't have yet into `migrations/`, and a module with a schema check
+  stops the server at startup with `SchemaMismatch` when its tables or columns
+  are missing.
+- `app.user_model`: your `BaseUser` subclass, passed as `user_model` (see
+  [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md#your-user-model)).
+- `app.include_router(router, **options)` takes all three kinds of router
+  (see below).
+
+Built-in commands: `server:start`, `migrations:init|up|down|fresh|make`, `test`,
+`queue:install|work|failed|retry|forget|flush|clear`.
+
+Run the CLI with `python main.py <command>`, `flowlab <command>` or
+`python -m flowlab <command>`. The last two load `main:app` from the working
+directory; pick another app with `--app module:attribute` or `FLOWLAB_APP`.
+
+## Routers
+
+Split a project over files with one router per surface, then include each one:
+
+```python
+from flowlab import APIRouter, CommandRouter, MCPRouter
+
+api = APIRouter(prefix="/posts")  # FastAPI's APIRouter
+
+
+@api.get("/")
+def posts() -> list[str]:
+    return []
+
+
+mcp = MCPRouter("posts")  # a FastMCP server
+
+
+@mcp.tool
+def count_posts() -> int:
+    return 0
+
+
+console = CommandRouter()
+
+
+@console.command("posts:prune")
+def prune() -> None:
+    print("Pruned.")
+
+
+app.include_router(api, tags=["posts"])  # options go to FastAPI.include_router
+app.include_router(mcp, namespace="posts")  # options go to FastMCP.mount; the tool becomes posts_count_posts
+app.include_router(console)
+```
+
+`flowlab` also re-exports the FastAPI names a project needs, so routes can
+import from one place: `APIRouter`, `Depends`, `HTTPException`, `Request`,
+`Response`, `Query`, `Path`, `Body`, `Header`, `Cookie`, `Form`, `File`,
+`UploadFile`, `BackgroundTasks`, `Security`, `WebSocket`, `WebSocketDisconnect`
+and `status`.
+
+## Settings
+
+All settings classes live in `flowlab._settings` and are exported from
+`flowlab`: `FastAPISettings`, `FastMCPSettings`, `TyperSettings`,
+`DatabaseSettings`, `CacheSettings`, `QueueSettings`, `AuthSettings`. They read the environment
+and `.env` (from the working directory and from the directory of the script
+being run).
+
+## Modules
+
+- `flowlab.modules.db`: query builder and ORM for SQLite,
+  PostgreSQL, MySQL and MariaDB. See [docs/db.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/db.md).
+- `flowlab.modules.cache`: memory, database, Redis, Valkey and Memcached
+  caches. See [docs/cache.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/cache.md).
+- `flowlab.modules.migrator`: file-based migrations, publishing templates, schema
+  drop helpers. See [docs/migrator.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/migrator.md).
+- `flowlab.modules.auth`: users, JWT login, API keys, MCP API key auth. See
+  [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md).
+- `flowlab.modules.ratelimit`: rate limits for routes and MCP tools, counted in
+  the cache. See [docs/ratelimit.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/ratelimit.md).
+- `flowlab.modules.queue`: background jobs with `@job`, workers and failed-job
+  commands, on the database, Redis or Valkey. See [docs/queue.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/queue.md).
+
+Extras: `flowlab[postgres]`, `flowlab[mysql]`, `flowlab[asyncpg]`,
+`flowlab[redis]`, `flowlab[valkey]`, `flowlab[memcached]`, `flowlab[all]`.

flowlab-0.1.0/README.md

@@ -0,0 +1,167 @@
+# flowlab
+
+An API framework like FastAPI that also serves an MCP server at `/mcp` and runs
+console commands, all from one app object. Database, cache, migrations and auth
+are built in.
+
+```bash
+pip install flowlab
+```
+
+```python
+from flowlab import AuthSettings, FlowLab
+
+app = FlowLab(auth_settings=AuthSettings())
+
+
+@app.get("/")
+def index() -> dict[str, str]:
+    return {"message": "Hello"}
+
+
+@app.tool
+def hello(name: str) -> str:
+    return f"Hello, {name}!"
+
+
+@app.command("hello:say")
+def say(name: str) -> None:
+    print(f"Hello, {name}!")
+
+
+if __name__ == "__main__":
+    app.run()
+```
+
+Every migration lives in the project's `migrations/` folder, including the
+ones auth needs. `python main.py auth:install` copies them in (the starter
+project already has them). For extra user fields, pass your own `user_model`;
+see [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md#your-user-model).
+
+```bash
+python main.py auth:install      # once: copies the users and api_keys migrations into migrations/
+python main.py migrations:up
+python main.py server:start      # or: flowlab server:start (loads main:app from the cwd)
+```
+
+## The FlowLab class
+
+`FlowLab(fastapi_settings=None, fastmcp_settings=None, typer_settings=None, *, database_settings=None, cache_settings=None, auth_settings=None, user_model=None, project_dir=None, **kwargs)`
+
+Every settings argument is optional; when it's left out, the settings are read
+from the environment and `.env`.
+
+FlowLab is a singleton: the database, cache, migrator and auth live on the one
+app.
+
+- `FlowLab.instance()` returns the app. Before one is created it raises
+  `FlowLabNotInitialized`, and so do `get_db()`, `get_cache()` and the `DB` /
+  `Cache` dependencies. Creating a second app raises
+  `FlowLabAlreadyInitialized`. `FlowLab.reset()` closes and forgets the app
+  (for tests); `FlowLab.initialized()` says whether one exists.
+- `app.db`, `app.cache`: the open connections. Outside `app.lifespan()` (or a
+  running server / command) they raise `NotConnected`.
+- `app.migrator`: a `Migrator` over the project's `migrations/` folder
+  (`app.migrations_dir`). The package never runs migrations of its own.
+- `app.auth`: the `AuthSettings`. Auth is on when `auth_settings` is passed,
+  which wires its routes, MCP tools and commands; otherwise
+  `app.auth` raises `AuthNotEnabled`.
+- `**kwargs` are passed to `FastAPI(...)`.
+- `project_dir` defaults to the directory of the file that creates the app. A
+  relative sqlite `DB_NAME` and the `migrations/` folder resolve against it.
+- `app` is itself an ASGI app (`uvicorn main:app` works). `app.api` is the
+  FastAPI instance, `app.mcp` the FastMCP server, `app.cli` the Typer app.
+- Routes: `app.get/post/put/patch/delete/api_route`, `app.include_router`,
+  `app.add_middleware`, `app.exception_handler`.
+- MCP: `app.tool`, `app.resource`, `app.prompt`. Served at `MCP_PATH` (`/mcp`)
+  as a stateless JSON route.
+- CLI: `app.command("namespace:verb", lifespan=True)`. Commands run inside the
+  app lifespan (database and cache open) unless `lifespan=False`.
+- `app.lifespan()` is the one lifecycle used by HTTP, MCP and the CLI.
+  `app.add_lifespan(factory)` adds a process-wide client to it. With
+  `CACHE_DRIVER=database`, opening the cache at startup runs
+  `CREATE TABLE IF NOT EXISTS` for `CACHE_TABLE`; there is no migration for it.
+- `app.include_module(module)` adds a module's routers. A module with
+  migration templates gets a `<name>:install` command that copies the ones the
+  project doesn't have yet into `migrations/`, and a module with a schema check
+  stops the server at startup with `SchemaMismatch` when its tables or columns
+  are missing.
+- `app.user_model`: your `BaseUser` subclass, passed as `user_model` (see
+  [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md#your-user-model)).
+- `app.include_router(router, **options)` takes all three kinds of router
+  (see below).
+
+Built-in commands: `server:start`, `migrations:init|up|down|fresh|make`, `test`,
+`queue:install|work|failed|retry|forget|flush|clear`.
+
+Run the CLI with `python main.py <command>`, `flowlab <command>` or
+`python -m flowlab <command>`. The last two load `main:app` from the working
+directory; pick another app with `--app module:attribute` or `FLOWLAB_APP`.
+
+## Routers
+
+Split a project over files with one router per surface, then include each one:
+
+```python
+from flowlab import APIRouter, CommandRouter, MCPRouter
+
+api = APIRouter(prefix="/posts")  # FastAPI's APIRouter
+
+
+@api.get("/")
+def posts() -> list[str]:
+    return []
+
+
+mcp = MCPRouter("posts")  # a FastMCP server
+
+
+@mcp.tool
+def count_posts() -> int:
+    return 0
+
+
+console = CommandRouter()
+
+
+@console.command("posts:prune")
+def prune() -> None:
+    print("Pruned.")
+
+
+app.include_router(api, tags=["posts"])  # options go to FastAPI.include_router
+app.include_router(mcp, namespace="posts")  # options go to FastMCP.mount; the tool becomes posts_count_posts
+app.include_router(console)
+```
+
+`flowlab` also re-exports the FastAPI names a project needs, so routes can
+import from one place: `APIRouter`, `Depends`, `HTTPException`, `Request`,
+`Response`, `Query`, `Path`, `Body`, `Header`, `Cookie`, `Form`, `File`,
+`UploadFile`, `BackgroundTasks`, `Security`, `WebSocket`, `WebSocketDisconnect`
+and `status`.
+
+## Settings
+
+All settings classes live in `flowlab._settings` and are exported from
+`flowlab`: `FastAPISettings`, `FastMCPSettings`, `TyperSettings`,
+`DatabaseSettings`, `CacheSettings`, `QueueSettings`, `AuthSettings`. They read the environment
+and `.env` (from the working directory and from the directory of the script
+being run).
+
+## Modules
+
+- `flowlab.modules.db`: query builder and ORM for SQLite,
+  PostgreSQL, MySQL and MariaDB. See [docs/db.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/db.md).
+- `flowlab.modules.cache`: memory, database, Redis, Valkey and Memcached
+  caches. See [docs/cache.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/cache.md).
+- `flowlab.modules.migrator`: file-based migrations, publishing templates, schema
+  drop helpers. See [docs/migrator.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/migrator.md).
+- `flowlab.modules.auth`: users, JWT login, API keys, MCP API key auth. See
+  [docs/auth.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/auth.md).
+- `flowlab.modules.ratelimit`: rate limits for routes and MCP tools, counted in
+  the cache. See [docs/ratelimit.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/ratelimit.md).
+- `flowlab.modules.queue`: background jobs with `@job`, workers and failed-job
+  commands, on the database, Redis or Valkey. See [docs/queue.md](https://github.com/Flowmatic-AI/flowlab/blob/main/package/docs/queue.md).
+
+Extras: `flowlab[postgres]`, `flowlab[mysql]`, `flowlab[asyncpg]`,
+`flowlab[redis]`, `flowlab[valkey]`, `flowlab[memcached]`, `flowlab[all]`.

flowlab-0.1.0/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flowlab"
+version = "0.1.0"
+description = "An API framework on FastAPI that also serves an MCP server and a command runner from the same app, with database, cache, migrations, auth, queues and rate limiting built in."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["fastapi", "mcp", "typer", "framework", "database", "orm", "cache", "auth", "queue", "rate-limit"]
+
+authors = [
+    {name = "Flowmatic"},
+    {name = "UniForceMusic"},
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Framework :: FastAPI",
+    "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "fastapi>=0.135",
+    "fastmcp>=3.0",
+    "typer>=0.15",
+    "uvicorn[standard]>=0.30",
+    "pydantic>=2.0",
+    "pydantic-settings>=2.0",
+    "email-validator>=2.0",
+    "bcrypt>=4.0",
+    "PyJWT>=2.8",
+]
+
+[project.optional-dependencies]
+postgres = ["psycopg[binary]>=3.1"]
+asyncpg = ["asyncpg>=0.29"]
+mysql = ["mysql-connector-python>=9.0"]
+redis = ["redis>=5.0"]
+valkey = ["valkey>=6.0"]
+memcached = ["pymemcache>=4.0"]
+all = [
+    "psycopg[binary]>=3.1",
+    "asyncpg>=0.29",
+    "mysql-connector-python>=9.0",
+    "redis>=5.0",
+    "valkey>=6.0",
+    "pymemcache>=4.0",
+]
+dev = [
+    "build>=1.2",
+    "twine>=5.0",
+    "pytest>=7.0",
+    "httpx>=0.27",
+    "mypy>=1.0",
+    "ruff>=0.1",
+    "psycopg[binary]>=3.1",
+    "mysql-connector-python>=9.0",
+    "redis>=5.0",
+    "valkey>=6.0",
+    "pymemcache>=4.0",
+]
+
+[project.scripts]
+flowlab = "flowlab._console:main"
+
+[project.urls]
+Homepage = "https://github.com/Flowmatic-AI/flowlab"
+Repository = "https://github.com/Flowmatic-AI/flowlab"
+Documentation = "https://github.com/Flowmatic-AI/flowlab/tree/main/package/docs"
+Issues = "https://github.com/Flowmatic-AI/flowlab/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+flowlab = ["py.typed", "**/migrations/*.py"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = ["--import-mode=importlib"]
+
+[tool.mypy]
+strict = true
+python_version = "3.12"
+ignore_missing_imports = true
+
+[tool.ruff]
+target-version = "py312"
+line-length = 120
+
+[tool.ruff.lint]
+ignore = ["UP040", "UP046", "UP047"]
+
+[tool.ruff.lint.flake8-bugbear]
+extend-immutable-calls = [
+    "flowlab.modules.auth.CurrentMCPUser",
+    "flowlab.modules.auth._mcp.CurrentMCPUser",
+    "flowlab.modules.ratelimit.MCPRateLimit",
+    "flowlab.modules.ratelimit._mcp.MCPRateLimit",
+]

flowlab-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flowlab-0.1.0/src/flowlab/__init__.py

@@ -0,0 +1,109 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from fastapi import (
+    APIRouter,
+    BackgroundTasks,
+    Body,
+    Cookie,
+    Depends,
+    File,
+    Form,
+    Header,
+    HTTPException,
+    Path,
+    Query,
+    Request,
+    Response,
+    Security,
+    UploadFile,
+    WebSocket,
+    WebSocketDisconnect,
+    status,
+)
+from fastmcp.dependencies import Depends as MCPDepends
+
+from flowlab._cache import Cache, get_cache
+from flowlab._database import DB, INTEGRITY_ERRORS, get_db
+from flowlab._exceptions import (
+    AuthNotEnabled,
+    FlowLabAlreadyInitialized,
+    FlowLabError,
+    FlowLabNotInitialized,
+    NotConnected,
+    SchemaMismatch,
+)
+from flowlab._flowlab import FlowLab
+from flowlab._module import Module
+from flowlab._queue import get_queue
+from flowlab._routing import Command, CommandRouter, MCPRouter
+from flowlab._settings import (
+    AppEnv,
+    AuthSettings,
+    CacheDriver,
+    CacheSettings,
+    DatabaseSettings,
+    DBDriver,
+    FastAPISettings,
+    FastMCPSettings,
+    QueueDriver,
+    QueueSettings,
+    TyperSettings,
+)
+from flowlab._state import get_app
+
+try:
+    __version__ = version("flowlab")
+except PackageNotFoundError:  # pragma: no cover - running from a source tree without metadata
+    __version__ = "0.0.0"
+
+__all__ = [
+    "DB",
+    "INTEGRITY_ERRORS",
+    "APIRouter",
+    "AppEnv",
+    "AuthNotEnabled",
+    "AuthSettings",
+    "BackgroundTasks",
+    "Body",
+    "Cache",
+    "CacheDriver",
+    "CacheSettings",
+    "Command",
+    "CommandRouter",
+    "Cookie",
+    "DBDriver",
+    "DatabaseSettings",
+    "Depends",
+    "FastAPISettings",
+    "FastMCPSettings",
+    "File",
+    "FlowLab",
+    "FlowLabAlreadyInitialized",
+    "FlowLabError",
+    "FlowLabNotInitialized",
+    "Form",
+    "HTTPException",
+    "Header",
+    "MCPDepends",
+    "MCPRouter",
+    "Module",
+    "NotConnected",
+    "Path",
+    "Query",
+    "QueueDriver",
+    "QueueSettings",
+    "Request",
+    "Response",
+    "SchemaMismatch",
+    "Security",
+    "TyperSettings",
+    "UploadFile",
+    "WebSocket",
+    "WebSocketDisconnect",
+    "__version__",
+    "get_app",
+    "get_cache",
+    "get_db",
+    "get_queue",
+    "status",
+]

flowlab-0.1.0/src/flowlab/__main__.py

@@ -0,0 +1,3 @@
+from flowlab._console import main
+
+main()