{"id":23989600,"url":"https://github.com/candidtim/cookiecutter-flask-minimal","last_synced_at":"2025-04-14T13:53:46.891Z","repository":{"id":82270367,"uuid":"99275227","full_name":"candidtim/cookiecutter-flask-minimal","owner":"candidtim","description":"A minimalist's production-ready Flask project template. A microtemplate for a microframework.","archived":false,"fork":false,"pushed_at":"2024-03-22T20:40:56.000Z","size":32,"stargazers_count":64,"open_issues_count":0,"forks_count":18,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-28T02:53:28.122Z","etag":null,"topics":["cookiecutter","cookiecutter-template","flask"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/candidtim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-03T21:09:27.000Z","updated_at":"2024-07-10T00:40:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"9c576268-40e3-4624-8504-c8979cf59fdc","html_url":"https://github.com/candidtim/cookiecutter-flask-minimal","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fcookiecutter-flask-minimal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fcookiecutter-flask-minimal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fcookiecutter-flask-minimal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/candidtim%2Fcookiecutter-flask-minimal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/candidtim","download_url":"https://codeload.github.com/candidtim/cookiecutter-flask-minimal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248891798,"owners_count":21178710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cookiecutter","cookiecutter-template","flask"],"created_at":"2025-01-07T17:32:16.389Z","updated_at":"2025-04-14T13:53:46.842Z","avatar_url":"https://github.com/candidtim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cookiecutter-flask-minimal\n\n*A microtemplate for a microframework.*\n\nThis is a **minimalist's** **production-ready** [Flask](http://flask.pocoo.org) project template:\n\n - no external dependencies except for [Flask](http://flask.pocoo.org) and [pytest](https://pytest.org)\n - doesn't impose any choices of third-party libraries\n - project set-up as per Flask documentation, including things like logging and config, testing and packaging\n - optional and off by deafult: flake8, black and mypy configuration\n - optional: [Poetry](https://python-poetry.org/) build tool, setuptools by defualt\n - preserves the pure joy of developing with Flask!\n\n**Now upgraded to Flask 3 !**\n\nIf you look for the **Flask 2** version, check out the `flask2` branch. It is\nnot actively maintained but is tested and known to work with the latest Flask 2\nrelease (2.3.3 as of the time of this writing).\n\nLooking for a feature-complete, yet minimalistic web app starter kit? Check out\n[cookicutter-flask-boring](https://github.com/candidtim/cookiecutter-flask-boring).\n\n## Usage\n\nInstall [cookiecutter](https://github.com/audreyr/cookiecutter):\n\n    pip install --user cookiecutter\n\nCreate your application from this template:\n\n    cookiecutter https://github.com/candidtim/cookiecutter-flask-minimal.git\n\nAll set! Run the application:\n\n    cd yourapplication\n    make run\n\nAnd then open it at [http://127.0.0.1:5000/](http://127.0.0.1:5000/)\n\n## Features\n\nIncluded:\n\n - minimal production-ready Flask application:\n   an [application factory](https://flask.palletsprojects.com/en/3.0.x/patterns/appfactories/),\n   and a single [blueprint](https://flask.palletsprojects.com/en/3.0.x/blueprints/)\n   with a sample static resource, template and an index view, packaged as as per\n   [Larger Applications](https://flask.palletsprojects.com/en/3.0.x/patterns/packages/)\n\n - setuptools (or Poetry) configuration to package and release the application,\n   as well as to develop locally\n\n    - side note: [Poetry](https://python-poetry.org/) is a popular build tool\n      and it provides a well-structured and\n      [well-documented](https://python-poetry.org/docs/) development\n      environment; but, this also means that the generated project will not\n      explain or document its usage and you would need to refer to the Poetry\n      documentation\n\n - configuration system, as per\n   [Configuration Handling](https://flask.palletsprojects.com/en/3.0.x/config/)\n\n - basic [Logging](https://flask.palletsprojects.com/en/3.0.x/logging/) configuration\n\n - sample test and testing set-up, as per\n   [Testing Flask Applications](https://flask.palletsprojects.com/en/3.0.x/testing/)\n\n - optional (and off by deafult) configuration for flake8, black and mypy\n\n - Makefile with a few typical tasks automated (see generated README for details)\n\nNot included:\n\n - everything else: there is no SQLAlchemy, or MongoKit, or Bootstrap CSS, or\n   React, or whatever else; it is up to you to chose how to implement your\n   application;\n   [Patterns for Flask](https://flask.palletsprojects.com/en/3.0.x/patterns/)\n   documents well how to easily add these if necessary\n\n - there are no \"sample\" features or examples of how to use Flask; this\n   template is not intended as a tutorial, but as a well-configured starting\n   point for a new implementation; refer to the\n   [Flask documentation](https://flask.palletsprojects.com/en/3.0.x/quickstart/)\n   to learn Flask if necessary\n\n - no choice on how to deploy the application is made, no WSGI container is\n   chosen; see\n   [Deploying to Production](https://flask.palletsprojects.com/en/3.0.x/deploying/)\n   for the options most suitable for your infrastructure\n\n# Contributions\n\n... are welcome! Feel free to create a pull request to fix bugs or keep up to date.\n\nIf you think some additional feature is indispensable, feel free to create an\nissue or a pull request, but bare in mind that the goal of this template is to\nstay a \"minimal\" one. If you would like to add a feature, maybe best way to do\nso is to make it optional and off by default then. One can use cookiecutter's\nchoice variables, and, ultimately, hooks, in order to create an optional\nfeature.\n\nIf you do a change, use `make test` from root directory to test the updated template.\n\n# Attributions\n\nConfiguration of this entire project template is based on\n[Flask documentation](https://flask.palletsprojects.com/en/3.0.x/).\nPlease, note however, that this template is not guaranteed to follow Flask\ndocumentation precisely.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Fcookiecutter-flask-minimal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcandidtim%2Fcookiecutter-flask-minimal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcandidtim%2Fcookiecutter-flask-minimal/lists"}