@exlint.io/cli

 

Exlint CLI Open Beta

👩🏻‍💻 Centralized Code Standards: Keep your code clean and standardized over multiple repositories.

📦️ Grouped & Sharable Compliances: Share and run your coding conventions over any repositories.

🚀 CI Workflow: Integrate Exlint into your workflow to continuously prevent coding bad practices.

See more on exlint.io

Exlint is in open beta and still under development! Help us by giving feedback and contributing.

Table of Contents

• Getting Started

• Running from command line

• CI Workflows

• Privacy

• Support

• Contributing

  • Code of Conduct

• License

Getting Started

We recommend installing Exlint CLI globally using npm:

npm install --global @exlint.io/cli

You can also install it locally:

npm install --save-dev @exlint.io/cli

🚀 Go Command

exlint go

Get started quickly with Exlint using our go command.

Exlint will create a recommended multi-policy compliance based on your project language, and will run the compliance linting result on your terminal.

You can then easily create an account and customize the recommended compliance as you wish (or start from scratch).

Running from command line

You can run Exlint directly from the CLI (if it's globally available in your PATH, e.g. by npm install --global @exlint.io/cli) with a variety of useful commands. If you haven't installed Exlint CLI globally, but locally, you can use it in the CLI by using npx.

Auth Command

exlint auth

Exlint requires you to authenticate. This will allow you to use your configured compliances in the CLI. First, you should make sure you have created an account and configured your compliance. When running the command, you will be prompted to your browser to authenticate yourself. After doing so, you can return back to the CLI and start using Exlint!

Use Command

exlint use <compliance_id>

When you want to use a compliance you have created in the dashboard, you copy its unique identifier and use it with the use command. Exlint will adjust your IDE (if using VSCode or Webstorm), install required extensions and libraries. You can easily switch compliances by using the command again!

Run Command

exlint run [options]

After running the use command, you can run your compliance over your code to get CLI results. Exlint will run your configured libraries against your code and report upon success or failure runs. If your code fails to match the configured code standards, Exlint will report the issues in the CLI.

Options

You can also run the command with --fix or -f option. Providinig this option will make Exlint try to automatically fix your code issues.

CI Workflows

You can run your centralized Exlint compliance also in CI. If you want to integrate an Exlint step in your workflow, you can use the GitHub Action

Privacy

Exlint does not and will not, in any way, view / copy / obtain access or intrude user code. Our CLI is 100% open source and will stay this way. Open source libraries should stay open source, and not used as a means to an end of obscuring privacy.

Support

Currently we offer support through Discussions and Issues, but you can always reach out on [e-mail].

Contributing

Development of Exlint CLI happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements.

Code of Conduct

Exlint has adopted a Code of Conduct that we expect project participants to adhere to.

License

Exlint is Apache 2.0 Licensed.