{"id":13454368,"url":"https://github.com/rochacbruno/flask-project-template","last_synced_at":"2025-04-07T11:08:35.617Z","repository":{"id":41527523,"uuid":"397020062","full_name":"rochacbruno/flask-project-template","owner":"rochacbruno","description":"DO NOT FORK, CLICK \"Use this template\" - A github template to start a Flask Project - this uses github actions to generate your project based on the template.","archived":false,"fork":false,"pushed_at":"2023-08-10T02:32:37.000Z","size":66,"stargazers_count":192,"open_issues_count":3,"forks_count":25,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-02T13:52:14.669Z","etag":null,"topics":["boilerplate","cookiecutter","flask","hacktoberfest","project-template","python","python-project-template","python-template","rochacbruno-template","template","template-project"],"latest_commit_sha":null,"homepage":"https://github.com/rochacbruno/flask-project-template/generate","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rochacbruno.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":["rochacbruno"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-08-16T23:59:08.000Z","updated_at":"2025-03-14T04:35:34.000Z","dependencies_parsed_at":"2024-06-01T05:44:42.234Z","dependency_job_id":"7214d65d-51d3-4b15-a135-887876080672","html_url":"https://github.com/rochacbruno/flask-project-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochacbruno%2Fflask-project-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochacbruno%2Fflask-project-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochacbruno%2Fflask-project-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rochacbruno%2Fflask-project-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rochacbruno","download_url":"https://codeload.github.com/rochacbruno/flask-project-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640464,"owners_count":20971557,"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":["boilerplate","cookiecutter","flask","hacktoberfest","project-template","python","python-project-template","python-template","rochacbruno-template","template","template-project"],"created_at":"2024-07-31T08:00:53.484Z","updated_at":"2025-04-07T11:08:35.599Z","avatar_url":"https://github.com/rochacbruno.png","language":"Python","funding_links":["https://github.com/sponsors/rochacbruno"],"categories":["Uncategorized","Python","Flask"],"sub_categories":["Uncategorized","Phaser"],"readme":"# Flask Project Template\n\nA full feature Flask project template.\n\nSee also \n- [Python-Project-Template](https://github.com/rochacbruno/python-project-template/) for a lean, low dependency Python app.\n- [FastAPI-Project-Template](https://github.com/rochacbruno/fastapi-project-template/) The base to start an openapi project featuring: SQLModel, Typer, FastAPI, JWT Token Auth, Interactive Shell, Management Commands.\n\n### HOW TO USE THIS TEMPLATE\n\n\u003e **DO NOT FORK** this is meant to be used from **[Use this template](https://github.com/rochacbruno/flask-project-template/generate)** feature.\n\n1. Click on **[Use this template](https://github.com/rochacbruno/flask-project-template/generate)**\n3. Give a name to your project  \n   (e.g. `my_awesome_project` recommendation is to use all lowercase and underscores separation for repo names.)\n3. Wait until the first run of CI finishes  \n   (Github Actions will process the template and commit to your new repo)\n4. If you want [codecov](https://about.codecov.io/sign-up/) Reports and Automatic Release to [PyPI](https://pypi.org)  \n  On the new repository `settings-\u003esecrets` add your `PIPY_API_TOKEN` and `CODECOV_TOKEN` (get the tokens on respective websites)\n4. Read the file [CONTRIBUTING.md](CONTRIBUTING.md)\n5. Then clone your new project and happy coding!\n\n\u003e **NOTE**: **WAIT** until first CI run on github actions before cloning your new project.\n\n### What is included on this template?\n\n- 🍾 A full feature Flask application with CLI, API, Admin interface, web UI and modular configuration.\n- 📦 A basic [setup.py](setup.py) file to provide installation, packaging and distribution for your project.  \n  Template uses setuptools because it's the de-facto standard for Python packages, you can run `make switch-to-poetry` later if you want.\n- 🤖 A [Makefile](Makefile) with the most useful commands to install, test, lint, format and release your project.\n- 📃 Documentation structure using [mkdocs](http://www.mkdocs.org)\n- 💬 Auto generation of change log using **gitchangelog** to keep a HISTORY.md file automatically based on your commit history on every release.\n- 🐋 A simple [Containerfile](Containerfile) to build a container image for your project.  \n  `Containerfile` is a more open standard for building container images than Dockerfile, you can use buildah or docker with this file.\n- 🧪 Testing structure using [pytest](https://docs.pytest.org/en/latest/)\n- ✅ Code linting using [flake8](https://flake8.pycqa.org/en/latest/)\n- 📊 Code coverage reports using [codecov](https://about.codecov.io/sign-up/)\n- 🛳️ Automatic release to [PyPI](https://pypi.org) using [twine](https://twine.readthedocs.io/en/latest/) and github actions.\n- 🎯 Entry points to execute your program using `python -m \u003cproject_name\u003e` or `$ project_name` with basic CLI argument parsing.\n- 🔄 Continuous integration using [Github Actions](.github/workflows/) with jobs to lint, test and release your project on Linux, Mac and Windows environments.\n\n\u003e Curious about architectural decisions on this template? read [ABOUT_THIS_TEMPLATE.md](ABOUT_THIS_TEMPLATE.md)  \n\u003e If you want to contribute to this template please open an [issue](https://github.com/rochacbruno/flask-project-template/issues) or fork and send a PULL REQUEST.\n\n\u003c!--  DELETE THE LINES ABOVE THIS AND WRITE YOUR PROJECT README BELOW --\u003e\n\n---\n# project_name Flask Application\n\nproject_description\n\n## Installation\n\nFrom source:\n\n```bash\ngit clone https://github.com/author_name/project_urlname project_name\ncd project_name\nmake install\n```\n\nFrom pypi:\n\n```bash\npip install project_name\n```\n\n## Executing\n\nThis application has a CLI interface that extends the Flask CLI.\n\nJust run:\n\n```bash\n$ project_name\n```\n\nor\n\n```bash\n$ python -m project_name\n```\n\nTo see the help message and usage instructions.\n\n## First run\n\n```bash\nproject_name create-db   # run once\nproject_name populate-db  # run once (optional)\nproject_name add-user -u admin -p 1234  # ads a user\nproject_name run\n```\n\nGo to:\n\n- Website: http://localhost:5000\n- Admin: http://localhost:5000/admin/\n  - user: admin, senha: 1234\n- API GET:\n  - http://localhost:5000/api/v1/product/\n  - http://localhost:5000/api/v1/product/1\n  - http://localhost:5000/api/v1/product/2\n  - http://localhost:5000/api/v1/product/3\n\n\n\u003e **Note**: You can also use `flask run` to run the application.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frochacbruno%2Fflask-project-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frochacbruno%2Fflask-project-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frochacbruno%2Fflask-project-template/lists"}