CurlDotNet

Originally Posted On: https://www.nuget.org/packages/CurlDotNet

The Industry Standard curl Experience for C# and .NET Developers

CurlDotNet brings the power and simplicity of curl to the .NET ecosystem. Execute curl commands directly in C#, make HTTP requests with curl’s battle-tested reliability, and leverage decades of curl development – all with pure .NET code.

Quick Start with curl for C# and .NET

using CurlDotNet;// Execute curl commands directly in C#var result = await Curl.ExecuteAsync("curl -X GET https://api.github.com/users/octocat -H 'Accept: application/json");// Or use the fluent API for type safetyvar response = await Curl.GetAsync("https://api.github.com/users/octocat") .WithHeader("Accept", "application/vnd.github.v3+json") .ExecuteAsync();// Simple one-liners for common operationsvar json = await Curl.GetJsonAsync("https://api.github.com/users/octocat");

Installation

# .NET CLIdotnet add package CurlDotNet# Package Manager ConsoleInstall-Package CurlDotNet# PackageReference"CurlDotNet" Version="*" />

Why CurlDotNet?

curl Compatibility in .NET

• 100% curl behavior – Your C# code works exactly like curl commands
• Parse any curl command – Copy from documentation and paste into your code
• Industry standard – Used by millions of developers worldwide

Superior to HttpClient

• More features – Proxies, authentication chains, retries, rate limiting
• Better debugging – curl-style verbose output
• Simpler API – One-line operations that would take 20+ lines with HttpClient

Pure .NET Implementation

• No native dependencies – 100% managed C# code
• Universal compatibility – Runs anywhere .NET runs: Windows, Linux, macOS, iOS, Android, IoT devices, Docker, cloud
• Safe and secure – No P/Invoke, no unmanaged memory

Key Features

HTTP/REST Operations

// GET requestvar data = await Curl.GetAsync("https://api.example.com/users");// POST JSONvar user = await Curl.PostJsonAsync("https://api.example.com/users", new { name = "Alice", email = "[email protected]" });// PUT with authenticationawait Curl.PutAsync("https://api.example.com/users/123") .WithBearerToken(token) .WithJson(updatedData) .ExecuteAsync();// DELETEawait Curl.DeleteAsync("https://api.example.com/users/123");// PATCHawait Curl.PatchAsync("https://api.example.com/users/123") .WithJson(new { status = "active" }) .ExecuteAsync();

Authentication Methods

// Bearer Tokenawait Curl.GetAsync("https://api.example.com") .WithBearerToken(token) .ExecuteAsync();// Basic Authawait Curl.GetAsync("https://api.example.com") .WithBasicAuth("username", "password") .ExecuteAsync();// API Keyawait Curl.GetAsync("https://api.example.com") .WithHeader("X-API-Key", apiKey) .ExecuteAsync();// OAuth 2.0await Curl.GetAsync("https://api.example.com") .WithOAuth2(clientId, clientSecret, tokenEndpoint) .ExecuteAsync();

File Operations

// Download with progressawait Curl.DownloadFileAsync("https://example.com/file.zip", "local.zip", progress: (percent) => Console.WriteLine($"{percent}% complete"));// Upload fileawait Curl.UploadFileAsync("https://api.example.com/upload", "document.pdf");// Multipart form uploadawait Curl.PostAsync("https://api.example.com/upload") .WithFile("document", "report.pdf") .WithFormField("description", "Annual report") .ExecuteAsync();

Proxy Support – NEW

CurlDotNet provides comprehensive proxy support for various scenarios:

