Contents

= libpcloud

* {Homepage}[https://rubygems.org/gems/libpcloud]
* {Documentation}[http://rubydoc.info/gems/libpcloud/frames]
* {Email}[mailto:[e-mail]]

== Description

Ruby library for communicating with the {packagecloud.io}[https://packagecloud.io] API.

== Features

Implemented:

  * {Get Package Contents}[https://packagecloud.io/docs/api#resource_packages_method_contents]
  * {Create Package}[https://packagecloud.io/docs/api#resource_packages_method_create]
  * {List distributions}[https://packagecloud.io/docs/api#resource_distributions_method_index]

== Usage

  require 'packagecloud'

  # Create a client
  credentials = Credentials.new("joedamato", "test_token")
  @client = PackageCloud.new(credentials)

  # Get distributions
  distros = @client.distributions

  # Looking up a distribution id by name
  id = @client.find_distribution_id("centos/6") # returns 12

  # Looking up all repositories available for a client
  repos = @client.repositories

  # Lookup info on a single repo
  repo = @client.repository("my_repo")

  # Creating a repository
  @client.create_repository("my_repo")

  # Create Packages (takes IO object for file)
  gem_package = Package.new(open("rails-4.0.0.gem"))
  rpm_package = Package.new(open("libcurl-0.1.2.rpm"), 12) # 12 being the distribution id for centos/6, for example

  # Creating source Packages
  source_files = { "jake_1.0.orig.tar.bz2" => open("/path/jake_1.0.orig.tar.bz2"),
                   "jake_1.0-7.debian.tar.gz" => open("/path/jake_1.0-7.debian.tar.gz") }
  dsc_package = Package.new("jake_1.0-7.dsc", 20, source_files)

  # Upload Packages
  @client.put_package("test_repo", gem_package)
  @client.put_package("test_repo", rpm_package)
  @client.put_package("test_repo", dsc_package)

== Install

  $ gem install libpcloud

== Copyright

Copyright (c) 2014 Computology, LLC

See LICENSE.txt for details.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
packagecloud-ruby-0.2.16	README.rdoc