Skip to content

Commit

Permalink
Merge pull request #41 from brainhubeu/chore-setup-monorepo
Browse files Browse the repository at this point in the history
chore: setup monorepo
  • Loading branch information
angjez authored Oct 7, 2024
2 parents d15b8d3 + e9d69ab commit f160e84
Show file tree
Hide file tree
Showing 122 changed files with 4,193 additions and 23,926 deletions.
9 changes: 0 additions & 9 deletions .eslintrc

This file was deleted.

35 changes: 0 additions & 35 deletions .github/workflows/pull_request.yml

This file was deleted.

20 changes: 0 additions & 20 deletions .github/workflows/push_to_master_branch.yml

This file was deleted.

17 changes: 0 additions & 17 deletions .github/workflows/release.yml

This file was deleted.

24 changes: 24 additions & 0 deletions .github/workflows/verify-pr.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
on:
pull_request:
types: [opened, reopened, synchronize]

jobs:
format-and-lint:
runs-on: ubuntu-latest
steps:
- name: Check out code
uses: actions/checkout@v3

- name: Set up Node.js
uses: actions/setup-node@v3
with:
node-version: '20'

- name: Install dependencies
run: npm install

- name: Run Biome
run: npx biome ci .

- name: Run typecheck
run: npm run typecheck
38 changes: 34 additions & 4 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,34 @@
/node_modules/
.idea
.coveralls.yml
coverage/
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.

# Dependencies
node_modules
.pnp
.pnp.js

# Local env files
.env
.env.local
.env.development.local
.env.test.local
.env.production.local

# Testing
coverage

# Turbo
.turbo

# Build Outputs
out/
build
dist


# Debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Misc
.DS_Store
*.pem
2 changes: 2 additions & 0 deletions .husky/prepare-commit-msg
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
#!/usr/bin/env sh
exec < /dev/tty && node_modules/.bin/cz --hook || true
10 changes: 0 additions & 10 deletions .npmignore

This file was deleted.

1 change: 1 addition & 0 deletions .npmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
save-exact=true
22 changes: 0 additions & 22 deletions LICENSE.md

This file was deleted.

156 changes: 1 addition & 155 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,155 +1 @@
<br/>
<h1 align="center">
license-auditor
</h1>

<p align="center">
License Auditor helps you track and validate licenses inside your project.
</p>

<p align="center">
<strong>
<a href="https://brainhub.eu/contact/">Hire us</a>
</strong>
</p>

<div align="center">

