Download the PHP package magelan/readmegen without Composer

On this page you can find all versions of the php package magelan/readmegen. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of magelan/readmegen

Informations about the package readmegen

ReadmeGen

Notice: The package currently supports only GIT and the *.md output files.

Notice 2: Don't forget to update config file readmegen.yml with your parameters.

Installation

Global installation (recommended)

You can read more about global installation in the composer docs.

Local installation

Windows installation

Make sure the Windows PATH variable contains the path to the composer bin dir:

Restart any shell terminal you want to use for changes to take effect.

Usage

This package is intended to be used as an executable script, not a library you would include in your project. Assuming you installed ReadmeGen globally, to update your changelog file, simply run:

For example:

This tells the script to generate a changelog update named 1.13.0 and that it should scan the log since tag 1.12.0 up to 1.13.0. No earlier (or latter) commits will be taken into consideration. ReadmeGen will create a CHANGELOG.md file and inject the generated log *after* the#Changelog` line.

If you want to generate the changelog from a specific tag (or commit checksum) up to the latest commit (HEAD) just omit the --to argument:

You can also specify the breakpoint in the readmegen.yml config file so the command will be even cleaner:

Message format

ReadmeGen will search for messages that start with a specific keyword. These keywords tell the script to which group the commit should be appended. The message groups can be overwritten.

For example - the default configuration supports four types of commits: Features, Bugfixes, Documentation, Design, Performance, Chore and Refactoring. The commit will be appended to a certain group only if it starts with a specific word. The default config allows two keywords for bugfixes: bugfix and fix. This means, that for a message to be appended to the Bugfix group it has to start with either bugfix: blabla or Fix: foo bar (notice the colon : sign - it has to be right after the keyword). The keywords are case insensitive.

All commits that do not fit into any of the groups will be ignored (we don't want merges and stuff like that in the changelog).

Grouping commits

Each commit that fits into a group will be grouped (yeah, that sounds silly). Groups will be printed out in the order they appear in the config file, so if you have Features and Bugfixes, this is the order they will appear in the changelog:

You can override the groups in your custom config file (details below).

Link patterns

ReadmeGen can link issues to a issue tracker - all numbers starting with # or KEY- will be linked to a website defined in the config under the issue_tracker_pattern key. If a commit message has a string #1234 or KEY-1234 in it, it will be converted to a link targeting the issue tracker.

Local config

The default config holds the definitions of commit groups and the issue link pattern. It also specifies which VCS to use and the type of the output file. You can override these settings (project-wide) by creating a readmegen.yml file in the root dir of your project. When ReadmeGen will be run it will check if this file exists and merge the settings accordingly.

The default readmegen.yml config looks like this:

Each of the message_groups key is the name of the group that will be put in the changelog. The values inside the group are the keywords the commit must start with (followed by the colon : sign) to be appended to that group.

issue_tracker_key= /(KEY-[0-9]+)/ is the key used by your Issues Tracker (i.e. JIRA, Github, or anything else).

The way it works depends on your Issue Tracker service. Here some examples :

  1. For JIRA : replace KEY by your project key
  2. For Github : replace KEY- by #

Release number

ReadmeGen requires a release number (--release) to be provided. This will be the title of the generated changelog.

Breakpoint

By default the changes will go onto the beginning of the changelog file. You can though specify a "breakpoint" beneath which these changes should be appended. Usually, you'll have some "intro" in you changelog, and the changes listed below. You don't want the script to push the changes on top of the file, but below a certain line. You can specify this line in the readmegen.yml config file or using the --break argument.

For example:

The script will append the changes below the line that contains the #Changelog phrase. This should be the only phrase in this line. If you use the CLI argument method (--break), the breakpoint must not contain spaces. Thus you are encouraged to use the config method - you can use spaces there, as shown in the default config.

ReadmeGen will search for the # Changelog breakpoint by default. If the breakpoint phrase is not found, the output will go onto the beginning of the changelog file.

Example commits

Here are some example commit messages that will be grabbed by ReadmeGen (with the default config):

Changelog

1.2.3

(2018-08-20)

Bugfixes

Chore

1.2.0

(2018-07-16)

Features

Documentation

All versions of readmegen with dependencies

PHP Build Version
Package Version
Requires symfony/yaml Version ^4.1 || ~2.1
ulrichsg/getopt-php Version ^3.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package magelan/readmegen contains the following files

Loading the files please wait ....