Skip to main content

License your project

Project description

https://img.shields.io/pypi/v/notary.svg https://img.shields.io/pypi/l/notary.svg https://img.shields.io/pypi/wheel/notary.svg https://img.shields.io/pypi/pyversions/notary.svg https://travis-ci.org/sxn/notary.svg?branch=master https://codecov.io/gh/sxn/notary/branch/master/graph/badge.svg https://dependencyci.com/github/sxn/notary/badge https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg

Notary is a Python CLI tool to help you manage your project’s license. Licenses are fetched from choosealicense.

https://asciinema.org/a/105819.png

Installation

pip install notary

Usage

$ notary
Usage: notary [OPTIONS] COMMAND [ARGS]...

Manages your project's license.

Options:
-h, --help  Show this message and exit.

Commands:
add     Adds a license, replacing any that might exist.
remove  Removes any license present in the current folder.
$ notary add --help
Usage: notary add [OPTIONS]

Tries to find a license that matches the given LICENSE argument. If one
exists and takes a author and year, it adds them to the license. Otherwise
it writes the license without an author and year and informs the user.

:param license_name: the 'human' name of the license that should be added.
Notary will try to guess the actual name from this. :param author: Tuple
representing the name of the author. :param year: Integer representing the
year that will be written to the license.

Options:
-l, --license TEXT  The name of the license you want to add. Doesn't have to
                    be exact.
-a, --author TEXT   The name that will be on the license. Is ignored if not
                    required.
-y, --year INTEGER  The year that will be on the license. Is ignored if not
                    required.  [default: 2017]
-h, --help          Show this message and exit.
$ notary add
License name: m
The following license file(s) already exist:
/Users/sorin/Workspace/notary/LICENSE
Remove /Users/sorin/Workspace/notary/LICENSE? [y/N]: y
Removed /Users/sorin/Workspace/notary/LICENSE.
Found the following matching licenses:
1: MIT License
2: Mozilla Public License Version 2.0
Please choose which one you'd like to add [1]: 1
Author: Sorin Muntean
Adding MIT License as the project's license. Continue? [y/N]: y
Added MIT License to /Users/sorin/Workspace/notary/LICENSE
$ notary add --author 'Sorin Muntean'
License name: mit
Adding MIT License as the project's license. Continue? [y/N]: y
Added MIT License to /Users/sorin/Workspace/notary/LICENSE
$ notary add -l mit -a 'Sorin Muntean' -y 2017
Adding MIT License as the project's license. Continue? [y/N]: y
Added MIT License to /Users/sorin/Workspace/Python/Personal/github.com/notary/LICENSE
$ notary remove --help
Usage: notary remove [OPTIONS]

Tries to find a file named LICENSE or LICENSE.md. If one (or both) exists,
it asks the user if it should go ahead and remove them. Otherwise it exits
and informs the user that none could be found.

Options:
-h, --help  Show this message and exit.
$ notary remove
The following license file(s) already exist:
/Users/sorin/Workspace/notary/LICENSE
Remove /Users/sorin/Workspace/notary/LICENSE? [y/N]: y
Removed /Users/sorin/Workspace/notary/LICENSE.
$ notary remove
The following license file(s) already exist:
/Users/sorin/Workspace/notary/LICENSE
/Users/sorin/Workspace/notary/LICENSE.md
/Users/sorin/Workspace/notary/license.rst
Remove /Users/sorin/Workspace/notary/LICENSE? [y/N]: y
Removed /Users/sorin/Workspace/notary/LICENSE.
Remove /Users/sorin/Workspace/notary/LICENSE.md? [y/N]: y
Removed /Users/sorin/Workspace/notary/LICENSE.md.
Remove /Users/sorin/Workspace/notary/license.rst? [y/N]: y
Removed /Users/sorin/Workspace/notary/license.rst.
$ notary remove
No license file found in the current directory.

Documentation

You can find the documentation over at ReadTheDocs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notary-0.1.17.tar.gz (40.3 kB view hashes)

Uploaded Source

Built Distribution

notary-0.1.17-py3-none-any.whl (47.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page