百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

skunk

> 编程语言
开源

针对 Ruby 代码的 SkunkScore 计算器 -- 查找没有测试覆盖的最复杂代码!

546 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

针对 Ruby 代码的 SkunkScore 计算器 -- 查找没有测试覆盖的最复杂代码!

Skunk

Skunk is a RubyCritic extension to calculate a SkunkScore for a file or project. The SkunkScore is a value that assesses the technical debt of a module.

Table of contents

  • What is the SkunkScore?
  • Getting started
    • Running SimpleCov
  • Usage
    • Help commands
    • Generate the SkunkCore for your project
    • Comparing Feature Branches
  • Configuration
    • Setting Output Formats
  • Sharing your SkunkScore
  • Contributing
  • Sponsorship

What is the SkunkScore?

The main goal of the SkunkScore is to serve as a compass in your next refactoring adventure. It will help you answer these questions:

  • What can I do to pay off technical debt?
  • What are the most complicated files with the least code coverage?
  • What are good candidates for my next test-writing efforts?
  • What are good candidates for my next refactoring efforts?

To assess the technical debt of a module, Skunk takes into account:

  • Code Complexity
  • Code Smells
  • Code Coverage

Getting started

Start by including skunk in your Gemfile:

ruby
gem 'skunk'

Then run bundle.

Or, install it yourself by running: $ gem install skunk

Running SimpleCov to generate your Code Coverage report

Use SimpleCov to generate a report of how many statements are covered by your test suite (code coverage). That's how skunk knows what's the status of your test suite + code coverage.

Please refer to SimpleCov's Getting Started Guide to install it and generate the coverage report.

SimpleCov was successfully installed when it generated a JSON file under coverage/.resultset.json in your application directory.

:warning: Skunk runs rubycritic, which loads code coverage data from your coverage/.resultset.json file. Make sure to have this file for best SkunkScore results.

Note: after adding more tests to your application, run SimpleCov again to generate an updated Code Coverage. This way, skunk will generate a new SkunkScore.

Usage

Help commands

Run skunk -h to check out the help options:

Usage: skunk [options] [paths]
    -b, --branch BRANCH              Set branch to compare
    -o, --out FILE                   Output report to file
    -v, --version                    Show gem's version
    -h, --help                       Show this message

Generating the SkunkCore for your project

The SkunkCore is a sorted list of smelly files. Skunk's report will be in the console. On the Ruby project you want to analyze, run:

skunk

The result is a list of smelly files and the SkunkScore of the project/files:

…

With the report, you can answer these refactoring questions with clarity.

In this example, the file samples/rubycritic/analysed_module.rb has the Worst SkunkScore. It means this file has a high code complexity, with lower code coverage. To decrease its SkunkScore, start by adding tests to it. Then, simplify the code to decrease the code complexity.

Other great candidates are the files that have lower code coverage. By adding tests, their SkunkScore will decrease, and refactoring the code will be more achievable.

Skunk also gives you a SkunkScore Total value: it shows you the overall code quality of the project. As you decrease the SkunkScore of the files, the total score of the project will decrease.

Excluding folders from the report

To only run skunk on specific folders, pass a list of directories in the command line. For example, if you only want the report for the files under app and lib, run:

skunk app lib

Generate JSON report in background

When the Skunk command is run, it will generate a JSON report file in the RubyCritic::Config.root location.

Comparing feature branches

When working on new features, run skunk against your feature branch to check if the changes are improving or decreasing the code quality of the project.

To generate the SkunkScore of your feature branch, run:

skunk -b 

Then, get a SkunkScore average comparison with main by running:

$ skunk -b main

Switched to branch 'main'
....

Base branch (main) average skunk score: 290.53999999999996
Feature branch (feature/compare) average skunk score: 340.3005882352941
Score: 340.3

This should give you an idea if you're moving in the direction of maintaining the code quality or not. In this case, the feature branch is decreasing the code quality because it has a higher SkunkScore than the main branch.

Configuration

Setting Output Formats

Skunk supports multiple output formats and you can select them via CLI or programmatically.

Supported formats:

  • :json - JSON report
  • :html - HTML report with visual charts and tables
  • :console - Console output (default)

CLI flag

You can choose one or more formats from the command line:

skunk --formats=json
skunk --f json,html
skunk --formats console,json

If omitted, Skunk defaults to console.

Programmatic configuration

You can also configure formats in code using Skunk::Config:

ruby
require 'skunk/config'

# Set multiple formats (equivalent to `--formats=json,html`)
Skunk::Config.formats = [:json, :html]

# Add a format to the existing list
Skunk::Config.add_format(:html)

# Remove a format
Skunk::Config.remove_format(:json)

# Check supported formats
Skunk::Config.supported_formats # => [:json, :html, :console]
Skunk::Config.supported_format?(:json) # => true

# Reset to defaults
Skunk::Config.reset

Sharing your SkunkScore

If you want to share the results of your Skunk report with the Ruby community, run:

SHARE=true skunk app/

SkunkScore Total: 126.99
Modules Analysed: 17
SkunkScore Average: 7.47
Worst SkunkScore: 41.92 (lib/skunk/commands/status_sharer.rb)

Generated with Skunk v0.5.0
Shared at: https://skunk.fastruby.io/

Results will be posted by default to https://skunk.fastruby.io which is a free and open source Ruby on Rails application sponsored by OmbuLabs(source code).

If you prefer to post results to your server, set your own SHARE_URL:

$ SHARE_URL=https://path.to.your.skunk-fyi-server.example.com skunk app/

SkunkScore Total: 126.99
Modules Analysed: 17
SkunkScore Average: 7.47
Worst SkunkScore: 41.92 (lib/skunk/commands/status_sharer.rb)

Generated with Skunk v0.5.0
Shared at: https://path.to.your.skunk-fyi-server.example.com

Contributing

Have a fix for a problem you've been running into or an idea for a new feature you think would be useful? Want to see how you can support Skunk?

Take a look at the Contributing document for instructions to set up the repo on your machine, check the Help Wanted section, and create a good Pull Request.

Sponsorship

skunk is maintained and funded by FastRuby.io. The names and logos for FastRuby.io are trademarks of The Lean Software Boutique LLC.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rubycode-coveragecode-qualitycode-quality-analyzergood-first-issue

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言