> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# cropster/git-release-information

This orb uses Mergestat and Git log to list all the commits included in the latest tagged code version of the release, to then send the structured result to Slack, via webhook.


## Commands

### install_mergestat

Installs the tool Mergestat, needed for listing commits.


### send_release_commit_list

This command fetches the list of commits of the last tagged release and sends them to a Slack channel.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `repo_name` | string | NO-REPO | Name of the repo present in the message header |
| `slack_channel` | string | $SLACK_WEBHOOK_URL	 | Channel where the full commit list will be sent |

## Jobs

### commit_list_notification

Fetch a list of all the release commits and send the info via Slack


| Parameter | Type | Default | Description |
|---|---|---|---|
| `repo_name` | string | NO-REPO | Name of the repo present in the message header |
| `slack_channel` | string | $SLACK_WEBHOOK_URL | Channel where the full commit list will be sent |

## Executors

### base

Docker executor for Base image


## Examples

### get_release-commit-info

Example of the job commit_list_notification. The goal is to fetch a list of all the release commits and send the info via Slack


```yaml
version: '2.1'
orbs:
  git-release-information: cropster/git-release-information@1.0.0
workflows:
  fetch-and-send-release-commit-list:
    jobs:
      - git-release-information/commit_list_notification:
          name: Send commit list via Slack and store it in an artifact
          repo_name: Infrastructure
          slack_channel: $SLACK_WEBHOOK_URL
```