angular-docs-cn/packages
Paul Gschwendtner 7a3a453072 build: convert CLDR locale extraction from Gulp to Bazel tool (#42230)
Converts the CLDR locale extraction script to a Bazel tool.
This allows us to generate locale files within Bazel, so that
locales don't need to live as sources within the repo. Also
it allows us to get rid of the legacy Gulp tooling.

The migration of the Gulp script to a Bazel tool involved the
following things:

  1. Basic conversion of the `extract.js` script to TypeScript.
     This mostly was about adding explicit types. e.g. adding `locale:
     string` or `localeData: CldrStatic`.

  2. Split-up into separate files. Instead of keeping the large
     `extract.js` file, the tool has been split into separate files.
     The logic remains the same, just that code is more readable and
     maintainable.

  3. Introduction of a new `index.ts` file that is the entry-point
     for the Bazel tool. Previously the Gulp tool just generated
     all locale files, the default locale and base currency files
     at once. The new entry-point accepts a mode to be passed as
     first process argument. based on that argument, either locales
     are generated into a specified directory, or the default locale,
     base currencies or closure file is generated.

     This allows us to generate files with a Bazel genrule where
     we simply run the tool and specify the outputs. Note: It's
     necessary to have multiple modes because files live in separate
     locations. e.g. the default locale in `@angular/core`, but the
     rest in `@angular/common`.

  4. Removal of the `cldr-data-downloader` and custom CLDR resolution
     logic. Within Bazel we cannot run a downloader using network.

     We switch this to something more Bazel idiomatic with better
     caching. For this a new repository rule is introduced that
     downloads the CLDR JSON repository and extracts it. Within
     that rule we determine the supported locales so that they
     can be used to pre-declare outputs (for the locales) within
     Bazel analysis phase. This allows us to add the generated locale
     files to a `ts_library` (which we want to have for better testing,
     and consistent JS transpilation).

     Note that the removal of `cldr-data-downloader` also requires us to
     add logic for detecting locales without data. The CLDR data
     downloader overwrote the `availableLocales.json` file with a file
     that only lists locales that CLDR provides data for. We use the
     official `availableLocales` file CLDR provides, but filter out
     locales for which no data is available. This is needed until we
     update to CLDR 39 where data is available for all such locales
     listed in `availableLocales.json`.

PR Close #42230
2021-07-16 12:44:59 -07:00
..
animations refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
bazel build: update dependency @microsoft/api-extractor to v7.18.4 (#42864) 2021-07-15 13:34:24 -07:00
benchpress refactor(benchpress): ensure compatibility with noImplicitOverride (#42512) 2021-07-12 13:11:15 -07:00
common build: convert CLDR locale extraction from Gulp to Bazel tool (#42230) 2021-07-16 12:44:59 -07:00
compiler docs: remove reference to an obsolete design doc (#42842) 2021-07-15 13:24:58 -07:00
compiler-cli perf(compiler-cli): optimize cycle detection using a persistent cache (#41271) 2021-07-15 13:13:48 -07:00
core refactor: remove checked-in locale files (#42230) 2021-07-16 12:44:58 -07:00
docs docs: remove/update broken links in resources appearing on aio (#42232) 2021-05-26 14:21:12 -07:00
elements refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
examples refactor: ensure compatibility with noImplicitOverride for examples (#42512) 2021-07-12 13:11:16 -07:00
forms refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
language-service refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
localize refactor(localize): ensure compatibility with noImplicitOverride (#42512) 2021-07-12 13:11:16 -07:00
misc/angular-in-memory-web-api refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
platform-browser refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
platform-browser-dynamic refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
platform-server refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
private/testing docs: convert the last `my-app` components to `app-root` (#42256) 2021-05-25 22:13:36 +00:00
router refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
service-worker refactor: add override keyword to members implementing abstract declarations (#42512) 2021-07-12 13:11:17 -07:00
upgrade refactor(upgrade): ensure compatibility with noImplicitOverride (#42512) 2021-07-12 13:11:15 -07:00
zone.js build: lock file maintenance (#42824) 2021-07-15 13:22:37 -07:00
BUILD.bazel build: remove unused no-strict tsconfig file (#42506) 2021-06-07 10:47:47 -07:00
README.md docs: add doc reference to npm package readme (#33911) 2019-11-20 14:46:23 -08:00
circular-deps-test.conf.js fix(platform-webworker): remove platform-webworker and platform-webworker-dynamic (#38846) 2020-09-30 09:13:59 -04:00
empty.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
goog.d.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
license-banner.txt docs: update year (#40925) 2021-02-22 12:37:40 -08:00
system.d.ts build: update license headers to reference Google LLC (#37205) 2020-05-26 14:26:58 -04:00
tsconfig-build.json build: enable noImplicitOverride in project (#42512) 2021-07-12 13:11:14 -07:00
tsconfig-legacy-saucelabs.json build: enable noImplicitOverride in project (#42512) 2021-07-12 13:11:14 -07:00
tsconfig-test.json
tsconfig.json build: enable noImplicitOverride in project (#42512) 2021-07-12 13:11:14 -07:00
types.d.ts build: replace @types/trusted-types dep with minimal type defs (#39211) 2020-10-15 09:08:00 -07:00

README.md

Angular

The sources for this package are in the main Angular repo. Please file issues and pull requests against that repo.

Usage information and reference details can be found in Angular documentation.

License: MIT