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

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.1059
File	Size	Uploaded
abstract_flask-0.0.0.1059.tar.gz	32.0 kB	Oct 16, 2026	Details

Built distribution (wheel)

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

Total release size: 64.7 kB

Release files / abstract_flask-0.0.0.1059.tar.gz

Download URL	abstract_flask-0.0.0.1059.tar.gz
Size	32.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`58f6f2d695eb2729993341340641397405aba2689a1406d2cfd3baaa280bdd23`
BLAKE2b-256 checksum How to use checksums	`5b0e8536bec6096d80ec5c36bd3dfb7855f5d7a17bef543859c6e8d6eb205526`
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.1059-py3-none-any.whl

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