{"id":16537950,"url":"https://github.com/jamesmcroft/swagger-merge","last_synced_at":"2025-10-25T01:11:07.381Z","repository":{"id":39708077,"uuid":"485239804","full_name":"jamesmcroft/swagger-merge","owner":"jamesmcroft","description":"A CLI \u0026 SDK to merge multiple Swagger files together","archived":false,"fork":false,"pushed_at":"2024-08-14T19:06:19.000Z","size":246,"stargazers_count":14,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-01T05:11:24.398Z","etag":null,"topics":["api","documentation","dotnet","json","openapi","sdk","swagger","swagger2"],"latest_commit_sha":null,"homepage":"","language":"C#","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/jamesmcroft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["jamesmcroft"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["buymeacoffee.com/jamesmcroft"]}},"created_at":"2022-04-25T05:51:42.000Z","updated_at":"2024-08-19T12:10:37.000Z","dependencies_parsed_at":"2023-02-17T09:46:13.776Z","dependency_job_id":"bcd410d8-e25e-4cfa-ba38-6eab5ec9f269","html_url":"https://github.com/jamesmcroft/swagger-merge","commit_stats":{"total_commits":18,"total_committers":3,"mean_commits":6.0,"dds":0.5,"last_synced_commit":"8a1c776c680fd74db6bd7d52ee39fec773bab9c2"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmcroft%2Fswagger-merge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmcroft%2Fswagger-merge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmcroft%2Fswagger-merge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmcroft%2Fswagger-merge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamesmcroft","download_url":"https://codeload.github.com/jamesmcroft/swagger-merge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244130269,"owners_count":20402753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","documentation","dotnet","json","openapi","sdk","swagger","swagger2"],"created_at":"2024-10-11T18:44:04.243Z","updated_at":"2025-10-25T01:11:02.337Z","avatar_url":"https://github.com/jamesmcroft.png","language":"C#","funding_links":["https://github.com/sponsors/jamesmcroft","buymeacoffee.com/jamesmcroft"],"categories":[],"sub_categories":[],"readme":"# Swagger Merge\n\n[![GitHub release](https://img.shields.io/github/release/jamesmcroft/swagger-merge.svg)](https://github.com/jamesmcroft/swagger-merge/releases)\n[![Build status](https://github.com/jamesmcroft/swagger-merge/actions/workflows/ci-sdk.yml/badge.svg?branch=main)](https://github.com/jamesmcroft/swagger-merge/actions/workflows/ci-sdk.yml)\n[![.NET Tool](https://img.shields.io/nuget/v/SwaggerMerge?label=dotnet%20tool)](https://www.nuget.org/packages/SwaggerMerge/)\n[![SDK](https://img.shields.io/nuget/v/SwaggerMerge.SDK?label=sdk)](https://www.nuget.org/packages/SwaggerMerge.SDK/)\n\nThe Swagger Merge SDK \u0026 CLI tool allows you to process the merging of multiple Swagger files into a single Swagger file. This is useful for bringing together the API layer of a distributed service architecture where you wish to expose the APIs via a single API gateway.\n\nThe CLI tool currently supports merging Swagger V2 specification JSON files. It is not yet capable of merging Swagger V3 specification JSON or YAML files.\n\n## Getting started\n\n### Install the tool\n\nIf you want to just use the tool to merge your Swagger files, you can install and use the Swagger Merge CLI tool.\n\n```bash\ndotnet tool install -g SwaggerMerge\n```\n\n**Or update an existing install**\n\n```bash\ndotnet tool update -g SwaggerMerge\n```\n\nTo use the tool, [follow the Swagger Merge CLI tool instructions](https://github.com/jamesmcroft/swagger-merge/blob/main/src/SwaggerMerge/README.md).\n\n### Get the SDK\n\nIf you want to build your own applications on the Swagger Merge SDK that backs the CLI tool, you can install the Swagger Merge SDK into your dotnet application.\n\n```bash\ndotnet add package SwaggerMerge.SDK\n```\n\nOr by adding the `SwaggerMerge.SDK` package in your NuGet package manager of choice.\n\nTo use the SDK, [follow the Swagger Merge SDK instructions](https://github.com/jamesmcroft/swagger-merge/blob/main/src/SwaggerMerge.SDK/README.md).\n\n## Contributing 🤝🏻\n\nContributions, issues and feature requests are welcome!\n\nFeel free to check the [issues page](https://github.com/jamesmcroft/swagger-merge/issues). You can also take a look at the [contributing guide](https://github.com/jamesmcroft/swagger-merge/blob/main/CONTRIBUTING.md).\n\nWe actively encourage you to jump in and help with any issues, and if you find one, don't forget to log it!\n\n## Support this project 💗\n\nAs many developers know, projects like this are built and maintained in maintainers' spare time. If you find this project useful, please **Star** the repo.\n\n## Author\n\n👤 **James Croft**\n\n- Website: \u003chttps://www.jamescroft.co.uk\u003e\n- Github: [@jamesmcroft](https://github.com/jamesmcroft)\n- LinkedIn: [@jmcroft](https://linkedin.com/in/jmcroft)\n\n## License\n\nThis project is made available under the terms and conditions of the [MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesmcroft%2Fswagger-merge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamesmcroft%2Fswagger-merge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesmcroft%2Fswagger-merge/lists"}