messageformat2 0.1.0__tar.gz → 1.0.0__tar.gz

messageformat2-1.0.0/.github/dependabot.yml

@@ -0,0 +1,27 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "Europe/Zurich"
+    cooldown:
+      default-days: 7
+    groups:
+       github-actions:
+          patterns: ["*"]
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "Europe/Zurich"
+    cooldown:
+      default-days: 7
+    groups:
+       python-dependencies:
+          patterns: ["*"]

messageformat2-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14", "3.15"]
+
+    steps:
+      - uses: actions/checkout@v7.0.1
+
+      - name: Install the latest version of uv and set the python version
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Lint code 🧹
+        run: |
+          uv run ruff check tests/ messageformat2/
+
+      - name: Format code 📃
+        run: |
+          uv run ruff format --check --output-format=github messageformat2/ tests/
+
+      - name: Type check 🏷
+        run: |
+          uv run ty check messageformat2/ tests/
+
+      - name: Run tests 🧪
+        run: |
+          uv run pytest --no-cov --doctest-modules

messageformat2-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Upload To PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  pypi-publish:
+
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+
+    steps:
+    - uses: actions/checkout@v7.0.1
+
+    - name: Install the latest version of uv and set the python version
+      uses: astral-sh/setup-uv@v7
+      with:
+        python-version: '3.14'
+
+    - name: Build package 📦
+      run: uv build
+
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

{messageformat2-0.1.0 → messageformat2-1.0.0}/.gitignore

@@ -1,5 +1,4 @@
-venv/
-.python-version
+.venv/
 __pycache__/
 .coverage
 htmlcov/
@@ -7,4 +6,3 @@ htmlcov/
 .pytest_cache/
 *.egg-info/
 
-node_modules/

{messageformat2-0.1.0 → messageformat2-1.0.0}/.readthedocs.yaml

@@ -6,14 +6,16 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-26.04
   tools:
-    python: "3.12"
+    python: "3.14"
 
-mkdocs:
-  configuration: mkdocs.yml
-
-# Optionally declare the Python requirements required to build your docs
 python:
   install:
-    - requirements: requirements.docs.txt
+    - method: uv
+      command: sync
+      groups:
+        - docs
+
+mkdocs:
+  configuration: mkdocs.yml

{messageformat2-0.1.0 → messageformat2-1.0.0}/CONTRIBUTING.md

@@ -24,6 +24,6 @@ pytest --doctest-modules
 ### Code quality
 
 ```sh
-pyright tests/ messageformat2/
+ty tests/ messageformat2/
 ruff check tests/ messageformat2/
 ```

{messageformat2-0.1.0 → messageformat2-1.0.0}/PKG-INFO

@@ -1,7 +1,10 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.5
 Name: messageformat2
-Version: 0.1.0
+Version: 1.0.0
 Summary: Python implementation of Unicode MessageFormat 2.0
+Project-URL: Homepage, https://github.com/tomasr8/messageformat2
+Project-URL: Github, https://github.com/tomasr8/messageformat2
+Project-URL: Documentation, https://messageformat2.readthedocs.io/en/latest/
 Author-email: Tomas Roun <tomas.roun8@gmail.com>
 License: MIT License
         
@@ -24,52 +27,34 @@ License: MIT License
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/tomasr8/messageformat2
-Project-URL: Github, https://github.com/tomasr8/messageformat2
-Keywords: i18n,internationalization,localization,messageformat,messageformat 2,cldr,gettext
-Classifier: License :: OSI Approved :: MIT License
+License-File: LICENSE
+Keywords: cldr,gettext,i18n,internationalization,localization,messageformat,messageformat 2
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Internationalization
 Classifier: Topic :: Software Development :: Localization
 Requires-Python: >=3.12
