Changelog#

All notable changes to this project are documented here. This project follows Keep a Changelog and SemVer.

Unreleased#

0.3.3 - 2026-05-30#

Added#

  • Add generated project template .gitignore files for database-backed and no-database scaffolds.

Changed#

  • Update generated project template .gitignore files to ignore log directories and *.log files.

  • Update installation docs with pipx upgrade guidance and troubleshooting for exposing the flask command.

0.3.2 - 2026-05-24#

Fixed#

  • Retry the package release with the PyPI publish workflow using Python 3.11 to match the project requirement.

0.3.1 - 2026-05-24#

Fixed#

  • Retry the 0.3.x package release after the PyPI publish workflow stopped before build because pyproject.toml and poetry.lock were out of sync.

0.3.0 - 2026-05-24#

Added#

  • Add --no-db support to flask new for no-database project scaffolding.

  • Add no-DB app template scaffold at flask_commands/project_no_db/app/__init__.py.

  • Add model-structure overrides: - flask make:model ... --crud --flat|--nest - flask make:controller ... -m --flat|--nest

  • Add interactive nested model-selection prompts for make:model and make:controller inference flows.

  • Add model-aware RESTful scaffolding for nested controller/model generation.

  • Add RouteSpec-driven route analysis and prompt-planning helpers in flask_commands/utils/routes.py.

  • Add nested parent-route scaffolding helpers for multi-level blueprint setup.

  • Add centralized CRUD/RESTful output rendering helpers in flask_commands/utils/presents.py.

  • Add shared scaffold result metadata for created, reused, skipped, warning, and failed wiring steps.

  • Add a flask commands --version / flask commands -v version command.

  • Add docs infrastructure for videos/navigation: - custom youtube_embed directive - searchable video catalog data - video library styles and client-side progress tracking - docs navigation template override

  • Add chapter-based docs pages for installation, project creation, core ideas, make:view, make:controller, make:model, video series, and the cheat sheet.

  • Add new utility test modules for project, presents, venv, and wirings and broaden command/utils coverage.

Changed#

  • Register Flask-Commands through Flask CLI plugin entry points instead of a replacement top-level flask console script.

  • Refactor dotted-path normalization and parsing into a consistent dotted-path-with-action flow across view, model, route, and wiring code.

  • Refactor model hierarchy inference to be registry-aware, normalize inferred model names to PascalCase, and preserve multi-word model choices.

  • Refactor route creation/registration into helper-driven steps with clearer failure aggregation and immutable failure results.

  • Refactor controller/model/view wiring to report created, reused, skipped, warning, and failure states consistently.

  • Update flask new dependency/template flow to support DB-enabled and no-DB scaffolds.

  • Raise supported Python version to >=3.11,<4.0.

  • Update the generated project run.sh flow and docs to use Chrome/browser reload behavior consistently.

  • Refresh README examples, install guidance, docs links, and RESTful/CRUD wording to match the new docs.

  • Reorganize command docs into nested make:view, make:controller, and make:model chapters with cooking-app examples.

  • Redesign the docs homepage and video pages with updated navigation, responsive styles, and course progress support.

  • Refresh Poetry dependencies and lock file for the new Flask CLI plugin and docs/test tooling.

Fixed#

  • Stop --crud from creating implicit models unless model generation is requested with -m, --model, or make:model.

  • Keep generated root templates out of mains when creating simple root-level views.

  • Import controllers when adding generated routes and handle missing controller imports more reliably.

  • Keep namespace route segments singular when generating namespaced nested controllers.

  • Correct the SQLite template path used during new project scaffolding.

  • Prevent partial route setup in nested parent-route failure scenarios.

  • Improve failure immutability for route write/registration edge cases.

  • Fix mobile docs logo/navigation behavior on command pages.

  • Remove stale/incorrect unreleased changelog references to non-existent helper names/files.

Removed#

  • Remove obsolete single-page command docs in favor of the chapter-based guide.

  • Remove the legacy flask_commands.cli console-script entry point path.

0.2.4 - 2026-01-26#

Fixed#

  • Updating Documentation

  • Fixed flask new error 💣 Error: Project Creation Failed 😤 Error: exception: ‘utf-8’ codec can’t decode byte 0xe3 in position 16: invalid continuation byte

0.2.3 - 2026-01-25#

Added#

  • Add flask make:model command with optional --crud scaffolding for controller, routes, and views.

  • Add tests covering model creation, CRUD scaffolding, and missing init warnings.

Changed#

  • Refresh README with docs links, a compact cheat sheet, and example-driven messaging.

0.2.2 - 2026-01-25#

Added#

  • Add --model and -m support to flask make:controller for inferred or explicit model creation.

  • Add model inference from controller names and cover it with tests.

  • Add a commands book with dedicated chapters for new project scaffolding, concepts, and a cheat sheet.

Changed#

  • Refactor view model inference to accept dotted view paths and use split_dotted_path_with_action_into_relative_path_and_action internally.

  • Split the commands documentation into a multi-page book and point the legacy commands page at it.

0.2.1 - 2026-01-24#

Added#

  • Add wiring utility module and refactor view wiring to use it.

  • Add --crud flag to flask make:controller for full RESTful scaffolding.

  • Add test coverage for CRUD controller generation, nested routes/templates, and controller init exports.

  • Add tests for nested CRUD controllers, import insertion edge cases, and updated controller parameters.

  • Document --crud controller scaffolding with full examples and routes output.

