Merge pull request #481 from str4d/release-0.10.0

Release 0.10.0

Cargo.toml

@@ -15,8 +15,8 @@ repository = "https://github.com/str4d/rage"
 license = "MIT OR Apache-2.0"
 
 [workspace.dependencies]
-age = { version = "0.9.2", path = "age" }
-age-core = { version = "0.9.0", path = "age-core" }
+age = { version = "0.10.0", path = "age" }
+age-core = { version = "0.10.0", path = "age-core" }
 
 # Dependencies required by the age specification:
 # - Base64 from RFC 4648

age-core/CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to Rust's notion of
 to 1.0.0 are beta releases.
 
 ## [Unreleased]
+
+## [0.10.0] - 2024-02-04
 ### Added
 - `impl Eq for age_core::format::Stanza`
 

age-core/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "age-core"
 description = "[BETA] Common functions used across the age crates"
-version = "0.9.0"
+version = "0.10.0"
 authors.workspace = true
 repository.workspace = true
 readme = "README.md"

age-plugin/CHANGELOG.md

@@ -9,8 +9,11 @@ and this project adheres to Rust's notion of
 to 1.0.0 are beta releases.
 
 ## [Unreleased]
+
+## [0.5.0] - 2024-02-04
 ### Changed
 - MSRV is now 1.65.0.
+- Migrated to `age-core 0.10`.
 - `age_plugin::run_state_machine` now takes optional arguments, to enable the
   creation of recipient-only or identity-only plugins.
 

age-plugin/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "age-plugin"
 description = "[BETA] API for writing age plugins."
-version = "0.4.0"
+version = "0.5.0"
 authors.workspace = true
 repository.workspace = true
 readme = "README.md"

age/CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to Rust's notion of
 to 1.0.0 are beta releases.
 
 ## [Unreleased]
+
+## [0.10.0] - 2024-02-04
 ### Added
 - Russian translation!
 - `age::cli_common`:

age/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "age"
 description = "[BETA] A simple, secure, and modern encryption library."
-version = "0.9.2"
+version = "0.10.0"
 authors.workspace = true
 repository.workspace = true
 readme = "README.md"

age/README.md

@@ -23,7 +23,7 @@ The reference interoperable Go implementation is available at
 Add this line to your `Cargo.toml`:
 
 ```
-age = "0.9"
+age = "0.10"
 ```
 
 See the [documentation](https://docs.rs/age) for examples.

docs/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# How to contribute to `rage`
+
+## Localization
+
+Locale files are stored in the `age/i18n/` and `rage/i18n/` directories. Check
+there to see if your locale already exists!
+
+We use [Fluent](https://projectfluent.org/) for localization; check that website
+for details about the format. In general, strings look like this:
+
+```fluent
+some-unique-identifier = Translate the content on this side of the '=' symbol.
+another-unique-identifier =
+    This is a multiline string that can contain one or more paragraphs. Like
+    above, the 'another-unique-identifier =' part is not translated, but this
+    text is.
+
+    Individual paragraphs should be line-wrapped at roughly the same number of
+    characters as the corresponding English text, so that it looks roughly the
+    same. Remember that {-terms} and {$variables} won't necessarily be the same
+    length once filled in.
+```
+
+To update strings for an existing locale `your-locale`:
+- Compare `age/i18n/en-US/age.ftl` with `age/i18n/your-locale/age.ftl`, and copy
+  over any missing strings (look for unique identifiers that don't appear in the
+  file for `your-locale`).
+- Compare `rage/i18n/en-US/age.ftl` with `rage/i18n/your-locale/age.ftl`, and
+  copy over any missing strings.
+- Edit `age/i18n/your-locale/age.ftl` and `rage/i18n/your-locale/age.ftl` to
+  replace the English text with the appropriate translations for your locale.
+
+To translate strings into a new locale `your-locale`:
+- Create the directories `age/i18n/your-locale/` and `rage/i18n/your-locale/`.
+- Copy `age/i18n/en-US/age.ftl` to `age/i18n/your-locale/age.ftl`.
+- Copy `rage/i18n/en-US/age.ftl` to `rage/i18n/your-locale/age.ftl`.
+- Edit `age/i18n/your-locale/age.ftl` and `rage/i18n/your-locale/age.ftl` to
+  replace the English text with the appropriate translations for your locale.
+
+To test locally, use `cargo run --bin BINARY_NAME -- ARGUMENTS`. If you don't
+have `your-locale` enabled globally, set the `LANG` environment variable to
+force it:
+```
+$ LANG=your-locale cargo run --bin rage -- --help
+$ LANG=your-locale cargo run --bin rage -- ARGUMENTS
+$ LANG=your-locale cargo run --bin rage-keygen -- --help
+```

docs/debian.md

@@ -9,7 +9,5 @@ cargo install cargo-deb
 ## Process
 
 ```
-cargo run --example generate-completions
-cargo run --example generate-docs
 cargo deb --package rage
 ```

rage/CHANGELOG.md

@@ -9,7 +9,10 @@ and this project adheres to Rust's notion of
 to 1.0.0 are beta releases.
 
 ## [Unreleased]
+
+## [0.10.0] - 2024-02-04
 ### Added
+- Russian translation!
 - `rage-keygen -y IDENTITY_FILE` to convert identity files to recipients.
 - Elvish completions to the Debian package. These are not automatically
   discovered; Elvish users will need to manually import them.

rage/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "rage"
 description = "[BETA] A simple, secure, and modern encryption tool."
-version = "0.9.2"
+version = "0.10.0"
 authors.workspace = true
 repository.workspace = true
 readme = "../README.md"

rage/tests/cmd/rage-keygen/version.toml

@@ -1,6 +1,6 @@
 bin.name = "rage-keygen"
 args = "--version"
 stdout = """
-rage-keygen 0.9.2
+rage-keygen 0.10.0
 """
 stderr = ""

rage/tests/cmd/rage-mount/version.toml

@@ -1,6 +1,6 @@
 bin.name = "rage-mount"
 args = "--version"
 stdout = """
-rage-mount 0.9.2
+rage-mount 0.10.0
 """
 stderr = ""

rage/tests/cmd/rage/version.toml

@@ -1,6 +1,6 @@
 bin.name = "rage"
 args = "--version"
 stdout = """
-rage 0.9.2
+rage 0.10.0
 """
 stderr = ""