HttpRepl

• Adds support for running HttpRepl on .NET 7
• Removes support for running HttpRepl on .NET Core 3.1, as .NET Core 3.1 is out of support as of December 13, 2022.
• Shared assemblies now target .NET 6 (minimum supported runtime for the tool) instead of .NET Standard 2.0

Available via nuget

To update from your favorite shell, run:

dotnet tool update --global microsoft.dotnet-httprepl --version 7.0.0

Available via nuget

Another bugfix release related to console handling:

• FIX: Deleting a character in a command, other than the last character, causes the cursor to jump

Available via nuget

To update from your favorite shell, run:

dotnet tool update --global microsoft.dotnet-httprepl --version 5.0.2

Bugfix release including one fix for issues involving console handling:

• FIX: User might experience ArgumentOutOfRangeException and/or improper input and cursor handling when running HttpRepl in some virtualized terminals (#443)

Available via nuget

To update from your favorite shell, run:

dotnet tool update --global microsoft.dotnet-HttpRepl --version 5.0.1

This is a preview of a bugfix release for an impactful console handling bug. Please give this build a chance and let us know both if the bug is fixed and if you run into any other cursor handling and input issues that may be related.

• FIX: User might experience ArgumentOutOfRangeException and/or improper input and cursor handling when running HttpRepl in some virtualized terminals (#443)

Available via nuget

To update from your favorite shell, run:

dotnet tool update --global microsoft.dotnet-HttpRepl --version 5.0.1-preview.20611.1

Final release of 5.0.0. No functional changes after the last prerelease build.

• Query of all PRs included since the 3.1 release
• v5.0.0-preview.20559.6 Release Notes
• v5.0.0-preview.20559.3 Release Notes
• v5.0.0-preview.20552.2 Release Notes
• v5.0.0-preview.20527.2 Release Notes
• v5.0.0-preview.20526.6 Release Notes
• v5.0.0-preview.20521.1 Release Notes
• v5.0.0-preview.20513.2 Release Notes
• v5.0.0-preview.20460.1 Release Notes
• v5.0.0-preview.20418.1 Release Notes
• v5.0.0-preview.20559.6 Release Notes

Available via nuget

To update from your favorite shell, run:

dotnet tool update microsoft.dotnet-httprepl --version 5.0.0 --global

If you don't have the tool installed yet, run:

dotnet tool install microsoft.dotnet-httprepl --version 5.0.0 --global

Note that the --version 5.0.0 argument is optional - the latest non-prerelease version will be installed if you don't specify a version.

A quick update that moves us to the final .NET 5 SDK (#428) and updates a few of our dependencies to the latest (#431).

Available via nuget

To update from your favorite shell, run:

dotnet tool update microsoft.dotnet-httprepl --version 5.0.0-preview.20559.6 --global

If you don't have it installed yet and want to try it for the first time before the final release of 5.0, run:

dotnet tool install microsoft.dotnet-httprepl --version 5.0.0-preview.20559.6 --global

This will likely be the final preview release with new features before 5.0 hits.

• NEW: The --verbose option on the connect command will now display OpenAPI validation information when attempting to process the OpenAPI Description.
• CHANGE: Removed the --response option from all HTTP Commands. This option was intended to save both the headers and the body of the message to the same file, but it never worked properly. Since there were unanswered questions about how this should be done (what is the proper way to concatenate those two different pieces of data?) and since it had not worked since release, we opted to cut it from the featureset for now (#426)

Available via nuget

• NEW: Added swagger.addToSearchPaths and swagger.removeFromSearchPaths preferences to enable more fine-grained control of the OpenAPI search paths (#360)
• CHANGE: Exceptions thrown by the underlying HttpClient when executing HTTP requests used to be displayed as a full error message + stack trace that took up the whole screen. We now handle those errors more appropriately and display just the message if necessary (#304)

Available via nuget

• FIX: The pref get and set header commands could throw exceptions under some circumstances (#420)

Available via nuget

A nice little batch of updates in this release as we get towards the 5.0 release in a couple of weeks:

• NEW: Added a httpClient.proxy.useDefaultCredentials preference that enables working with proxies that require default credentials for authentication (#305)
• NEW: The tool will now provide a notice to any user who specifies VS Code as their default editor, telling the user they should add the -w or --wait argument to the editor arguments preference (#310)
• NEW: Added a --verbose option to the connect command. When that option is provided, the connect command will display more detailed information about its attempts to find and process the OpenAPI Description document via the other arguments and options presented to the command (#373)
• CHANGE: We've removed the help {url} form of the help command in favor of displaying the same information using the list command with a verbose flag (ls --verbose or dir --verbose) (#70)
• FIX: We fixed an issue where arguments of commands with more than one form (e.g. the list command, which can be either ls or dir) are not parsed correctly (#409)
• FIX: We fixed an issue where the formatting of HTTP request methods was inconsistent in the list command with the recursive option (#410)

Available via nuget

This release includes one change:

• FIX: We fixed an issue with the help command that caused it to show an error or incomplete information (#403)

Available via nuget

In addition to updating the repo to use the latest .NET 5 SDKs (first RC1, then RC2) the primary thing this release adds is telemetry.

One focus for our post-5.0 work is going to be the usability of our existing commands and command syntax. We're working closely with customers to gather feedback, but we'd also like to get a feel for how the tool is being used "in the wild".

For more information on the telemetry we're collecting, take a look at the telemetry page of the repo. Like other .NET CLI tools, you can opt-out from the telemetry using the method outlined on that page.

Available via nuget.

A small update with just one change to accommodate the upcoming .NET 5 RC1 release:

• CHANGE: Automatically strip "/swagger" from the root url passed to the connect command. This enables a more seamless default F5 experience with the latest dotnet new webapi template (#386)

Available via nuget.

In this first preview release of 5.0.0, we're excited to give you a first look at the new parsing capabilities enabled by our use of OpenAPI.NET. The big news here is that we can now handle a much wider range of OpenAPI description documents than the custom parser we previously used could handle. That includes full support for YAML descriptions as well as the existing JSON format support.

Here's the full changelog for this preview:

• ADD: Support for YAML OpenAPI descriptions (#347)
• REMOVE: We no longer support v1 Swagger descriptions. Please see the issue for more information. If this presents a problem for you, file an issue and let us know your scenario (#347)
• FIX: We fixed an issue where using the windows clipboard history to paste into the REPL would cause invalid input (#374)

Available via nuget.

Final release of 3.1.0. No additional changes after the two prerelease builds. Please see those release notes for details:

• v3.1.0-preview.20354.1
• v3.1.0-preview.20380.2

Available via nuget.

Adding one additional bug fix to the 3.1 release:

• FIX: Extra spaces between parameters should not cause command parsing to fail (#365)

Available via nuget.

Our first pre-release build of the work we're doing for 3.1, which is mostly a bug fix release.

• FIX: Don't duplicate headers when sending a body with the request (#237)
• FIX: Show friendlier error messages when specified default editor is not found (#213)
• FIX: Allow the AltGr key to be used for character input (#226)
• FIX: Handle more character encodings when available (#238)
• CHANGE: The --swagger option on the connect command is now deprecated, with the preferred option being --openapi. We will consider removing --swagger in 4.0, but for now it is still available (#346)
• CHANGE: Drop support for .NET Core 3.0 (since it is out of support) and add support for .NET Core 3.1 (LTS version) and .NET 5 (#348)
• ADD: Add openapi.json and /openapi.json to the well-known search paths (#248)

Available via nuget.

First official release of HttpRepl!

To install on a machine with .Net Core 2.1 or higher:

dotnet tool install -g Microsoft.dotnet-httprepl

For full information on the features of HttpRepl and how to use it, please see the documentation.

Updated preview release.

• Updated the in-app documentation for the ui command to reflect the changes made in #209.

Available via NuGet.