harvey
Harvey is a command line legal expert who manages license for your open source project.
Demo
Features
- Written in Python
- Supports all Github-supported
licenses
- Works on Mac, Linux, Windows
Installation
Pip
Option 1:$ pip install harvey
Option 2: From source
$ git clone [email protected]:architv/harvey.git
$ cd harvey/
$ python setup.py install
####Note:
Windows users might need to install ansicon for colorama to work correctly.
Usage
Get summary, can, cannot and must rules for a license
$ harvey gpl-2.0 --tldr
LICENSE
for your git repo
Get a $ harvey mit # outputs mit license to stdout
LICENSE
Overwrite existing $ harvey mit > LICENSE # saves a new mit LICENSE file
OR
$ harvey --export mit # saves a new mit LICENSE file
List all licenses
$ harvey ls # or `harvey list`
Help
$ harvey --help
List of supported licenses
- BSD 3-clause "New" or "Revised" License [bsd-3-clause]
- GNU Lesser General Public License v3.0 [lgpl-3.0]
- GNU General Public License v2.0 [gpl-2.0]
- Mozilla Public License 2.0 [mpl-2.0]
- GNU General Public License v3.0 [gpl-3.0]
- The Unlicense [unlicense]
- Creative Commons Zero v1.0 Universal [cc0-1.0]
- Artistic License 2.0 [artistic-2.0]
- GNU Affero General Public License v3.0 [agpl-3.0]
- ISC License [isc]
- GNU Lesser General Public License v2.1 [lgpl-2.1]
- Eclipse Public License 1.0 [epl-1.0]
- Apache License 2.0 [apache-2.0]
- BSD 2-clause "Simplified" License [bsd-2-clause]
- MIT License [mit]
FAQ's
choose a license and tldr legal?
How is this any better than- Harvey doesn't only let you select a license, it also helps you to add it to your project. So, doing something like:
harvey apache-2.0 > LICENSE
will add the apache license in your project, with your user name, which you have setup in your git config
settings
- Yes, choose a license also allows you to select a license. But since this is a CLI app, you can choose the license without breaking your workflow. Thus, it saves you time by not having to switch over to the browser.
Still, it seems really unnecessary.
Apart from what I have mentioned above, I wouldn't go as far as saying that harvey is absolutely essential to manage license for your open source project. I felt the need for the app because every time I had to add a license to my project I had to head over to the browser for a license template. So, I created harvey to allow me to add a license without breaking my workflow.
Contributing
Bug Reports & Feature Requests
Please use the issue tracker to report any bugs or file feature requests.
Developing
PRs are welcome. To begin developing, do this:
# make virtual env
$ git clone [email protected]:architv/harvey.git
$ pip install requirements.txt
$ cd harvey/
$ python harvey/harvey.py mit
Licence
Open sourced under MIT License (Created by harvey)
Image: buylocalexperts.com