django-unicorn 0.15.1

A magical full-stack framework for Django.

django-unicorn

The magical fullstack framework for Django. ✨

Unicorn is a reactive component framework that progressively enhances a normal Django view, makes AJAX calls in the background, and dynamically updates the DOM. It seamlessly extends Django past its server-side framework roots without giving up all of its niceties or re-building your website.

Why?

Building server-side sites in Django with the ORM and template engine is so pleasant, but once you need more interactivity on the frontend, there is a lot more ambiguity. Should you build out an entire API in Django REST framework? Should you use React or Vue.js (or some) other frontend framework?

It seems like there should be an easier way to create interactive experiences.

A note

django-unicorn is still beta and the API will likely change on the way to version 1.0.0. All efforts will be made to include an easy upgrade path. 1.0.0 will signify that the public API won't change until the next major release.

Detailed documentation

https://www.django-unicorn.com

Developing

1. git clone [e-mail]:adamghill/django-unicorn.git
2. poetry install
3. poetry run python example/manage.py migrate
4. poetry run python example/manage.py runserver localhost:8000
5. Go to localhost:8000 in your browser
6. To install in another project pip install -e ../django-unicorn

Run unittests

1. poetry run pytest
2. npm run test

Minify Javascript

1. npm install
2. npm run build

Bump version

1. npm run build
2. poetry version major|minor|patch
3. Commit/tag/push version bump
4. poetry publish --build -r test
5. Make sure test package can be installed as expected (https://test.pypi.org/project/django-unicorn/)
6. poetry publish
7. Make sure live package can be installed as expected (https://pypi.org/project/django-unicorn/)
8. Update django-unicorn.com's changelog.md
9. Update django-unicorn.com's version of django-unicorn
10. Create GitHub release and add changelog there

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Adam Hill 💻 ⚠️

Andres Vargas 💻

Eddy Ernesto del Valle Pino 💻

Yaser Al-Najjar 💻

This project follows the all-contributors specification. Contributions of any kind welcome!