[![Last commit](https://img.shields.io/github/last-commit/brainhubeu/license-auditor.svg)](https://github.com/brainhubeu/license-auditor/commits/master)
[![license](https://img.shields.io/npm/l/@brainhubeu/license-auditor.svg)](https://github.com/brainhubeu/license-auditor/blob/master/LICENSE.md)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
[![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)

[![Coveralls github](https://img.shields.io/coveralls/github/brainhubeu/license-auditor.svg)](https://coveralls.io/github/brainhubeu/license-auditor?branch=master)
[![Downloads](https://img.shields.io/npm/dm/@brainhubeu/license-auditor?color=blue)](https://www.npmjs.com/package/@brainhubeu/license-auditor)
[![Activity](https://img.shields.io/github/commit-activity/m/brainhubeu/license-auditor.svg)](https://github.com/brainhubeu/license-auditor/commits/master)
[![Minified](https://img.shields.io/bundlephobia/min/@brainhubeu/license-auditor?label=minified)](https://www.npmjs.com/package/@brainhubeu/license-auditor)
[![npm](https://img.shields.io/npm/v/@brainhubeu/license-auditor.svg)](https://www.npmjs.com/package/@brainhubeu/license-auditor)
[![Contributors](https://img.shields.io/github/contributors/brainhubeu/license-auditor?color=blue)](https://github.com/brainhubeu/license-auditor/graphs/contributors)

</div>

License Auditor helps you track and validate licenses inside your project. Prevents unwanted law complications. The license Auditor includes a step in your pipeline and creates notifications about potential problems with used licenses. At the moment, a notification means a comment.

# Getting started

To start using the **License Auditor**, install its package with NPM:

```command
npm install @brainhubeu/license-auditor
```

or Yarn:

```command
yarn add @brainhubeu/license-auditor
```

In the next step, copy `license-template` directory with `licenses.js`, `blacklist.js`, and `whitelist.js` files, naming it `license` in your project. The first one contains a full list of all currently acknowledged, depreciated, and exceptional software licenses. To whitelist or blacklist the license, you must copy selected licenses from the main file into them.

Whitelisting stops **License Auditor** from analyzing and displaying any notifications for a given package with whitelisted license type. Blacklisting a license leads to the generation of fail notification log or causes CI job to fail if the blacklisted license is found, which prevents the developer from merging unwanted dependencies into the destination branch. Any license that is included in neither `blacklist.js` nor `whitelist.js`, but is found during packages analyze or merge request, becomes a warning, which developer should address during merge process or further development.

If a given dependency has no license specified, it's marked with `UNKNOWN` and thus the default blacklist contains `UNKNOWN` license to notify about a potentially unwanted license.

For **License Auditor** to work, all project dependencies have to be installed before an audit. **License Auditor** iterates through the `node_modules` and retrieves the license information from them. List of licenses is also available at [spdx site](https://spdx.org/licenses/).

The order of files in which the license information is retrieved from is: `package.json`, `LICENSE`, `LICENCE`, `COPYING`, `README`. Warning and Error notifications specify the license file that it has been read from. In some cases, license files may not provide the license directly. The asterisk `*` symbol next to shown license name indicates that it is the closest possible, but not fully confirmed license.

# Usage and examples

## Continuous Integration tools adaptation

If you intend to use **License Auditor** with GitLab CI or GitHub Actions, you have to copy [CI example file](./examples/ci_example.js) to the root of your project directory and RENAME it to `dangerfile.js`. This example provides a base for CI-oriented licenses checking using DangerJS (for more information this framework, visit [official Danger Systems site](https://danger.systems/js/)).

Then, you have to include it in your pipeline. The basic structure of **Gitlab** pipeline step should look like this:

```yaml
check_foo_licenses:
stage: CheckFooLicenses
image: node:alpine
script:
- yarn add -D danger @brainhubeu/license-auditor
- yarn danger ci --failOnErrors --id Foo
variables:
DANGER_GITLAB_API_TOKEN: $GITLAB_ACCESS_TOKEN
PROJECT_PATH: $PATH_TO_FOO_PACKAGE # it could look like: ./packages/web or ./server
only:
- merge_requests
```
and the basic structure for **Github Actions**:
```yaml
- name: CheckBarLicenses
run: |
yarn add -D danger @brainhubeu/license-auditor
yarn danger ci --failOnErrors --verbose --id Bar
env:
DANGER_GITHUB_API_TOKEN: ${{ secrets.GITHUB_ACCESS_TOKEN }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
PROJECT_PATH: $PATH_TO_BAR_PACKAGE # it could look like: ./packages/web or ./server
```
You can find more examples in examples directory for [GitLab](./examples/gitlab) and [GitHub](./examples/github).
To allow automatic comments posting on MRs/PRs, you need to create either `Gitlab Access Token` or `Github Access Token` in a profile that is going to post comments
under MRs/ PRs. Then you need to specify environmental variables with key `DANGER_GITLAB_API_TOKEN` or `DANGER_GITHUB_API_TOKEN` and value being the acquired token.
The Access Token needs to have the ability to use the Github/Gitlab API and write discussions for MRs/PRs.

#### Gitlab:

![Gitlab Access Token](./assets/gitlab_access_token_screenshot.png)

#### Github:

![Github Access Token](./assets/github_access_token_screenshot.png)

In provided examples, the new Gitlab and Github accounts were created to act as a "bot", that was posting MR/PR comments based on license information. Both of them were named [HAL9002](https://en.wikipedia.org/wiki/HAL_9000).

The comments should look similar to:

for Gitlab:

![Gitlab Comment Warn](./assets/gitlab_comments.png)

for Github:

![Gitlab Comment Error](./assets/github_comments.png)

You can find more information about Github and Gitlab configuration [here](https://danger.systems/js/guides/getting_started.html).

## Logging tool and own implementation

To use a logging tool instead of CI, copy [logging example file](./examples/logging_example.js) to the root of your project directory. It is intended to log used license information into the console of your preference. To use it, you need to have a JavaScript runtime environment installed (e.g. [Node.js](https://nodejs.org/en/)). Then, just simply type:

```command
node logging_example.js
```

This command will list fails for every dependency that was blacklisted in `blacklist.js` file and warnings for licenses that are missing on both `whitelist.js` and `blacklist.js` files.

You can also create your own implementation of `warn` and `fail` methods behavior based on your needs. To do so, we recommend to copy [logging example file](./examples/logging_example.js) and change `fail` and `warn` methods implementations, remembering to preserve `msg` input parameter and not to add new parameters, as they will be of no use.

# Contributing

# Releasing a new version of the package

1. Create a new branch `release-<version>` e.g. `release-v1.1.1`.
2. Run `yarn version` command and set a new version e.g `v1.1.1`. Follow [Semantic Versioning 2.0.0](https://semver.org/).
3. Push your branch along with created tag e.g. `git push --set-upstream origin release-v1.1.1 --tags`.
4. Open pull request.
5. Once pull request is merged, create a new release on Github. Select existing tag e.g. `v1.1.1` and fill in release notes. A new version will be published using Github Actions :tada:.
## Tests
- run `yarn test`

## About

`license-auditor` was built using:

- [Danger.js](https://danger.systems/js/)

`license-auditor` is maintained by [@jkthomas](https://github.com/jkthomas), [@nikodemwrona](https://github.com/NikodemWrona) and the Brainhub development team. It is funded by Brainhub and the names and logos for Brainhub are trademarks of Brainhub Sp. z o.o.. You can check other open-source projects supported/developed by our teammates [here](https://brainhub.eu/?utm_source=github).

[![Brainhub](https://brainhub.eu/brainhub.svg)](https://brainhub.eu/?utm_source=github)

We love open-source JavaScript software! See our other projects or hire us to build your next web, desktop, and mobile application with JavaScript.
# license-auditor
Binary file removed assets/github_access_token_screenshot.png
Binary file not shown.
Binary file removed assets/github_comments.png
Binary file not shown.
Binary file removed assets/gitlab_access_token_screenshot.png
Binary file not shown.
Binary file removed assets/gitlab_comments.png
Binary file not shown.
50 changes: 50 additions & 0 deletions biome.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
{
"$schema": "https://biomejs.dev/schemas/1.9.3/schema.json",
"vcs": {
"enabled": false,
"clientKind": "git",
"useIgnoreFile": false
},
"files": {
"ignoreUnknown": false,
"ignore": []
},
"formatter": {
"enabled": true,
"indentStyle": "space"
},
"organizeImports": {
"enabled": true
},
"linter": {
"enabled": true,
"rules": {
"recommended": true,
"complexity": {
"noExcessiveCognitiveComplexity": "error",
"useSimplifiedLogicExpression": "error"
},
"style": {
"noDefaultExport": "error",
"useBlockStatements": "error",
"useDefaultSwitchClause": "error",
"useFilenamingConvention": {
"level": "error",
"options": {
"filenameCases": ["kebab-case"],
"requireAscii": true
}
},
"useNamingConvention": "error",
"useShorthandArrayType": "error",
"useShorthandAssign": "error",
"useSingleCaseStatement": "error"
}
}
},
"javascript": {
"formatter": {
"quoteStyle": "double"
}
}
}
Loading

0 comments on commit f160e84

Please sign in to comment.