Install

$ npm install -g gitlab-merge

Usage

Create your configuration file. gitlab-merge uses cosmiconfig for configuration file support. This means you can configure cca via:

• A .gitlab-mergerc file, written in YAML or JSON, with optional extensions: .yaml/.yml/.json.
• A gitlab-merge.config.js file that exports an object.
• A "gitlab-merge" key in your package.json file.

The configuration file will be resolved starting from the root of your project, and searching up the file tree until a config file is (or isn't) found.

{
  "api_link": "https://gitlab.example.com/api/v4/",
  "private_token": "XXX"
}

Launch from terminal:

$ cd ~/my-projects
$ gitlab-merge

Configuration

Currently supported options are:

| Option | Description | | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | api_link | Mandatory Api link of the gitlab host | | private_token | Mandatory Your private token generated from gitlab. Where can I generate the private token? | | project_id | Optional Project id for the destionation of the merge request. If you don't set the project_id in the configuration file the tool at the beginning fetch ALL the list of the project hosted to the api_link provided. Where can I find the project id in Gitlab? | | source_branch | Optional From which branch the merge request come from (default the local active branch) | | target_branch | Optional Target branch to merge changes | | title | Optional Title of the merge request | | description | Optional Description of the merge request | | assignee_id | Optional Assignee id of the merge request. If you put none the MR will be unassigned |

You can add to your config file the options that you want, here is the list.

Where can I generate the private token?

Very simple! go to your user settings in Gitlab at ´https://XXXXXXX/profile´

Where can I find the project id in Gitlab?

You can find the project id of your project in the details tab of the repo.

Contributing

Check the issue list to contribute on some activities or to advice new features! The library is open to everybody, contribute improve your skills.

gitlab-merge is maintained under the Semantic Versioning guidelines.

Use npm run watch while coding.

Contributors

License

MIT © Christian Varisco