knowledge/technology/applications/development/licensit.md
2025-01-31 20:10:15 +01:00

2.2 KiB

obj repo rev
application https://github.com/neuromeow/licensit 2025-01-31

licensit

licensit is a command-line tool to create LICENSE files.

Supported licenses

  • GNU Affero General Public License v3.0 (AGPL-3.0)
  • Apache License 2.0 (Apache-2.0)
  • BSD 2-Clause “Simplified” License (BSD-2-Clause)
  • BSD 3-Clause “New” or “Revised” License (BSD-3-Clause)
  • Boost Software License 1.0 (BSL-1.0)
  • Creative Commons Zero v1.0 Universal (CC0-1.0)
  • Eclipse Public License 2.0 (EPL-2.0)
  • GNU General Public License v2.0 (GPL-2.0)
  • GNU General Public License v3.0 (GPL-3.0)
  • GNU Lesser General Public License v2.1 (LGPL-2.1)
  • MIT License (MIT)
  • Mozilla Public License 2.0 (MPL-2.0)
  • The Unlicense (Unlicense)

Usage

licensit simplifies the process of creating and managing license files for your projects.

Listing Available Licenses

licensit list

Shows all supported licenses.

Showing License Content

To view the content of a specific license with the author and year filled in:

licensit show [LICENSE] [--user USER] [--year YEAR]
  • [LICENSE]: The ID of the license you want to display (for example, mit, apache-2.0)
  • --user [USER]: Specifies the license holder's name. If not provided, licensit will use the following sources in order to determine the user name:
    • LICENSE_AUTHOR environment variable
    • user.name entry in the $HOME/.gitconfig file
    • Username associated with the current effective user ID
  • --year [YEAR]: Sets the year during which the license is effective. Defaults to the current year if not specified

To display just the template of a license (without any specific user or year information):

licensit show [LICENSE] --template
  • [LICENSE]: The ID of the license whose template you want to display (for example, mit, apache-2.0)
  • --template: Displays the license template with placeholders for the user and year. This option cannot be used with --user or --year

Adding a License to Your Project

To add a license file to your current directory:

licensit add [LICENSE] [--user USER] [--year YEAR]

Creates a LICENSE file in the current directory with the specified details.