PHPackages                             gesdinet/bidla - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. gesdinet/bidla

ActiveApplication[Parsing &amp; Serialization](/categories/parsing)

gesdinet/bidla
==============

Bidla is a PHP Tool for help developers to generate Changelog and Contributors files

v1.0.4(11y ago)119MITPHP

Since Jan 23Pushed 11y ago1 watchersCompare

[ Source](https://github.com/gesdinet/bidla)[ Packagist](https://packagist.org/packages/gesdinet/bidla)[ Docs](https://github.com/gesdinet/bidla)[ RSS](/packages/gesdinet-bidla/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (6)Used By (0)

BIDLA
=====

[](#bidla)

Bidla is a PHP Tool for help developers to generates Changelog and Contributors files. Bidla reads your VCS log and generates a changelog/contributors file to include in your repository.

INSTALLATION
------------

[](#installation)

### Locally

[](#locally)

Download the [`bidla.phar`](http://gesdinet.github.io/bidla/download/bidla.phar) file and store it somewhere on your computer.

### Globally (manual)

[](#globally-manual)

You can run these commands to easily access `bidla.phar` from anywhere on your system:

```
$ wget http://gesdinet.github.io/bidla/download/bidla.phar -O bidla
```

or with curl:

```
$ curl http://gesdinet.github.io/bidla/download/bidla.phar -o bidla
```

```
$ sudo chmod a+x bidla
$ sudo mv bidla /usr/local/bin/bidla
```

Then, just run `bidla`

### Globally (composer)

[](#globally-composer)

To install bidla, install Composer and issue the following command:

```
$ ./composer.phar global require gesdinet/bidla
```

Then, make sure you have `~/.composer/vendor/bin` in your `PATH`, and you're good to go:

```
export PATH="$PATH:$HOME/.composer/vendor/bin"
```

Then, just run `bidla`

Use
---

[](#use)

In this early release Bidla only supports Git and Markdown:

These commands puts by default git, markdown, and CHANGELOG.md or CONTRIBUTORS.md

- bidla changelog
- bidla contributors

> Bidla changelog is going to ask you for the next tag release name. This happens cause if you tag before generate CHANGELOG then CHANGELOG file not be included in release and if you tag after Bidla can´t read last tag name.

Workflow is:

1. First commit all changes for release
2. Generate CHANGELOG and CONTRIBUTORS files with next tag name and commit them
3. Tag your release
4. Push your changes to remote

### Optional arguments

[](#optional-arguments)

Bidla accepts three input arguments

- bidla \[vcs\] \[file\] \[filename\]

\###Note

> Actually bidla only supports git and markdown

UPDATE
------

[](#update)

### Locally (actually doesn´t work, need to re-download .phar)

[](#locally-actually-doesnt-work-need-to-re-download-phar)

The `self-update` command tries to update `bidla` itself:

```
$ bidla.phar update
```

### Globally (manual) (actually doesn´t work, need to re-download .phar)

[](#globally-manual-actually-doesnt-work-need-to-re-download-phar)

You can update `bidla` through this command:

$ sudo bidla update

### Globally (Composer)

[](#globally-composer-1)

You can update `bidla` through this command:

$ ./composer.phar global update gesdinet/bidla

Example output
--------------

[](#example-output)

This project CHANGELOG.md and CONTRIBUTORS.md

- [**CHANGELOG**](CHANGELOG.md)
- [**CONTRIBUTORS**](CONTRIBUTORS.md)

How to Collaborate in this Project
----------------------------------

[](#how-to-collaborate-in-this-project)

Feel free to open issues

LEGAL DISCLAIMER
----------------

[](#legal-disclaimer)

This software is published under the MIT License, which states that:

> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

5

Last Release

4127d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c6a33e58698c721e8320faec7ff2781101b276c0cb2eaa70619084a1d60ab889?d=identicon)[markitosgv](/maintainers/markitosgv)

---

Top Contributors

[![markitosgv](https://avatars.githubusercontent.com/u/1706470?v=4)](https://github.com/markitosgv "markitosgv (17 commits)")

---

Tags

generatormarkdowngitchangelogvcscontributors

### Embed Badge

![Health badge](/badges/gesdinet-bidla/health.svg)

```
[![Health](https://phpackages.com/badges/gesdinet-bidla/health.svg)](https://phpackages.com/packages/gesdinet-bidla)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[captainhook/captainhook

PHP git hook manager

1.1k6.8M370](/packages/captainhook-captainhook)[justinwalsh/daux.io

Documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly

4.6k38.1k1](/packages/justinwalsh-dauxio)[daux/daux.io

Documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly

825191.0k1](/packages/daux-dauxio)[psx/schema

Parse and generate data schema formats

57238.7k18](/packages/psx-schema)[davidbadura/faker-markdown-generator

Faker Markdown Generator

18833.6k10](/packages/davidbadura-faker-markdown-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
