abstract_flask

A composable toolkit for standing up Flask APIs without repeating yourself. Handles blueprint discovery, CORS, request parsing, endpoint introspection, and route generation — so the only code you write is the code that matters.

Install

pip install abstract_flask

Quickstart

# my_api/__init__.py
from . import routes
from abstract_flask import get_Flask_app

app = get_Flask_app(routes=routes, allowed_origins=["https://yourdomain.com"])

That's it. Blueprints are discovered from any *_bp objects in your routes module, CORS is applied, and introspection endpoints are registered automatically.

Full signature

app = get_Flask_app(
    name="my_api",              # Flask app name (default: caller's __name__)
    routes=routes,              # module to scan for *_bp Blueprints
    bp_list=None,               # or pass blueprints explicitly
    url_prefix="v1",            # prefix for blueprint registration + filtered /endpoints
    allowed_origins=["https://example.com"],
    supports_credentials=True,
)

Running

from abstract_flask import main_flask_start

main_flask_start(app, key_head="MYAPI", env_path=".env")
# reads MYAPI_DEBUG, MYAPI_HOST, MYAPI_PORT from env

Package structure

abstract_flask/
├── abstract_flask.py        # App factory, CORS, audit logging, introspection
├── request_utils/
│   ├── request_utils.py     # get_request_data, extract_request_data
│   ├── get_requests.py      # required_keys, execute_request, get_spec_kwargs
│   └── parse_utils.py       # parse_request, parse_and_spec_vars
├── network_utils/
│   └── ip_utils.py          # get_host_ip, get_user_ip, get_ip_addr
├── user_utils/
│   └── user_utils.py        # get_user_name (from request or fallback)
└── generator/
    ├── generateFlaskRoute.py # Auto-generate Flask routes from Python files
    └── help_utils.py         # ?help introspection for any endpoint

Core modules

App factory (`abstract_flask.py`)

Function	Purpose
`get_Flask_app(...)`	One-call app factory: blueprints, CORS, logging, introspection
`get_bp(name, abs_path)`	Create a named Blueprint with a logger
`main_flask_start(app)`	Run the app using env-driven host/port/debug

Every app gets these endpoints for free:

GET /endpoints — all registered routes
GET /<prefix>/endpoints — routes under that prefix
GET /prefixes — unique top-level route segments

Request utilities (`request_utils/`)

from abstract_flask.request_utils import get_request_data, required_keys, parse_request

get_request_data(req) — Returns a dict from JSON body, form data, or query string (checked in that order).
extract_request_data(req, res_type) — Full extraction: user, IP, headers, cookies, files, metadata. Pass res_type to narrow scope.
required_keys(keys, req, defaults) — Validate that required keys are present; returns the data dict or a 400 error payload.
parse_request(req) — Split a request into positional args and kwargs.
get_spec_kwargs(var_types, args, **kwargs) — Type-coerced argument extraction against a schema.

Route generator (`generator/`)

Auto-generate Flask endpoints from plain Python files:

from abstract_flask.generator import generate_from_files

source = generate_from_files(
    directory="./my_functions",
    bp_name="auto_bp",
    url_prefix="generated",
)

Every public function becomes a GET/POST endpoint. Async functions are preserved. Pass ?help to any generated endpoint to get parameter introspection via offer_help.

from abstract_flask.generator import register_category

register_category(bp, "math", {
    "add": lambda a, b: a + b,
    "multiply": lambda a, b: a * b,
})
# creates /math/add, /math/multiply

Network utilities (`network_utils/`)

from abstract_flask.network_utils import get_host_ip, get_user_ip

User utilities (`user_utils/`)

from abstract_flask.user_utils import get_user_name

Resolves username from the request's .user attribute, falling back to IP-based lookup via UserIPManager.

Dependencies

flask, flask_cors, werkzeug
abstract_utilities, abstract_security, abstract_queries

License

MIT

Author

putkoff — partners@abstractendeavors.com

Metadata

Release files for abstract-flask 0.0.0.1060

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for abstract-flask 0.0.0.1060
File	Size	Uploaded
abstract_flask-0.0.0.1060.tar.gz	32.2 kB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for abstract-flask 0.0.0.1060
File	Interpreter	ABI	Platform	Reset
abstract_flask-0.0.0.1060-py3-none-any.whl 32.8 kB Oct 16, 2026	Python 3	none	any	Details

Total release size: 65.0 kB

Release files / abstract_flask-0.0.0.1060.tar.gz

Download URL	abstract_flask-0.0.0.1060.tar.gz
Size	32.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`db47d5e95f7c6ada0010706d03b4a15bd9d3d7ffde2077d4b1e689b3223f8666`
BLAKE2b-256 checksum How to use checksums	`804db5682f1105d0cf712603f16eec26fcfc2ba5f588907d42de2221ce3efba4`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / abstract_flask-0.0.0.1060-py3-none-any.whl

Download URL	abstract_flask-0.0.0.1060-py3-none-any.whl
Size	32.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e240a6222d39c8dae0dd142f183c43115576f2831a2bbcd8ffa3514f037fbe94`
BLAKE2b-256 checksum How to use checksums	`7adc95555c8d4f68e8ee4ed2cb0c533c1163d03638646a981986a748f68878bc`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`