Package newreleases is a Go client library for accessing the NewReleases v1 API.

You can view the client API docs here: https://godoc.org/newreleases.io/newreleases

You can view NewReleases API docs here: https://newreleases.io/api/v1

Run go get newreleases.io/newreleases from command line.

import "newreleases.io/newreleases"

Create a new Client, then use the exposed services to access different parts of the API.

Currently, API keys is the only method of authenticating with the API. You can manage your keys at the NewReleases API keys settings page.

You can then use your token to create a new Client.

This client implements all NewReleases API features.

• List projects
• Search projects
• Get project
• Add project
• Update project
• Delete project
• List projects releases
• Get project release
• Get latest non-excluded project release
• Get project release note
• Get tracked providers
• Get added Slack Channels
• Get added Telegram Chats
• Get added Dissord Channels
• Get added Hangouts Chat webhooks
• Get added Microsoft Teams webhooks
• Get added Mattermost webhooks
• Get added Rocket.Chat webhooks
• Get added Matrix Rooms
• Get added custom Webhooks
• List tags
• Get tag
• Add tag
• Update tag
• Delete tag
• Get auth keys

To add a new project:

package main

import (
    "context"
    "log"

    "newreleases.io/newreleases"
)

var key = "myapikey"

func main() {
    client := newreleases.NewClient(key, nil)
    p, err := client.Projects.Add(
        context.Background(),
        "github",
        "golang/go",
        newreleases.ProjectOptions{
            EmailNotification: &newreleases.EmailNotificationHourly,
        }
    )
    if err != nil {
        log.Fatal(err)
    }
    log.Print(p.ID)
}

List projects with pagination:

func AllProjects(ctx context.Context, client *newreleases.Client) (pp []newreleases.Project, err error) {
    o := &newreleases.ProjectListOptions{
        Page: 1,
    }
    for {
        projects, lastPage, err := client.Projects.List(ctx, o)
        if err != nil {
            return nil, err
        }

        pp = append(pp, projects...)

        if o.Page >= lastPage {
            break
        }
        o.Page++
    }

    return pp, nil
}

Each version of the client is tagged and the version is updated accordingly.

This package uses Go modules.

To see the list of past versions, run git tag.

We love pull requests! Please see the contribution guidelines.

This library is distributed under the BSD-style license found in the LICENSE file.