veyor

veyor is a low level client for the Appveyor API

API docs: https://www.appveyor.com/docs/api

Installation

Stable version

gem install veyor

Development version

git clone https://github.com/sckott/veyor.git
cd veyor
rake install

veyor API

• Veyor.project - get project by name, branch, or build version
• Veyor.projects - get all projects
• Veyor.project_history - get project history
• Veyor.project_deployments - get project deployments
• Veyor.project_settings - get project settings
• Veyor.build_start - start a build
• Veyor.build_cancel - cancel a build

More to come in future veyor versions

Changes

For changes see the Changelog

Setup

Veyor.configuration do |config|
  config.account_name = "janedoe"
  config.account_token = "<your token>"
end

Ideally, store those in env var keys like

• ENV['APPVEYOR_ACCOUNT_NAME']
• ENV['APPVEYOR_API_TOKEN']

In Ruby

get projects

Veyor.projects()

get a project by name

Veyor.project(project: 'cowsay')

get project history

Veyor.project_history(project: 'cowsay')

start a build

Veyor.build_start(project: 'cowsay')

cancel a build

Veyor.build_cancel(project: 'cowsay', version: '1.0.697')

On the CLI

List commands

veyor

Commands:
  veyor help [COMMAND]  # Describe available commands or one specific command
  veyor project [Name]  # List a project
  veyor projects        # List projects

List your projects

veyor projects

alm
analogsea
aspacer
bmc
bold
ccafs
... cutoff

Get back json - parse with jq

veyor projects --json | jq .[].builds[].status

"cancelled"
"success"
"success"
"failed"
"success"
"success"

List metadata for single project

veyor project cowsay

project: cowsay
repository: sckott/cowsay
branch: master
build status: cancelled
build ID: 3906530

JSON

veyor project cowsay --json | jq .project

{
  "projectId": 44589,
  "accountId": 13586,
  "accountName": "sckott",
  "builds": [],
  "name": "cowsay",
  "slug": "cowsay",
  "repositoryType": "gitHub",
  "repositoryScm": "git",
  "repositoryName": "sckott/cowsay",
  "repositoryBranch": "master",
  "isPrivate": false,
  "skipBranchesWithoutAppveyorYml": false,
  "enableSecu
...cutoff

Contributing

Bug reports and pull requests are welcome. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Code of Conduct.

License

The gem is available as open source under the terms of the MIT License.