Changed#

  • Refactor route utility functions and update wiring to reuse them; limit view creation to GET routes.

  • Refactor controller and route creation logic (parameter handling, import insertion, method block creation).

  • Update controller path handling to use slashes and convert to dotted names for RESTful route inference.

  • Move import insertion earlier in controller_add_method and add controller file debug output.

  • Update controller method creation and wiring signatures; remove unused wiring code.

  • Expand flask make:controller docs with a cooking-site example and route details.

Fixed#

  • Fix redirect parameter handling and a typo in import pattern matching.

  • Update error messaging in controllers.py for new controller parameters.

0.2.0 - 2026-01-19#

Added#

  • Started work on new command flask make:controller

  • Add a project-root safeguard so flask make:... commands only run when app/ and run.py are present.

  • Add tests covering controller creation, view behavior outside project roots, and file utility helpers.

Changed#

  • Make controller creation support class-only scaffolds with clearer output and validation.

  • Refine project-root warning wording for clarity.

Fixed#

  • Prevent controller file generation when method/view arguments are mismatched.

0.1.21 - 2026-01-17#

Added#

  • Add tests for nested route blueprint registration and controller creation with route names.

Changed#

  • Clarify scaffold helpers for model detection and CRUD route generation.

  • Remove the top-level CHANGELOG.md in favor of this docs changelog.

Fixed#

  • Avoid controller_make_file crashing when no route_name is provided.

  • Fix small typos in tests and view docstrings.

  • Register nested relationship blueprints with their parent instead of the top-level route, enabling full dotted-path route naming.

0.1.20 - 2026-01-16#

Added#

  • Add changelog page to the docs toctree and remove the top nav link.

Changed#

  • Update flask make:view documentation with clearer examples and RESTful guidance.

  • Improve nested blueprint registration so url_for uses dot notation consistently, avoiding mixed dot/underscore names in nested relationships.

  • Register nested blueprints at the top of the relationship tree instead of the app level.

Fixed#

  • Placeholder for upcoming fixes.

0.1.19 - 2026-01-10#

Changed#

  • Update commands documentation and release notes.

Fixed#

  • Fix a second typo in controller comment text that was breaking tests.

0.1.18 - 2026-01-10#

Changed#

  • Update release notes.

Fixed#

  • Fix a controller comment typo that was breaking tests.

0.1.17 - 2026-01-10#

Added#

  • Add project.urls metadata (homepage, repo, issues) to pyproject.toml.

  • Add controller registration feedback to the success output.

Changed#

  • Expand commands documentation (nested views and RESTful actions).

  • Refresh README and docs index copy.

Fixed#

  • Fix flask make:view about -rc warning by inferring MainController when -c is provided; update tests accordingly.

0.1.16 - 2026-01-10#

Changed#

  • Remove unused docs dependency blocks and extras from pyproject.toml.

  • Simplify configuration and reduce poetry.lock churn.

0.1.15 - 2026-01-09#

Changed#

  • Minor README and docs navigation updates.

  • Small Sphinx configuration tweak.

0.1.14 - 2026-01-09#

Changed#

  • Update README image source and bump version.

0.1.13 - 2026-01-09#

Changed#

  • Update README copy and PyPI badge versions.

0.1.12 - 2026-01-09#

Changed#

  • Iterate on publish-to-PyPI workflow configuration.

0.1.11 - 2026-01-09#

Changed#

  • Tweak publish-to-PyPI workflow configuration.

0.1.10 - 2026-01-09#

Changed#

  • Tweak publish-to-PyPI workflow configuration.

0.1.9 - 2026-01-09#

Changed#

  • Tweak publish-to-PyPI workflow configuration.

0.1.8 - 2026-01-09#

Changed#

  • Version bump only.

0.1.7 - 2026-01-08#

Changed#

  • Update publish-to-PyPI workflow configuration.

0.1.6 - 2026-01-08#

Changed#

  • Version bump only.

0.1.5 - 2026-01-08#

Changed#

  • Update publish-to-PyPI workflow configuration.

0.1.4 - 2026-01-08#

Changed#

  • Update publish-to-PyPI workflow configuration.

0.1.3 - 2026-01-08#

Changed#

  • Update publish-to-PyPI workflow configuration.

  • Remove small README artifacts during workflow cleanup.

0.1.2 - 2026-01-08#

Changed#

  • Update publish-to-PyPI workflow configuration.

0.1.1 - 2026-01-08#

Added#

  • Sphinx documentation scaffold, Read the Docs configuration, and Makefiles.

  • Project logo asset, theme CSS overrides, and Read the Docs badges.

  • PyPI publish workflow that triggers on version changes.

  • Template-based project scaffolding with config, routes, controllers, and run scripts.

  • Tailwind CSS setup in generated projects (npm install, input.css, template wiring).

  • make:view command and supporting controller/view utilities.

  • Optional route flag support, route parameter handling, and controller generation enhancements.

  • SQLite development setup and example model scaffolding.

  • Initial test suite, coverage configuration, and CI workflow.

Changed#

  • Refactor utilities from a monolithic module into focused files (controllers, files, models, naming, routes, scaffold, venv, views).

  • Rework flask new, view, and route messaging for clearer feedback.

  • Improve route inference, blueprint registration, and generation flow.

  • Update README and docs content as features landed.

  • Adjust project structure to use flask_commands/project templates.

Fixed#

  • Ensure file_append_file inserts a newline and handles empty files safely.

  • Guard blueprint registration when return app is missing.

  • Fix controller option errors and model name inference.

  • Improve error handling for controller/model generation and align tests.

0.1.0 - 2025-11-23#

Added#

  • Initial repository structure, CLI entrypoint, and command stubs.

  • Project metadata, license, and base README.