+Requires-Dist: babel>=2
+Requires-Dist: click>=8
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: Babel
-Requires-Dist: click
-Provides-Extra: dev
-Requires-Dist: build; extra == "dev"
-Requires-Dist: twine; extra == "dev"
-Requires-Dist: uv; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-snapshot; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: ruff; extra == "dev"
-Requires-Dist: pyright; extra == "dev"
-Requires-Dist: mkdocs; extra == "dev"
-Requires-Dist: mkdocstrings[python]; extra == "dev"
-Requires-Dist: mkdocs-material; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: mkdocs; extra == "docs"
-Requires-Dist: mkdocstrings[python]; extra == "docs"
-Requires-Dist: mkdocs-material; extra == "docs"
-
-
-
-# MessageFormat2 [![Documentation Status](https://readthedocs.org/projects/messageformat2/badge/?version=latest)](https://messageformat2.readthedocs.io/en/latest/?badge=latest) [![CI](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg) [![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+
+
+
+# MessageFormat2 [![Documentation Status](https://readthedocs.org/projects/messageformat2/badge/?version=latest)](https://messageformat2.readthedocs.io/en/latest/?badge=latest) [![CI](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)
 
 This is a Python implementation of the [Unicode Message Format 2.0
-specification](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html).
+specification](https://www.unicode.org/reports/tr35/tr35-messageFormat.html).
 
 Message Format 2.0 (MF2) is a new iteration of Message Format which aims to be
 more expressive and flexible than both Message Format 1.0 and, in the context of
 Python, gettext.
 
 If you would like to learn more about MF2 itself head over to the [Unicode technical
-specification](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html).
+specification](https://www.unicode.org/reports/tr35/tr35-messageFormat.html).
 
 ## Features
 
@@ -77,12 +62,14 @@ The library includes:
 
 - A message parser and a formatter
 - Several builtin formatters and selectors described by the
-  [spec](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html#function-registry)
+  [spec](https://github.com/unicode-org/message-format-wg/blob/main/spec/functions/README.md)
   and the possibility to write custom formatters/selectors
 - Helper classes to inspect and transform the message [data
-  model](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html#interchange-data-model)
+  model](https://github.com/unicode-org/message-format-wg/blob/main/spec/data-model/README.md)
+
+## Documentation
 
-## [Documentation](https://messageformat2.readthedocs.io/en/latest/)
+Documentation is available here: [https://messageformat2.readthedocs.io/en/latest/](https://messageformat2.readthedocs.io/en/latest/)
 
 ## Installation
 
@@ -136,7 +123,8 @@ MF2 supports pluralization using built-in or custom selectors.
 from messageformat2 import Message
 
 msg = Message ("""\
-.match {$count :number}
+.input {$count :number}
+.match $count
 one {{You have {$count} notification.}}
 *   {{You have {$count} notifications.}}
 """)

{messageformat2-0.1.0 → messageformat2-1.0.0}/README.md

@@ -1,16 +1,16 @@
 
 
-# MessageFormat2 [![Documentation Status](https://readthedocs.org/projects/messageformat2/badge/?version=latest)](https://messageformat2.readthedocs.io/en/latest/?badge=latest) [![CI](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg) [![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+# MessageFormat2 [![Documentation Status](https://readthedocs.org/projects/messageformat2/badge/?version=latest)](https://messageformat2.readthedocs.io/en/latest/?badge=latest) [![CI](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)](https://github.com/tomasr8/messageformat2/workflows/CI/badge.svg)
 
 This is a Python implementation of the [Unicode Message Format 2.0
-specification](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html).
+specification](https://www.unicode.org/reports/tr35/tr35-messageFormat.html).
 
 Message Format 2.0 (MF2) is a new iteration of Message Format which aims to be
 more expressive and flexible than both Message Format 1.0 and, in the context of
 Python, gettext.
 
 If you would like to learn more about MF2 itself head over to the [Unicode technical
-specification](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html).
+specification](https://www.unicode.org/reports/tr35/tr35-messageFormat.html).
 
 ## Features
 
@@ -18,12 +18,14 @@ The library includes:
 
 - A message parser and a formatter
 - Several builtin formatters and selectors described by the
-  [spec](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html#function-registry)
+  [spec](https://github.com/unicode-org/message-format-wg/blob/main/spec/functions/README.md)
   and the possibility to write custom formatters/selectors
 - Helper classes to inspect and transform the message [data
-  model](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html#interchange-data-model)
+  model](https://github.com/unicode-org/message-format-wg/blob/main/spec/data-model/README.md)
 
-## [Documentation](https://messageformat2.readthedocs.io/en/latest/)
+## Documentation
+
+Documentation is available here: [https://messageformat2.readthedocs.io/en/latest/](https://messageformat2.readthedocs.io/en/latest/)
 
 ## Installation
 
@@ -77,7 +79,8 @@ MF2 supports pluralization using built-in or custom selectors.
 from messageformat2 import Message
 
 msg = Message ("""\
-.match {$count :number}
+.input {$count :number}
+.match $count
 one {{You have {$count} notification.}}
 *   {{You have {$count} notifications.}}
 """)

messageformat2-1.0.0/docs/builtins.md

@@ -0,0 +1,142 @@
+The default function registry includes these functions
+
+in line with the [specification](https://github.com/unicode-org/message-format-wg/tree/main/spec/functions)
+
+### `:string`
+
+#### Formatter
+
+As a formatter, this function simply calls `str(value)`.
+
+#### Selector
+
+As a selector, this function selects the exact match among the variant keys
+(after NFC normalization of the value).
+
+```python
+format_message("""\
+.input {$pet :string}
+.match $pet
+dog {{I have a dog}}
+cat {{I have a cat}}
+* {{I have a {$pet}}}
+""", {"pet": "cat"})
+# -> "I have a cat"
+```
+
+### `:number`
+
+The operand must be an `int`, `float` or `Decimal` (but not a `bool`), or a string matching the
+`number-literal` production of the spec (e.g. `|-1234.5|`, `|1e3|`; `|01|` or `|.5|` are not numbers).
+The resolved value of another numeric function (`:number`, `:integer`, `:offset`) is also accepted, in which
+case its options are inherited, with the options of the expression taking priority.
+
+#### Formatter
+
+- `signDisplay`
+    - auto (default)
+    - always
+    - exceptZero
+    - negative
+    - never
+- `useGrouping`
+    - auto (default)
+    - always
+    - never
+    - min2 (treated as auto)
+- `minimumIntegerDigits`
+- `minimumFractionDigits`
+- `maximumFractionDigits`
+- `minimumSignificantDigits`
+- `maximumSignificantDigits`
+- `numberingSystem` (implementation extension): a Unicode Number System Identifier
+
+The digit options are *digit size options*: small non-negative integers (`0`-`99`).
+Not implemented: `trailingZeroDisplay`, `roundingPriority`, `roundingIncrement`, `roundingMode` (these are ignored).
+
+#### Selector
+
+The selector takes the same options as the formatter in addition to:
+
+- `select`
+    - plural (default)
+    - ordinal
+    - exact
+
+`select` must be set by a literal. The selector first tries an exact match between the number and
+numeric keys (e.g. `1`), then (unless `select=exact`) matches the CLDR plural or ordinal category of the number
+(`zero`, `one`, `two`, `few`, `many`, `other`). Any other key is a `BadVariantKey` error.
+
+### `:integer`
+
+Same as `:number`, but the operand is truncated to an integer. The `minimumFractionDigits`, `maximumFractionDigits`
+and `minimumSignificantDigits` options of an annotated operand are discarded.
+
+### `:offset`
+
+Adds or subtracts a small integer from a numeric operand, e.g. to count "other" users:
+
+```python
+.input {$likes :integer}
+.local $others = {$likes :offset subtract=1}
+```
+
+Exactly one of the options must be given:
+
+- `add`
+- `subtract`
+
+The formatting options of an annotated operand (e.g. `signDisplay` of `{$likes :integer signDisplay=always}`)
+are inherited. `:offset` can also be used as a selector, in which case it behaves like `:number`.
+
+### `:datetime`, `:date`, `:time`
+
+The operand must be a `datetime` (or a `date`/`time` for `:date`/`:time` respectively) or an ISO 8601 date or
+datetime string that can be parsed with `datetime.fromisoformat`, e.g. `|2006-01-02|` or `|2006-01-02T15:04:06+01:00|`.
+The resolved value of another date/time function is also accepted, in which case its override options
+(`timeZone`, `hour12`) are inherited.
+
+The option values below must be set by literals (an option set by a variable is a `BadOption` error).
+
+#### `:datetime`
+
+- `dateFields`
+    - weekday
+    - day-weekday
+    - month-day
+    - month-day-weekday
+    - year-month-day (default)
+    - year-month-day-weekday
+- `dateLength`
+    - long
+    - medium (default)
+    - short
+- `timePrecision`
+    - hour
+    - minute (default)
+    - second
+- `timeZoneStyle`: no time zone is shown unless set
+    - long
+    - short
+
+#### `:date`
+
+- `fields`: same values as `dateFields` above
+- `length`: same values as `dateLength` above
+
+#### `:time`
+
+- `precision`: same values as `timePrecision` above
+- `timeZoneStyle`: same values as above
+
+#### Override options
+
+- `timeZone`: `UTC`, `input` (the time zone of the operand, which must then have one), an IANA time zone
+  name (`|Europe/Zurich|`) or an offset (`|+01:00|`). A naive `datetime` is interpreted in this time zone,
+  an aware one is converted to it.
+- `hour12`: `true` or `false` (`:datetime` and `:time` only); the default is locale-dependent.
+- `calendar`: not implemented (ignored).
+
+#### Selector
+
+The date/time functions do not support selection, as it is not required by MF2.

messageformat2-1.0.0/docs/explanation.md

@@ -0,0 +1,71 @@
+## Runtime model
+
+All expressions are lazily evaluated at the time of use.
+If the same variable is referenced more than once, it will also be evaluated more than once.
+Pay attention when providing custom formatters/selectors with side effects:
+
+```python
+counter = 0
+
+def formatter_with_side_effect(value, locale, options):
+    nonlocal counter
+    counter +=1
+    return str(value)
+
+msg = Message("\
+.local $foo = {|foo| :side_effect}
+{{{$foo} {$foo}}}
+")
+msg.format(formatters={'side_effect': formatter_with_side_effect})
+print(counter)  # -> 2
+```
+
+## Unannotated variables
+
+A placeholder consisting only of a variable (`{$x}`) is formatted according to the type of its value:
+numbers (`int`, `float`, `Decimal`) as if annotated with `:number`, `datetime`, `date` and `time` values with
+`:datetime`, `:date` and `:time`. Anything else is formatted with `str()`.
+Literals are always strings, so `{|1234.5|}` is formatted verbatim.
+
+## Function composition
+
+A variable which was annotated with a function can be annotated again, for example in a placeholder.
+The function handler then receives the resolved value of the earlier annotation
+(a `messageformat2.builtins.LazyValue` carrying the earlier function's name, operand and options) as its operand,
+and decides what to do with it. The built-in numeric functions accept each other's resolved values
+and inherit their options, with the options of the later expression taking priority:
+
+```python
+.local $x = {42 :number minimumFractionDigits=2 signDisplay=always}
+{{x = {$x :number minimumFractionDigits=1}}}  # -> "x = +42.0"
+
+.local $x = {1.25 :integer}
+{{x = {$x :number}}}  # -> "x = 1"
+```
+
+whereas e.g. `{$x :date}` would raise `BadOperand`. See [Custom formatters](howto/formatter.md) for how to
+handle such operands in your own functions.
+
+## Whitespace
+
+This library implements the [grammar](https://github.com/unicode-org/message-format-wg/blob/main/spec/message.abnf) exactly as specified which includes whitespace.
+
+Whitespace around a complex message (a message containing declarations and/or a match block) is not significant,
+so complex messages can be freely indented, e.g. in multiline strings:
+
+```python
+Message("""
+    .input {$count :integer}
+    .match $count
+    * {{count is {$count}}}
+""")
+```
+
+Whitespace in a simple message (a message consisting of a single pattern) is always significant
+and is part of the message text. Note that the first non-whitespace character of a simple message
+cannot be a `.`, so a misspelled keyword (`.imput`) is a syntax error rather than silently becoming text.
+To get a pattern which starts with a `.`, use a quoted pattern:
+
+```python
+Message("{{.input is not a keyword here}}")
+```

{messageformat2-0.1.0 → messageformat2-1.0.0}/docs/getting_started.md

@@ -48,7 +48,8 @@ MF2 supports pluralization using built-in or custom selectors.
 from messageformat2 import Message
 
 msg = Message ("""\
-.match {$count :number}
+.input {$count :number}
+.match $count
 one {{You have {$count} notification.}}
 *   {{You have {$count} notifications.}}
 """)

{messageformat2-0.1.0 → messageformat2-1.0.0}/docs/howto/datamodel.md

@@ -1,6 +1,6 @@
 The `Message` class has a `datamodel` property which gives you access to the
 message data model which is based on the [MF2
-spec](https://www.unicode.org/reports/tr35/tr35-72/tr35-messageFormat.html#interchange-data-model).
+spec](https://github.com/unicode-org/message-format-wg/blob/main/spec/data-model/README.md).
 The data model nodes are documented [here](/datamodel).
 
 There are two classes to work with the datamodel - `DataModelVisitor` &

messageformat2-1.0.0/docs/howto/errors.md

@@ -0,0 +1,72 @@
+# Error handling
+
+Errors might be raised during parsing or during formatting. You can learn more
+about MF2 errors
+[here](https://github.com/unicode-org/message-format-wg/blob/main/spec/errors.md).
+
+During parsing the following exceptions (or their subclasses) might be raised:
+
+- `messageformat2.errors.ParseError` - for syntax errors
+- `messageformat2.errors.DataModelError` - for semantic errors
+
+During formatting the following exception (or its subclasses) might be raised:
+
+- `messageformat2.errors.FormatError`
+
+## Handling parsing errors
+
+```python
+from messageformat2.message import Message
+from messageformat2.errors import ParseError, DataModelError
+
+try:
+    Message("}} invalid syntax")
+except ParseError as e:
+    print(e)  # -> Invalid syntax
+
+
+try:
+    Message("""\
+.input {$count :integer}
+.match $count
+one {{The count is {$count}}}
+""")
+except DataModelError as e:
+    print(e)  # -> Missing fallback variant
+```
+
+## Handling formatting errors
+
+```python
+from messageformat2.message import Message
+from messageformat2.errors import FormatError
+
+msg = Message("Hello, {$name}!")
+try:
+    msg.format()
+except FormatError as e:
+    print(e)  # -> Unresolved variable
+```
+
+## Formatting with fallback values
+
+By default the first formatting error is raised and no output is produced. The spec requires
+that a valid message can always be formatted, with
+[fallback values](https://github.com/unicode-org/message-format-wg/blob/main/spec/formatting.md#fallback-resolution)
+standing in for the parts that failed. Pass an `on_error` callback to get this behaviour: every error is
+passed to the callback instead of being raised, and formatting continues.
+
+```python
+from messageformat2.message import Message
+
+errors = []
+msg = Message("Hello, {$name}! You have {$count :number} messages.")
+msg.format({"count": "many"}, on_error=errors.append)
+# -> "Hello, {$name}! You have {$count} messages."
+errors
+# -> [UnresolvedVariable('Unresolved variable: name'), BadOperand("Bad operand: 'many' is not a number")]
+```
+
+The fallback value is `{$name}` for a variable, `{|literal|}` for a literal operand and `{:function}` for a
+function without an operand. An option whose value cannot be resolved is omitted, and a selector which fails
+only matches the catch-all key `*`. Syntax and data model errors are still raised by `Message()`.