Project

basecamper

0.0
No commit activity in last 3 years
No release in over 3 years
Basecamp API Wrapper
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.10.0
~> 0.8.7
~> 2.5.0

Runtime

 Project Readme

Basecamper

travis

Basecamper is a Ruby wrapper to the 37 Signals Basecamp API

Installation

Simply add the gem to your Gemfile

    gem 'basecamper'

Configuration

Add authentication configurations:

    Basecamper.configure do |config|
      config.token   = '123abc'
      config.domain  = 'dummy.basecamphq.com'
    end

Basecamper also enables one to authenticate with one's username and password:

    Basecamper.configure do |config|
      config.user      = '123abc'
      config.password  = 'secret'
    end

Authentication using OAuth is also supported:

    Basecamper.configure do |config|
      config.use_oauth  = true
      config.token      = 'abc123'
    end

Use SSL?

    Basecamper.configure {|c| c.use_ssl = true }

Usage

View account info:

    Basecamper.account

Return current user:

    Basecamper::Person.me

Basic operations:

    Basecamper::Project.all
    returns:  [#<Basecamper::Project:0x266e458 @attributes={"company"=>..}>]

    Basecamper::Project.first
    returns:  #<Basecamper::Project:0x266e458 @attributes={"company"=>..}>

Advanced queries:

    Basecamper::TodoList.all(:params => { :project_id => 1234 })
    Basecamper::TodoList.find(:all, :params => { :project_id => 1234, :responsible_party => 9124 })

Child assocations:

    project = Basecamper::Project.find(123)
    project.messages

Parent associations:

    message = Basecamper::Message.find(123)
    message.project

Credits