Skip to content

Prepare for next development iteration #270

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 1, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion api-2.2/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-api-2.2</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion api-2.3/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-api-2.3</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion api-2.4/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<artifactId>initializer</artifactId>
<groupId>org.openmrs.module</groupId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>

Expand Down
2 changes: 1 addition & 1 deletion api-2.5/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<artifactId>initializer</artifactId>
<groupId>org.openmrs.module</groupId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>

Expand Down
2 changes: 1 addition & 1 deletion api-bahmni/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-api-bahmni</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion api/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-api</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion omod/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-omod</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Initializer</name>
<description>The OpenMRS Initializer module is an API-only module that processes the content of the configuration folder when it is found inside OpenMRS' application data directory.</description>
Expand Down
14 changes: 7 additions & 7 deletions readme/validator.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ mvn clean package -P validator
3) Run it (use absolute paths for arguments):

```bash
java -jar ./validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar ./validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration
```
4) That's it! The dry run will either pass or fail.
Expand All @@ -25,40 +25,40 @@ java -jar ./validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
### Dry run examples
##### On top of CIEL
```bash
java -jar ./validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar ./validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration \
--ciel-file=/Users/mksd/Downloads/openmrs_concepts_2.2_20200927.sql
```
##### Skipping some domains
```bash
java -jar validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration \
--domains='!metadatasharing,privileges,roles'
```
##### Including only some domains
```bash
java -jar validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration \
--domains='concepts,locations'
```
##### Excluding some files in a domain
```bash
java -jar validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration \
--exclude.concepts='*diags*,*interventions*'
```
In the above example all 'concepts' domain files matching the [wildcard patterns](https://docs.oracle.com/cd/E23389_01/doc.11116/e21038/conditions.htm#BABEJGAH) `*diags*` and `*interventions*` will be filtered out.
##### Unsafe mode
```bash
java -jar ./validator/target/initializer-validator-2.7.0-SNAPSHOT.jar \
java -jar ./validator/target/initializer-validator-2.8.0-SNAPSHOT.jar \
--config-dir=/Users/mksd/repos/openmrs-config-acme/configuration --unsafe
```
The unsafe mode will break as soon as the first loading error occurs, triggering the validation to stop short. This mode is particularly suitable for CI processes that just need to fail early.
##### CLI arguments
Just run the fatjar with no arguments (or with the `--help` argument) to get a list of all possible options:

```bash
java -jar validator/target/initializer-validator-2.7.0-SNAPSHOT.jar
java -jar validator/target/initializer-validator-2.8.0-SNAPSHOT.jar
```
#### Note
Make sure to have the Docker Engine installed before running the validator. Please refer to the [installation docs](https://docs.docker.com/engine/install) for details.
2 changes: 1 addition & 1 deletion validator-first-dependency/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-validator-first-dependency</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion validator/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>org.openmrs.module</groupId>
<artifactId>initializer</artifactId>
<version>2.7.0-SNAPSHOT</version>
<version>2.8.0-SNAPSHOT</version>
</parent>

<artifactId>initializer-validator</artifactId>
Expand Down