cybrox / licensir

An Elixir mix task that lists the license(s) of all installed packages in your Mix project.

Licensir

An Elixir mix task that list the license(s) of all installed packages in your project.

Installation

The package can be installed by adding licensir to your list of dependencies in mix.exs:

def deps do
  [
    {:licensir, "~> 0.4", only: :dev, runtime: false}
  ]
end

This mix task in most cases only needs to be run on a development machine and independent from the runtime applications, hence the only: dev, runtime: false options.

Install locally

If you do not wish to include this tool as part of your dependencies, you may also install it locally by running:

$ mix archive.install hex licensir 0.4.0

Now you can access this tool from any path on your local machine that has access to mix.

Usage

Run the command to get the list of packages and their licenses:

mix licenses

The command above should return an output similar to below (example from phoenix):

$ mix licenses
cowboy 2.2.2            -> Undefined
cowlib 2.1.0            -> Undefined
earmark                 -> Apache 2 (see the file LICENSE for details)
ex_doc                  -> Unsure (found: Apache 2.0, Apache 2)
gettext                 -> Apache 2.0
inch_ex                 -> MIT
jason 1.0.0             -> Unsure (found: Apache 2.0, Apache 2)
licensir 0.2.5          -> MIT
mime 1.2.0              -> Apache 2
phoenix_html            -> MIT
phoenix_pubsub 1.0.2    -> MIT
plug 1.5.0              -> Apache 2
poison                  -> CC0-1.0
ranch 1.4.0             -> Undefined
websocket_client        -> Undefined

Flags

• --top-level-only - Only fetch license information from top level dependencies (e.g. packages that are directly listed in your application's mix.exs). Excludes transitive dependencies.

License

Copyright (c) 2017-2019, Unnawut Leepaisalsuwanna.

Licensir is released under the MIT License.