feat(cli): add --formats flag to support multiple output formats

Add support for selecting output formats via CLI with the new --formats flag.
Update documentation to explain usage and maintain existing programmatic config.

Author: JuanVqz

CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## main [(unreleased)](https://github.com/fastruby/skunk/compare/v0.5.4...HEAD)
 
+* [FEATURE: Add `--formats` CLI flag to select report formats (json, html, console)]
 * [REFACTOR: Move Console Report](https://github.com/fastruby/skunk/pull/128)
 * [BUGFIX: Set the right content type in the share HTTP request](https://github.com/fastruby/skunk/pull/129)
 * [REFACTOR: Centralize Skunk analysis into RubyCritic module](https://github.com/fastruby/skunk/pull/127)

README.md

@@ -158,16 +158,33 @@ This should give you an idea if you're moving in the direction of maintaining th
 
 ### Setting Output Formats
 
-Skunk provides a simple configuration class to control output formats programmatically. You can use `Skunk::Config` to set which formats should be generated when running Skunk.
+Skunk supports multiple output formats and you can select them via CLI or programmatically.
 
 **Supported formats:**
-- `:json` - JSON report (default)
+- `: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
+# Set multiple formats (equivalent to `--formats=json,html`)
 Skunk::Config.formats = [:json, :html]
 
 # Add a format to the existing list
@@ -177,7 +194,7 @@ Skunk::Config.add_format(:html)
 Skunk::Config.remove_format(:json)
 
 # Check supported formats
-Skunk::Config.supported_formats # => [:json, :html]
+Skunk::Config.supported_formats # => [:json, :html, :console]
 Skunk::Config.supported_format?(:json) # => true
 
 # Reset to defaults

lib/skunk/cli/options/argv.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "rubycritic/cli/options/argv"
+require "skunk/config"
 
 module Skunk
   module Cli
@@ -26,6 +27,10 @@ def parse
               self.output_filename = filename
             end
 
+            opts.on("-f", "--formats x,y,z", Array, "Output formats: json,html,console") do |list|
+              Skunk::Config.formats = Array(list).map(&:to_sym)
+            end
+
             opts.on_tail("-v", "--version", "Show gem's version") do
               self.mode = :version
             end

test/lib/skunk/cli/options/argv_test.rb

@@ -24,4 +24,20 @@
       end
     end
   end
+
+  describe "#formats" do
+    context "passing --formats option" do
+      let(:argv) { ["--formats=json,html"] }
+
+      it "applies formats to Skunk::Config" do
+        begin
+          parser = Skunk::Cli::Options::Argv.new(argv)
+          parser.parse
+          _(Skunk::Config.formats).must_equal %i[json html]
+        ensure
+          Skunk::Config.reset
+        end
+      end
+    end
+  end
 end

test/lib/skunk/commands/help_test.rb

@@ -12,6 +12,7 @@
         Usage: skunk [options] [paths]
             -b, --branch BRANCH              Set branch to compare
             -o, --out FILE                   Output report to file
+            -f, --formats x,y,z              Output formats: json,html,console
             -v, --version                    Show gem's version
             -h, --help                       Show this message
       HELP