A useful tool to have in your toolbelt is an ability to make web requests and retrieve responses from the command line.
There are many tools that can do this for you, my favourite being these two:
It is the second that I want to turn my attention to.
Curl is a very popular utility that comes installed in many Linux distributions.
If you use tools like Swashbuckle, it generates examples in curl format
If you are developing on Windows, curl is something you will need to install.
On my machine I use the chocolatey package manager
You can install it using
choco install curl
Once it installed and you have reloaded the shell you might do the following
A response will come back as follows
You might say to yourself “mission accomplished”
You would be wrong.
What has in fact happened here is that curl has not run at all!
What has in fact run is the PowerShell cmdlet
Why? Because out of the box PowerShell has a pre-configured alias for this –
You can verify this as follows
You should see the following
So the question is how do we run curl the application?
There are two ways to do it.
The first is to leave PowerShell in no doubt you are referring to an application by providing the extension
You can see the results are very different because curl has (in my opinion) the sensible default of not printing the headers if invoked without parameters.
This technique works but is very tiresome because you have to keep remembering to provide the extension.
The other (more sensible) solution is to remove the curl alias.
You can do this from your profile. Using your favourite text editor, open your profile.
Today we will use Visual Studio Code.
In a PowerShell prompt type the following:
Scroll to the bottom (if your profile already has entries and add this line):
Save the file and then reload the shell – or close and open it again.
Now try and run curl (without the extension)
This second approach makes this change persistent across PowerShell sessions.
If you just want it temporarily you can run
Remove-Item in the current session and it will be reset the next time you start the shell.
You can access the code on my Github.