{"id":50332964,"url":"https://github.com/rspereiratech/openapi-collection-generator-insomnia","last_synced_at":"2026-05-29T11:01:12.135Z","repository":{"id":356572183,"uuid":"1233061484","full_name":"rspereiratech/openapi-collection-generator-insomnia","owner":"rspereiratech","description":"Insomnia collection generator plugin for OpenAPI specifications — converts OpenAPI specs into importable Insomnia v4 exports.","archived":false,"fork":false,"pushed_at":"2026-05-08T17:22:08.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-08T18:37:15.139Z","etag":null,"topics":["api","collection-generator","insomnia","java","java17","openapi","openapi-spec","openapi3","rest-api","swagger"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rspereiratech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-08T14:51:18.000Z","updated_at":"2026-05-08T17:22:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rspereiratech/openapi-collection-generator-insomnia","commit_stats":null,"previous_names":["rspereiratech/openapi-collection-generator-insomnia"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/rspereiratech/openapi-collection-generator-insomnia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspereiratech%2Fopenapi-collection-generator-insomnia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspereiratech%2Fopenapi-collection-generator-insomnia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspereiratech%2Fopenapi-collection-generator-insomnia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspereiratech%2Fopenapi-collection-generator-insomnia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rspereiratech","download_url":"https://codeload.github.com/rspereiratech/openapi-collection-generator-insomnia/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rspereiratech%2Fopenapi-collection-generator-insomnia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33648534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","collection-generator","insomnia","java","java17","openapi","openapi-spec","openapi3","rest-api","swagger"],"created_at":"2026-05-29T11:01:11.052Z","updated_at":"2026-05-29T11:01:12.078Z","avatar_url":"https://github.com/rspereiratech.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openapi-collection-generator-insomnia\n\n[![Build](https://github.com/rspereiratech/openapi-collection-generator-insomnia/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/rspereiratech/openapi-collection-generator-insomnia/actions/workflows/build.yml)\n[![CodeQL](https://github.com/rspereiratech/openapi-collection-generator-insomnia/actions/workflows/codeql.yml/badge.svg?branch=master)](https://github.com/rspereiratech/openapi-collection-generator-insomnia/actions/workflows/codeql.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)\n![Java 17+](https://img.shields.io/badge/Java-17%2B-blue)\n![Maven 3.9+](https://img.shields.io/badge/Maven-3.9%2B-C71A36?logo=apachemaven\u0026logoColor=white)\n![OpenAPI 3.0](https://img.shields.io/badge/OpenAPI-3.0-6BA539?logo=openapiinitiative\u0026logoColor=white)\n![Swagger v3](https://img.shields.io/badge/Swagger-v3-85EA2D?logo=swagger\u0026logoColor=black)\n![Insomnia v4](https://img.shields.io/badge/Insomnia-v4-4000BF?logo=insomnia\u0026logoColor=white)\n[![Donate](https://img.shields.io/badge/Donate-NOWPayments-1A1A1A?logo=bitcoin\u0026logoColor=white)](https://nowpayments.io/donation/rspereiratech)\n\nInsomnia collection generator plugin for OpenAPI specifications — converts\nOpenAPI specs into importable [Insomnia](https://insomnia.rest/) v4 exports.\n\nThis module is the **Insomnia format adapter** in the\n`openapi-collection-generator` family. Given an `OpenAPI` model and a\n`GenerationConfig`, it returns a JSON string that Insomnia can import as a\nworkspace with environments, folders, and HTTP requests.\n\n## What it produces\n\n- An Insomnia export document (`__export_format: 4`) containing:\n  - **One workspace** named after the OpenAPI title (or the configured name).\n  - **One environment per OpenAPI server**, with a `base_url` variable.\n    Global security variables are merged into the first environment.\n  - **One folder per OpenAPI tag**, plus a `Callbacks` folder when callbacks\n    are present, plus a `default` folder for untagged operations.\n  - **One request per operation**, with URL, headers, query parameters, and\n    a body example derived from `examples`, `example`, or the schema.\n- Path parameters are converted from `{petId}` to Insomnia's `:petId`.\n- Deprecated operations are prefixed with `⚠` and get a warning in the\n  description.\n- Vendor extensions can rewrite name/description through the extension chain\n  exposed by the core module.\n\n## Maven coordinates\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.rspereiratech\u003c/groupId\u003e\n    \u003cartifactId\u003eopenapi-collection-generator-insomnia\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0-SNAPSHOT\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nThe version is inherited from the\n[`openapi-collection-generator-parent`](https://github.com/rspereiratech)\nparent POM.\n\n## Quick start\n\nThis module is normally invoked through\n`openapi-collection-generator-maven-plugin`. If you want to use it\nprogrammatically:\n\n```java\nInsomniaCollectionGenerator generator = new InsomniaCollectionGenerator(\n    idGenerator,           // IdGenerator\n    requestBuilder,        // InsomniaRequestBuilder (DefaultInsomniaRequestBuilder)\n    serializer,            // CollectionSerializer\n    securityApplier,       // SecurityApplier\n    serverEnvGenerator);   // ServerEnvironmentGenerator\n\nString insomniaJson = generator.generate(openApi, generationConfig);\n// Save insomniaJson to a file and import it from Insomnia → Application → Import.\n```\n\nAll collaborators are SPIs from `openapi-collection-generator-core`, with\ndefault implementations available in this module under their respective\npackages (`url/`, `header/`, `body/`, `parameter/`, `builder/`,\n`deprecated/`).\n\n## Building\n\n```bash\nmvn clean verify\n```\n\nRequires **Java 17+** and Maven 3.9+. The parent POM and the `-core` module\nmust be installed in your local Maven repository (`mvn install` from the\nmulti-module root) before building this module standalone.\n\n## Documentation\n\n| Document | What it covers |\n|---|---|\n| [docs/configuration.md](docs/configuration.md) | Build configuration, Maven coordinates, parent POM, dependencies |\n| [docs/architecture.md](docs/architecture.md) | High-level design, collaborator pattern, control flow |\n| [docs/components.md](docs/components.md) | Per-package walk-through |\n| [docs/publishing.md](docs/publishing.md) | SNAPSHOT publishing to Sonatype Central, required secrets |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Bug reports and pull requests are\nwelcome — please make sure your change belongs in this module and not in a\nsibling one.\n\nAll participants are expected to follow the\n[Code of Conduct](CODE_OF_CONDUCT.md).\n\n## Security\n\nFound a vulnerability? Please follow the process in [SECURITY.md](SECURITY.md)\nand **do not** open public GitHub issues for security-sensitive reports.\n\n## Support\n\n[![Donate](https://img.shields.io/badge/Donate-NOWPayments-1A1A1A?logo=bitcoin\u0026logoColor=white)](https://nowpayments.io/donation/rspereiratech)\n\nIf this project saves you time, consider supporting development\nvia [NOWPayments](https://nowpayments.io/donation/rspereiratech).\nEvery contribution helps keep it maintained — thank you!\n\n## License\n\n[MIT](LICENSE) © 2026 rspereiratech\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frspereiratech%2Fopenapi-collection-generator-insomnia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frspereiratech%2Fopenapi-collection-generator-insomnia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frspereiratech%2Fopenapi-collection-generator-insomnia/lists"}