1
1
.\" You can view this file with:
2
- .\" man -l urler .1
2
+ .\" man -l trurl .1
3
3
.\" Written by Daniel Stenberg
4
4
.\"
5
- .TH urler 1 "31 Mar 2023" "urler 0.1" "urler Manual"
5
+ .TH trurl 1 "31 Mar 2023" "trurl 0.1" "trurl Manual"
6
6
.SH NAME
7
- urler \- parse and manipulate URLs
7
+ trurl \- transpose URLs
8
8
.SH SYNOPSIS
9
- .B urler [options]
9
+ .B trurl [options]
10
10
.SH DESCRIPTION
11
- .B urler
11
+ .B trurl
12
12
parses, manipulates and outputs URLs and parts of URLs.
13
13
14
14
It uses the RFC 3986 definition of URLs and it uses libcurl's URL parser to do
@@ -23,13 +23,13 @@ Show version information and exit.
23
23
.SH "INPUT OPTIONS"
24
24
.IP " --url [URL]"
25
25
Set the input URL to work with. The URL may be provided without a scheme,
26
- which then typically is not actually a legal URL but urler will try to figure
26
+ which then typically is not actually a legal URL but trurl will try to figure
27
27
out what is meant and guess what scheme to use.
28
28
29
- Providing multiple URLs will make urler act on all URLs in a serial fashion.
29
+ Providing multiple URLs will make trurl act on all URLs in a serial fashion.
30
30
.IP " --url-file [name]"
31
31
Read URLs to work on from the given file. Use the file name "-" (a single
32
- minus) to tell urler to read the URLs from stdin.
32
+ minus) to tell trurl to read the URLs from stdin.
33
33
34
34
Each line needs to be a single valid URL and the line needs to end with a
35
35
newline. The maximum URL length supported in a file like this is 4095 bytes.
@@ -62,52 +62,52 @@ within curly braces. The following component names are available: {url},
62
62
.SH "MODIFIERS"
63
63
.IP " --urldecode"
64
64
By default each component is output using the format of the input (URL
65
- encoded). This option makes urler instead provide it URL decoded. Note that
65
+ encoded). This option makes trurl instead provide it URL decoded. Note that
66
66
%20 will then output space and %09 a tab etc.
67
67
.SH EXAMPLES
68
68
.IP " Replace the host name of a URL"
69
69
.nf
70
- $ urler --url https://curl.se --set host=example.com
70
+ $ trurl --url https://curl.se --set host=example.com
71
71
https://example.com/
72
72
.fi
73
73
.IP " Create a URL by setting components"
74
74
.nf
75
- $ urler --set host=example.com --set scheme=ftp
75
+ $ trurl --set host=example.com --set scheme=ftp
76
76
ftp://example.com/
77
77
.fi
78
78
.IP " Redirect a URL"
79
79
.nf
80
- $ urler --url https://curl.se/we/are.html --redirect here.html
80
+ $ trurl --url https://curl.se/we/are.html --redirect here.html
81
81
https://curl.se/we/here.html
82
82
.fi
83
83
.IP " Change port number"
84
- This also shows how urler will remove dot-dot sequences
84
+ This also shows how trurl will remove dot-dot sequences
85
85
86
86
.nf
87
- $ urler --url https://curl.se/we/../are.html --set port=8080
87
+ $ trurl --url https://curl.se/we/../are.html --set port=8080
88
88
https://curl.se:8080/are.html
89
89
.IP " Extract the path from a URL"
90
90
.nf
91
- $ urler --url https://curl.se/we/are.html --get '{path}'
91
+ $ trurl --url https://curl.se/we/are.html --get '{path}'
92
92
/we/are.html
93
93
.IP " Extract the port from a URL"
94
94
This gets the default port based on the scheme if the port is not set in the
95
95
URL.
96
96
97
97
.nf
98
- $ urler --url https://curl.se/we/are.html --get '{port}'
98
+ $ trurl --url https://curl.se/we/are.html --get '{port}'
99
99
443
100
100
.IP " Append a path segment to a URL"
101
101
.nf
102
- $ urler --url https://curl.se/hello --append path=you
102
+ $ trurl --url https://curl.se/hello --append path=you
103
103
https://curl.se/hello/you
104
104
.IP " Append a query segment to a URL"
105
105
.nf
106
- $ urler --url "https://curl.se?name=hello" --append query=search=string
106
+ $ trurl --url "https://curl.se?name=hello" --append query=search=string
107
107
https://curl.se/?name=hello&search=string
108
108
.IP " Read URLs from stdin"
109
109
.nf
110
- $ cat urllist.txt | urler --url-file -
110
+ $ cat urllist.txt | trurl --url-file -
111
111
...
112
112
.SH WWW
113
- https://github.com/curl/urler
113
+ https://github.com/curl/trurl
0 commit comments