Add a Sort RequestOption helper

EXAMPLES.md

@@ -33,6 +33,7 @@ management.PerPage()
 management.IncludeTotals()
 management.Take()
 management.From()
+management.Sort()
 ```
 
 ## Pagination

management/management_request.go

@@ -285,3 +285,13 @@ func Stringify(v interface{}) string {
 	}
 	return string(b)
 }
+
+// Sort configures a request to sort data by the selected field.
+// Use 1 to sort ascending and -1 to sort descending.
+func Sort(sort string) RequestOption {
+	return newRequestOption(func(r *http.Request) {
+		q := r.URL.Query()
+		q.Set("sort", sort)
+		r.URL.RawQuery = q.Encode()
+	})
+}

management/management_test.go

@@ -157,6 +157,17 @@ func TestOptionDefaults(t *testing.T) {
 	assert.Equal(t, "false", includeTotals)
 }
 
+func TestOptionSort(t *testing.T) {
+	r, _ := http.NewRequest("GET", "/", nil)
+
+	Sort("name:-1").apply(r)
+
+	v := r.URL.Query()
+
+	sort := v.Get("sort")
+	assert.Equal(t, "name:-1", sort)
+}
+
 func TestStringify(t *testing.T) {
 	expected := `{
   "foo": "bar"