Name | django_tailwind_cli JSON |
Version |
2.11.1
JSON |
| download |
home_page | None |
Summary | Django and Tailwind integration based on the prebuilt Tailwind CSS CLI. |
upload_time | 2024-05-07 15:25:55 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.9 |
license | None |
keywords |
django
tailwind
css
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# django-tailwind-cli
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/oliverandrich/django-tailwind-cli/test.yml?style=flat-square)
[![PyPI](https://img.shields.io/pypi/v/django-tailwind-cli.svg?style=flat-square)](https://pypi.org/project/django-tailwind-cli/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
![GitHub](https://img.shields.io/github/license/oliverandrich/django-tailwind-cli?style=flat-square)
![Django Versions](https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli)
![Python Versions](https://img.shields.io/pypi/pyversions/django-tailwind-cli)
[![Downloads](https://static.pepy.tech/badge/django-tailwind-cli)](https://pepy.tech/project/django-tailwind-cli)
[![Downloads / Month](https://pepy.tech/badge/django-tailwind-cli/month)](<https://pepy.tech/project/django-tailwind-cli>)
This library provides an integration of [Tailwind CSS](https://tailwindcss.com) for Django that is using on the precompiled versions of the [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli).
The goal of this library is to provided the simplest possible Tailwind integration for your Django project. It took its inspiration from the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind) which completely skips the neccesity of a node installation.
## Installation
1. Install the library.
```shell
python -m pip install django-tailwind-cli
```
2. Add `django_tailwind_cli` to `INSTALLED_APPS` in `settings.py`.
```python
INSTALLED_APPS = [
# other Django apps
"django_tailwind_cli",
]
```
3. Configure the `STATICFILES_DIRS` parameter in your `settings.py` if not already configured.
```python
STATICFILES_DIRS = [BASE_DIR / "assets"]
```
4. Add template code.
```htmldjango
{% load tailwind_cli %}
...
<head>
...
{% tailwind_css %}
...
</head>
```
5. Start the debug server.
```shell
python manage.py tailwind runserver
```
Enjoy!
Checkout the detailed [installation guide](https://django-tailwind-cli.andrich.me/installation/) if you want to activate browser reload or the `runserver_plus` management command known from `django-extensions`.
## Features
- Simplest possible integration.
- Management commands:
- To start the Tailwind CLI in watch mode during development.
- To build the production grade CSS file for your project.
- To start a debug server along with the Tailwind CLI in watch mode in a single session.
- Necessary configuration to adapt the library to your project, when the defaults don't fit you.
- A template tag to include the Tailwind CSS file in your project.
- A base template for your project.
- A sane tailwind.config.js that activates all the official plugins and includes a simple HTMX plugin.
## Requirements
Python 3.9 or newer with Django >= 3.2.
## Documentation
The documentation can be found at [https://django-tailwind-cli.andrich.me/](https://django-tailwind-cli.andrich.me/)
## Contributing
If you want to contribute to this project, checkout the [development guide](https://django-tailwind-cli.andrich.me/development/) for details to get your dev environment up and running.
## License
This software is licensed under [MIT license](https://github.com/oliverandrich/django-tailwind-cli/blob/main/LICENSE).
Raw data
{
"_id": null,
"home_page": null,
"name": "django_tailwind_cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "django, tailwind, css",
"author": null,
"author_email": "Oliver Andrich <oliver@andrich.me>",
"download_url": "https://files.pythonhosted.org/packages/f8/d3/ca0b541e37f63ffdaf442317f1d160348f09b72a42ec1855edf7567780e4/django_tailwind_cli-2.11.1.tar.gz",
"platform": null,
"description": "# django-tailwind-cli\n\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/oliverandrich/django-tailwind-cli/test.yml?style=flat-square)\n[![PyPI](https://img.shields.io/pypi/v/django-tailwind-cli.svg?style=flat-square)](https://pypi.org/project/django-tailwind-cli/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)\n![GitHub](https://img.shields.io/github/license/oliverandrich/django-tailwind-cli?style=flat-square)\n![Django Versions](https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli)\n![Python Versions](https://img.shields.io/pypi/pyversions/django-tailwind-cli)\n[![Downloads](https://static.pepy.tech/badge/django-tailwind-cli)](https://pepy.tech/project/django-tailwind-cli)\n[![Downloads / Month](https://pepy.tech/badge/django-tailwind-cli/month)](<https://pepy.tech/project/django-tailwind-cli>)\n\nThis library provides an integration of [Tailwind CSS](https://tailwindcss.com) for Django that is using on the precompiled versions of the [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli).\n\nThe goal of this library is to provided the simplest possible Tailwind integration for your Django project. It took its inspiration from the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind) which completely skips the neccesity of a node installation.\n\n## Installation\n\n1. Install the library.\n\n ```shell\n python -m pip install django-tailwind-cli\n ```\n\n2. Add `django_tailwind_cli` to `INSTALLED_APPS` in `settings.py`.\n\n ```python\n INSTALLED_APPS = [\n # other Django apps\n \"django_tailwind_cli\",\n ]\n ```\n\n3. Configure the `STATICFILES_DIRS` parameter in your `settings.py` if not already configured.\n\n ```python\n STATICFILES_DIRS = [BASE_DIR / \"assets\"]\n ```\n\n4. Add template code.\n\n ```htmldjango\n {% load tailwind_cli %}\n ...\n <head>\n ...\n {% tailwind_css %}\n ...\n </head>\n ```\n\n5. Start the debug server.\n\n ```shell\n python manage.py tailwind runserver\n ```\n\nEnjoy!\n\nCheckout the detailed [installation guide](https://django-tailwind-cli.andrich.me/installation/) if you want to activate browser reload or the `runserver_plus` management command known from `django-extensions`.\n\n## Features\n\n- Simplest possible integration.\n- Management commands:\n - To start the Tailwind CLI in watch mode during development.\n - To build the production grade CSS file for your project.\n - To start a debug server along with the Tailwind CLI in watch mode in a single session.\n- Necessary configuration to adapt the library to your project, when the defaults don't fit you.\n- A template tag to include the Tailwind CSS file in your project.\n- A base template for your project.\n- A sane tailwind.config.js that activates all the official plugins and includes a simple HTMX plugin.\n\n## Requirements\n\nPython 3.9 or newer with Django >= 3.2.\n\n## Documentation\n\nThe documentation can be found at [https://django-tailwind-cli.andrich.me/](https://django-tailwind-cli.andrich.me/)\n\n## Contributing\n\nIf you want to contribute to this project, checkout the [development guide](https://django-tailwind-cli.andrich.me/development/) for details to get your dev environment up and running.\n\n## License\n\nThis software is licensed under [MIT license](https://github.com/oliverandrich/django-tailwind-cli/blob/main/LICENSE).\n",
"bugtrack_url": null,
"license": null,
"summary": "Django and Tailwind integration based on the prebuilt Tailwind CSS CLI.",
"version": "2.11.1",
"project_urls": {
"Documentation": "https://django-tailwind-cli.andrich.me/",
"Home": "https://django-tailwind-cli.andrich.me/",
"Repository": "https://github.com/oliverandrich/django-tailwind-cli"
},
"split_keywords": [
"django",
" tailwind",
" css"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c4e2f839180b48fad0605e347e9b55b357ada16dbbec1bf8df966aff5fa2c392",
"md5": "7527c58b46914b98db3d72f5666ca100",
"sha256": "a1b0f661b5fc8706f8e99475701a1c3716cdf95d33c41a9f8df1e170631063e0"
},
"downloads": -1,
"filename": "django_tailwind_cli-2.11.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7527c58b46914b98db3d72f5666ca100",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 10577,
"upload_time": "2024-05-07T15:25:53",
"upload_time_iso_8601": "2024-05-07T15:25:53.978826Z",
"url": "https://files.pythonhosted.org/packages/c4/e2/f839180b48fad0605e347e9b55b357ada16dbbec1bf8df966aff5fa2c392/django_tailwind_cli-2.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f8d3ca0b541e37f63ffdaf442317f1d160348f09b72a42ec1855edf7567780e4",
"md5": "8771749ebb71ca8759e775c74b33dffd",
"sha256": "a4427dd48e8877d64098b353fd15cb89a95d2a32dc2eadac5feef0d56d4aa459"
},
"downloads": -1,
"filename": "django_tailwind_cli-2.11.1.tar.gz",
"has_sig": false,
"md5_digest": "8771749ebb71ca8759e775c74b33dffd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 23541,
"upload_time": "2024-05-07T15:25:55",
"upload_time_iso_8601": "2024-05-07T15:25:55.427463Z",
"url": "https://files.pythonhosted.org/packages/f8/d3/ca0b541e37f63ffdaf442317f1d160348f09b72a42ec1855edf7567780e4/django_tailwind_cli-2.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-07 15:25:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "oliverandrich",
"github_project": "django-tailwind-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django_tailwind_cli"
}