4389742afc
This adds an index on `geonames_alternates(geoname_id)` plus some geonames and weather benchmarks that I used to verify the change. The bug has some benchmark numbers and discussion. The index speeds up weather queries by as much as ~98%, going from hundreds of ms in the worst case to ~10ms. |
||
---|---|---|
.cargo | ||
.circleci | ||
.github | ||
.vscode | ||
automation | ||
build-scripts | ||
components | ||
docs | ||
examples | ||
gradle | ||
libs | ||
megazords | ||
taskcluster | ||
testing | ||
tools | ||
xcconfig | ||
.buildconfig-android.yml | ||
.cron.yml | ||
.detekt.yml | ||
.gitignore | ||
.gitmodules | ||
.mailmap | ||
.mergify.yml | ||
.swiftlint.yml | ||
.taskcluster.yml | ||
CHANGELOG.md | ||
CODE_OF_CONDUCT.md | ||
COPYRIGHT | ||
Cargo.lock | ||
Cargo.toml | ||
DEPENDENCIES.md | ||
LICENSE | ||
README.md | ||
build.gradle | ||
clippy.toml | ||
gradle.properties | ||
gradlew | ||
gradlew.bat | ||
install-nimbus-cli.sh | ||
proguard-rules-consumer-jna.pro | ||
publish.gradle | ||
rust-toolchain.toml | ||
settings.gradle | ||
version.txt |
README.md
Firefox Application Services
Application Services (a-s) is a collection of Rust Components that are used to enable Firefox applications to integrate with Firefox accounts, sync, experimentation, etc. Each component is built using a core of shared code written in Rust, wrapped with native language bindings for different platforms.
Contributing
To contribute, please review the Mozilla Community Participation Guidelines and then visit our how to contribute guide.
Contact
Get in touch with other community members on Matrix, or through issues here on GitHub.
- Matrix: #rust-components:mozilla.org (How to connect)
Documentation
High-level docs
The Application Services Book contains high-level documentation about the code in this repository. It's built from the ./docs/ directory.
Package docs
We use rustdoc to document both the public API of the components and the various internal implementation details. View them on https://mozilla.github.io/application-services/book/rust-docs/fxa_client/index.html. Once you have completed the build steps, you can view the docs by running:
cargo doc --no-deps --document-private-items --open
Building
Building the Rust Components
- Clone or Download the repository:
$ git clone https://github.com/mozilla/application-services # (or use the ssh link)
$ cd application-services
$ git submodule init
$ git submodule update --recursive
- Follow these instructions to install your system-level dependencies
- Run the a-s Rust unit tests
cargo test
Consumer build, integration and testing
The application-services library primary consumers are Fenix (Firefox on Android) and Firefox iOS. Assure you are able to run integration tests (for Android and iOS if using MacOS) by following the instructions to build for Android and iOS integrations.
Android integration builds and helpful tools
- Build instructions to test Fenix / android-components integration
- Fenix Auto-publication workflow for android-components and application-services
Firefox for iOS integration
- Build instructions to test Firefox iOS integration
Firefox Desktop
- Build instructions to test Firefox Desktop integration
Rust Components
./components/ contains the source for each component. Note that most components have their FFI generated by the uniffi library.
- See ./components/places/ for an example, where you can
find:
- The shared rust code.
- The Kotlin bindings for use by Android applications.
- The Swift bindings for use by iOS applications.
- See ./components/fxa-client for an example that uses uniffi to generate API wrappers for multiple languages, such as Kotlin and Swift.
List of components
- autofill - for storage and syncing of credit card and address information
- crashtest - testing-purposes (crashing the Rust code)
- fxa-client - for applications that need to sign in with FxA, access encryption keys for sync, and more.
- logins - for storage and syncing of a user's saved login credentials
- nimbus - for integrating with Mozilla's experimentation platform for Firefox
- places - for storage and syncing of a user's saved browsing history
- push - for applications to receive real-time updates via WebPush
- support - low-level utility libraries
- support/rc_crypto - handles cryptographic needs backed by Mozilla's NSS library
- support/sql - utilities for storing data locally with SQL
- sync15 - shared library for accessing data in Firefox Sync
- sync_manager - integrates multiple sync engines/ stores into a single framework
- tabs - an in-memory syncing engine for remote browser tabs
- viaduct - an HTTP request library
- webext-storage - powers an implementation of the chrome.storage.sync WebExtension API
Note the above list is partial; see the actual list under the components
directory.