Skip to content

Releases: lucianopaz/head_of_apache

v0.1.1

Choose a tag to compare

@lucianopaz lucianopaz released this 11 Mar 10:27

What's Changed

  • Add a way to overwrite the start year in all files' license headers by @lucianopaz in #13

Full Changelog: 0.1.0...0.1.1

v0.1.0

Choose a tag to compare

@lucianopaz lucianopaz released this 20 Jan 09:44
0c9cade

First minor relase of head_of_apache

This package adds or updates the Apache v2 license header to source code files of your project.

The code is mostly taken from the IAM-CMS pre-commit-hooks project. The major changes were that the license header is fuzzily matched, meaning that if the year changes, the license header will be updated inplace instead of being prepended to the previous header.

Usage

The hook is intended to the following:

  • Add the Apache 2.0 License header for the desired author and a date range that finishes with the current year or the string "present" to source code files that do not have the Apache 2.0 License header
  • If there's an existing Apache 2.0 License header with another author, it keeps it while prepending a new License header under the desired author and the year range
  • If there's an existing Apache 2.0 License header for the desired author but for an incorrect year range, the year range is updated while keeping the start year of the original license header.
  • Any special shebang or encoding opennings are left are they were found.

To run the pre-commit hook, you must pass the following configuration:

repos:
  - repo: https://github.com/lucianopaz/head_of_apache
    rev: "0.1.0"
    hooks:
      - id: head_of_apache
        args:
          - --author
          - name of author
          - --exclude
          - excluded/directory_or_file
          - --last-year-present

Using the args keyword, the default behaviour of the hook can be adapted. The following options exist:

-a/--author: The author to use in the license header.

-m/--mapping: Overwrite existing or add additional file types to the
default file/comment style mapping. For example, to use Jinja comment styles
in HTML files, the following mapping can be used: -m html jinja.

-x/--exclude: A path to exclude. A file will be excluded if it starts with
the given path. Can be specified more than once.

-d/--dry-run: If present, head_of_apache will only print the list of the files that need a license update instead of changing them inplace.

-l/--last-year-present: If present, the end year in the license date range is set to the string "present". If the flag is not supplied, then the current year number will be used in the year range instead.

v0.0.3

Choose a tag to compare

@lucianopaz lucianopaz released this 31 Jan 21:31
head_of_apache script returns an exit code equal to 1 when license fi…

v0.0.2

Choose a tag to compare

@lucianopaz lucianopaz released this 31 Jan 21:25
Make author a required option

v0.0.1

Choose a tag to compare

@lucianopaz lucianopaz released this 31 Jan 14:18
Initial commit of source code