You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Simple HTTP and REST client for Go inspired by Ruby rest-client. [Features](#features) section describes in detail about resty capabilities.
3
+
Simple HTTP and REST client for Go inspired by Ruby rest-client. [Features](#features) section describes in detail about Resty capabilities.
4
4
5
-
***v0.13[released](https://github.com/go-resty/resty/releases/latest) and tagged on Jun 22, 2017.***
5
+
***v1.0[released](https://github.com/go-resty/resty/releases/latest) and tagged on Sep 25, 2017.***
6
6
7
7
*Since Go v1.6 HTTP/2 & HTTP/1.1 protocol is used transparently. `Resty` works fine with HTTP/2 and HTTP/1.1.*
8
8
9
-
#### Roadmap
10
-
***v1.0***
9
+
#### v1.0 Released
11
10
12
-
Go Resty first released on Sep 15, 2015 then go-resty grew gradually as a very handy and helpful library of HTTP & REST Client in the golang community. I'm planning to freeze API and make v1.0 release.
11
+
Resty first version released on Sep 15, 2015 then it grew gradually as a very handy and helpful library. Its been a two year; `v1.0` released on Sep 25, 2017. I'm very thankful to Resty users and its [contributors](https://github.com/go-resty/resty/graphs/contributors).
13
12
14
13
#### Features
15
14
* GET, POST, PUT, DELETE, HEAD, PATCH and OPTIONS
@@ -22,8 +21,8 @@ Go Resty first released on Sep 15, 2015 then go-resty grew gradually as a very h
22
21
* Automatic marshal and unmarshal for `JSON` and `XML` content type
23
22
* Default is `JSON`, if you supply `struct/map` without header `Content-Type`
24
23
* For auto-unmarshal, refer to -
25
-
- Success scenario [Request.SetResult()](https://godoc.org/gopkg.in/resty.v0#Request.SetResult) and [Response.Result()](https://godoc.org/gopkg.in/resty.v0#Response.Result).
26
-
- Error scenario [Request.SetError()](https://godoc.org/gopkg.in/resty.v0#Request.SetError) and [Response.Error()](https://godoc.org/gopkg.in/resty.v0#Response.Error).
24
+
- Success scenario [Request.SetResult()](https://godoc.org/github.com/go-resty/resty#Request.SetResult) and [Response.Result()](https://godoc.org/github.com/go-resty/resty#Response.Result).
25
+
- Error scenario [Request.SetError()](https://godoc.org/github.com/go-resty/resty#Request.SetError) and [Response.Error()](https://godoc.org/github.com/go-resty/resty#Response.Error).
27
26
* Easy to upload one or more file(s) via `multipart/form-data`
28
27
* Backoff Retry Mechanism with retry condition function [reference](retry_test.go)
29
28
* resty client HTTP & REST [Request](https://godoc.org/github.com/go-resty/resty#Client.OnBeforeRequest) and [Response](https://godoc.org/github.com/go-resty/resty#Client.OnAfterResponse) middlewares
@@ -41,8 +40,8 @@ Go Resty first released on Sep 15, 2015 then go-resty grew gradually as a very h
41
40
* Optionally allows GET request with payload, see [SetAllowGetMethodPayload](https://godoc.org/github.com/go-resty/resty#Client.SetAllowGetMethodPayload)
42
41
* Supports registering external JSON library into resty, see [how to use](https://github.com/go-resty/resty/issues/76#issuecomment-314015250)
43
42
* Exposes Response reader without reading response (no auto-unmarshaling) if need be, see [how to use](https://github.com/go-resty/resty/issues/87#issuecomment-322100604)
44
-
* Option to specify expected `Content-Type` when response `Content-Type` header missing. Refer [#92](https://github.com/go-resty/resty/issues/92)
45
-
*resty design
43
+
* Option to specify expected `Content-Type` when response `Content-Type` header missing. Refer to [#92](https://github.com/go-resty/resty/issues/92)
44
+
*Resty design
46
45
* Have client level settings & options and also override at Request level if you want to
47
46
* Request and Response middlewares
48
47
* Create Multiple clients if you want to `resty.New()`
@@ -72,7 +71,7 @@ resty tested with Go `v1.3` and above.
72
71
Please refer section [Versioning](#versioning) for detailed info.
73
72
```sh
74
73
# install the library
75
-
go get -u gopkg.in/resty.v0
74
+
go get -u gopkg.in/resty.v1
76
75
```
77
76
#### Latest Version - Development Edge
78
77
```sh
@@ -92,9 +91,7 @@ The following samples will assist you to become as comfortable as possible with
92
91
93
92
Import resty into your code and refer it as `resty`.
Response Received At: 2015-09-15 12:05:28.922780103 -0700 PDT
120
117
Response Body: {
121
118
"args": {},
122
119
"headers": {
@@ -636,17 +633,16 @@ resty releases versions according to [Semantic Versioning](http://semver.org)
636
633
637
634
`gopkg.in/resty.vX` points to appropriate tag versions; `X` denotes version number and it's a stable release. It's recommended to use version, for eg. `gopkg.in/resty.v0`. Development takes place at the master branch. Although the code in master should always compile and test successfully, it might break API's. We aim to maintain backwards compatibility, but API's and behaviour might be changed to fix a bug.
638
635
639
-
640
636
## Contributing
641
637
Welcome! If you find any improvement or issue you want to fix, feel free to send a pull request, I like pull requests that include test cases for fix/enhancement. I have done my best to bring pretty good code coverage. Feel free to write tests.
642
638
643
-
BTW, I'd like to know what you think about go-resty. Kindly open an issue or send me an email; it'd mean a lot to me.
639
+
BTW, I'd like to know what you think about `Resty`. Kindly open an issue or send me an email; it'd mean a lot to me.
0 commit comments