Swagcov

See OpenAPI documentation coverage report for Rails Routes.

Installation

Add this line to your application's Gemfile:

gem "swagcov"

Execute:

bundle

Create a .swagcov.yml in root of your Rails application.

• Add the paths of your openapi yml files (required):

  docs:
    paths:
      - swagger/v1/swagger.yaml

• Add only routes (optional) :

  routes:
    paths:
      only:
        - ^/v1

• Add ignore routes (optional) :

  routes:
    paths:
      ignore:
        - /v1/foobar/:token

• Example .swagcov.yml Config File:

  docs:
    paths:
      - swagger/v1/swagger.yaml
  
  routes:
    paths:
      only:
        - ^/v1
      ignore:
        - /v1/foobar/:token

Execute:

bundle exec rake swagcov

Example configurations and output from running bundle exec rake swagcov from the root of your Rails Application:

• All Routes (minimal configuration):

  docs:
    paths:
      - swagger.yaml

  

• With only endpoint configuration:

  docs:
    paths:
      - swagger.yaml
  
  routes:
    paths:
      only:
        - ^/v2

  

• With ignore and only endpoint configurations:

  docs:
    paths:
      - swagger/v1/swagger.yaml
  
  routes:
    paths:
      only:
        - ^/v2
      ignore:
        - /v2/users

  

Development

git clone git@github.com:smridge/swagcov.git

Add this line to your application's Gemfile:

 # Use the relative path from your application, to the swagcov folder
gem "swagcov", path: "../swagcov"

bundle

Run Tests

bundle exec rspec spec --exclude-pattern spec/sandbox_5_2/**/*_spec.rb

Test via Sandbox Application

For Rails 5

• cd spec/sandbox_5_2/
• Run tests: bundle exec rspec spec
• Run bundle exec rake swagcov
  • This will run against any changes made to your branch.

Publish (internal)

Note: Publishing a new version of this gem is only meant for maintainers.

• Ensure you have access to publish on rubygems.
• Update CHANGELOG.
• Update VERSION.
• Commit changes to main branch locally.
• Run: rake release
  • This command builds the gem, creates a tag and publishes to rubygems, see bundler docs.

TODO

• Add specs
• Test against different rails versions
• Create Sandbox App for Rails 6
• Add autogeneration of ignore paths
• Add CONTRIBUTING.md
• Add GitHub Actions for specs/linting

Credit

To @lonelyelk for initial development!