#+TITLE: RubyGems Concourse Resource
#+SUBTITLE: A Custom Resource for Concourse
#+LATEX: \pagebreak

* Overview

RubyGems Integration for Concourse Pipelines.

* Usage

Add the resource to your pipeline's ~resource_types~ (requires Concourse 0.74.0+)

#+BEGIN_SRC yaml
  resource_types:
    - name: rubygems
      type: docker-image
      source:
        repository: resource/rubygems
#+END_SRC

* Source Configuration

|---------+----------+--------------+----------------------|
| Name    | Required | Default      | Description          |
|---------+----------+--------------+----------------------|
| gem     | Yes      |              | The name of the gem  |
| host    | No       | rubygems.org | The RubyGems host    |
| api_key | Yes      |              | Key for RubyGems API |
|---------+----------+--------------+----------------------|

* Behaviour

** ~check~ Find the available versions for a gem

*** Parameters

- None

** ~in~ Fetch a gem

Fetch a gem.

*** Parameters

- None

** ~out~ Publish a gem

*** Parameters

|------+----------+------------------+--------------------------------------|
| Name | Required | Default          | Description                          |
|------+----------+------------------+--------------------------------------|
| glob | no       | pkg/#{gem}-*.gem | Globbing pattern for files to upload |
|------+----------+------------------+--------------------------------------|

* License


  ~concourse-resource-rubygems~ is available under the [[https://tldrlegal.com/license/mit-license][MIT License]]. See
  ~LICENSE.txt~ for the full text.

* Contributors

- [[https://colstrom.github.io/][Chris Olstrom]] | [[mailto:chris@olstrom.com][e-mail]] | [[https://twitter.com/ChrisOlstrom][Twitter]]