semvec/pypi-packages huggingface dataset:
preling 1.5.1
Command-line tool for learning foreign languages through gradual exposure to new vocabulary
Requires Python: >=3.12

# PreLing

PreLing is a command-line tool for improving language comprehension skills through gradual exposure to new vocabulary. It supports every language that [spaCy supports](https://spacy.io/usage/models#languages). Because PreLing uses GPT under the hood, you must have a paid [OpenAI account](https://platform.openai.com/) and an [API key](https://platform.openai.com/api-keys) to run it.

## Installation

Install [Python](https://www.python.org/downloads/) **3.12 or later** and [pipx](https://pipx.pypa.io/stable/installation/), then run:

```bash
pipx install preling          # install
pipx install "preling[ja]"    # alternatively: install with Japanese support
pipx upgrade preling          # upgrade
pipx uninstall preling        # uninstall (hopefully you won't need this)
```

## Initialize a New Language

Prepare a plain-text file that contains **one sentence per line** in the language you want to learn. For example, you can download a monolingual corpus from [OPUS](https://opus.nlpl.eu/). Then run:

```bash
preling init <lang> <corpus>
```

`<lang>` is the [language code](https://spacy.io/usage/models#languages), and `<corpus>` is the path to the corpus file.

## Study a Language

```bash
preling study <lang> [--audio] [--audio-only] [--model <GPT_MODEL>] \
               [--tts-model <TTS_MODEL>] [--api-key <OPENAI_KEY>] [--tts-api-key <OPENAI_OR_GCLOUD_KEY>]
```

* **`<lang>`** – the language code you initialized earlier.
* **`--audio`** – play audio along with the text.  
* **`--audio-only`** – play audio without displaying the text.  
* **`--tts-locale`** – the locale for text-to-speech (e.g., `en-US`, `ja-JP`); required for Gemini models.
* **`--model`** – the GPT model to use for grammar evaluation.  
* **`--tts-model`** – the text-to-speech model to use for audio playback.
* **`--api-key`** – your OpenAI API key.
* **`--tts-api-key`** – your OpenAI API key for text-to-speech, or path to Google Cloud service account JSON file for Gemini models.

Instead of passing these options each time, you can set the environment variables `PRELING_API_KEY`, `PRELING_MODEL`, `PRELING_TTS_API_KEY`, and `PRELING_TTS_MODEL`.

## View Your Progress

```bash
preling stats <lang>
```

## Other Commands

```bash
preling path <lang>               # show the path to the language data file
preling delete <lang> [--force]   # delete the language data file; use --force to skip the confirmation prompt
```
render-engine-tailwindcss 2025.11.2a1
tailwindcss-parser for Render Engine

# Render Engine TailwindCSS Plugin

Add tailwindcss to your Render Engine site.

[TailwindCSS](https://tailwindcss.com) is a utility-first CSS framework for rapidly building custom designs.

The [pytailwindcss](https://pypi.org/project/pytailwindcss/) package is used to install compile the tailwindcss stylesheets without the need of npm.

This plugin installs builds a tailwindcss file from the default configuration and adds a `tailwind.css` file to your static files.

> ***Warning***: This is in early development.

## Installation

Install the extension with pip:

    pip install render-engine-tailwindcss

## Usage

1. Import the plugin.

    ```python
    # app.py

    from render_engine import Site
    from render_engine_tailwindcss import TailwindCSS
    ```

2. Add the plugin to your site.

    ```python
    # app.py

    class site(Site):

        static_path = 'static'
        plugins=[
            TailwindCSS(),
        ]

    )
    ```

3. In your 'static_path', add your pre-tailwindcss stylesheets.

    ```css
    # static/styles.css

    @tailwind base;
    @tailwind components;
    @tailwind utilities; 
    ```

You can add multiple CSS files to the static path and they will all converted into their own files.

## Development & Testing

This project uses `just` for common development tasks and `nox` for testing across multiple Python versions.

### Quick Start with Just

```bash
# Run tests
just test

# Run tests with coverage
just test-coverage

# Run both (if available)
just check
```

### Using Nox for Multi-Version Testing

Test the plugin across Python 3.11, 3.12, 3.13, and 3.14:

```bash
# Run tests on all Python versions
nox -s test

# Run all checks
nox -s check
```

### Development Setup

```bash
# Install with uv (recommended)
uv sync

# Install with pip
pip install -e ".[test]"

# Run tests
just test
```

## Available Just Commands

- `just test` - Run pytest on current Python version
- `just test-coverage` - Run pytest with coverage reporting
- `just check` - Run tests