No commit activity in last 3 years
No release in over 3 years
Automate generate changelog between previous build failed and the latest commit of scm in CI
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.103.0
>= 0
>= 0

Runtime

>= 2.2.2
 Project Readme

ci_changelog plugin

fastlane Plugin Badge

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-ci_changelog, add it to your project by running:

fastlane add_plugin ci_changelog

About ci_changelog

Automate generate changelog between previous and the latest commit of SCM during the CI services.

Available CI system:

  • Jenkins
  • Gitlab CI
  • Travis CI

Configuration

$ fastlane action ci_changelog
+------------------------------+---------+--------------+
|                     Used plugins                      |
+------------------------------+---------+--------------+
| Plugin                       | Version | Action       |
+------------------------------+---------+--------------+
| fastlane-plugin-ci_changelog | 0.4.1   | ci_changelog |
+------------------------------+---------+--------------+

Loading documentation for ci_changelog:

+-----------------------------------------------------------------------------------------------+
|                                         ci_changelog                                          |
+-----------------------------------------------------------------------------------------------+
| Automate generate changelog between previous build failed and the latest commit of scm in CI. |
|                                                                                               |
| availabled with jenkins, gitlab ci, more support is comming soon.                             |
|                                                                                               |
| Created by icyleaf <icyleaf.cn@gmail.com>                                                     |
+-----------------------------------------------------------------------------------------------+

+----------------------+----------------------------------------------+-------------------------------------+---------+
|                                                ci_changelog Options                                                 |
+----------------------+----------------------------------------------+-------------------------------------+---------+
| Key                  | Description                                  | Env Var                             | Default |
+----------------------+----------------------------------------------+-------------------------------------+---------+
| silent               | Hide all information of print table          | CICL_SILENT                         | false   |
| jenkins_user         | the user of jenkins if enabled security      | CICL_CHANGELOG_JENKINS_USER         |         |
| jenkins_token        | the token or password of jenkins if enabled  | CICL_CHANGELOG_JENKINS_TOKEN        |         |
|                      | security                                     |                                     |         |
| gitlab_api_url           | the api url of gitlab                            | CICL_CHANGELOG_GITLAB_API_URL           |         |
| gitlab_private_token | the private token of gitlab                  | CICL_CHANGELOG_GITLAB_PRIVATE_TOKEN |         |
+----------------------+----------------------------------------------+-------------------------------------+---------+

+----------------+--------------------------------------------------------------------------+
|                               ci_changelog Output Variables                               |
+----------------+--------------------------------------------------------------------------+
| Key            | Description                                                              |
+----------------+--------------------------------------------------------------------------+
| CICL_CI        | the name of CI                                                           |
| CICL_BRANCH    | the name of CVS branch                                                   |
| CICL_COMMIT    | the last hash of CVS commit                                              |
| CICL_CHANGELOG | the json formatted changelog of CI (datetime, message, author and email) |
+----------------+--------------------------------------------------------------------------+
Access the output values using `lane_context[SharedValues::VARIABLE_NAME]`

Example

Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

$ fastlane test
[10:56:15]: Driving the lane 'test' 🚀
[10:56:15]: --------------------------
[10:56:15]: --- Step: ci_changelog ---
[10:56:15]: --------------------------
[10:56:15]: detected: gitlab ci

+-------------+------------------------------------------+
|             Summary for ci_changelog 0.5.0             |
+-------------+------------------------------------------+
| ci          | Jenkins                                  |
| project_url | http://stub.ci.com/example-project       |
| branch      | develop                                  |
| commit      | 45e3a61db94828b2b21a93fcabf278b6ad4d9dd8 |
| changelog   | id: 1234                                 |
|             | date: 2017-11-14 16:07:08 +0800          |
|             | title: Testing ...                       |
|             | message: Details of commit               |
|             | author: icyleaf                          |
|             | email: icyleaf.cn@gmail.com              |
|             |                                          |
|             | id: 1234                                 |
|             | date: 2017-11-14 16:07:08 +0800          |
|             | title: Testing ...                       |
|             | message: Details of commit               |
|             | author: icyleaf                          |
|             | email: icyleaf.cn@gmail.com              |
+-------------+------------------------------------------+

Run tests for this plugin

To run both the tests, and code style validation, run

rake

To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting doc in the main fastlane repo.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate building and releasing your iOS and Android apps. To learn more, check out fastlane.tools.