As Gecko is moving toward more Rust code, the cases where Rust and C code interoperate will become more common.
This document is an attempt to ease the learning curve for engineers facing it for the first time. It assumes no prior experience with cross-language C interfaces (called FFI).
It also assumes that Rust code is already built into Gecko. If you need help with that, read Introducing Rust code in Firefox.
In this tutorial, you will learn how to build an end-to-end application using ICU4X to format a date and time with some default locales and additional locales loaded dynamically.
Installing dependencies is always your first step.
We recommend using CodePen to follow along. To load ICU4X into CodePen, you can use this snippet in the JavaScript editor:
| Temporal benchmark starting... | |
| TimeZones: UTC, America/Los_Angeles, Europe/Warsaw, Asia/Shanghai | |
| Calendars: iso8601, gregory, hebrew, chinese, japanese, buddhist, persian | |
| All results are higher-is-better (ops/sec). | |
| Offset lookup via ZDT (proxy for getOffset) | ops/sec mean=1025339 median=1024000 p95=1028016 (n=6) | |
| ZonedDateTime.from Instant+TZ | ops/sec mean=887657 median=885622 p95=891646 (n=6) | |
| ZonedDateTime.add across DST | ops/sec mean=470945 median=471482 p95=474899 (n=6) | |
| PlainDate dateAdd (months/years/leap) | ops/sec mean=1499564 median=1502270 p95=1506575 (n=6) | |
| PlainDateTime since/until (varied units) | ops/sec mean=628153 median=627139 p95=630154 (n=6) | |
| ZonedDateTime.round (minute/hour/day) | ops/sec mean=856836 median=859498 p95=868026 (n=6) |
| // https://github.com/facebook/hermes/blob/main/lib/Platform/Intl/PlatformIntlApple.mm#L319-L353 | |
| vm::CallResult<std::vector<std::u16string>> canonicalizeLocaleList( | |
| vm::Runtime &runtime, | |
| const std::vector<std::u16string> &locales) { | |
| // 1. If locales is undefined, then | |
| // a. Return a new empty List | |
| // Not needed, this validation occurs closer to VM in 'normalizeLocales'. | |
| // 2. Let seen be a new empty List. | |
| std::vector<std::u16string> seen; |
| ╭────┬────────────────────────┬──────┬─────────┬────────────────╮ | |
| │ # │ name │ type │ size │ modified │ | |
| ├────┼────────────────────────┼──────┼─────────┼────────────────┤ | |
| │ 0 │ ar-icu4c-line.txt │ file │ 22.7 KB │ 3 hours ago │ | |
| │ 1 │ ar-icu4c-word.txt │ file │ 48.6 KB │ 3 hours ago │ | |
| │ 2 │ ar-icu4x-line-utf8.txt │ file │ 23.8 KB │ 3 hours ago │ | |
| │ 3 │ ar-icu4x-line.txt │ file │ 22.9 KB │ 3 hours ago │ | |
| │ 4 │ ar-icu4x-word-utf8.txt │ file │ 50.5 KB │ 3 hours ago │ | |
| │ 5 │ ar-icu4x-word.txt │ file │ 48.6 KB │ 3 hours ago │ | |
| │ 6 │ ar.txt │ file │ 35.1 KB │ 3 hours ago │ |
| browser.commands.onCommand.addListener(async (command) => { | |
| let num = parseInt(command.substr(9, 10)) - 1; | |
| let tabs = await browser.tabs.query({currentWindow: true}); | |
| if (tabs.length < num) { | |
| return; | |
| } | |
| browser.tabs.update(tabs[num].id, {active: true}); | |
| }); |
| const fs = require('fs'); | |
| const display = false; | |
| const pretty = false; | |
| let input = { | |
| "title": { | |
| "display": "Lorem Ipsum", | |
| }, |
| /Users/zibi/projects/icu4x〉rg 'Result<\(\)' -g "!{ffi/**}" -g "!{coverage/**}" ./ 11/02/2022 08:50:06 AM | |
| ./components/collections/src/codepointinvlist/cpinvlist.rs | |
| 864: fn test_serde_with_postcard_roundtrip() -> Result<(), postcard::Error> { | |
| ./components/collections/src/codepointtrie/cptrie.rs | |
| 996: fn test_serde_with_postcard_roundtrip() -> Result<(), postcard::Error> { | |
| ./components/list/src/provider.rs | |
| 274: ) -> Result<(), DataError> { |
| call plug#begin('~/.vim/plugged') | |
| " Collection of common configurations for the Nvim LSP client | |
| Plug 'neovim/nvim-lspconfig' | |
| " Completion framework | |
| Plug 'hrsh7th/nvim-cmp', { 'branch': 'main' } | |
| " LSP completion source for nvim-cmp | |
| Plug 'hrsh7th/cmp-nvim-lsp', { 'branch': 'main' } |
| ## Current Library Structure in the repo | |
| // | |
| ├─ components/ | |
| │ ├─ component1/ | |
| │ │ ├─ src/ | |
| │ ├─ component2/ | |
| │ │ ├─ src/ | |
| │ │ ├─ data/ | |
| │ │ │ ├─ from_unicode/ |