Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vschwaberow/rexturl
A simple tool in Rust to split urls in their protocol, host, port, path and query parts.
https://github.com/vschwaberow/rexturl
Last synced: about 2 months ago
JSON representation
A simple tool in Rust to split urls in their protocol, host, port, path and query parts.
- Host: GitHub
- URL: https://github.com/vschwaberow/rexturl
- Owner: vschwaberow
- License: mit
- Created: 2022-09-16T05:39:40.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T04:14:47.000Z (9 months ago)
- Last Synced: 2024-04-26T04:17:46.021Z (9 months ago)
- Language: Rust
- Size: 25.4 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rexturl
A versatile command-line tool for parsing and manipulating URLs.
## Features
- Extract specific URL components (scheme, username, host, port, path, query, fragment)
- Custom output formatting
- JSON output support
- Sorting and deduplication of results
- Process multiple URLs from command line or stdin
## Installation
```bash
cargo install rexturl
```
or clone the repository and build from source:
```bash
git clone https://github.com/vschwaberow/rexturl.git
cd rexturl
cargo build --release
```
## Usage
```bash
rexturl [OPTIONS] [URLS...]
```
If no URLs are provided, rexturl will read from stdin.
## Options
`--urls ` Input URLs to process
`--scheme` Extract and display the URL scheme
`--username` Extract and display the username from the URL
`--host` Extract and display the hostname
`--port` Extract and display the port number
`--path` Extract and display the URL path
`--query` Extract and display the query string
`--fragment` Extract and display the URL fragment
`--sort` Sort the output
`--unique` Remove duplicate entries from the output
`--json` Output results in JSON format
`--all` Display all URL components
`--custom` Enable custom output mode
`--domain` Extract the domain
`--format ` Custom output format (default: "{scheme}://{host}{path}")
`-h`, `--help` Print help information
`-V`, `--version` Print version information
## Examples
1. Extract all components from a single URL:
```bash
rexturl --all https://user:[email protected]:8080/path?query=value#fragment
```
2. Extract host and port from multiple URLs:
```bash
rexturl --host --port https://example.com https://api.example.com:8443
```
3. Process URLs from a file, extracting paths and sorting results:
```bash
cat urls.txt | rexturl --path --sort
```
4. Use custom output format:
```bash
rexturl --custom --format "{scheme}://{host}:{port}{path}" https://example.com:8080/api
```
5. Output results in JSON format:
```bash
rexturl --json --all https://example.com https://api.example.com
```
6. Sort and deduplicate results:
```bash
echo -e "https://example.com\nhttps://example.com\nhttps://api.example.com" | rexturl --host --sort --unique
```
## Custom Output Format
When using `--custom` and `--format`, you can use the following placeholders:
- `{scheme}`
- `{username}`
- `{host}`
- `{domain}`
- `{port}`
- `{path}`
- `{query}`
- `{fragment}`
Example:
```bash
rexturl --custom --format "Host: {host}, Path: {path}"
https://example.com/api
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.