Artifactspublic-v0

curl

master
ply4 git calls235 ms288 KiB2 cachedprotocol v2
43 lines1.9 KiBRaw

VARIABLES

curl supports command line variables (added in 8.3.0). Set variables with --variable name=content or --variable name@file (where file can be stdin if set to a single dash (-)).

Variable contents can be expanded in option parameters using {{name}} if the option name is prefixed with --expand-. This gets the contents of the variable name inserted, or a blank if the name does not exist as a variable. Insert {{ verbatim in the string by prefixing it with a backslash, like \{{.

You can access and expand environment variables by importing them with --variable %name. This imports the variable called name but exits with an error if that environment variable is not already set. To provide a default value in case it is not already set, use --variable %name=content or --variable %name@content.

Example: get the USER environment variable and expand into the URL, fail if USER is not set:

--variable '%USER'
--expand-url = "https://example.com/api/{{USER}}/method"

When expanding variables, curl supports a set of functions that can make the variable contents more convenient to use. It can trim leading and trailing white space with trim, output the contents as a JSON quoted string with json, URL encode the string with url, base64 encode it with b64 and base64 decode it with 64dec. To apply functions to a variable expansion, add them colon separated to the right side of the variable. Variable content holding null bytes that are not encoded when expanded causes an error.

Example: get the contents of a file called $HOME/.secret into a variable called "fix". Make sure that the content is trimmed and percent-encoded when sent as POST data:

--variable %HOME
--expand-variable fix@{{HOME}}/.secret
--expand-data "{{fix:trim:url}}"
https://example.com/

Command line variables and expansions were added in 8.3.0.

1<!-- Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -->
2<!-- SPDX-License-Identifier: curl -->
3# VARIABLES
4curl supports command line variables (added in 8.3.0). Set variables with
5--variable name=content or --variable name@file (where `file` can be stdin if
6set to a single dash (-)).
8Variable contents can be expanded in option parameters using `{{name}}` if the
9option name is prefixed with `--expand-`. This gets the contents of the
10variable `name` inserted, or a blank if the name does not exist as a
11variable. Insert `{{` verbatim in the string by prefixing it with a backslash,
12like `\{{`.
14You can access and expand environment variables by importing them with
15`--variable %name`. This imports the variable called `name` but exits with an
16error if that environment variable is not already set. To provide a default
17value in case it is not already set, use `--variable %name=content` or
18`--variable %name@content`.
20Example: get the USER environment variable and expand into the URL, fail if
21USER is not set:
23 --variable '%USER'
24 --expand-url = "https://example.com/api/{{USER}}/method"
26When expanding variables, curl supports a set of functions that can make the
27variable contents more convenient to use. It can trim leading and trailing
28white space with `trim`, output the contents as a JSON quoted string with
29`json`, URL encode the string with `url`, base64 encode it with `b64` and
30base64 decode it with `64dec`. To apply functions to a variable expansion, add
31them colon separated to the right side of the variable. Variable content
32holding null bytes that are not encoded when expanded causes an error.
34Example: get the contents of a file called $HOME/.secret into a variable
35called "fix". Make sure that the content is trimmed and percent-encoded when
36sent as POST data:
38 --variable %HOME
39 --expand-variable fix@{{HOME}}/.secret
40 --expand-data "{{fix:trim:url}}"
41 https://example.com/
43Command line variables and expansions were added in 8.3.0.
Diagnostics4 git calls · 235 ms
CallStatusSizeTime0235 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=229
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch2001.0 KiB229 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1027
git.response.cache=MISS
git.response.duration_ms=229
git.fetch.wants=834fc5ef28378af0a4ba6fef3d200b79d6227bf5
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1027
git.pkt.payload.max=1006
git.sideband.band1.bytes=1005
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e3440edd816e2a
Request
c0a19a4b…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format