Notice: This repository is now archived. Thank you for over 192,000 downloads since December 2017. While I think Elixir is an awesome ecosystem, I no longer have the chance to be developing using Elixir on a regular basis. :'(
An Elixir mix task that list the license(s) of all installed packages in your project.
The package can be installed by adding :licensir to your list of dependencies in mix.exs:
def deps do
[
{:licensir, "~> 0.7", only: :dev, runtime: false}
]
endThis 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.
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.7.0Now you can access this tool from any path on your local machine that has access to mix.
Run mix licenses to get the list of packages and their licenses:
$ mix licenses
+---------------------+---------+--------------------------------------------------------+
| Package | Version | License |
+---------------------+---------+--------------------------------------------------------+
| certifi | | BSD |
| earmark | 1.3.2 | Apache 2.0 |
| ex_doc | 0.20.2 | Apache 2.0 |
| excoveralls | | Unsure (found: MIT, Unrecognized license file content) |
| hackney | | Apache 2.0 |
| idna | | Unsure (found: BSD, MIT) |
| jason | | Apache 2.0 |
| makeup | 0.8.0 | Unsure (found: BSD, Unrecognized license file content) |
| makeup_elixir | 0.13.0 | BSD |
| metrics | | BSD |
| mimerl | | MIT |
| nimble_parsec | 0.5.0 | Apache 2.0 |
| ssl_verify_fun | | MIT |
| table_rex | 2.0.0 | MIT |
| unicode_util_compat | | Unsure (found: Apache 2.0, BSD) |
+---------------------+---------+--------------------------------------------------------+Run mix licenses --csv to output in csv format:
Package,Version,License
certifi,,BSD
earmark,1.3.2,Apache 2.0
ex_doc,0.20.2,Apache 2.0
excoveralls,,"Unsure (found: MIT, Unrecognized license file content)"
hackney,,Apache 2.0
idna,,"Unsure (found: BSD, MIT)"
jason,,Apache 2.0
makeup,0.8.0,"Unsure (found: BSD, Unrecognized license file content)"
makeup_elixir,0.13.0,BSD
metrics,,BSD
mimerl,,MIT
nimble_parsec,0.5.0,Apache 2.0
ssl_verify_fun,,MIT
unicode_util_compat,,"Unsure (found: Apache 2.0, BSD)"
--top-level-only- Only fetch license information from top level dependencies (e.g. packages that are directly listed in your application'smix.exs). Excludes transitive dependencies.
You may call the function Licensir.Scanner.scan() from your Elixir application to get a list of license data per dependency.
iex> Licensir.Scanner.scan([])
[
%Licensir.License{
app: :jason,
dep: %Mix.Dep{
app: :jason,
deps: ...
},
file: "Apache 2",
hex_metadata: ["Apache 2.0"],
license: "Apache 2.0",
mix: nil,
name: "jason",
version: nil
},
%Licensir.License{...},
...
]Copyright (c) 2017, Unnawut Leepaisalsuwanna.
This library is released under the MIT License. See the LICENSE.md file for further details.
This project contains 3rd party work as follow:
- ASCII table rendering: a partial copy of djm/table_rex.
- CSV rendering: a partial copy of beatrichartz/csv.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent