Skip to content

Commit

Permalink
Release 0.8.0
Browse files Browse the repository at this point in the history
srtool-cli@0.8.0
srtool-lib@0.8.0

Generated by cargo-workspaces
  • Loading branch information
chevdor committed Jan 3, 2022
1 parent c78ab35 commit ddfe35a
Show file tree
Hide file tree
Showing 9 changed files with 95 additions and 92 deletions.
4 changes: 2 additions & 2 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

90 changes: 46 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,28 +33,24 @@ This alias is likely set in your `.bash_profile` or `.zshrc`, make sure to remov

srtool-cli 0.7.1
chevdor <chevdor@gmail.com>
This utility helps starting a container from the srtool Docker image. It passes the right parameters
and environment variables to the container. Learn more about the srtool image here:
https://github.com/paritytech/srtool
srtool is cli allowing to control the srtool docker image

USAGE:
srtool [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
-h, --help Prints help information
-j, --json This option is DEPRECATED and has no effect
-n, --no-cache Do not use the local cached tag value
-V, --version Prints version information
srtool [OPTIONS] <SUBCOMMAND>

OPTIONS:
-i, --image <image> Choose an alternative image. Beware to choose an image that is compatible
-h, --help Print help information
-i, --image <IMAGE> Choose an alternative image. Beware to choose an image that is compatible
with the original srtool image. Using a random image, you take the risk
to NOT produce exactly the same deterministic result as srtool [default:
paritytech/srtool]
-j, --json This option is DEPRECATED and has no effect
-n, --no-cache Do not use the local cached tag value
-V, --version Print version information

SUBCOMMANDS:
build Start a new srtool container to build your runtime
help Prints this message or the help of the given subcommand(s)
help Print this message or the help of the given subcommand(s)
info Provide information about the srtool container and your repo
pull Simply pull the srtool image and do not run anything else
version Show the versions of the srtool container. Use --version if you want the version
Expand All @@ -69,9 +65,9 @@ This alias is likely set in your `.bash_profile` or `.zshrc`, make sure to remov
USAGE:
srtool version

FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-h, --help Print help information
-V, --version Print version information

**info**

Expand All @@ -80,22 +76,20 @@ This alias is likely set in your `.bash_profile` or `.zshrc`, make sure to remov
Provide information about the srtool container and your repo

USAGE:
srtool info [OPTIONS] --package <package> [path]
srtool info [OPTIONS] --package <PACKAGE> [PATH]

ARGS:
<path> By default, srtool will work in the current folder. If your project is located in
<PATH> By default, srtool will work in the current folder. If your project is located in
another location, you can pass it here [default: .]

FLAGS:
-h, --help Prints help information
-V, --version Prints version information

OPTIONS:
-p, --package <package> Provide the runtime such as kusama-runtime, polkadot-runtime,
-h, --help Print help information
-p, --package <PACKAGE> Provide the runtime such as kusama-runtime, polkadot-runtime,
etc... [env: PACKAGE=]
-r, --runtime-dir <runtime-dir> If your runtime is not in the standard location
-r, --runtime-dir <RUNTIME_DIR> If your runtime is not in the standard location
runtime/<chain_name> you can pass this args to help srtool
find it [env: RUNTIME_DIR=]
-V, --version Print version information

**pull**

Expand All @@ -106,9 +100,9 @@ This alias is likely set in your `.bash_profile` or `.zshrc`, make sure to remov
USAGE:
srtool pull

FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-h, --help Print help information
-V, --version Print version information

**build**

Expand All @@ -117,46 +111,54 @@ This alias is likely set in your `.bash_profile` or `.zshrc`, make sure to remov
Start a new srtool container to build your runtime

USAGE:
srtool build [FLAGS] [OPTIONS] --package <package> [path]
srtool build [OPTIONS] --package <PACKAGE> [PATH]

ARGS:
<path> By default, srtool will work in the current folder. If your project is located in
<PATH> By default, srtool will work in the current folder. If your project is located in
another location, you can pass it here [default: .]

FLAGS:
-a, --app Enable the "app" mode which is a mix of json output and outputting progress
during the build. This flag is recommended for CI. the json output will be
provided as a single line at the end in compact mode
-h, --help Prints help information
-j, --json Enable json output, same than the global --json option
--no-cache Passing this flag allows completely disabling caching. As a result, no cargo-
home will be mounted to the srtool image. There is no known issue with having
the cache ON, this is why it is the default
-V, --version Prints version information

OPTIONS:
--build-opts <build-opts>
-a, --app
Enable the "app" mode which is a mix of json output and outputting progress during the
build. This flag is recommended for CI. the json output will be provided as a single
line at the end in compact mode

--build-opts <BUILD_OPTS>
You may pass options to cargo directly here. WARNING, if you pass this value, the
automatic build options for Kusama and Polkadot will not be passed and you need to take
care of them manually. In general, you should never use this option unless you HAVE to
[env: BUILD_OPTS=]

--default-features <default-features>
--default-features <DEFAULT_FEATURES>
Passing this is less involved than passing BUILD_OPTS. It allows changing the list of
default features while keeping the automatic features detection. This value is useless
if BUILD_OPTS is set [env: DEFAULT_FEATURES=]

-p, --package <package>
-h, --help
Print help information

-j, --json
Enable json output, same than the global --json option

--no-cache
Passing this flag allows completely disabling caching. As a result, no cargo-home will
be mounted to the srtool image. There is no known issue with having the cache ON, this
is why it is the default

-p, --package <PACKAGE>
Provide the runtime such as kusama-runtime, polkadot-runtime, etc... [env: PACKAGE=]

--profile <profile>
--profile <PROFILE>
The default profile to build runtimes is always `release`. You may override the default
with this flag [env: PROFILE=] [default: release]

-r, --runtime-dir <runtime-dir>
-r, --runtime-dir <RUNTIME_DIR>
If your runtime is not in the standard location runtime/<chain_name> you can pass this
args to help srtool find it [env: RUNTIME_DIR=]

-V, --version
Print version information

## Contributing

If you landed here, you likely want to contribute the project. Let me thank you already.
Expand Down
2 changes: 1 addition & 1 deletion cli/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ license = "MIT"
name = "srtool-cli"
readme = "README.md"
repository = "https://github.com/chevdor/srtool-cli"
version = "0.7.1"
version = "0.8.0"

[[bin]]
bench = false
Expand Down
20 changes: 8 additions & 12 deletions doc/usage.adoc
Original file line number Diff line number Diff line change
@@ -1,27 +1,23 @@
srtool-cli 0.7.1
chevdor <chevdor@gmail.com>
This utility helps starting a container from the srtool Docker image. It passes the right parameters
and environment variables to the container. Learn more about the srtool image here:
https://github.com/paritytech/srtool
srtool is cli allowing to control the srtool docker image

USAGE:
srtool [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
-h, --help Prints help information
-j, --json This option is DEPRECATED and has no effect
-n, --no-cache Do not use the local cached tag value
-V, --version Prints version information
srtool [OPTIONS] <SUBCOMMAND>

OPTIONS:
-i, --image <image> Choose an alternative image. Beware to choose an image that is compatible
-h, --help Print help information
-i, --image <IMAGE> Choose an alternative image. Beware to choose an image that is compatible
with the original srtool image. Using a random image, you take the risk
to NOT produce exactly the same deterministic result as srtool [default:
paritytech/srtool]
-j, --json This option is DEPRECATED and has no effect
-n, --no-cache Do not use the local cached tag value
-V, --version Print version information

SUBCOMMANDS:
build Start a new srtool container to build your runtime
help Prints this message or the help of the given subcommand(s)
help Print this message or the help of the given subcommand(s)
info Provide information about the srtool container and your repo
pull Simply pull the srtool image and do not run anything else
version Show the versions of the srtool container. Use --version if you want the version
Expand Down
43 changes: 25 additions & 18 deletions doc/usage_build.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,43 +3,50 @@ chevdor <chevdor@gmail.com>
Start a new srtool container to build your runtime

USAGE:
srtool build [FLAGS] [OPTIONS] --package <package> [path]
srtool build [OPTIONS] --package <PACKAGE> [PATH]

ARGS:
<path> By default, srtool will work in the current folder. If your project is located in
<PATH> By default, srtool will work in the current folder. If your project is located in
another location, you can pass it here [default: .]

FLAGS:
-a, --app Enable the "app" mode which is a mix of json output and outputting progress
during the build. This flag is recommended for CI. the json output will be
provided as a single line at the end in compact mode
-h, --help Prints help information
-j, --json Enable json output, same than the global --json option
--no-cache Passing this flag allows completely disabling caching. As a result, no cargo-
home will be mounted to the srtool image. There is no known issue with having
the cache ON, this is why it is the default
-V, --version Prints version information

OPTIONS:
--build-opts <build-opts>
-a, --app
Enable the "app" mode which is a mix of json output and outputting progress during the
build. This flag is recommended for CI. the json output will be provided as a single
line at the end in compact mode

--build-opts <BUILD_OPTS>
You may pass options to cargo directly here. WARNING, if you pass this value, the
automatic build options for Kusama and Polkadot will not be passed and you need to take
care of them manually. In general, you should never use this option unless you HAVE to
[env: BUILD_OPTS=]

--default-features <default-features>
--default-features <DEFAULT_FEATURES>
Passing this is less involved than passing BUILD_OPTS. It allows changing the list of
default features while keeping the automatic features detection. This value is useless
if BUILD_OPTS is set [env: DEFAULT_FEATURES=]

-p, --package <package>
-h, --help
Print help information

-j, --json
Enable json output, same than the global --json option

--no-cache
Passing this flag allows completely disabling caching. As a result, no cargo-home will
be mounted to the srtool image. There is no known issue with having the cache ON, this
is why it is the default

-p, --package <PACKAGE>
Provide the runtime such as kusama-runtime, polkadot-runtime, etc... [env: PACKAGE=]

--profile <profile>
--profile <PROFILE>
The default profile to build runtimes is always `release`. You may override the default
with this flag [env: PROFILE=] [default: release]

-r, --runtime-dir <runtime-dir>
-r, --runtime-dir <RUNTIME_DIR>
If your runtime is not in the standard location runtime/<chain_name> you can pass this
args to help srtool find it [env: RUNTIME_DIR=]

-V, --version
Print version information
14 changes: 6 additions & 8 deletions doc/usage_info.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,19 +3,17 @@ chevdor <chevdor@gmail.com>
Provide information about the srtool container and your repo

USAGE:
srtool info [OPTIONS] --package <package> [path]
srtool info [OPTIONS] --package <PACKAGE> [PATH]

ARGS:
<path> By default, srtool will work in the current folder. If your project is located in
<PATH> By default, srtool will work in the current folder. If your project is located in
another location, you can pass it here [default: .]

FLAGS:
-h, --help Prints help information
-V, --version Prints version information

OPTIONS:
-p, --package <package> Provide the runtime such as kusama-runtime, polkadot-runtime,
-h, --help Print help information
-p, --package <PACKAGE> Provide the runtime such as kusama-runtime, polkadot-runtime,
etc... [env: PACKAGE=]
-r, --runtime-dir <runtime-dir> If your runtime is not in the standard location
-r, --runtime-dir <RUNTIME_DIR> If your runtime is not in the standard location
runtime/<chain_name> you can pass this args to help srtool
find it [env: RUNTIME_DIR=]
-V, --version Print version information
6 changes: 3 additions & 3 deletions doc/usage_pull.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ Simply pull the srtool image and do not run anything else
USAGE:
srtool pull

FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-h, --help Print help information
-V, --version Print version information
6 changes: 3 additions & 3 deletions doc/usage_version.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ Show the versions of the srtool container. Use --version if you want the version
USAGE:
srtool version

FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-h, --help Print help information
-V, --version Print version information
2 changes: 1 addition & 1 deletion lib/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "srtool-lib"
version = "0.7.1"
version = "0.8.0"
authors = ["chevdor <chevdor@gmail.com>"]
edition = "2021"

Expand Down

0 comments on commit ddfe35a

Please sign in to comment.