Release 1.0 (#1112)

CHANGELOG.md

@@ -1,6 +1,15 @@
 Changelog
 =========
 
+[1.0.0](https://github.com/casey/just/releases/tag/1.0.0) - 2022-2-22
+---------------------------------------------------------------------
+
+### Added
+- Add path_exists() function (#1106)
+
+### Misc
+- Note that `pipefail` isn't normally set (#1108)
+
 [0.11.2](https://github.com/casey/just/releases/tag/0.11.2) - 2022-2-15
 -----------------------------------------------------------------------
 

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "just"
-version = "0.11.2"
+version = "1.0.0"
 description = "🤖 Just a command runner"
 authors = ["Casey Rodarmor <[email protected]>"]
 license = "CC0-1.0"
@@ -34,7 +34,7 @@ serde = { version = "1.0.130", features = ["derive", "rc"] }
 serde_json = "1.0.68"
 similar = { version = "2.1.0", features = ["unicode"] }
 snafu = "0.7.0"
-strum = { version  = "0.23.0", features = ["derive"] }
+strum = { version  = "0.24.0", features = ["derive"] }
 target = "2.0.0"
 tempfile = "3.0.0"
 typed-arena = "2.0.1"

README.md

@@ -195,6 +195,19 @@ Example usage:
 
 An [RSS feed](https://en.wikipedia.org/wiki/RSS) of `just` releases is available [here](https://github.com/casey/just/releases.atom).
 
+Backwards Compatibility
+-----------------------
+
+With the release of version 1.0, `just` features a strong commitment to backwards compatibility and stability.
+
+Future releases will not introduce backwards incompatible changes that make existing `justfile`s stop working, or break working invocations of the command-line interface.
+
+This does not, however, preclude fixing outright bugs, even if doing so might break `justfiles` that rely on their behavior.
+
+There will never be a `just` 2.0. Any desirable backwards-incompatible changes will be opt-in on a per-`justfile` basis, so users may migrate at their leisure.
+
+Features that aren't yet ready for stabilization are gated behind the `--unstable` flag. Features enabled by `--unstable` may change in backwards incompatible ways at any time.
+
 Editor Support
 --------------
 

man/just.1

@@ -1,9 +1,9 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
-.TH JUST "1" "February 2022" "just 0.11.2" "Just Manual"
+.TH JUST "1" "February 2022" "just 1.0.0" "Just Manual"
 .SH NAME
 just \- save and run commands
 .SH DESCRIPTION
-just 0.11.2
+just 1.0.0
 \- Please see https://github.com/casey/just for more information.
 .SS "USAGE:"
 .IP
@@ -14,12 +14,12 @@ just [FLAGS] [OPTIONS] [\-\-] [ARGUMENTS]...
 Print changelog
 .TP
 \fB\-\-check\fR
-Run `\-\-fmt` in 'check' mode. Exits with 0 if justfile is formatted correctly. Exits with 1
-and prints a diff if formatting is required.
+Run `\-\-fmt` in 'check' mode. Exits with 0 if justfile is formatted correctly. Exits with
+1 and prints a diff if formatting is required.
 .TP
 \fB\-\-choose\fR
-Select one or more recipes to run using a binary. If `\-\-chooser` is not passed the chooser
-defaults to the value of $JUST_CHOOSER, falling back to `fzf`
+Select one or more recipes to run using a binary. If `\-\-chooser` is not passed the
+chooser defaults to the value of $JUST_CHOOSER, falling back to `fzf`
 .TP
 \fB\-\-clear\-shell\-args\fR
 Clear shell arguments
@@ -98,8 +98,9 @@ Run an arbitrary command with the working directory, `.env`, overrides, and expo
 \fB\-\-completions\fR <SHELL>
 .IP
 Print shell completion script for <SHELL> [possible values: zsh, bash, fish, powershell, elvish]
-.TP
+.HP
 \fB\-\-dotenv\-filename\fR <DOTENV\-FILENAME>
+.IP
 Search for environment file named <DOTENV\-FILENAME> instead of `.env`
 .TP
 \fB\-\-dotenv\-path\fR <DOTENV\-PATH>