swagcov 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6982166b311ad4760552a4d9b867dd0933b08f67e27da868a5b679e3cf93e4f4
-  data.tar.gz: 27bf743505dd26ce0180e1cfb47cdaba3b08690b746a5577b47e9e3e0f821026
+  metadata.gz: 8f7e8120c6da2d859ae0712f523ee0586e9e800c842594ef89c7fdaed3a28ee0
+  data.tar.gz: c884efd95e1dc61fba493ba731633087baf546612a00a83489f3d4abc7c38cff
 SHA512:
-  metadata.gz: df6f5c0dcd71a4f71954f40c818a831584a964983790bbb25e9aa335f569453b41cd6d6d1a5dc092389dc061338e90e3a44907cbf2c77016f7e43faae0ac2ca6
-  data.tar.gz: e27a24e341a0fee8d7122c92e778543c9dd64de52b9b7ad74a60f60c808ac96aed4b779945f15221560803094fffe131ebedb72f5a4440b7ad5be54d6ad94034
+  metadata.gz: d000402186ba36251cbdc689374979e863dce7b23f154837eba4e177bc484de337bf4928cc8d547bd71d20b7db323ab08cc378590871b2502c72a2398b8749e6
+  data.tar.gz: 74144d434fd8ba835564b3fc92a9a63b318b74c438390213a9cd62cfba0705666464d3363d3d732eff05b46ddacb9105547352310ffeb7e166e5a5834efccba3

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 ## main (unreleased)
 -
 
