mirror of
https://github.com/optim-enterprises-bv/siembol.git
synced 2025-11-02 03:18:09 +00:00
127 lines
3.0 KiB
Markdown
127 lines
3.0 KiB
Markdown
How to Contribute
|
|
=================
|
|
|
|
How to contribute to the siembol Java project
|
|
---------------------------------------------
|
|
|
|
### Environment
|
|
|
|
- [Maven](https://maven.apache.org/guides/) - version `3.5+`
|
|
- [Java Development Kit 17+](https://adoptopenjdk.net/)
|
|
|
|
### How to compile and install
|
|
|
|
To install the project locally:
|
|
|
|
```shell
|
|
mvn clean install -Dgpg.skip=true
|
|
```
|
|
|
|
To build and test the project:
|
|
|
|
```shell
|
|
mvn clean package
|
|
```
|
|
|
|
> **_note:_** We recommend that you execute this command before committing changes in the git repository.
|
|
|
|
To build the project but skip testing:
|
|
|
|
```shell
|
|
mvn clean package -DskipTests=true
|
|
```
|
|
|
|
### How to solve dependencies conflicts
|
|
|
|
To obtain the dependency trees that can help to resolve issues with conflict in dependencies
|
|
|
|
```shell
|
|
mvn dependency:tree
|
|
```
|
|
|
|
### How to increase the version of submodules
|
|
|
|
To increment versions in all submodules:
|
|
|
|
```shell
|
|
mvn versions:set -DnewVersion=your_new_version
|
|
```
|
|
|
|
> **_note:_** Incrementing the version is recommended for each PR with siembol java code change. Use version name with `SNAPSHOT` if you are not preparing a release version.
|
|
|
|
|
|
How to contribute to config editor UI project
|
|
---------------------------------------------
|
|
|
|
### NodeJS version
|
|
|
|
The current NodeJS version used can be found in the github actions pipeline [here](https://github.com/G-Research/siembol/blob/main/.github/workflows/ci.yml#L215).
|
|
### Angular version
|
|
|
|
The current Angular version can be found in the [package.json](/config-editor/config-editor-ui/package.json) file.
|
|
|
|
|
|
### Build
|
|
|
|
To build the project:
|
|
|
|
```shell
|
|
npm run build
|
|
```
|
|
|
|
The build artifacts will be stored in the `dist/` directory. Use the `-prod` flag for a production build.
|
|
|
|
### Development server
|
|
|
|
To start a development server, run:
|
|
|
|
```shell
|
|
npm run start
|
|
```
|
|
|
|
Navigate to [`http://localhost:4200`](http://localhost:4200) to view the UI.
|
|
|
|
The app will automatically reload if you change any of the source files.
|
|
|
|
### Running unit tests
|
|
|
|
to execute the unit tests via [Karma](https://karma-runner.github.io), run:
|
|
|
|
```shell
|
|
npm run test
|
|
```
|
|
|
|
### Linting
|
|
|
|
To lint all files:
|
|
|
|
```shell
|
|
npm run lint
|
|
```
|
|
|
|
To lint all files and fix linting errors:
|
|
|
|
```shell
|
|
npm run lint-fix
|
|
```
|
|
|
|
### Package lock file
|
|
|
|
To change the dependencies listed in [package.json](/config-editor/config-editor-ui/package.json), run:
|
|
|
|
```shell
|
|
npm install
|
|
```
|
|
|
|
Always update and commit dependencies in the [package lock file](/config-editor/config-editor-ui/package-lock.json)
|
|
|
|
> **_note:_** Please compress the package-lock.json file into one line so it does not affect the contributor statistics. Powershell example:
|
|
|
|
```shell
|
|
Get-Content package-lock.json | ConvertFrom-Json | ConvertTo-Json -compress -Depth 10 | Out-File package-lock2.json -Encoding ascii ; rm package-lock.json ; mv package-lock2.json package-lock.json
|
|
```
|
|
|
|
### Increase the config editor's UI version
|
|
|
|
The config editor's UI version should be increased after each code change in [package.json](/config-editor/config-editor-ui/package.json).
|