Metadata-Version: 2.1
Name: elm-fluent
Version: 0.3
Summary: Fluent i18n solution for Elm
Home-page: https://github.com/elm-fluent/elm-fluent
Author: Luke Plant
Author-email: L.Plant.98@cantab.net
License: MIT license
Keywords: elm_fluent
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: Click (>=6.0)
Requires-Dist: fluent.syntax (<0.13.0,>=0.12.0)
Requires-Dist: attrs (>=18)
Requires-Dist: language-tags (>=0.4.4)
Requires-Dist: beautifulsoup4 (>=4.6.3)
Requires-Dist: lxml (>=4.2.4)
Requires-Dist: watchdog (>=0.8.3)

==========
elm-fluent
==========


.. image:: https://img.shields.io/pypi/v/elm_fluent.svg
        :target: https://pypi.org/project/elm-fluent/

.. image:: https://img.shields.io/travis/elm-fluent/elm-fluent.svg
        :target: https://travis-ci.org/elm-fluent/elm-fluent

.. image:: https://codecov.io/gh/elm-fluent/elm-fluent/branch/master/graph/badge.svg
        :target: https://codecov.io/gh/elm-fluent/elm-fluent

.. image:: https://readthedocs.org/projects/elm-fluent/badge/?version=latest
        :target: https://elm-fluent.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


elm-fluent is a `Fluent <https://projectfluent.org/>`_ implementation for Elm.

Fluent is a next-generation translation/localization solution, designed by the
folks at Mozilla, based on many years of experience with localizing into a large
number of different languages. Mozilla have extracted parts of their 'l20n'
solution (used by apps like Firefox and Thunderbird) into a re-usable
specification designed specifically for the web.

elm-fluent is a full implementation of this specification for Elm (currently
supporting the Fluent 0.8 syntax).

It operates as a command line tool that compiles ``.ftl`` files to ``.elm``
files. The result is that each message becomes a function that will generate a
translated string (or HTML fragment) for a given locale and an optional set of
strongly typed parameters (string, dates or numbers).

Dates and numbers can also be passed with formatting parameters supplied - for
example, to attach a currency to a number, so that it can be correctly formatted
as a currency according to the rules of the locale in use.

Please see the `docs
<https://elm-fluent.readthedocs.io/en/latest/>`_ for more
information.

For discussion regarding Fluent, including elm-fluent, see also the `Mozilla
Discourse Fluent category <https://discourse.mozilla.org/c/fluent>`_.

Status
------

* Rough around the edges, but usable. Please see the list of `open issues
  <https://github.com/elm-fluent/elm-fluent/issues>`_.
* A pretty complete test suite.
* Compatibility: Elm 0.18 only at the moment. Fluent 0.8 syntax.
* Free software: MIT license

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.3.0 (2019-03-06)
------------------

* Syntax 0.8 support, including parameterized terms.
* Better compile-time resolution of some expressions.

0.2.1 (2018-12-19)
------------------

* Fixed python-fluent dependency to an older version (< 0.9), because it
  doesn't work with newer versions. Thanks @stasm for the report.

0.2.0 (2018-09-10)
------------------

* Better handling for a large variety of error conditions
* Proper fallback mechanism implemented
* Added ``--watch`` option.
* Eliminate unused imports from generated code
* Various bug fixes:

  * Avoid outputting ``.elm`` files with no exports
  * Bugs with HTML attributes and non-string message args
  * Crasher with multi-line messages
  * Crasher when a message is missing from default locale


0.1.0 (2018-07-27)
------------------

* First release on PyPI.


