tailwind-py 0.1.1

Install Tailwind CSS in Python projects, no NPM required.

Tailwind-Py

Tailwind-Py is a lightweight Python utility that allows you to download and use TailwindCSS without NPM. It is designed for Python web frameworks like Flask, Django, and FastAPI, making it easy to integrate Tailwind into your projects.

Inspired from the standalone published here.

Table of Contents

• Tailwind-Py
  • Table of Contents
• Install
• Install locally
• Usage
• Commands
• Quickstart

Install

If you have Python 3.12+ installed, you can install tailwind-py using pip:

pip install tailwind-py

After installation, you can proceed to the usage section.

Install locally

tailwind-py uses the following pre-requisites:

• Python 3.12 or higher
• Poetry 2.1 or higher

You will then need to clone the repo and install it using Poetry:

git clone https://github.com/your-repo/tailwind-py.git
cd tailwind-py
poetry install

Check if the CLI works.

$ tailwindcss --help  

usage: tailwindcss [-h] {download,init,build} ...

Tailwind Python CLI - A tool for managing Tailwind CSS in Python projects, without npm

options:
  -h, --help            show this help message and exit

subcommands:
  {download,init,build}
                        Available commands
    download            Downloads the latest version of the TailwindCSS CLI
    init                Initialize `tailwind.config.js` file
    build               Builds the CSS output

Use 'tailwindcss <command> --help' for more information on a specific command.

Usage

Use tailwind download to download the latest version of TailwindCSS's standalone CLI, ready to use alongside this package.

Then use tailwind build -i "/path/to/your/input.css" -o "/path/to/your/output.css" --watch to start a watcher over the final result of your CSS file, named output.css. The input.css file is a file contaning directives for TailwindCSS. Here's an example:

@import "tailwindcss";

/* Your custom styles there */

For further details, check the official TailwindCSS documentation.

Commands

• tailwind download: downloads the latest version of TailwindCSS's CLI on Github
• tailwind init: writes in the current directory by default the tailwind.config.js file
• tailwind build: compiles an input CSS file (typically located in your static directory) into an optimized output CSS file, ready to use in your project. Use the --watch flag for active changes and the --minify option to produce a lightweight output.

Quickstart

After installing tailwind-py, you can quickly generate a Tailwind-powered CSS file:

tailwind download  # Fetch the latest Tailwind CLI
tailwind init      # Create a default tailwind.config.js (not really needed for 4.0+)
tailwind build -i "static/css/input.css" -o "static/css/output.css" --watch

Then include output.css in your project:

<link rel="stylesheet" href="static/css/output.css">