---
id: fluent-pygments
version: "1.0"
license: APL 2
license_treatment: permissive
maintenance: active
---

# fluent.pygments — Pygments lexer for Fluent.

License: permissive · Maintenance: active · Downloads: 443.0K/mo

## What it is and what it does

fluent.pygments is a Pygments lexer plugin that teaches Pygments how to recognize and highlight Fluent localization syntax. Fluent is a localization system designed to make it easier to express complex plural rules, gender agreement, and other linguistic nuances in application strings. This package integrates that syntax highlighting into Pygments, which means it works with any tool that uses Pygments—most notably Sphinx documentation generators.

The package depends on Pygments itself, fluent.syntax (the Fluent parser and utilities), and six (for Python 2/3 compatibility). It's a small, focused tool: if you're documenting Fluent files or displaying Fluent code in a Sphinx project, this lexer makes that code readable with proper syntax coloring. Without it, Fluent code appears as plain text.

Use it for:

- Add colored Fluent syntax to Sphinx documentation for localization projects
- Display Fluent localization files with proper highlighting in code examples
- Enable syntax-aware rendering of Fluent code in documentation generation pipelines
- Provide IDE-like syntax highlighting for Fluent in any Pygments-based tool

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds syntax highlighting support for Fluent localization files to Pygments, enabling syntax-colored display of Fluent code in documentation tools like Sphinx.

Yes, if you use Sphinx or another Pygments-based tool and need to display Fluent localization code with syntax highlighting. Install it as a dependency of your documentation build. The low friction, permissive license, and active repository make it a straightforward addition. However, note that the last release was in 2020; verify compatibility with your current Pygments version before relying on it in production documentation.

## Install

pip install fluent-pygments
uv add fluent-pygments
poetry add fluent-pygments

## Installing fluent.pygments

Before you install: Low friction installation with a pure-Python wheel and minimal dependencies. The package is actively maintained with recent commits, though it has not seen a release since 2020-05-20.

License in practice: Licensed under Apache License, Version 2.0 (permissive), allowing use in both open-source and proprietary projects with minimal restrictions.

Quickstart:

pip install fluent.pygments

from pygments import highlight
from pygments.lexers import get_lexer_by_name
from pygments.formatters import TerminalFormatter

lexer = get_lexer_by_name('fluent')
code = 'hello = Hello, { $name }!'
print(highlight(code, lexer, TerminalFormatter()))

Verify before relying:

- Whether the package works with current Pygments versions despite the last release being in 2020
- Compatibility with Python versions beyond 3.5 given the classifier dates

## Package facts

- License: APL 2 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 443.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fluent syntax highlighting, pygments fluent lexer, fluent localization highlighting, sphinx fluent plugin, fluent code highlighting, pygments localization, fluent documentation syntax, localization, syntax-highlighting, documentation

[View on SkillFed](https://skillfed.io/packages/fluent-pygments) · [View on PyPI](https://pypi.org/project/fluent-pygments/)