|
|
@@ -0,0 +1,354 @@
|
|
|
+// Copyright 2017 Frédéric Guillot. All rights reserved.
|
|
|
+// Use of this source code is governed by the MIT license
|
|
|
+// that can be found in the LICENSE file.
|
|
|
+
|
|
|
+package miniflux
|
|
|
+
|
|
|
+import (
|
|
|
+ "encoding/json"
|
|
|
+ "fmt"
|
|
|
+ "net/url"
|
|
|
+ "strconv"
|
|
|
+)
|
|
|
+
|
|
|
+// Client represents a Miniflux client.
|
|
|
+type Client struct {
|
|
|
+ request *request
|
|
|
+}
|
|
|
+
|
|
|
+// Users returns all users.
|
|
|
+func (c *Client) Users() (Users, error) {
|
|
|
+ body, err := c.request.Get("/v1/users")
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var users Users
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&users); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return users, nil
|
|
|
+}
|
|
|
+
|
|
|
+// User returns a single user.
|
|
|
+func (c *Client) User(userID int64) (*User, error) {
|
|
|
+ body, err := c.request.Get(fmt.Sprintf("/v1/users/%d", userID))
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var user User
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&user); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return &user, nil
|
|
|
+}
|
|
|
+
|
|
|
+// CreateUser creates a new user in the system.
|
|
|
+func (c *Client) CreateUser(username, password string, isAdmin bool) (*User, error) {
|
|
|
+ body, err := c.request.Post("/v1/users", &User{Username: username, Password: password, IsAdmin: isAdmin})
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var user *User
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&user); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return user, nil
|
|
|
+}
|
|
|
+
|
|
|
+// UpdateUser updates a user in the system.
|
|
|
+func (c *Client) UpdateUser(user *User) (*User, error) {
|
|
|
+ body, err := c.request.Put(fmt.Sprintf("/v1/users/%d", user.ID), user)
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var u *User
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&u); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return u, nil
|
|
|
+}
|
|
|
+
|
|
|
+// DeleteUser removes a user from the system.
|
|
|
+func (c *Client) DeleteUser(userID int64) error {
|
|
|
+ body, err := c.request.Delete(fmt.Sprintf("/v1/users/%d", userID))
|
|
|
+ if err != nil {
|
|
|
+ return err
|
|
|
+ }
|
|
|
+ body.Close()
|
|
|
+ return nil
|
|
|
+}
|
|
|
+
|
|
|
+// Discover try to find subscriptions from a website.
|
|
|
+func (c *Client) Discover(url string) (Subscriptions, error) {
|
|
|
+ body, err := c.request.Post("/v1/discover", map[string]string{"url": url})
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var subscriptions Subscriptions
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&subscriptions); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return subscriptions, nil
|
|
|
+}
|
|
|
+
|
|
|
+// Categories gets the list of categories.
|
|
|
+func (c *Client) Categories() (Categories, error) {
|
|
|
+ body, err := c.request.Get("/v1/categories")
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var categories Categories
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&categories); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return categories, nil
|
|
|
+}
|
|
|
+
|
|
|
+// CreateCategory creates a new category.
|
|
|
+func (c *Client) CreateCategory(title string) (*Category, error) {
|
|
|
+ body, err := c.request.Post("/v1/categories", map[string]interface{}{
|
|
|
+ "title": title,
|
|
|
+ })
|
|
|
+
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var category *Category
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&category); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return category, nil
|
|
|
+}
|
|
|
+
|
|
|
+// UpdateCategory updates a category.
|
|
|
+func (c *Client) UpdateCategory(categoryID int64, title string) (*Category, error) {
|
|
|
+ body, err := c.request.Put(fmt.Sprintf("/v1/categories/%d", categoryID), map[string]interface{}{
|
|
|
+ "title": title,
|
|
|
+ })
|
|
|
+
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var category *Category
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&category); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return category, nil
|
|
|
+}
|
|
|
+
|
|
|
+// DeleteCategory removes a category.
|
|
|
+func (c *Client) DeleteCategory(categoryID int64) error {
|
|
|
+ body, err := c.request.Delete(fmt.Sprintf("/v1/categories/%d", categoryID))
|
|
|
+ if err != nil {
|
|
|
+ return err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ return nil
|
|
|
+}
|
|
|
+
|
|
|
+// Feeds gets all feeds.
|
|
|
+func (c *Client) Feeds() (Feeds, error) {
|
|
|
+ body, err := c.request.Get("/v1/feeds")
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var feeds Feeds
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&feeds); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return feeds, nil
|
|
|
+}
|
|
|
+
|
|
|
+// Feed gets a new feed.
|
|
|
+func (c *Client) Feed(feedID int64) (*Feed, error) {
|
|
|
+ body, err := c.request.Get(fmt.Sprintf("/v1/feeds/%d", feedID))
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var feed *Feed
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&feed); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return feed, nil
|
|
|
+}
|
|
|
+
|
|
|
+// CreateFeed creates a new feed.
|
|
|
+func (c *Client) CreateFeed(url string, categoryID int64) (*Feed, error) {
|
|
|
+ body, err := c.request.Post("/v1/feeds", map[string]interface{}{
|
|
|
+ "feed_url": url,
|
|
|
+ "category_id": categoryID,
|
|
|
+ })
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var feed *Feed
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&feed); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return feed, nil
|
|
|
+}
|
|
|
+
|
|
|
+// UpdateFeed updates a feed.
|
|
|
+func (c *Client) UpdateFeed(feed *Feed) (*Feed, error) {
|
|
|
+ body, err := c.request.Put(fmt.Sprintf("/v1/feeds/%d", feed.ID), feed)
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var f *Feed
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&f); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return f, nil
|
|
|
+}
|
|
|
+
|
|
|
+// RefreshFeed refresh a feed.
|
|
|
+func (c *Client) RefreshFeed(feedID int64) error {
|
|
|
+ body, err := c.request.Put(fmt.Sprintf("/v1/feeds/%d/refresh", feedID), nil)
|
|
|
+ if err != nil {
|
|
|
+ return err
|
|
|
+ }
|
|
|
+ body.Close()
|
|
|
+ return nil
|
|
|
+}
|
|
|
+
|
|
|
+// DeleteFeed removes a feed.
|
|
|
+func (c *Client) DeleteFeed(feedID int64) error {
|
|
|
+ body, err := c.request.Delete(fmt.Sprintf("/v1/feeds/%d", feedID))
|
|
|
+ if err != nil {
|
|
|
+ return err
|
|
|
+ }
|
|
|
+ body.Close()
|
|
|
+ return nil
|
|
|
+}
|
|
|
+
|
|
|
+// Entry gets a single feed entry.
|
|
|
+func (c *Client) Entry(feedID, entryID int64) (*Entry, error) {
|
|
|
+ body, err := c.request.Get(fmt.Sprintf("/v1/feeds/%d/entries/%d", feedID, entryID))
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var entry *Entry
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&entry); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return entry, nil
|
|
|
+}
|
|
|
+
|
|
|
+// Entries gets feed entries.
|
|
|
+func (c *Client) Entries(feedID int64, filter *Filter) (*EntryResultSet, error) {
|
|
|
+ path := fmt.Sprintf("/v1/feeds/%d/entries", feedID)
|
|
|
+
|
|
|
+ if filter != nil {
|
|
|
+ values := url.Values{}
|
|
|
+
|
|
|
+ if filter.Status != "" {
|
|
|
+ values.Set("status", filter.Status)
|
|
|
+ }
|
|
|
+
|
|
|
+ if filter.Direction != "" {
|
|
|
+ values.Set("direction", filter.Direction)
|
|
|
+ }
|
|
|
+
|
|
|
+ if filter.Order != "" {
|
|
|
+ values.Set("order", filter.Order)
|
|
|
+ }
|
|
|
+
|
|
|
+ if filter.Limit != 0 {
|
|
|
+ values.Set("limit", strconv.Itoa(filter.Limit))
|
|
|
+ }
|
|
|
+
|
|
|
+ if filter.Offset != 0 {
|
|
|
+ values.Set("offset", strconv.Itoa(filter.Offset))
|
|
|
+ }
|
|
|
+
|
|
|
+ path = fmt.Sprintf("%s?%s", path, values.Encode())
|
|
|
+ }
|
|
|
+
|
|
|
+ body, err := c.request.Get(path)
|
|
|
+ if err != nil {
|
|
|
+ return nil, err
|
|
|
+ }
|
|
|
+ defer body.Close()
|
|
|
+
|
|
|
+ var result EntryResultSet
|
|
|
+ decoder := json.NewDecoder(body)
|
|
|
+ if err := decoder.Decode(&result); err != nil {
|
|
|
+ return nil, fmt.Errorf("miniflux: response error (%v)", err)
|
|
|
+ }
|
|
|
+
|
|
|
+ return &result, nil
|
|
|
+}
|
|
|
+
|
|
|
+// UpdateEntries updates the status of a list of entries.
|
|
|
+func (c *Client) UpdateEntries(entryIDs []int64, status string) error {
|
|
|
+ type payload struct {
|
|
|
+ EntryIDs []int64 `json:"entry_ids"`
|
|
|
+ Status string `json:"status"`
|
|
|
+ }
|
|
|
+
|
|
|
+ body, err := c.request.Put("/v1/entries", &payload{EntryIDs: entryIDs, Status: status})
|
|
|
+ if err != nil {
|
|
|
+ return err
|
|
|
+ }
|
|
|
+ body.Close()
|
|
|
+
|
|
|
+ return nil
|
|
|
+}
|
|
|
+
|
|
|
+// NewClient returns a new Client.
|
|
|
+func NewClient(endpoint, username, password string) *Client {
|
|
|
+ return &Client{request: &request{endpoint: endpoint, username: username, password: password}}
|
|
|
+}
|