← Back to plugins index

📜 Repository licenses

This plugin display repository license informations like permissions, limitations and conditions along with additional stats about dependencies.

Supported features
→ Full specification		 📘 Repository template
📓 Repositories
🔑 (scopeless) read:org (optional) read:user (optional) read:packages (optional) repo (optional)
Permissions, limitations and conditions
Licenses overview
## 🔎 Licenses analysis Use to `plugin_licenses_setup` command to setup project dependencies. *Example: setup a NodeJS project using `npm ci`* ```yml - name: Licenses and permissions with: repo: metrics plugin_licenses: yes plugin_licenses_setup: npm ci ``` Dependencies will be analyzed by [GitHub licensed](https://github.com/github/licensed) and compared against GitHub known licenses. > ⚠ī¸ This is **NOT** legal advice, use at your own risk > đŸ’Ŗ This plugin **SHOULD NOT** be enabled on web instances, since it allows raw command injection. > This could result in compromised server! ## ➡ī¸ Available options
OptionDescription

plugin_licenses

Enable licenses plugin
🌐 Web instances must configure settings.json:
  • metrics.cpu.overuse
  • metrics.run.tempdir
  • metrics.run.git
  • metrics.run.licensed
  • metrics.run.user.cmd
type: boolean
default: no

plugin_licenses_setup

Setup command
type: string

plugin_licenses_ratio

Used licenses ratio
type: boolean
default: no

plugin_licenses_legal

Permissions, limitations and conditions about used licenses
type: boolean
default: yes
## ℹī¸ Examples workflows ```yaml name: Licenses and permissions with: filename: metrics.plugin.licenses.svg token: ${{ secrets.METRICS_TOKEN }} base: "" template: repository repo: metrics plugin_licenses: yes plugin_licenses_setup: npm ci ``` ```yaml name: Licenses with open-source ratio graphs uses: lowlighter/metrics@latest with: filename: metrics.plugin.licenses.ratio.svg token: ${{ secrets.METRICS_TOKEN }} base: "" template: repository repo: metrics plugin_licenses: yes plugin_licenses_setup: npm ci plugin_licenses_legal: no plugin_licenses_ratio: yes ```