DanielGSmith.OpenApiTools 1.0.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet tool install --global DanielGSmith.OpenApiTools --version 1.0.1
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local DanielGSmith.OpenApiTools --version 1.0.1
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=DanielGSmith.OpenApiTools&version=1.0.1
                    


                    

                
nuke :add-package DanielGSmith.OpenApiTools --version 1.0.1

openapi-tools

A dotnet global tool for discovering, validating, diffing, merging, and transforming OpenAPI (Swagger) JSON and YAML documents.

Installation

# From GitHub Packages
# Authenticate to the feed first if you have not already added it locally.
dotnet tool install --global DanielGSmith.OpenApiTools --add-source https://nuget.pkg.github.com/danielgsmith/index.json

Package id: DanielGSmith.OpenApiTools

Installed command: openapi-tool

Commands

Command Description
help Shows help for the application or a specific command
validate Validates an OpenAPI document against the specification
convert Converts an OpenAPI document between JSON and YAML
discover Recursively scans a directory and identifies OpenAPI documents
endpoints Lists all endpoints (paths and operations) in a document
stats Shows overview statistics for a document
search Fuzzy searches endpoints, schemas, and other components
describe endpoint Describes a specific endpoint in detail
describe schema Describes a specific schema in detail
unused Finds unused/orphaned components
lint Lints a document against a configurable ruleset
diff Diffs two documents and identifies breaking changes
resolve Resolves all $ref references into a single document
split Splits a monolithic document into multiple component files
merge Merges multiple documents into a single unified specification

See the full documentation for detailed usage of each command.

Usage

openapi-tool validate ./openapi.yaml
openapi-tool convert ./openapi.yaml --format json -o openapi.json
openapi-tool diff ./v1.yaml ./v2.yaml --breaking-only
openapi-tool merge --title "Platform API" --version "1.0" -o merged.json api1.yaml api2.yaml
openapi-tool merge --schema-conflict rename-incoming --schema-identical warn-and-dedupe --title "Platform API" --version "1.0" api1.yaml api2.yaml

Run openapi-tool --help to list all available commands.

Development

dotnet build
dotnet test
dotnet pack src/OpenApiTools/OpenApiTools.csproj -c Release

CI validates packaging by installing the packed tool and smoke testing it:

dotnet pack src/OpenApiTools/OpenApiTools.csproj -c Release -o artifacts
dotnet tool install --tool-path ./.tools DanielGSmith.OpenApiTools --add-source ./artifacts
./.tools/openapi-tool --help
./.tools/openapi-tool merge --help

Versioning

Package and assembly versions are managed automatically with Nerdbank.GitVersioning.

  • The version root is defined in version.json
  • CI and publish builds require full git history (fetch-depth: 0)
  • Release tags should use the v prefix, for example v0.1.0

Running locally without installing

# Direct invocation
dotnet run --project src/OpenApiTools/OpenApiTools.csproj -- validate samples/petstore.yaml

# Or add a shell alias (in ~/.zshrc) for a native-feeling dev loop:
alias openapi-tool="dotnet run --project $(pwd)/src/OpenApiTools/OpenApiTools.csproj --no-build --"

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.1 146 6/29/2026
0.1.5 126 6/25/2026