A software license management CLI
licensure_{version}_darwin_amd64.tar.gz$PATHLicensure is available on crates.io and so can be installed with the following command:
cargo install licensure
Make sure that you have a working Rust environment. Instructions for setting one up can be found here: https://rustup.rs you can then install licensure from source with the following commands:
bash
git clone https://github.com/chasinglogic/licensure
cd licensure
cargo install --path .
If you need to update cargo you can then run the appropriate cargo install
command with the --force flag.
For now licensure only has one sub command: license. This command adds license
headers to source files and comments them. For example given the file
test.py which has the following contents:
python
print("Hello world!")
If we run the following command:
licensure license --author 'Mathew Robinson' --email 'chasinglogic@gmail.com' --ident GPL-3.0 test.py
The resulting file will be:
```python
#
#
#
print("Hello World!") ```
Licensure does some naive string comparison to determine if the header already exists. If you try to run licensure against a file which already has the generated license header you'll get this message:
chasinglogic@Mathews-MBP:~ $ licensure license --author 'Mathew Robinson' --email 'chasinglogic@gmail.com' --ident GPL-3.0 test.py
Licensing file: test.py
test.py already licensed
chasinglogic@Mathews-MBP:~ $
This makes it safe and convenient to run licensure license --project on the
same project multiple times.
Licensure does it's best to determine the comment character based on filetype but will always fall back to "python style" comments if it can't figure it out since that is the most comment comment style. As of today we explicitly support the following file types:
Adding new file types is trivial and would make for a great first pull request if you're interested in adding your favorite programming language.
For reference the full help output has been placed below. If you're having any problems running licensure please open an issue.
```text licensure 0.1.2 Mathew Robinson chasinglogic@gmail.com
Manage licenses in your projects.
Copyright 2018 Mathew Robinson chasinglogic@gmail.com. All rights reserved.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
USAGE: licensure [SUBCOMMAND]
FLAGS: -h, --help Prints help information -V, --version Prints version information
SUBCOMMANDS: help Prints this message or the help of the given subcommand(s) license Apply license headers to source files ```
License help:
```text licensure-license Apply license headers to source files
USAGE: licensure license [FLAGS] [OPTIONS] [FILES]...
FLAGS: -h, --help Prints help information -p, --project When specified will license the current project files as returned by git ls-files -V, --version Prints version information
OPTIONS:
-a, --author
ARGS:
Specifying the author, license identifier, and other flags to licensure every time can be tedious and error prone. To help with this licensure supports the use of a configuration file so you can specify these options.
Note: All arguments given as flags will overwrite the values in a config file if found, with the exception of excludes. Excludes will be joined with any found in a config file.
The configuration file is written in yaml and is searched for in two locations.
First, it will look for a file named .licensure.yml in the root of your git
repository. Second, it will look for a global configuration file located at
$HOME/.licensure/config.yml.
The required keys for the configuration file are the same as the required command line flags, author and ident:
yaml
author: Mathew Robinson
ident: Apache-2.0
You can also specify an author email:
yaml
author: Mathew Robinson
ident: Apache-2.0
email: chasinglogic@gmail.com
Additionally you can add excludes which is a yaml list of regexes which licensure will logical or together and combine with the default excludes. For example if you want to exclude the Cargo.toml from getting a license header:
yaml
author: Mathew Robinson
ident: Apache-2.0
email: chasinglogic@gmail.com
excludes:
- Cargo.toml
You can use regexes as supported by the regex crate to make more complicated matches. By default licensure will ignore any files ending with "lock", the ".gitignore" file, the README and the LICENSE file.
git checkout -b my-new-featuregit commit -am 'Add some feature'git push origin my-new-featureThis code is distributed under the GNU General Public License
``` Copyright (C) 2017 Mathew Robinson
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
```