Overview
vile
is a general purpose code quality tool for any language or
platform that statically analyzes your software project and its dependencies.
Along with its hosted service it provides a highly flexible platform for continuous software analysis that integrates directly into your CI process and development workflow.
Demo
Features
- 🔥 Analyze complexity & churn
- 🚚 Check for outdated software packages
- 🔍 Identify similar and duplicate code
- 🌐 Calculate test coverage
- 🔐 Check for vulnerabilities in libraries and code
- 📋 Generate file statistics
- 🕑 Capture commit data
- 🔧 Run traditional linter tools
- 🔌 Flexible and easy to use plugin system
- ♥️ Supports Windows, Linux, and MacOS
+ vile.io
- 〽️ Track code quality and issues over time
- 💪 Get automated insights and suggestions based on the current state of your project
- ✉️ Get notified about new issues and insights
- 🙋 Collaborate with other users
- :octocat: Set GitHub pull request statuses
- 🚿 Schedule routine CI builds for popular services like CircleCI, AppVeyor, and Codeship
Installation & Usage
The main library requires you at least have Node.js installed.
A simple install and setup:
cd my_project/
npm i vile
npx vile init
npx vile analyze
Please see docs.vile.io for more detailed info.
Plugins
The core vile
package comes with a general set of plugins that support basic multi-language analysis.
To analyze your code further, such as tracking outdated RubyGems, plugging in your favourite linter, tracking code complexity, or checking for vulnerabilities, you need to install extra plugins first.
Common Use Cases
- Run
vile a
locally to analyze your code and print any issues or data - Run
vile a -u
on every build server commit to continuously analyze your code - Run
vile a -d -p lint-plugin my/file.ext
to run a plugin on a specific file - Run
vile a -d -e -p lint-plugin,security-plugin
to run certain lint checks during a build
Contributing
Any contributions are welcome and appreciated!
Please see CONTRIBUTING for more info.
Licensing
This project is licensed under the MPL-2.0 license.
Any contributions made to this project are made under the current license.
Versioning
This project uses Semver.
Maintainers
- Brent Lintner - @brentlintner
Project Goals
- 🌈 Provide an open and extensible platform for any type of software analysis
- 🌱 Help maintain and foster an open and inclusive community around code quality
- 📼 Distill various types of software analysis into a language independent data format
- 🎉 Support and complement existing tooling (linters, complexity tools, etc.)
- 🔩 Create new libraries and plugins that backfill language support (ex: synt)
For more info on why vile
was created checkout our post on Medium.