Skip to content

Enhance your Django developer experience: CLI and Guides for the Modern Django Developer.

License

Notifications You must be signed in to change notification settings

shearichard/falco

 
 

Repository files navigation

falco logo

Falco

An opinionated toolkit for a modern Django development experience

Documentation Continuous Integration pypi Hatch project Ruff MIT License PyPI - Python Version PyPI - Versions from Framework Classifiers PyPI - Downloads

All Contributors

Falco is a Django-centric toolkit designed to enhance the development experience. The CLI offers commands for initiating new projects, generating simple CRUD views for rapid prototyping, and more. Additionally, it provides a collection of guides to address common issues in web development specifically tailored to Django.

The CLI

This is a set of commands to help you throughout the lifecycle of your django project development, from bootstrapping a new project using modern tools like htmx, hatch, tailwindcss, to generating CRUD views for your models and a few utilities that might help during deployment.

pip install falco-cli
  • start-project: Initialize a new django project the falco way.
  • crud: Generate CRUD (Create, Read, Update, Delete) views for a model.
  • install-crud-utils: Install utils necessary for CRUD views.
  • work: Run all the services required to run your django project in parallel with a single command. (development only)
  • htmx: Download a local copy of the latest version of htmx.
  • htmx-ext: Download one of htmx extensions.
  • sync-dotenv: Synchronize the .env file with the .env.template file.
  • rm-migrations: Remove all migrations for the specified applications directory. (development only)
  • reset-migrations: Delete and recreate all migrations. (development only)
  • make-superuser: Make a superuser from some pre-defined django settings.

The guides

Note

These are currently a work in progress. Most of them are half-written or not written at all. I hope to get them in a usable state by the end of january 2024.

If you don't find any use of the CLI, I hope you will in these guides. This is a collection of guides that address common issues in web development, specifically tailored to Django. Each guide provides solutions, patterns, and approaches that are relevant to Django projects. It is similar to the Django topic guides, but instead of focusing on components of the framework like forms, models, views, etc., it focuses on more general topics like task queues, deployment, realtime, etc.

Acknowledgements

Falco is inspired by (and borrows elements from) some excellent open source projects:

Contributors

Tobi DEGNON
Tobi DEGNON

💻 📖 ⚠️
Muhammad Hammad
Muhammad Hammad

🤔
mathiasag7
mathiasag7

💻

About

Enhance your Django developer experience: CLI and Guides for the Modern Django Developer.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 87.0%
  • HTML 10.9%
  • Dockerfile 1.1%
  • Other 1.0%