Rcurl

rcurl is a simple, powerful command-line tool for transferring data with URLs, inspired by cURL, and built in Rust.

Features

• Support for HTTP/1.1, HTTP/2, and HTTP/2 with prior knowledge
• Customizable HTTP methods (GET, POST, etc.)
• Sending custom request body and form data
• Custom headers, user-agent, cookies, and referrer
• User authentication
• Support for PEM certificates and insecure connections
• File downloads and uploads
• Byte range support
• Verbose mode for debugging (-v, -vv)
• Request timing breakdown (--time)
• Proxy support (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY)
• Quick commands: ping, disk, telnet, DNS lookup, WHOIS, port query
• Interactive mode with request history

rcurl vs curl

rcurl is a modern reimagining of curl, built with Rust for enhanced safety, better developer experience, and extended functionality.

Why choose rcurl?

• Modern & Safe: Built with Rust for memory safety and reliability, eliminating entire classes of security vulnerabilities
• Better DX: Interactive mode with request history, colored output, and intuitive shortcuts for daily workflows
• Enhanced Insights: Detailed timing breakdown (DNS lookup, TCP handshake, TLS negotiation, transfer) for performance debugging
• All-in-One: Network diagnostics (ping, DNS, whois, telnet) integrated—no need to switch tools
• Drop-in Replacement: Compatible with curl's most-used options while adding powerful new features

Installation on Linux (Quick Start)

For Linux users, the quickest way to get started is by downloading the pre-compiled binary directly from GitHub Releases. This method does not require you to have the Rust toolchain installed.

Download the Latest Release

curl -L -o rcurl https://github.com/lsk569937453/rcurl/releases/download/v0.0.27/rcurl-x86_64-unknown-linux-gnu
chmod +x ./rcurl

Installation

Install via Cargo

If you have Rust and Cargo installed, you can install rcurl directly from crates.io:

cargo install cargo-rcurl

Build from Source

Alternatively, you can install rcurl by cloning this repository and building it with Cargo:

git clone https://github.com/lsk569937453/rcurl.git
cd rcurl
cargo install --path .

Usage

Examples

HTTP/HTTPS Requests

Make a simple GET request:

rcurl http://www.google.com

Download a webpage to a file:

rcurl -o google.html http://www.google.com

Send POST form data:

rcurl -X POST -d "param1=value1&param2=value2" http://httpbin.org/post

Send JSON data with a custom header:

rcurl -X POST -d '{"name":"John Doe"}' -H "Content-Type: application/json" http://httpbin.org/post

View only the response headers (HEAD request):

rcurl -I http://www.google.com

Use a custom user-agent:

rcurl -A "MyCoolBrowser/1.0" http://httpbin.org/user-agent

Download a specific byte range:

rcurl -r 0-1023 http://example.com/file.zip -o partial_file.zip

Show request timing breakdown:

rcurl https://example.com --time

Verbose mode for debugging:

rcurl -v http://example.com          # Debug level
rcurl -vv https://example.com        # Trace level

FTP/FTPS/SFTP

FTP request:

rcurl ftp://ftp.example.com

FTPS (FTP over TLS):

rcurl ftps://ftp.example.com

SFTP with authentication:

rcurl -u user:pass ftp://ftp.example.com

Quick Commands

Ping a host:

rcurl ping google.com
rcurl p 8.8.8.8          # Shorthand

DNS lookup (like dig):

rcurl ns google.com

WHOIS lookup for domain information:

rcurl whois google.com
rcurl w example.com      # Shorthand
rcurl whois 8.8.8.8       # IP lookup

Check disk size:

rcurl disk .             # Current directory
rcurl d /home            # Specific path (shorthand)

Telnet to a host:port:

rcurl telnet example.com 80
rcurl t 192.168.1.1 23   # Shorthand

Port query - list all listening ports:

rcurl port                # List all listening ports
rcurl l                   # Shorthand

Port query - find process by port:

rcurl port 8080           # Find process using port 8080

Port query - kill process by port:

rcurl port 3000 --kill    # Kill process using port 3000

Options

Below is a complete list of available command-line options:

Quick Commands

Proxy Support

Set environment variables to use proxy:

# Unix/Linux/MacOS
export ALL_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY=example.com,localhost

# Windows CMD
set ALL_PROXY=http://127.0.0.1:7890

# Windows PowerShell
$env:ALL_PROXY='http://127.0.0.1:7890'

Disable proxy for a single request:

rcurl https://example.com --noproxy

Interactive Mode

When no URL or command is provided, rcurl enters interactive mode, allowing you to select and execute previous requests from history:

rcurl

Contributing

Contributions are welcome! Feel free to fork the repository, make your changes, and submit a pull request.

License

This project is licensed under the Apache License.