Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
AverseABFun authored Jan 2, 2025
1 parent 7093554 commit 67952ea
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,20 @@

`rust-pkg-gen` creates so-called rust packages with arbitrary toolchains/components and arbitrary crates. These packages then can be used on separate machines, and installed with provided install scripts.

To use the cli, you can generally simply run `rust-pkg-gen`/`cargo run`. There are a couple of command line options, mostly for debugging, that you can see in `src/main.rs` and below:

| Argument | Purpose |
| -------- | ------- |
| --temp-dir | Changes the temporary directory. Use in conjunction with --save-temp to save more of the temporary files. Some temporary files are always kept. Default value in debug builds is ./test, in release builds a automatically created directory in the system temporary directory. |
| -y or --yes | Currently unused, says yes to all non-overwriting prompts. |
| --overwrite | Doesn't ask the user if they want to overwrite the temporary directory(mainly used in testing). |
| --path | The path to a toml file of the format of rust-config.toml. |
| --quiet | Displays minimal text; confirmation prompts still appear. |
| --silent | Equivelent to --quiet --yes --overwrite. |
| --save-temp | Saves temporary files that by default aren't saved. |
| --no-download-toolchain | Doesn't download a toolchain. Mainly used in testing when working on crates. Massively improves speed. |
| --no-build-crates | Copies the template crates directory, however doesn't run build.sh. Mainly used in testing. |

Currently, there is a small public API, but this API doesn't contain much. One of the things it does include, however, is code for parsing `rust-config.toml` files(contains configuration for `rust-pkg-gen`).

An example `rust-config.toml` file is in this repo.
Expand Down

0 comments on commit 67952ea

Please sign in to comment.