39960485ef
Bumps [black](https://github.com/psf/black) from 23.11.0 to 23.12.0. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/psf/black/releases">black's releases</a>.</em></p> <blockquote> <h2>23.12.0</h2> <h3>Highlights</h3> <p>It's almost 2024, which means it's time for a new edition of <em>Black</em>'s stable style! Together with this release, we'll put out an alpha release 24.1a1 showcasing the draft 2024 stable style, which we'll finalize in the January release. Please try it out and <a href="https://redirect.github.com/psf/black/issues/4042">share your feedback</a>.</p> <p>This release (23.12.0) will still produce the 2023 style. Most but not all of the changes in <code>--preview</code> mode will be in the 2024 stable style.</p> <h3>Stable style</h3> <ul> <li>Fix bug where <code># fmt: off</code> automatically dedents when used with the <code>--line-ranges</code> option, even when it is not within the specified line range. (<a href="https://redirect.github.com/psf/black/issues/4084">#4084</a>)</li> <li>Fix feature detection for parenthesized context managers (<a href="https://redirect.github.com/psf/black/issues/4104">#4104</a>)</li> </ul> <h3>Preview style</h3> <ul> <li>Prefer more equal signs before a break when splitting chained assignments (<a href="https://redirect.github.com/psf/black/issues/4010">#4010</a>)</li> <li>Standalone form feed characters at the module level are no longer removed (<a href="https://redirect.github.com/psf/black/issues/4021">#4021</a>)</li> <li>Additional cases of immediately nested tuples, lists, and dictionaries are now indented less (<a href="https://redirect.github.com/psf/black/issues/4012">#4012</a>)</li> <li>Allow empty lines at the beginning of all blocks, except immediately before a docstring (<a href="https://redirect.github.com/psf/black/issues/4060">#4060</a>)</li> <li>Fix crash in preview mode when using a short <code>--line-length</code> (<a href="https://redirect.github.com/psf/black/issues/4086">#4086</a>)</li> <li>Keep suites consisting of only an ellipsis on their own lines if they are not functions or class definitions (<a href="https://redirect.github.com/psf/black/issues/4066">#4066</a>) (<a href="https://redirect.github.com/psf/black/issues/4103">#4103</a>)</li> </ul> <h3>Configuration</h3> <ul> <li><code>--line-ranges</code> now skips <em>Black</em>'s internal stability check in <code>--safe</code> mode. This avoids a crash on rare inputs that have many unformatted same-content lines. (<a href="https://redirect.github.com/psf/black/issues/4034">#4034</a>)</li> </ul> <h3>Packaging</h3> <ul> <li>Upgrade to mypy 1.7.1 (<a href="https://redirect.github.com/psf/black/issues/4049">#4049</a>) (<a href="https://redirect.github.com/psf/black/issues/4069">#4069</a>)</li> <li>Faster compiled wheels are now available for CPython 3.12 (<a href="https://redirect.github.com/psf/black/issues/4070">#4070</a>)</li> </ul> <h3>Integrations</h3> <ul> <li>Enable 3.12 CI (<a href="https://redirect.github.com/psf/black/issues/4035">#4035</a>)</li> <li>Build docker images in parallel (<a href="https://redirect.github.com/psf/black/issues/4054">#4054</a>)</li> <li>Build docker images with 3.12 (<a href="https://redirect.github.com/psf/black/issues/4055">#4055</a>)</li> </ul> </blockquote> </details> <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/psf/black/blob/main/CHANGES.md">black's changelog</a>.</em></p> <blockquote> <h2>23.12.0</h2> <h3>Highlights</h3> <p>It's almost 2024, which means it's time for a new edition of <em>Black</em>'s stable style! Together with this release, we'll put out an alpha release 24.1a1 showcasing the draft 2024 stable style, which we'll finalize in the January release. Please try it out and <a href="https://redirect.github.com/psf/black/issues/4042">share your feedback</a>.</p> <p>This release (23.12.0) will still produce the 2023 style. Most but not all of the changes in <code>--preview</code> mode will be in the 2024 stable style.</p> <h3>Stable style</h3> <ul> <li>Fix bug where <code># fmt: off</code> automatically dedents when used with the <code>--line-ranges</code> option, even when it is not within the specified line range. (<a href="https://redirect.github.com/psf/black/issues/4084">#4084</a>)</li> <li>Fix feature detection for parenthesized context managers (<a href="https://redirect.github.com/psf/black/issues/4104">#4104</a>)</li> </ul> <h3>Preview style</h3> <ul> <li>Prefer more equal signs before a break when splitting chained assignments (<a href="https://redirect.github.com/psf/black/issues/4010">#4010</a>)</li> <li>Standalone form feed characters at the module level are no longer removed (<a href="https://redirect.github.com/psf/black/issues/4021">#4021</a>)</li> <li>Additional cases of immediately nested tuples, lists, and dictionaries are now indented less (<a href="https://redirect.github.com/psf/black/issues/4012">#4012</a>)</li> <li>Allow empty lines at the beginning of all blocks, except immediately before a docstring (<a href="https://redirect.github.com/psf/black/issues/4060">#4060</a>)</li> <li>Fix crash in preview mode when using a short <code>--line-length</code> (<a href="https://redirect.github.com/psf/black/issues/4086">#4086</a>)</li> <li>Keep suites consisting of only an ellipsis on their own lines if they are not functions or class definitions (<a href="https://redirect.github.com/psf/black/issues/4066">#4066</a>) (<a href="https://redirect.github.com/psf/black/issues/4103">#4103</a>)</li> </ul> <h3>Configuration</h3> <ul> <li><code>--line-ranges</code> now skips <em>Black</em>'s internal stability check in <code>--safe</code> mode. This avoids a crash on rare inputs that have many unformatted same-content lines. (<a href="https://redirect.github.com/psf/black/issues/4034">#4034</a>)</li> </ul> <h3>Packaging</h3> <ul> <li>Upgrade to mypy 1.7.1 (<a href="https://redirect.github.com/psf/black/issues/4049">#4049</a>) (<a href="https://redirect.github.com/psf/black/issues/4069">#4069</a>)</li> <li>Faster compiled wheels are now available for CPython 3.12 (<a href="https://redirect.github.com/psf/black/issues/4070">#4070</a>)</li> </ul> <h3>Integrations</h3> <ul> <li>Enable 3.12 CI (<a href="https://redirect.github.com/psf/black/issues/4035">#4035</a>)</li> <li>Build docker images in parallel (<a href="https://redirect.github.com/psf/black/issues/4054">#4054</a>)</li> <li>Build docker images with 3.12 (<a href="https://redirect.github.com/psf/black/issues/4055">#4055</a>)</li> </ul> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href=" |
||
---|---|---|
.. | ||
mozilla_nimbus_schemas | ||
.dockerignore | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
VERSION | ||
index.d.ts | ||
package.json | ||
poetry.lock | ||
pyproject.toml | ||
yarn.lock |
README.md
Nimbus Schemas
This directory contains a package of schemas published to various repositories for use by different parts of the Mozilla Nimbus experimentation ecosystem.
Installation/Usage
Prerequisites
- python ^3.10
- poetry ^1.2.2
- node ^16
- yarn ^1.22
Common Operations
From project root (i.e., parent to this directory)
- Install:
make schemas_install
- Run linting and tests:
make schemas_check
- Code formatting:
make schemas_code_format
Building Python Schemas Package
make schemas_build
Building Typescript Schemas Package
make schemas_build_npm
Schemas
Jetstream
Contains schemas describing analysis results, metadata, and errors from Jetstream.
Deployment
The build and deployment occurs automatically through CI. A deployment is triggered on merges into the main
branch when the version number changes. Schemas are published to various repos for access in different languages.
Versioning
mozilla-nimbus-schemas
uses a date-based versioning scheme (CalVer
). The format is yyyy.m.MINOR
, where m
is the non-zero-padded month, and MINOR
is an incrementing number starting from 1 for each month. Notably, this MINOR
number does NOT correspond to the day of the month. For example, the second release in June of 2023 would have a version of 2023.6.2
.
Version Updates
- To update the published package versions, update the
VERSION
file in this directory.
- From the project root, you can run the helper script:
./scripts/set_schemas_version.sh <version>
- Or write to the file:
echo <version> > ./schemas/VERSION
- Or simply edit the file in any text editor.
- Update the package versions with the new VERSION file:
make schemas_version
Python
Published to PyPI as mozilla-nimbus-schemas
Typescript
Published to NPM as @mozilla/nimbus-schemas
Rust
Not yet implemented.