flufl.i18n - A high level API for internationalization

This package is called flufl.i18n. It provides a high level, convenient API for managing internationalization translation contexts in Python application. There is a simple API for single-context applications, such as command line scripts which only need to translate into one language during the entire course of their execution. There is a more flexible, but still convenient API for multi-context applications, such as servers, which may need to switch language contexts for different tasks.

Requirements

flufl.i18n requires Python 3.8 or newer.

Documentation

A simple guide to using the library is available, along with a detailed API reference.

Project details

• Project home: https://gitlab.com/warsaw/flufl.i18n

• Report bugs at: https://gitlab.com/warsaw/flufl.i18n/issues

• Code hosting: https://gitlab.com/warsaw/flufl.i18n.git

• Documentation: https://flufli18n.readthedocs.io/

You can install it with pip:

% pip install flufl.i18n

You can grab the latest development copy of the code using git. The master repository is hosted on GitLab. If you have git installed, you can grab your own branch of the code like this:

$ git clone https://gitlab.com/warsaw/flufl.i18n.git

You may contact the author via barry@python.org.

Copyright

Copyright (C) 2004-2024 Barry A. Warsaw

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Table of Contents and Index

• Index

• Using the flufl.i18n library
  • Single language contexts
  • Multiple language contexts
  • Context manager
  • The default language context
  • Substitutions and placeholders
  • Deferred translations
• Expanding templates
• Catalog strategies
  • Python package strategies
  • Simple strategy
  • Calling with zero arguments
• API Reference
  • Classes
    • Application
      • Application.code
      • Application.current
      • Application.default
      • Application.defer()
      • Application.get()
      • Application.name
      • Application.pop()
      • Application.push()
    • Translator
      • Translator.catalog
      • Translator.translate()
    • PackageStrategy
    • SimpleStrategy
    • Registry
      • Registry.register()
  • Functions
    • initialize()
    • expand()
  • Globals
    • registry
  • Types
    • RuntimeTranslator
      • RuntimeTranslator.code
      • RuntimeTranslator.default
      • RuntimeTranslator.defer_translation()
      • RuntimeTranslator.pop()
      • RuntimeTranslator.push()
      • RuntimeTranslator.using()
    • TranslationContextManager
    • TranslationStrategy
      • TranslationStrategy.name
• flufl.i18n change log
  • 5.1 (2024-03-30)
  • 5.0.2 (2023-07-21)
  • 5.0.1 (2023-06-13)
  • 5.0 (unreleased)
  • 4.1.1 (2022-09-05)
  • 4.1 (2022-08-25)
  • 4.0 (2022-01-11)
  • 3.2 (2021-05-29)
  • 3.1.5 (2021-02-14)
  • 3.1.4 (2021-01-01)
  • 3.1.3 (2020-10-22)
  • 3.1.2 (2020-10-21)
  • 3.1.1 (2020-10-21)
  • 3.1 (2020-10-20)
  • 3.0.1 (2020-07-28)
  • 3.0 (2020-07-12)
  • 2.0.2 (2019-05-17)
  • 2.0.1 (2017-11-14)
  • 2.0 (2017-07-24)
  • 1.1.3 (2014-04-25)
  • 1.1.2 (2014-03-31)
  • 1.1.1 (2012-04-19)
  • 1.1 (2012-01-19)
  • 1.0.4 (2010-12-06)
  • 1.0.3 (2010-12-01)
  • 1.0.2 (2010-06-23)
  • 1.0.1 (2010-06-09)
  • 1.0 (2010-04-24)
  • 0.6 (2010-04-21)
  • 0.5 (2010-04-20)
  • 0.4 (2010-03-04)
  • 0.3 (2009-11-15)