Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 9 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,12 @@

# @omniboard/analyzer


## Getting started with Omniboard in less than 5 minutes (video)

<a href="https://app.omniboard.dev/assets/videos/omniboard-getting-started.mp4" target="_blank">
<img src="https://app.omniboard.dev/assets/videos/omniboard-getting-started.png" height="300" />
</a>


### Create account, get API key and define checks

1. Create account for [Omniboard.dev](https://www.omniboard.dev)
Expand All @@ -18,7 +16,6 @@
4. (optional) test your API key using `npx omniboard test-connection --api-key <your-api-key>` (same as `omniboard tc --ak <your-api-key>`)
5. Define checks in the [Omniboard.dev](https://app.omniboard.dev/app/checks) app


### Run in projects

Make sure you have already set `OMNIBOARD_API_KEY` environment variable in the given environment
Expand All @@ -28,11 +25,11 @@ Make sure you have already set `OMNIBOARD_API_KEY` environment variable in the g

or

* `npx @omniboard/analyzer` (in case it was not pre installed)
- `npx @omniboard/analyzer` (in case it was not pre installed)

or

* `npm i -g @omniboard/analyzer` - install it globally to be able to run `omniboard` in any path without waiting for npx install
- `npm i -g @omniboard/analyzer` - install it globally to be able to run `omniboard` in any path without waiting for npx install

## Options

Expand All @@ -45,7 +42,7 @@ Run `omniboard --help` for list of all supported commands and options (`omniboar
- `--check-pattern` - only run checks matching provided pattern
- `--json` - store data in local json file
- `--json-path` - location of local json file

- `--silent` - silcences the renderer

## How it works

Expand All @@ -58,21 +55,21 @@ Run `omniboard --help` for list of all supported commands and options (`omniboar
## FAQ

#### Is it possible to run @omniboard/analyzer behind organization proxy?

**Yes**

The `@omniboard/analyzer` uses [global-agent](https://github.com/gajus/global-agent) library which will uses
`HTTP_PROXY`, `HTTPS_PROXY` and `NO_PROXY` environment variables and use them to make requests
to `https://api.omniboard.dev`

#### Is this uploading my source code to the cloud?

**No**

The `@omniboard/analyzer` runs checks against your source code (or even generated artifacts)
and uploads results of these checks to the cloud service for further processing.
The `@omniboard/analyzer` runs checks against your source code (or even generated artifacts)
and uploads results of these checks to the cloud service for further processing.
The uploaded content is then just metadata describing the projects and results but NOT the projects themselves.

In theory, a check which matches everything could be constructed but such result will
be rejected as the payload would be too large. The limits of how much data can be stored
In theory, a check which matches everything could be constructed but such result will
be rejected as the payload would be too large. The limits of how much data can be stored
per check and per all checks for a project can be customized in organization settings in the Omniboard.dev app.


5 changes: 5 additions & 0 deletions lib/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,11 @@ import { loggerMiddleware } from './middlewares/logger.middleware';
description:
'Exit with success (0) even in case of errors and log them as warnings',
})
.option('silent', {
type: 'boolean',
default: false,
description: 'Silences the renderer.',
})
.alias('v', 'version')
.alias('h', 'help')
.epilogue(
Expand Down
1 change: 1 addition & 0 deletions lib/interface.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ export interface Options {
checkPattern?: string;
checkDefinition?: string;
apiKey?: string;
silent: boolean;
}

export interface Context {
Expand Down
1 change: 1 addition & 0 deletions lib/utils/process.ts
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ export const runner = async (
await new Listr(tasks, {
rendererFallback: () => options?.verbose,
rendererOptions: { collapse: false, showTimer: true },
renderer: options.silent ? 'silent' : 'default',
})
.run(context)
.then((res) => {
Expand Down