Gitlicense - CLI Utility for Adding License File to Your Project

Introduction

Gitlicense is a CLI utility that helps you add license files to your projects. It supports multiple license types and provides a simple way to configure and manage licenses.

Getting Started

1. Install Gitlicense using the installation instructions below.
2. Configure it using the configuration instructions bellow
3. Run gitlicense --help to get available CLI arguments.

Features

• Add licenses to projects
• Support for multiple license types
• Configuration options for customizing the license file

Installation

On UNIX-Based OS:

• Move to the directory where you cloned this repository.
• Ensure you have rust installed on your machine.
• Run the following command: cargo build --release.
• Then, you can use the install.sh script or manually copy the executable binary to your /usr/bin directory. Optionally, you can add an alias gl = "gitlicense" to your shell configuration.

Windows:

Currently not fully supported.

Configuration

Add Default Configuration

• Run gitlicense in your terminal, and a default configuration file will be created.

[User]
Name  =  "YOUR_NAME"

[Paths]
TargetLicenseFilename  =  "LICENSE"
LicensesPath  =  "./licenses"

[Settings]
SetUsername  =  true
SetDate  =  true
SetCustomMessage  =  true
AlwaysOverwrite  =  true

Configure it Yourself

• Move to ~/.config/gitlicense.
• Create or edit the config.toml file.

Available configuration fields:

[User]
Name  =  ""

[Paths]
TargetLicenseFilename  =  ""
LicensesPath  =  ""  # Path to licenses you want to use

[Settings]
SetUsername  =  true #or false
SetDate  =  true #or false
SetCustomMessage  =  true #or false
AlwaysOverwrite  =  true #or false

Adding Licenses

Simple (One File) Licenses

• You need to add license content to a file with a name that you will use in the CLI, into the directory that you provided in the 'LicensesPath' field.
• Then you can modify license content and add there special elements: which will be automatically substituted by the CLI. Special elements you can provide:
  • [USERNAME] - will be substituted with your username, as provided in the configuration
  • [DATE] - will be substituted with the current year
  • [CUSTOM_MESSAGE] - will be substituted with a custom message that you can provide when invoking the gitlicense command

Complex (Two File Licenses)

• You need to create your_license_name.toml in the directory where you store all your licenses.
• Add the following content to it:

[LICENSE]  # Section for short license
Content  =  "" # Here you can add special elements,like in one file licenses
[FULL_LICENSE]  # Section for full license
Filename  =  ""
Content  =  ""

Contributing

To contribute to this repository:

• Fork the repository
• Clone the forked repository to your local machine
• Create a new branch for your contribution
• Make changes, commit, and push to your fork
• Create a pull request to the original repository

Please:

• Follow the existing coding style
• Test new features
• Use commit messages that are meaningful and consistent in style with existing ones

License

Gitlicense is released under the GNU GPL 3.0 License.

You can view my copyright notice in the LICENSE file.