Ross ROSS = Recommend OSS · open-source software intelligence for agents

rswag/rswag

Seamlessly adds a Swagger to Rails-based API's observed · 2026-08-28

github.com/rswag/rswag · Ruby · MIT (permissive) observed · 2026-08-28

Health v2 · maintenance only

73/100

  • Activity 99
  • Release rhythm 23
  • Longevity 100
How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.

  • gap_med: 198.5
  • age_days: 4251
  • days_rel: 301
  • days_push: 9
  • n_releases_24m: 3

Full methodology

Adoption not part of the score

2201 stars · 455 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Rswag extends rspec-rails request specs with a Swagger-based DSL for describing and testing Rails API operations, then generates OpenAPI (Swagger) files from passing tests. It also embeds swagger-ui so the generated documentation can be explored and tested from a browser.

Use cases

  • generate OpenAPI documentation from Rails rspec tests
  • document a Rails API with Swagger
  • test API endpoints and produce living documentation
  • serve swagger-ui for a Rails API
  • export API spec as JSON or YAML endpoints
  • keep API docs in sync with integration tests

When to choose

  • you have a Rails API tested with rspec request specs and want auto-generated OpenAPI docs
  • you want documentation that is validated by your test suite
  • you want an embedded swagger-ui powered by your spec files

When to avoid

  • your API is not Rails/Ruby-based
  • you prefer generating specs from an OpenAPI file rather than the reverse
  • you don't use rspec

Facets

library · maturity active

testing api-framework api-documentation documentation web-development backend apis documentation testing ruby rails rspec openapi swagger-ui api-documentation web-server

1 source

Member repositories

RepositoryRoleHealth v2
rswag/rswagmain73

For agents

markdown · JSON · MCP: product_card(name="rswag/rswag")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem