instapaper

What

The instapaper gem provides a neat interface to the Instapaper API.

Installing

sudo gem install instapaper

Demonstration of usage

	
	# "password" is optional
	base = Instapaper::Base.new("username","password")
	
	# Test authentication (not required to add url)
	result = base.authenticate 
		# => Instapaper::Response::AuthenticationSuccessResponse
	
	result.code  # => 200
	
	# Add URL
	result = base.add("http://example.org/some-article.html") 
		# => Instapaper::Response::AddURLSuccess

	result.code	 # => 200
	
	# Bad Auth
	base   = Instapaper::Base.new("baduser","badpass")
	result = base.authenticate 
		# => Instapaper::Response::AuthenticationInvalidResponse
	
	result.code  # => 403
	
	# Advanced usage
	base    = Instapaper::Base.new("username","password")
	options = {:url => "http://example.org/some-article.html", :title => "MyArticle"}
	request = AddURLRequest.new(options,"username","password")
	
	base.secure? # => true (as default)
	
	base.use_clear_protocol! 
		# => connection will now use HTTP instead of HTTPS
	
	response = base.send_request(request)
	

Build and test instructions

cd instapaper
rake test
rake install_gem

Limits

The gem implements all the functionality provided by the Instapaper API.

License

This code is free to use under the terms of the MIT license.

Contact

Comments are welcome. Send an email to Douglas Willcocks

Douglas Willcocks, 17th February 2009
Theme extended from Paul Battley