epicarrow/git-changelog

A simple service to parse the git log of an application to a readable changelog.

Maintainers

Details

github.com/ferdinandfrank/git-changelog

Source

Issues

Installs: 53

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 3

Forks: 0

Open Issues: 0

v1.2 2017-01-23 17:32 UTC

Requires

MIT 3a753c8a9f7be1d418c854ad1432f16b414c66d6

  • EpicArrow <ferdinand-frank.woop@web.de>

gitversionlaravelchangelogcommits

This package is not auto-updated.

Last update: 2024-12-21 21:31:21 UTC

README

A simple service to parse the git log of an application to a readable changelog.

Requirements

Mandatory Requirements

  • PHP >= 5.6.4
  • Carbon >= 1.18: Used to format the date of the git commits

Optional Requirements

  • An existing >= Laravel 5.3 project to use the global view variable $gitVersion

Installation

  1. To get started, install the Git ChangeLog service via the Composer package manager:

    composer require epicarrow/git-changelog

  2. Optional: If you are using Laravel and you want to use the global view variable $gitVersion add the following entry to your providers array in config/app.php:

    'providers' => [
   ...
   ...
   EpicArrow\GitChangeLog\Providers\GitChangeLogServiceProvider::class
]

Documentation

Services

The following services are currently available:

EpicArrow\GitChangeLog\GitChangeLog::get([int $count = null])

Fetches the latest unique git commits. If two contiguous commits have the same commit message only one commit will be retrieved.

Parameters:

  • $count (int): The number of results to retrieve.

Return Values:

The retrieved commits as an array of EpicArrow\GitChangeLog\Models\Commits.

EpicArrow\GitChangeLog\GitChangeLog::version()

Gets the latest version of the git repository.

Return Values:

The retrieved latest version of the git repository as a string or null if no version exists.

Global Variables

If you are using Laravel and you've registered the GitChangeLogServiceProvider within your config/app.php providers array you can access the following variables from every blade view:

  • $gitVersion: Corresponds to the service EpicArrow\GitChangeLog\GitChangeLog::version() and gets you the latest version of the git repository.

The commit model EpicArrow\GitChangeLog\Models\Commit

When retrieving the latest git commit through this service you will get an array of EpicArrow\GitChangeLog\Models\Commits. This model has the following properties:

  • $id(string): The commit hash/id
  • $date(Carbon\Carbon): The date of the commit
  • $message(string): The commit message
  • $version(string|null): The version (tag) the commit belongs to
  • $author(string): The author of the commit
  • $email(string): The author's email address of the commit
  • $merge(string|null): The merge info of the commit