Introduce the javy-release crate (#1169)

* Introduce the `javy-release` crate

This commit introduces the `javy-release` crate.

The idea behind this crate is to provide a utility to partially
automate our release process, at least initially. In its current form,
this crate adds the necessary functionality to toggle the release/dev
versions according to our versioning system.

Even though publishing to crates.io should be possible, I've opted
exclude such functionality in the initial state of this crate mostly
for simplicity. Said functionality can be added as a follow-up if this
crate gets adopted.

Furthermore, the principal motivation for this change is to ease the
release process, which is currently manual and potentially error
prone. I've gone through this process twice, and in every instance
it's unclear to me the order of operations that I need to follow to
start a successful release.

* Add documentation entry

* Avoid using `std::env::current_dir` to avoid race conditions in tests

Author: saulecabrera

Cargo.lock

@@ -12,6 +12,7 @@ members = [
   "crates/test-plugin-wasip2",
   "crates/runner",
   "fuzz",
+  "release",
 ]
 resolver = "2"
 

Cargo.toml

@@ -22,6 +22,7 @@ lint-wasip1-targets:
 	--exclude=javy-runner \
 	--exclude=javy-test-plugin-wasip2 \
 	--exclude=javy-fuzz \
+	--exclude=javy-release \
 	--target=wasm32-wasip1 --all-targets --all-features -- -D warnings
 
 lint-wasip2-targets:
@@ -33,6 +34,7 @@ lint-wasip2-targets:
 	--exclude=javy-runner \
 	--exclude=javy-test-plugin-wasip1 \
 	--exclude=javy-fuzz \
+	--exclude=javy-release \
 	--target=wasm32-wasip2 --all-targets --all-features -- -D warnings
 
 test-wasi-targets: test-wasip1-targets test-wasip2-targets
@@ -44,6 +46,7 @@ test-wasip1-targets:
 	--exclude=javy-plugin-processing \
 	--exclude=javy-runner \
 	--exclude=javy-fuzz \
+	--exclude=javy-release \
 	--exclude=javy-test-plugin-wasip1 \
 	--exclude=javy-test-plugin-wasip2 \
 	--exclude=javy-test-invalid-plugin \
@@ -57,6 +60,7 @@ test-wasip2-targets:
 	--exclude=javy-plugin-processing \
 	--exclude=javy-runner \
 	--exclude=javy-fuzz \
+	--exclude=javy-release \
 	--exclude=javy-test-plugin-wasip1 \
 	--exclude=javy-test-plugin-wasip2 \
 	--exclude=javy-test-invalid-plugin \

Makefile

@@ -54,6 +54,23 @@ version `3.0.0` has not been published yet so version `3.0.0` can contain
 a mixture of additive and breaking changes from the last `2.x.x` version
 published.
 
+#### Toggling development/relese versions automatically
+
+Before making a release, you can set the release versions
+automatically by running the following command from the root of the
+repository
+
+    ./scripts/release.sh set-release-versions
+
+After the release is complete, you can set the development versions
+automatically by running the following command from the root of the
+repository
+
+    ./scripts/release.sh set-dev-versions
+
+Note that the previous script requires having
+[`jq`](https://github.com/jqlang/jq) installed.
+
 ## Web platform tests (WPT)
 
 We run a subset of the web platform test suite during continuous integration. We