conjunto 0.5.0

Django application framework/helpers using HTMX, tabler.io, tables2, crispy-forms & more.

Conjunto

Description

Conjunto is a Django application framework using HTMX, tabler.io, crispy-forms and more.

Installation

You can install the package by using pip (best using a virtualenv):

pip install conjunto

Conjunto's third-party JavaScript / CSS libraries (TinyMCE, Tabler, HTMX, Alpine, …) are not bundled in the wheel — fetch them into your project's static directory once after install:

python manage.py update_libraries --suggest    # prints CONJUNTO_LIBRARIES = [...]
# paste the block into settings.py, then:
python manage.py update_libraries

See docs/usage/static_libraries.md for the full settings (CONJUNTO_VENDOR_DIR, CONJUNTO_LIBRARIES, STATICFILES_DIRS) and CI integration.

Usage

There is a separate section in the documentation available.

Development setup

For setting up development environment you will need pytest, pre-commit and black. You can install these by running (in the project directory):

pip install .[dev]

Contributing

Pull requests and general ideas are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

The Conjunto project is open-source and licensed under the MIT License. Please keep in mind that Conjunto uses many other libraries, which may be under different licenses.