6 releases (breaking)
0.4.1 | Sep 20, 2021 |
---|---|
0.4.0 | Sep 19, 2021 |
0.3.0 | Sep 11, 2021 |
0.2.0 | Sep 8, 2021 |
0.0.1 | Jul 3, 2021 |
#2106 in Development tools
65KB
1K
SLoC
A utility for checking and listing the effected resources across a range of commits, useful when working with monorepos.
Content
- Downloading Binary
- Compiling via Local Repository
- Compiling via Cargo
- Unit Testing
- Issues/Feature Requests
Usage
Is Effected operates upon a range of Git commits in the repositories' history.
To specify the range of commits you can use either the --from-commit-hash <commit-hash>
or --from-reference <reference>
arguments.
The range of commits starts exclusively from the commit specified till inclusively of HEAD
.
One of these from arguments are required, but they conflict and can not be used together.
Over the range of commits you can perform two possible operations.
Either you can list all the effected resources by supplying the --list
flag.
Or you can check that specific resources have been effected, through the --effects-current-directory
flag or the --effects <resources>
argument.
With the --effects-current-directory
flag the effected resources are checked if they are within the current directory or sub-directories.
Using the --effects <resource>
argument you can supply multiple regexes and it is checked if any of the effected resources match any.
If either of the effects checks are met then Is Effected return a zero status code, otherwise it return a non-zero status code.
One of the output arguments are required, but they conflict and can not be used together.
Usage - Git Environment Variables
When looking for a repository the Git environment variables are respected.
When $GIT_DIR
is set, it takes precedence and Is Effected begins searching for a repository in the directory specified in $GIT_DIR
.
When $GIT_DIR
is not set, Is Effected searches for a repository beginning in the current directory.
Usage - Logging
The crates pretty_env_logger
and log
are used to provide logging.
The environment variable RUST_LOG
can be used to set the logging level.
See https://crates.io/crates/pretty_env_logger for more detailed documentation.
CICD Examples
GitLab CI Rust Project Example
Via Cargo
See Compiling via Cargo for more details about installing via Cargo.
Note - This example downloads the latest 0.*
version.
example-stage:
stage: example-stage
image: rust
before_script:
- cargo install is_effected --version ^0
script:
- cd monorepo/
# Check the monorepo is effected in the merge request or else skip the stage.
- /usr/local/cargo/bin/is_effected --from-reference "origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME" --effects-current-directory || exit 0
- ... rest of the stage
rules:
- if: $CI_MERGE_REQUEST_ID
Via Binary Download
See Downloading Binary for more details about Binary downloads.
Note - This example downloads version 0.4.0
.
example-stage:
stage: example-stage
image: rust
before_script:
- wget -q -O tmp.zip "https://gitlab.com/DeveloperC/is_effected/-/jobs/artifacts/0.4.0/download?job=release-binary-compiling-x86_64-linux-musl" && unzip tmp.zip && rm tmp.zip
- is_effected="$(pwd)/is_effected"
script:
- cd monorepo/
# Check the monorepo is effected in the merge request or else skip the stage.
- ${is_effected} --from-reference "origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME" --effects-current-directory || exit 0
- ... rest of the stage
rules:
- if: $CI_MERGE_REQUEST_ID
Downloading Binary
Statically linked compiled binaries are available for download. Visit the releases page at https://gitlab.com/DeveloperC/is_effected/-/releases to see all the releases, the release notes contains links to binary downloads for various architectures.
If you do not trust the provided binaries another option is to compile your own and then make it available for remote download, so your CICD etc can then download it.
Compiling via Local Repository
Checkout the code repository locally, change into the repository's directory and then build via Cargo.
Using the --release
flag produces an optimised binary but takes longer to compile.
git clone git@gitlab.com:DeveloperC/is_effected.git
cd is_effected/
cargo build --release
The compiled binary is present at target/release/is_effected
.
Compiling via Cargo
Cargo is the Rust package manager, the install
sub-command pulls from crates.io and then compiles the binary locally, placing the compiled binary at $HOME/.cargo/bin/is_effected
.
cargo install is_effected
By default it installs the latest version at the time of execution.
You can specify a specific version to install using the --version
argument.
For certain environments such as CICD etc you may want to pin the version.
e.g.
cargo install is_effected --version 0.2.0
Rather than pinning to a specific version you can specify the major or minor version.
e.g.
cargo install is_effected --version ^0
Will download the latest 0.*
release whether that is 0.2.2
or 0.7.0
.
Unit Testing
The unit test suite has several parameterised tests, Cargo is used to set up and run all the unit tests.
cargo test
Issues/Feature Requests
To report an issue or request a new feature use https://gitlab.com/DeveloperC/is_effected/-/issues.
Dependencies
~14–24MB
~391K SLoC