funURL

README

funURL

funURL is a command-line tool designed as a Swiss Army knife for URLs. It takes a URL as input (via stdin, command-line flags, or arguments) and provides a range of operations for parsing, validation, modification, encoding/decoding, and handling URLs efficiently.

Requirements

• Golang 1.18+

Features

URL Parsing

Extract specific components from a URL:

# Parse all URL components
funURL parse https://subdomain.vulnerabletarget.com/path?query=value#fragment

# Extract specific components
funURL parse -c https://vulnerabletarget.com     # Extract protocol/scheme
funURL parse -s https://subdomain.vulnerabletarget.com    # Extract subdomain
funURL parse -t https://vulnerabletarget.com     # Extract top-level domain
funURL parse -n https://vulnerabletarget.com     # Extract hostname
funURL parse -p https://vulnerabletarget.com/path    # Extract path
funURL parse -q https://vulnerabletarget.com/?key=value    # Extract query parameters
funURL parse -f https://vulnerabletarget.com/#section    # Extract fragments

URL Modification

Add, remove, or update URL components:

# Change protocol
funURL modify -c https http://vulnerabletarget.com

# Update path
funURL modify -p /new/path https://vulnerabletarget.com/old/path

# Change query string
funURL modify -q "key1=value1&key2=value2" https://vulnerabletarget.com?old=param

# Update fragment
funURL modify -f "new-section" https://vulnerabletarget.com#old-section

URL Encoding

Encode URLs or URL components:

# Path-encode a URL
funURL encode "hello world"

# Query component encoding
funURL encode -c "param=value with spaces"

URL Decoding

Decode URLs or URL components:

# Path-decode a URL
funURL decode "hello%20world"

# Query component decoding
funURL decode -c "param%3Dvalue%20with%20spaces"

Input Methods

funURL supports multiple ways to provide input:

1. Via command-line argument:

   funURL parse https://vulnerabletarget.com
   

2. Via the --url flag:

   funURL parse --url https://vulnerabletarget.com
   

3. Via standard input (pipe or interactive):

   echo "https://vulnerabletarget.com" | funURL parse
   # Or
   funURL parse  # Then type the URL and press Enter
   

Examples

# Parse a URL and extract all components
funURL parse https://user:pass@sub.vulnerabletarget.com:8080/path/to/page?query=string#fragment

# Encode a query parameter
funURL encode -c "search=special chars: &?=+"

# Decode a path component
funURL decode "my%20encoded%20path"

# Change protocol and path in one command
funURL modify -c https -p /new/path http://vulnerabletarget.com/old

Contributing

Hack! don't forget to follow CONTRIBUTING

---