Go to file
Damien Elmes 45f5709214
Migrate to protobuf-es (#2547)
* Fix .no-reduce-motion missing from graphs spinner, and not being honored

* Begin migration from protobuf.js -> protobuf-es

Motivation:

- Protobuf-es has a nicer API: messages are represented as classes, and
fields which should exist are not marked as nullable.
- As it uses modules, only the proto messages we actually use get included
in our bundle output. Protobuf.js put everything in a namespace, which
prevented tree-shaking, and made it awkward to access inner messages.
- ./run after touching a proto file drops from about 8s to 6s on my machine. The tradeoff
is slower decoding/encoding (#2043), but that was mainly a concern for the
graphs page, and was unblocked by
37151213cd

Approach/notes:

- We generate the new protobuf-es interface in addition to existing
protobuf.js interface, so we can migrate a module at a time, starting
with the graphs module.
- rslib:proto now generates RPC methods for TS in addition to the Python
interface. The input-arg-unrolling behaviour of the Python generation is
not required here, as we declare the input arg as a PlainMessage<T>, which
marks it as requiring all fields to be provided.
- i64 is represented as bigint in protobuf-es. We were using a patch to
protobuf.js to get it to output Javascript numbers instead of long.js
types, but now that our supported browser versions support bigint, it's
probably worth biting the bullet and migrating to bigint use. Our IDs
fit comfortably within MAX_SAFE_INTEGER, but that may not hold for future
fields we add.
- Oneofs are handled differently in protobuf-es, and are going to need
some refactoring.

Other notable changes:

- Added a --mkdir arg to our build runner, so we can create a dir easily
during the build on Windows.
- Simplified the preference handling code, by wrapping the preferences
in an outer store, instead of a separate store for each individual
preference. This means a change to one preference will trigger a redraw
of all components that depend on the preference store, but the redrawing
is cheap after moving the data processing to Rust, and it makes the code
easier to follow.
- Drop async(Reactive).ts in favour of more explicit handling with await
blocks/updating.
- Renamed add_inputs_to_group() -> add_dependency(), and fixed it not adding
dependencies to parent groups. Renamed add() -> add_action() for clarity.

* Remove a couple of unused proto imports

* Migrate card info

* Migrate congrats, image occlusion, and tag editor

+ Fix imports for multi-word proto files.

* Migrate change-notetype

* Migrate deck options

* Bump target to es2020; simplify ts lib list

Have used caniuse.com to confirm Chromium 77, iOS 14.5 and the Chrome
on Android support the full es2017-es2020 features.

* Migrate import-csv

* Migrate i18n and fix missing output types in .js

* Migrate custom scheduling, and remove protobuf.js

To mostly maintain our old API contract, we make use of protobuf-es's
ability to convert to JSON, which follows the same format as protobuf.js
did. It doesn't cover all case: users who were previously changing the
variant of a type will need to update their code, as assigning to a new
variant no longer automatically removes the old one, which will cause an
error when we try to convert back from JSON. But I suspect the large majority
of users are adjusting the current variant rather than creating a new one,
and this saves us having to write proxy wrappers, so it seems like a
reasonable compromise.

One other change I made at the same time was to rename value->kind for
the oneofs in our custom study protos, as 'value' was easily confused
with the 'case/value' output that protobuf-es has.

With protobuf.js codegen removed, touching a proto file and invoking
./run drops from about 8s to 6s.

This closes #2043.

* Allow tree-shaking on protobuf types

* Display backend error messages in our ts alert()

* Make sourcemap generation opt-in for ts-run

Considerably slows down build, and not used most of the time.
2023-06-14 22:47:37 +10:00
.buildkite Detect incorrect usage of triple slash in TypeScript (#2524) 2023-05-26 12:49:44 +10:00
.cargo Move protobuf generation into a separate crate; write .py interface in Rust 2023-06-12 09:52:00 +10:00
.config Update Rust deps 2023-03-31 14:38:24 +10:00
.github/ISSUE_TEMPLATE Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
.vscode.dist Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
build Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
cargo Update hakari and licenses 2023-05-29 17:54:00 +10:00
docs Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
ftl Update translations 2023-06-07 16:26:06 +10:00
proto Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
pylib Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
python Update requests for CVE 2023-05-24 16:09:15 +10:00
qt Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
rslib Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
sass Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
tools Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
ts Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
.deny.toml Update Rust deps (#2332) 2023-01-18 22:24:29 +10:00
.dprint.json Experiment with disabling prettier whitespace sensitivity 2023-06-01 11:11:26 +10:00
.eslintrc.js Upgrade Svelte (#2506) 2023-05-18 17:04:58 +10:00
.gitattributes try again to improve GitHub's language stats 2021-01-20 13:20:45 +10:00
.gitignore Rework syncing code, and replace local sync server (#2329) 2023-01-18 12:43:46 +10:00
.gitmodules Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
.isort.cfg Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
.mypy.ini Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
.pylintrc Add ability to restore a notetype to its original configuration (#2472) 2023-04-18 14:07:51 +10:00
.rustfmt-empty.toml Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
.rustfmt.toml Move ascii_percent_encoding into a separate repo 2023-04-12 08:45:23 +10:00
.version Bump version 2023-06-05 09:20:00 +10:00
CONTRIBUTORS Making phrasing more clear in dialog which lets user choose a deck to display options for. (#2522) 2023-05-26 12:50:38 +10:00
Cargo.lock Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
Cargo.toml Split io.rs into separate crate, and use it in proto build 2023-06-12 15:47:51 +10:00
LICENSE move aqt_data into source folder; implement wheel building 2020-11-04 12:14:03 +10:00
README.md Add link to website in README 2023-05-31 13:49:19 +10:00
SECURITY.md add SECURITY.md 2021-09-22 22:55:19 +10:00
ninja Add env var to enable sourcemaps 2022-12-04 11:37:16 +10:00
package.json Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00
pkgkey.asc add public key for release signing 2018-09-18 10:40:45 +10:00
run Move away from Bazel (#2202) 2022-11-27 15:24:20 +10:00
run.bat Automatically fetch win32 audio tools in .\run.bat 2023-05-11 09:10:22 +10:00
rust-toolchain.toml Update to Rust 1.70 2023-06-07 14:52:31 +10:00
yarn.lock Migrate to protobuf-es (#2547) 2023-06-14 22:47:37 +10:00

README.md

Anki

Build status

This repo contains the source code for the computer version of Anki.

If you'd like to try development builds of Anki but don't feel comfortable building the code, please see https://betas.ankiweb.net/

For more information on building, please see Development.