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.1050

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.1050
File	Size	Uploaded
abstract_flask-0.0.0.1050.tar.gz	20.8 kB	Sep 24, 2026	Details

Release files / abstract_flask-0.0.0.1050.tar.gz

Download URL	abstract_flask-0.0.0.1050.tar.gz
Size	20.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`7514d4f2eda7216a3e479cfc5d0a85595ccf37b6faad3448a83238ee45ae2568`
BLAKE2b-256 checksum How to use checksums	`c594add38331f1463d3fc4d7e516cfad0a48e91fbe1c9a5af5395c73ac2bb44f`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.11`