Skip to main content

Facilitates the usage of HTMX with Django

Project description

hx-requests

Full documentation: https://hx-requests.readthedocs.io/en/latest/#


pre-commit Code style: black Imports: isort Code style: djlint

Hx-requests is a package to simplify the usage of htmx with Django. It enables an application to make asyncronous requests without clogging up views and urls with extra code. It simplifies making django forms post asyncronously with htmx, and many other awesome features.

The idea of hx-requests is that HXRequests absorb all htmx requests. Define an HXRequest and observe the magic of hx-requests.

  • No need to define extra urls to handle these requests
  • No need to add anything extra in views
  • Reusable HXRequests across views
  • Built in HXRequests to reduce boilerplate code

See full documentation here: https://hx-requests.readthedocs.io/en/latest/#

Installation

pip install hx-requests
INSTALLED_APPS = (
    ...
    'hx_requests',
)

Note It's assumed that htmx is already included in the base html file. It's also recommended to include hyperscript. Htmx: <script src="https://unpkg.com/htmx.org@1.8.6"></script>
Hyperscript: <script src="https://unpkg.com/hyperscript.org@0.9.8"></script>

Contributing to this repository

Warning CI is not setup yet, but will be at a later date.

Getting setup

  • This project is using poetry
  • There is a dev container that can be used with vs-code

Committing

Must follow Conventional Commit https://www.conventionalcommits.org/en/v1.0.0/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hx_requests-0.28.1.tar.gz (13.6 kB view hashes)

Uploaded Source

Built Distribution

hx_requests-0.28.1-py3-none-any.whl (15.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page