在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
batGo implemented CLI cURL-like tool for humans. Bat can be used for testing, debugging, and generally interacting with HTTP servers. Inspired by Httpie. Thanks to the author, Jakub.
Main Features
Installationgo get -u github.com/astaxie/bat make sure the UsageHello World: $ bat beego.me Synopsis: bat [flags] [METHOD] URL [ITEM [ITEM]] See also ExamplesBasic settings - HTTP method, HTTP headers and JSON data: $ bat PUT example.org X-API-Token:123 name=John Any custom HTTP method (such as WebDAV, etc.): $ bat -method=PROPFIND example.org name=John Submitting forms: $ bat -form=true POST example.org hello=World See the request that is being sent using one of the output options: $ bat -v example.org Use Github API to post a comment on an issue with authentication: $ bat -a USERNAME POST https://api.github.com/repos/astaxie/bat/issues/1/comments body='bat is awesome!' Upload a file using redirected input: $ bat example.org < file.json Download a file and save it via redirected output: $ bat example.org/file > file Download a file wget style: $ bat -download=true example.org/file Set a custom Host header to work around missing DNS records: $ bat localhost:8000 Host:example.com Following is the detailed documentation. It covers the command syntax, advanced usage, and also features additional examples. HTTP MethodThe name of the HTTP method comes right before the URL argument: $ bat DELETE example.org/todos/7 which looks similar to the actual Request-Line that is sent: DELETE /todos/7 HTTP/1.1 When the METHOD argument is omitted from the command, bat defaults to either GET (if there is no request data) or POST (with request data). Request URLThe only information bat needs to perform a request is a URL. The default scheme is, somewhat unsurprisingly, http://, and can be omitted from the argument – Additionally, curl-like shorthand for localhost is supported. This means that, for example :3000 would expand to http://localhost:3000 If the port is omitted, then port 80 is assumed. $ bat :/fooGET /foo HTTP/1.1Host: localhost$ bat :3000/barGET /bar HTTP/1.1Host: localhost:3000$ bat :GET / HTTP/1.1Host: localhost If you find yourself manually constructing URLs with query string parameters on the terminal, you may appreciate the $ bat GET www.google.com search=bat tbm=ischGET /?search=bat&tbm=isch HTTP/1.1 Request ItemsThere are a few different request item types that provide a convenient mechanism for specifying HTTP headers, simple JSON and form data, files, and URL parameters. They are key/value pairs specified after the URL. All have in common that they become part of the actual request that is sent and that their type is distinguished only by the separator used:
You can use You can also quote values, e.g. JSONJSON is the lingua franca of modern web services and it is also the implicit content type bat by default uses: If your command includes some data items, they are serialized as a JSON object by default. bat also automatically sets the following headers, both of which can be overwritten:
You can use --json=true, -j=true to explicitly set Accept to Simple example: $ bat PUT example.org name=John [email protected]PUT / HTTP/1.1Accept: application/jsonAccept-Encoding: gzip, deflateContent-Type: application/jsonHost: example.org{ "name": "John", "email": "[email protected]"} Non-string fields use the := separator, which allows you to embed raw JSON into the resulting object. Text and raw JSON files can also be embedded into fields using =@ and :=@: $ bat PUT api.example.com/person/1 \name=John \age:=29 married:=false hobbies:='["http", "pies"]' \ # Raw JSON[email protected] \ # Embed text filebookmarks:[email protected] # Embed JSON filePUT /person/1 HTTP/1.1Accept: application/jsonContent-Type: application/jsonHost: api.example.com{ "age": 29, "hobbies": [ "http", "pies" ], "description": "John is a nice guy who likes pies.", "married": false, "name": "John", "bookmarks": { "HTTPie": "http://httpie.org", }} Send JSON data stored in a file (see redirected input for more examples): $ bat POST api.example.com/person/1 < person.json FormsSubmitting forms are very similar to sending JSON requests. Often the only difference is in adding the It is possible to make form data the implicit content type instead of JSON via the config file. Regular Forms$ bat -f=true POST api.example.org/person/1 name='John Smith' \[email protected]POST /person/1 HTTP/1.1Content-Type: application/x-www-form-urlencoded; charset=utf-8name=John+Smith&email=john%40example.org File Upload FormsIf one or more file fields is present, the serialization and content type is $ bat -f=true POST example.com/jobs name='John Smith' cv@~/Documents/cv.pdf The request above is the same as if the following HTML form were submitted: <form enctype="multipart/form-data" method="post" action="http://example.com/jobs"> <input type="text" name="name" /> <input type="file" name="cv" /></form> Note that HTTP HeadersTo set custom headers you can use the Header:Value notation: $ bat example.org User-Agent:Bacon/1.0 'Cookie:valued-visitor=yes;foo=bar' \X-Foo:Bar Referer:http://beego.me/GET / HTTP/1.1Accept: */*Accept-Encoding: gzip, deflateCookie: valued-visitor=yes;foo=barHost: example.orgReferer: http://beego.me/User-Agent: Bacon/1.0X-Foo: Bar There are a couple of default headers that bat sets: GET / HTTP/1.1Accept: */*Accept-Encoding: gzip, deflateUser-Agent: bat/<version>Host: <taken-from-URL> Any of the default headers can be overwritten. AuthenticationBasic auth: $ bat -a=username:password example.org ProxiesYou can specify proxies to be used through the --proxy argument for each protocol (which is included in the value in case of redirects across protocols): $ bat --proxy=http://10.10.1.10:3128 example.org With Basic authentication: $ bat --proxy=http://user:[email protected]:3128 example.org You can also configure proxies by environment variables HTTP_PROXY and HTTPS_PROXY, and the underlying Requests library will pick them up as well. If you want to disable proxies configured through the environment variables for certain hosts, you can specify them in NO_PROXY. In your ~/.bash_profile: export HTTP_PROXY=http://10.10.1.10:3128export HTTPS_PROXY=https://10.10.1.10:1080export NO_PROXY=localhost,example.com |
请发表评论