django-cythonizer 0.0.12

A Django package for Cythonizing Django projects

Django-Cythonizer 🚀

Supercharge your Django project with the power of Cython! 🐍💨

🌟 Features

• 🚀 Automatically compile Django views and models to Cython
• 📈 Boost performance by up to 30% (results may vary)
• 🛠 Easy integration with existing Django projects
• 🔒 Secure your Python source code
• 🔧 Customizable compilation settings

🚀 Quick Start

Installation

pip install django-cythonizer

Usage

1. Add 'cythonizer' to your INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    'cythonizer',
    # ...
]

2. Run the cythonize command:

python manage.py cythonize

3. Open build FLoder and run it as normal django project

4. Enjoy the speed boost! 🎉🎉🎉🎉
## ⚠️ Important Considerations

Handling Excluded Paths

• Virtual Environments: The .venv directory is excluded by default.
• Migration Files: The migrations folders are excluded to avoid issues with Django's migration system.
• Configuration Files: Sensitive files like settings.py and urls.py are excluded.

Other Considerations

• Always test your project after compilation to ensure no unexpected errors occur.
• Keep a backup of your original code before applying compilation on a large scale.

🔧 Configuration

The settings.yaml file in your project root controls the cythonizer behavior:

build:
  path: 'build'

exclude:
  files:
    - 'setup.py'
    - '__init__.py'
    - 'manage.py'
    - 'urls.py'
    - '.gitigonre'
    - '.git'
  dirs:
    - 'migrations'
    - '.venv'
    - 'build'

# ... (other settings)

🔥 Performance Comparison

Here's a quick benchmark comparing a standard Django view vs a Cythonized view:

Scenario	Requests/sec	Latency (ms)
Standard	1000	50
Cythonized	1300	38

As the load increases on the system, the performance and reliability gap between the standard Django project and the Cythonized Django project widens, with the Cythonized version consistently outperforming, despite both projects being identical in terms of code and environment.

🛠 How It Works

1. Analysis: Django-Cythonizer scans your project structure.
2. Compilation: It compiles eligible Python files to Cython.
3. Integration: The compiled modules seamlessly replace the original ones.
4. Optimization: Enjoy the performance benefits!

🤔 FAQs

Is it compatible with all Django versions?

Django-Cythonizer supports Django 3.2 and above, as specified in the project requirements.

Will it break my existing code?

No, Django-Cythonizer is designed to be non-intrusive. Your original Python files remain untouched.

Can I use it in production?

Absolutely! Many projects use Cython in production to great effect. Always thoroughly test before deploying.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for more details.

📜 License

Django-Cythonizer is released under the MIT License. See the LICENSE file for more details.

🙏 Acknowledgements

• The amazing Django community
• The Cython team for their incredible work
• All our contributors and users

📬 Contact

For support or queries, reach out to us at [e-mail].

---

Made with ❤️ by developers, for developers.
Initiated by Salah Aldain Alhajj