Django integration for Frontend Bundlers & React
Project description
Alliance Platform Django Frontend
A library for integrating the Alliance Platform React library into a Django project.
Uses Vite to bundle Javascript and perform server-side rendering, and supplies a number of templatetags to easily embed Alliance Platform React components into Django templates.
Installation
pip install alliance-platform-frontend
System Requirements
- Supports django 4.2 and 5.0
- Python >=3.11
Usage
Alliance UI
A collection of built-in template tags for easily using Alliance UI React components in Django templates.
A templatetag (for example, Button) can be inserted in a template using the syntax:
{% Button variant="outlined" type="submit" %}Submit{% endButton %}
Components can be nested, e.g.
{% MenuBar %}
{% Menubar.SubMenu %}
{% Menubar.Item %}Item{% endMenubar.Item %}
{% endMenubar.SubMenu %}
{% endMenuBar %}
Keyword arguments to the tag will be automatically passed as props to the React component.
Available Tags
- Button
- ButtonGroup
- DatePicker
- Icon
- InlineAlert
- Menubar
- Menubar.SubMenu
- Menubar.Item
- Menubar.Section
- Pagination
- Table
- TableHeader
- TableBody
- ColumnHeaderLink
- Column
- Row
- Cell
- TimeInput
- Fragment
- raw_html
The following functions are also available:
utils.get_module_import_source
Given the name of the export within alliance-platform-js/ui
, creates the javascript import specification for the specified component.
Bundler
Templates
Template Tags
Release Process
Poetry Config
- Add test repository
poetry config repositories.testpypi https://test.pypi.org/legacy/
- Generate an account API token at https://test.pypi.org/manage/account/token/
poetry config pypi-token.testpypi ${TOKEN}
- On macs this will be stored in the
login
keychain atpoetry-repository-testpypi
- On macs this will be stored in the
- Main pypi repository
- Generate an account API token at https://pypi.org/manage/account/token/
poetry config pypi-token.pypi ${TOKEN}
- On macs this will be stored in the
login
keychain atpoetry-repository-pypi
- On macs this will be stored in the
Publishing a New Release
- Update CHANGELOG.md with details of changes and new version
- Run
bin/build.py
. This will extract version from CHANGELOG.md, bump version inpyproject.toml
and generate a build for publishing - Tag with new version and update the version branch:
ver=$( poetry version --short ) && echo "Version: $ver"
git tag v/frontend/$ver
git push --tags
- To publish to test.pypi.org
poetry publish --repository testpypi
- To publish to pypi.org
poetry publish
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for alliance_platform_frontend-0.0.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1c962ed84519d6f448c1da78b4bfcc086d715fc18925df2b6a30f36b58eae11 |
|
MD5 | d49c227f8d4a419de035a0bd5f306d21 |
|
BLAKE2b-256 | f083717b981c74359e432d69c0d0c796dd7539e5eaee797c9f512da7d4779600 |
Hashes for alliance_platform_frontend-0.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60e28b6c7f864bc1c941e6be1f135f83a80c8be4d90bdc0333020ab661c5d857 |
|
MD5 | 1aed6bc3f96e98f7087cd3eb60b95f27 |
|
BLAKE2b-256 | 4c448ab6cccc8a8b84d54a4c1bb482ae45bf95ebb48d5d3e8ca6d9f06b3167d2 |