+## 0.10.0 (2025-05-08)
+### Enhancement
+- Added executable for streamlined command line usage ([#120](https://github.com/smridge/swagcov/pull/120))
+  - The below options are now available:
+    ```
+    swagcov
+    swagcov --init
+    swagcov --todo
+    swagcov --help
+    ```
+  - **Note**: This is experimental as it may not work for all use cases. Use `rake swagcov` as a fallback
+- Added command line options to the existing `rake swagcov` task ([#121](https://github.com/smridge/swagcov/pull/121), [#122](https://github.com/smridge/swagcov/pull/122), [#123](https://github.com/smridge/swagcov/pull/123))
+  - The below options are now available:
+    ```
+    rake swagcov
+    rake swagcov -- --init
+    rake swagcov -- --todo
+    rake swagcov -- --help
+    ```
+  - **Note**: This refactor involved `BREAKING CHANGES`:
+    - `rake swagcov:generate_todo` is now `rake swagcov -- --todo`
+    - `rake swagcov:install` is now `rake swagcov -- --init`
+
 ## 0.9.0 (2025-05-07)
 ### Enhancement
 - Add support for `.json` OpenAPI file types ([#112](https://github.com/smridge/swagcov/pull/112), [#113](https://github.com/smridge/swagcov/pull/113))

data/README.md

@@ -9,17 +9,32 @@
 ![CodeQL Build](https://github.com/smridge/swagcov/actions/workflows/codeql-analysis.yml/badge.svg)
 [![Coverage Status](https://coveralls.io/repos/github/smridge/swagcov/badge.svg?branch=main)](https://coveralls.io/github/smridge/swagcov?branch=main)
 
-See OpenAPI documentation coverage report for Rails Routes.
+OpenAPI documentation coverage report for Rails Routes.
 
 ## Usages
 - See overview of different endpoints covered, missing and what you choose to ignore.
-- Add pass/fail to your build pipeline when missing Documentation Coverage.
+- Add pass/fail to your build pipeline when missing documentation coverage.
 
-| `rake task` | `rails console` | Description |
-| :--- | :--- | :--- |
-| `rake swagcov` | `Swagcov::Command::ReportCoverage.new.run` | Check OpenAPI documentation coverage for Rails Route endpoints |
-| `rake swagcov:install` | `Swagcov::Command::GenerateDotfile.new.run` | Generate required `.swagcov.yml` config file |
-| `rake swagcov:generate_todo` | `Swagcov::Command::GenerateTodoFile.new.run` | Generate optional `.swagcov_todo.yml` config file |
+**Check OpenAPI documentation coverage for Rails Route endpoints**
+| `executable    ` | `rake task             ` | `rails console                             ` |
+| :---             | :---                     | :---                                         |
+| `swagcov`        | `rake swagcov`           | `Swagcov::Command::ReportCoverage.new.run`   |
+
+**Generate required `.swagcov.yml` config file**
+| `executable    ` | `rake task             ` | `rails console                             ` |
+| :---             | :---                     | :---                                         |
+| `swagcov --init` | `rake swagcov -- --init` | `Swagcov::Command::GenerateDotfile.new.run`  |
+
+
+**Generate optional `.swagcov_todo.yml` config file**
+| `executable    ` | `rake task             ` | `rails console                             ` |
+| :---             | :---                     | :---                                         |
+| `swagcov --todo` | `rake swagcov -- --todo` | `Swagcov::Command::GenerateTodoFile.new.run` |
+
+**See command line usage options**
+| `executable    ` | `rake task             ` | `rails console                             ` |
+| :---             | :---                     | :---                                         |
+| `swagcov --help` | `rake swagcov -- --help` | n/a |
 
 ## Ruby and Rails Version Support
 Versioning support from a test coverage perspective, see [tests.yml](/.github/workflows/tests.yml) for detail

data/exe/swagcov

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Experimental executable
+#
+# Booting rails approach should work for most applications
+# Rake task option as an alternative should always work as expected
+
+# Load logger before rails
+# Fix for booting rails 6.0-7.0 apps (uninitialized constant ActiveSupport::LoggerThreadSafeLevel::Logger)
+require "logger"
+
+require "swagcov"
+
+RAILS_APP_PATH = File.expand_path("config/application", Dir.pwd)
+
+def boot_rails_application!
+  require RAILS_APP_PATH
+  Rails.application.initialize!
+rescue LoadError, NoMethodError
+  warn "Unable to load Rails application, try running `rake swagcov` instead"
+  exit Swagcov::STATUS_ERROR
+end
+
+boot_rails_application!
+
+Swagcov::Runner.new(args: ARGV).run

data/lib/swagcov/dotfile.rb

@@ -2,8 +2,8 @@
 
 module Swagcov
   class Dotfile
-    DEFAULT_CONFIG_FILE_NAME = ".swagcov.yml"
-    TODO_CONFIG_FILE_NAME = ".swagcov_todo.yml"
+    DEFAULT_CONFIG_FILE_NAME = ::ENV.fetch("SWAGCOV_DOTFILE", ".swagcov.yml")
+    TODO_CONFIG_FILE_NAME = ::ENV.fetch("SWAGCOV_TODOFILE", ".swagcov_todo.yml")
 
     def initialize basename: DEFAULT_CONFIG_FILE_NAME, todo_basename: TODO_CONFIG_FILE_NAME, skip_todo: false
       @dotfile = load_yaml(basename, required: true)

data/lib/swagcov/options.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module Swagcov
+  class Options
+    def initialize args: ::ARGV
+      @args = args
+    end
+
+    def define
+      options = {}
+
+      ::OptionParser.new do |opts|
+        opts.banner = <<~MESSAGE
+          Usage:
+          * as executable: swagcov [options]
+          * as rake task: rake swagcov -- [options]
+        MESSAGE
+
+        opts.on("-i", "--init", "Generate required .swagcov.yml config file") do |opt|
+          options[:init] = opt
+        end
+
+        opts.on("-t", "--todo", "Generate optional .swagcov_todo.yml config file") do |opt|
+          options[:todo] = opt
+        end
+      end.parse!(@args)
+
+      options
+    rescue ::OptionParser::InvalidOption => e
+      warn e.message
+      warn "For usage information, use --help"
+      exit ::Swagcov::STATUS_ERROR
+    end
+  end
+end

data/lib/swagcov/runner.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Swagcov
+  class Runner
+    attr_reader :options
+
+    def initialize args: ::ARGV
+      @args = args
+      @options = ::Swagcov::Options.new(args: @args).define
+    end
+
+    def run
+      exit ::Swagcov::Command::GenerateDotfile.new.run if options[:init]
+      exit ::Swagcov::Command::GenerateTodoFile.new.run if options[:todo]
+      exit ::Swagcov::Command::ReportCoverage.new.run
+    end
+  end
+end

data/lib/swagcov/version.rb

@@ -2,6 +2,6 @@
 
 module Swagcov
   module Version
-    STRING = "0.9.0"
+    STRING = "0.10.0"
   end
 end

data/lib/swagcov.rb

@@ -11,7 +11,9 @@ require "swagcov/coverage"
 require "swagcov/dotfile"
 require "swagcov/errors"
 require "swagcov/openapi_files"
+require "swagcov/options"
 require "swagcov/railtie"
+require "swagcov/runner"
 require "swagcov/version"
 
 module Swagcov

data/lib/tasks/swagcov.rake

@@ -2,5 +2,6 @@
 
 desc "Check OpenAPI documentation coverage for Rails Route endpoints"
 task swagcov: :environment do
-  exit Swagcov::Command::ReportCoverage.new.run
+  args = ARGV.drop(2) # Remove "swagcov" and "--" to ignore standard rake arguments
+  Swagcov::Runner.new(args: args).run
 end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: swagcov
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Sarah Ridge
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -25,13 +25,15 @@ dependencies:
         version: '4.2'
 email:
 - sarahmarie@hey.com
-executables: []
+executables:
+- swagcov
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- exe/swagcov
 - lib/swagcov.rb
 - lib/swagcov/command/generate_dotfile.rb
 - lib/swagcov/command/generate_todo_file.rb
@@ -42,11 +44,11 @@ files:
 - lib/swagcov/errors.rb
 - lib/swagcov/formatter/console.rb
 - lib/swagcov/openapi_files.rb
+- lib/swagcov/options.rb
 - lib/swagcov/railtie.rb
+- lib/swagcov/runner.rb
 - lib/swagcov/version.rb
 - lib/tasks/swagcov.rake
-- lib/tasks/swagcov/generate_todo.rake
-- lib/tasks/swagcov/install.rake
 homepage: https://github.com/smridge/swagcov
 licenses:
 - MIT
@@ -72,5 +74,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.8
 specification_version: 4
-summary: OpenAPI documentation coverage for Rails Routes
+summary: OpenAPI documentation coverage report for Rails Route endpoints
 test_files: []

data/lib/tasks/swagcov/generate_todo.rake

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-namespace :swagcov do
-  desc "Generate optional .swagcov_todo.yml config file acting as a TODO list"
-  task generate_todo: :environment do
-    exit Swagcov::Command::GenerateTodoFile.new.run
-  end
-end

data/lib/tasks/swagcov/install.rake

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-namespace :swagcov do
-  desc "Generate required .swagcov.yml config file"
-  task install: :environment do
-    exit Swagcov::Command::GenerateDotfile.new.run
-  end
-end