// HTTP Proxyawait Curl.GetAsync("https://api.example.com") .WithProxy("http://proxy.company.com:8080") .ExecuteAsync();// HTTPS Proxy with authenticationawait Curl.GetAsync("https://api.example.com") .WithProxy("https://proxy.company.com:443") .WithProxyAuth("username", "password") .ExecuteAsync();// SOCKS5 Proxy (Tor, residential proxies)await Curl.GetAsync("https://api.example.com") .WithSocks5Proxy("socks5://localhost:9050") .ExecuteAsync();// Rotating/Backconnect Proxyawait Curl.GetAsync("https://api.example.com") .WithProxy("http://gate.proxy.com:8000") .WithProxyAuth("user-session-random123", "password") .ExecuteAsync();// Proxy with custom headers (for residential/datacenter proxies)await Curl.GetAsync("https://api.example.com") .WithProxy("http://proxy.provider.com:8080") .WithProxyHeader("X-Session-ID", "sticky-session-123") .ExecuteAsync();// No proxy for specific domainsawait Curl.GetAsync("https://internal.company.com") .WithNoProxy("*.company.com,192.168.*") .ExecuteAsync();

Why Use Proxies?

• Privacy & Anonymity – Hide your real IP address
• Geographic Access – Access region-locked content
• Web Scraping – Avoid rate limits and IP bans
• Security Testing – Test from different network locations
• Load Distribution – Spread requests across multiple IPs
• Corporate Networks – Access internet through company proxy

Proxy Types Supported:

• HTTP/HTTPS Proxies – Standard web proxies
• SOCKS4/SOCKS5 – For any TCP connection
• Residential Proxies – Real device IPs for scraping
• Datacenter Proxies – Fast, reliable proxy servers
• Rotating Proxies – Automatic IP rotation
• Backconnect Proxies – Sticky sessions with rotation

Advanced Features

// Retry with exponential backoffawait Curl.GetAsync("https://api.example.com") .WithRetry(maxAttempts: 3) .WithExponentialBackoff() .ExecuteAsync();// Rate limitingawait Curl.GetAsync("https://api.example.com") .WithRateLimit(requestsPerMinute: 60) .ExecuteAsync();// Timeout handlingawait Curl.GetAsync("https://api.example.com") .WithTimeout(TimeSpan.FromSeconds(30)) .WithConnectTimeout(TimeSpan.FromSeconds(10)) .ExecuteAsync();// Follow redirectsawait Curl.GetAsync("https://bit.ly/shortened") .FollowRedirects(maxRedirects: 5) .ExecuteAsync();// Cookie managementvar cookieJar = new CookieContainer();await Curl.GetAsync("https://example.com") .WithCookieContainer(cookieJar) .ExecuteAsync();

Performance & Reliability

• 244 Unit Tests – 100% pass rate
• Self-Contained Testing – No external dependencies
• Cross-Platform CI/CD – Windows, Linux, macOS
• Production Ready – Used in enterprise applications

Platform Support

Platform	Version	Support
.NET	10, 9, 8, 7, 6, 5	Full Support
.NET Core	3.1, 3.0, 2.1	Full Support
.NET Framework	4.7.2+	via .NET Standard 2.0
.NET Standard	2.0+	Maximum Compatibility
Windows	10, 11, Server 2016+	Native
Linux	Ubuntu, Debian, RHEL, Alpine	Native
macOS	10.14+, Apple Silicon	Native
iOS	12+	via .NET Standard/MAUI
Android	API 21+	via .NET Standard/MAUI
IoT	Raspberry Pi, Arduino	via .NET IoT
Docker	All .NET images	Optimized
Azure	Functions, App Service, IoT Hub	Cloud Ready
AWS	Lambda, ECS, IoT Core	Cloud Ready

Cross-Platform Shell Compatibility

CurlDotNet treats Ubuntu/Linux syntax as the canonical source of truth when parsing curl strings, and then normalizes Windows CMD, PowerShell, and macOS variations. Highlights:

• Paste commands directly from Linux/macOS shells (including multi-line \ continuations).
• Windows users can keep familiar %VAR% or $env:VAR environment variables—we expand them transparently.
• Trouble with quoting? See the dedicated guide: curl CLI Compatibility Reference.

When in doubt, author the command in an Ubuntu shell (or WSL), then copy it into your C# source—CurlDotNet will behave exactly like curl.

Documentation

• Full Documentation – Comprehensive guides and tutorials
• API Reference – Complete API documentation
• ‍ Cookbook – Ready-to-use recipes
• Tutorials – Step-by-step learning
• Migration Guides – Move from HttpClient/RestSharp

