Talk to the packagecloud API, in Go
Switch branches/tags
Clone or download
Pull request Compare This branch is 8 commits ahead of mlafeldt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
cmd
pkgcloudlib
vendor/github.com
.gitignore
Gopkg.lock
Gopkg.toml
LICENSE
README.md
main.go

README.md

Installation

Setup a Go Environment if you don't have one already

Then go get the pkgcloud

go get github.com/edwarnicke/pkgcloud/

You should now find:

ls ${GOPATH}/bin/pkgcloud

Client Usage

Get all packages in a repo

pkgcloud all <user/repo>

Get all packages with Custom Template

pkgcloud all <user/repo> -t <template>

The template is in Go template format

The following fields are available:

Template Description Example
{{.Name}} The name of the package "jake"
{{.CreatedAt}} When the package was uploaded "2017-03-13T02:49:29.000Z"
{{.Epoch}} The epoch of the package (if available) 0
{{.Scope}} The scope of the package (if available) null
{{.Private}} Whether or not the package is in a private repository false
{{.UploaderName}} The name of the uploader for the package. "test_user"
{{.Indexed}} Whether or not this package has been indexed. false
{{.RepositoryHTMLURL}} The HTML url of the repository. "/test_user/test_repo"
{{.DownloadDetailsURL}} The url to get access log details for package downloads. "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/detail.json"
{{.DownloadSeriesURL}} The url to get time series data for package downloads. "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/series/daily.json"
{{.DownloadCountURL}} The url to get the total number of package downloads. "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6/stats/downloads/count.json"
{{.PromoteURL}} The url for promoting this to another repository. "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm/promote.json"
{{.DestroyURL}} The url for the HTTP DELETE request to destroy this package "/api/v1/repos/test_user/test_repo/fedora/22/jake-1.0-1.el6.x86_64.rpm"
{{.Filename}} The filename of the package. "jake-1.0-1.el6.x86_64.rpm"
{{.DistroVersion}} The distro_version for the package. "fedora/22"
{{.Version}} The version of the package. "1.0"
{{.Release}} The release of the package (if available) "1.el6"
{{.Type}} The type of package ("deb", "gem", or "rpm"). "rpm"
{{.PackageURL}} The API url for this package "/api/v1/repos/test_user/test_repo/package/rpm/fedora/22/jake/x86_64/1.0/1.el6.json"
{{.PackageHTMLURL }} The HTML url for this package "/test_user/test_repo/packages/fedora/22/jake-1.0-1.el6.x86_64.rpm"

In addition, some 'methods' are provided:

Method Description
{{.DaysOld}} Number of days since the package has been uploaded. Derived from {{.CreatedAt}}
{{.Promote "user/repo"}} Promote the package to the named repo. Note: Does have side effects to packagecloud.io unless you use -d or --dry-run flags.
{{.Destroy}} Destroy the package. Note: Does have side effects to packagecloud.io unless you use -d or --dry-run flags.

Example: Filter for only packages with {{.Release}} equal "release"

pkgcloud all fdio/1710 -t $'{{if eq .Release "release"}}{{.PackageHTMLURL}}\n{{end}}' 

which produces output:

/fdio/1710/packages/ubuntu/xenial/vpp-api-java_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-api-lua_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-dbg_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-dev_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-lib_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-plugins_17.10-release_amd64.deb
/fdio/1710/packages/ubuntu/xenial/vpp-api-python_17.10-release_amd64.deb
/fdio/1710/packages/el/7/vpp-lib-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-devel-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-plugins-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-api-lua-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-api-java-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-api-python-17.10-release.x86_64.rpm
/fdio/1710/packages/el/7/vpp-17.10-release.x86_64.rpm

Lets break down some things about the commandline. First $'string\n' escapes the string so that newlines can be represented with \n. Second {{if eq .Release "release"}}...{{end}} is an if statement the body of which is only evaluated if Release == "release" Third {{.PackageHTMLURL}}\n outputs the package html url for any packages that match the if statement

Example: Promote packages with {{.Release}} equal "release" to "fdio/staging"

pkgcloud all fdio/1804 -t $'{{if eq .Release "release"}}{{.Promote "fdio/staging" }}\n{{end}}' -d

{{.Promote "fdio/staging" }} Promotes any packages that that passthe if statement to repo "fdio/staging".

-d causes this to be a 'dry run'... meaning it doesn't actually promote, just tells you what it would do to promote.

Example: Filter for only packages older than 415 days

pkgcloud all fdio/1707 -t $'{{if gt .DaysOld 415}}{{.PackageHTMLURL}}: {{.DaysOld}}\n{{end}}'

Which outputs:

/fdio/1707/packages/ubuntu/xenial/vpp_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-plugins_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-api-python_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-dbg_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-dev_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-lib_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-api-lua_17.07-rc1~b2_amd64.deb: 416
/fdio/1707/packages/ubuntu/xenial/vpp-dpdk-dkms_17.05-vpp5_amd64.deb: 416
/fdio/1707/packages/el/7/vpp-dpdk-devel-17.05-vpp5.x86_64.rpm: 416

Example: Filter for only packages older than 415 days and promote them to repo "fdio/backup"

pkgcloud all fdio/1707 -t $'{{if gt .DaysOld 415}}{{.Promote "fdio/backup"}}\n{{end}}' -d

In this command, {{.Promote "fdio/backup"}} promotes the packages that pass the filter of {{if gt .DaysOld 415}} to the repo "fdio/backup". Note the -d, which causes this to be a dry run. If you really want to perform the promote, remove the -d

Example: Filter for only packages older than 475 days and delete them:

pkgcloud all fdio/backup -t $'{{if gt .DaysOld 475}}{{.Destroy}}\n{{end}}' -d

In this command, {{.Destroy}} deletes the packages that pass the filter of {{if gt .DaysOld 415}}. Note the -d, which causes this to be a dry run. If you really want to perform the delete, remove the -d

Pushing packages

pkgcloud push user/repo/distro/version/ filename

There are two optional flags for pkgcloud push:

  • -d or --dry-run: which will tell you what would be done for pushing the package, but will not in fact push it, or delete if used in conjunction with -f
  • -f or --force: If and only if the package to-be-pushed already exists in packagecloud.io, delete it and then push.

Acknowledgement

This is based on the wonderful golang pkgcloud package provided by Mathias Lafeldt.