Skip to main content

Blazing fast implementation of Fluent localization language.

Project description

https://badge.fury.io/py/fluent-compiler.svg https://readthedocs.org/projects/fluent-compiler/badge/?version=latest&style=flat https://github.com/django-ftl/fluent-compiler/workflows/Python%20package/badge.svg

This is a Python implementation of Project Fluent, a localization framework designed to unleash the entire expressive power of natural language translations.

It provides a different implementation from the official fluent.runtime implementation, distinguished mainly by:

  • strategy: we compile FTL files to Python bytecode via AST and use exec (similar to the strategy used by projects like Mako, Jinja2 and Genshi).
  • speed: as a result of the above, plus static analysis, we get blazing fast performance, especially when combined with PyPy which can further optimize.
  • compile-time checking and error reporting.
  • ‘escapers’ feature for handling things like HTML escaping/embedding correctly.

Installation

To install:

pip install fluent_compiler

Status

The package should be considered a ‘beta’/’release candidate’. It has a very thorough test suite and good docs, and has seen usage in production as a dependency of django-ftl for a long time, but without many users.

We are not planning major backwards incompatible changes to the interface, but we’re also not guaranteeing stability yet. Also, the nature of the library is such that we expect most users will want to create their own wrappers anyway, which you are encouraged to do, in order to be able to absorb any backwards incompatible changes easily.

See the issues list for planned features.

Background

This code was originally developed as part of fluent.runtime, as an alternative implementation of FluentBundle, but never got merged to the master branch. It has now been pulled out as a separate package. This is why the repo’s history contains fluent.syntax and early versions of fluent.runtime, but the parts that are left in this repo all derive from the original version of fluent.runtime contributed by @spookylukey from a540993a085e36a9679e12f1ee7317ddc1ece5ad onwards and the new compiler implementation in d1481d61e0bc1a28a228a4b6d5258350d436e765 (which is squashed version of work done over a much longer period). Thats why we also corrected the copyright notice from Mozilla to Luke Plant.

See https://github.com/django-ftl/fluent-compiler/ for more info.

Project details


Download files

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

Files for fluent-compiler, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size fluent_compiler-0.3-py2-none-any.whl (40.0 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size fluent_compiler-0.3-py3-none-any.whl (38.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fluent_compiler-0.3.tar.gz (81.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page