Tests & Coverage

• dotnet test (net8.0): 255 tests passed – parser, CurlResult, builder, middleware, and integration coverage.
• Parser suite includes Ubuntu, PowerShell, and Windows CMD quoting/env patterns, keeping shell compatibility near 100%.
• Regenerate docs with dotnet script scripts/generate-docs.csx so NuGet + GitHub Pages share the same snippets.
• Framework compatibility: ./scripts/test-framework-compatibility.sh validates .NET Standard 2.0 & .NET 8 builds.

Common Use Cases

REST API Integration

Perfect for consuming REST APIs with minimal code:

var api = new Curl("https://api.example.com") .WithBearerToken(Environment.GetEnvironmentVariable("API_TOKEN"));var users = await api.GetJsonAsync>("/users");var newUser = await api.PostJsonAsync("/users", new { name = "Bob" });

Web Scraping

Handle complex scraping scenarios with ease:

var html = await Curl.GetAsync("https://example.com") .WithUserAgent("Mozilla/5.0...") .WithProxy("http://proxy.com:8080") .GetBodyAsync();

Microservices Communication

Resilient service-to-service calls:

var response = await Curl.GetAsync("http://service-b/api/data") .WithRetry(3) .WithCircuitBreaker() .WithTimeout(TimeSpan.FromSeconds(5)) .ExecuteAsync();

CI/CD and Automation

Execute curl commands from scripts:

var result = await Curl.ExecuteAsync(Environment.GetEnvironmentVariable("CURL_COMMAND"));

Migrating from Other Libraries

From HttpClient

// Before: HttpClientusing var client = new HttpClient();client.DefaultRequestHeaders.Add("Authorization", $"Bearer {token}");var response = await client.GetAsync("https://api.example.com");var content = await response.Content.ReadAsStringAsync();// After: CurlDotNetvar content = await Curl.GetAsync("https://api.example.com") .WithBearerToken(token) .GetBodyAsync();

From RestSharp

// Before: RestSharpvar client = new RestClient("https://api.example.com");var request = new RestRequest("/users", Method.Get);request.AddHeader("Authorization", $"Bearer {token}");var response = await client.ExecuteAsync(request);// After: CurlDotNetvar response = await Curl.GetAsync("https://api.example.com/users") .WithBearerToken(token) .ExecuteAsync();

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

CurlDotNet is MIT licensed. See LICENSE for details.

Why Developers Choose CurlDotNet

“Finally, I can just paste curl commands from API docs!” – Senior Developer

“The proxy support is fantastic for our web scraping needs.” – Data Engineer

“Migrating from HttpClient saved us hundreds of lines of code.” – Tech Lead

“The retry logic and rate limiting just work.” – DevOps Engineer

Getting Started

1. Install the package: dotnet add package CurlDotNet
2. Add using: using CurlDotNet;
3. Make your first request: await Curl.GetAsync("https://api.example.com");

That’s it! You’re now using the power of curl in C# and .NET.

Support

• GitHub Issues – Report bugs or request features
• Discussions – Ask questions and share ideas
• Stack Overflow – Community Q&A

Additional Resources

• Repository – https://github.com/jacob-mellor/curl-dot-net
• NuGet – https://www.nuget.org/packages/CurlDotNet
• CI/CD Integration Guide – https://github.com/jacob-mellor/curl-dot-net/blob/master/docs/articles/ci-cd-integration.md
• Logging & Observability Guide – https://github.com/jacob-mellor/curl-dot-net/blob/master/docs/guides/logging-observability.md
• Shell Compatibility Guide – https://jacob-mellor.github.io/curl-dot-net/reference/index.md

Our Story

Read about how CurlDotNet is bringing curl superpowers to every corner of the .NET 10 & C# stack: Featured Article: CurlDotNet – Bringing curl Superpowers to Every Corner of the .NET 10 & C# Stack

Part of UserLand.NET

CurlDotNet is part of the UserLand.NET initiative – bringing Unix/Linux tools to .NET through pure C# implementations.