Skip to content

Commit

Permalink
Add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
spyrkob committed Jan 25, 2024
1 parent 9dff04c commit 363fbca
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
## Prospero-extras

A collection of command line operations to assist in working with [wildfly-channels](https://github.com/wildfly-extras/wildfly-channel).

## Using prospero-extras

The latest available release is available on [github](https://github.com/spyrkob/prospero-extras/releases/latest). The tool is distributed as an executable jar.

You can use `-h` argument to displays available commands, e.g.:

```
java -jar prospero-extras-1.0.0.Beta1-shaded.jar -h
Usage: tools [-h] [COMMAND]
Options:
-h, --help
Commands:
create-bundle
manifest-diff
download-diff
manifest-merge Merges streams from two manifests.
from-channel
from-list
channel
repository
```

The same `-h` argument can be used on each command to displays additional usage information, e.g.:

```
java -jar prospero-extras-1.0.0.Beta1-shaded.jar manifest-merge -h
Merges streams from two manifests.
Usage: tools manifest-merge [-h] [--mode=<mergeStrategy>] <manifestOne> <manifestTwo>
Prints a manifest containing streams from both input manifests. If the samestream is available in both input manifests, the conflict is resolved using a merge strategy.
The LATEST merge strategy compares the versions and picks the latest stream.
The FIRST merge strategy chooses the stream from `<manifestOne>`.
Positional parameters:
<manifestOne>
<manifestTwo>
Options:
-h, --help
--mode=<mergeStrategy>
merge strategy to use. The default strategy is LATEST.
```

## Building

Project requires JDK 11+ and Apache Maven 3.9.0+

`mvn clean install`

0 comments on commit 363fbca

Please sign in to comment.