This is a work-in-progress crate that has not yet been published to
crates.io.  The source was taken from
https://github.com/tokio-rs/tracing/pull/1137

Future updates should remove this crate, once we can pull it from
somewhere else.

In production, eg. when embedded inside a `ratmand` build, if a string is
missing in the currently active language, fall back to the English one.

Missing strings will still trigger a build warning, eg.

  [ember-intl] "index.placeholder.greeting_" was not found in "en"
  [ember-intl] "index.placeholder.greeting" was not found in "de"

And in development, it will still fall back to an error message, eg.

  Missing translation "index.placeholder.greeting" for locale "de"

`ember-best-language` is an ember.js helper that tries to find a match
between the application's available languages, and `navigator.languages`.

Currently, we support English (en) and German (de), and the addon correctly
handles regional fallbacks, eg. US English (en-US) and Austrian (de-AT).

If we get eg. a user who speak only Swiss Italian and Japanese, we log a
warning (to debug faulty locale resolution), and fall back to English:

  [WARN] 🏳 No localisation for [ "it-CH", "ja" ] only [ "de", "en" ]

embr authored Apr 07, 2022 and Katharina Fey committed Apr 07, 2022

I forgot to tell my editor not to run `nixpkgs-fmt` on save.

embr authored Apr 01, 2022 and Katharina Fey committed Apr 07, 2022

This prevents some weird-looking ordering issues when the ratman-webui
assets are built as a side effect of the ratman targets.

embr authored Apr 01, 2022 and Katharina Fey committed Apr 07, 2022

There's an upstream nixpkgs issue, which breaks eg. `pkgsStatic.yarn2nix`:
https://github.com/NixOS/nixpkgs/issues/116207

Thankfully, the output of `ratman-webui` is a pile of arch-independent,
static assets, so we don't actually need this to work; we only need the
build scripts to run on the builder.

--------------------------------------------------------------------------

> $ nix-shell -p pkgsStatic.yarn2nix
> error: attribute 'runtimeShell' missing
>
>        at /home/embr/src/nixpkgs/pkgs/top-level/all-packages.nix:731:17:
>
>           730|       substitutions = {
>           731|         shell = targetPackages.runtimeShell;
>              |                 ^
>           732|         passthru.tests = tests.makeWrapper;
> (use '--show-trace' to show detailed location information)

embr authored Mar 31, 2022 and Katharina Fey committed Apr 07, 2022

This embeds the built Ember.js Web UI into the binary (release), or reads
them from the source tree (development), which means we don't have to worry
about where on disk the assets are relative to the binary.

But it comes with the caveat that building `ratmand` with `--feature=webui`
will now error unless you've previously ran `cd ratman/webui; yarn build`.

embr authored Mar 29, 2022 and Katharina Fey committed Apr 07, 2022

This is already a boolean in the API response; adding a transformation has
a slight runtime performance penalty.