improved makefile dependencies checking, posterous connector

posterous/posterous-api.php

@@ -0,0 +1,248 @@
+<?php /*
+Name: Posterous API Library
+Description: Object-oriented PHP class for accessing the Posterous API
+Author: Calvin Freitas
+Version: 0.1.0
+Author URI: http://calvinf.com/
+License:  MIT License (see LICENSE) http://creativecommons.org/licenses/MIT/
+Warranties: None
+Last Modified: December 07, 2009
+Requirements: PHP 5 or higher.
+*/
+
+/*
+Copyright (c) 2009 Calvin Freitas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+/* Define Static Variables */
+define('POSTEROUS_API_LIBRARY_VERSION','1.0');
+define('POSTEROUS_API_LIBRARY_RELEASE_DATE','December 07, 2009');
+define('POSTEROUS_API_LIBRARY_URL','http://calvinf.com/projects/posterous-api-library-php/');
+define('POSTEROUS_API_LIBRARY_AUTHOR_NAME','Calvin Freitas');
+define('POSTEROUS_API_LIBRARY_AUTHOR_URL','http://calvinf.com/');
+define('POSTEROUS_API_LIBRARY_AUTHOR_EMAIL','cal@calvinfreitas.com');
+
+define('POSTEROUS_API_URL', 'http://posterous.com/api/');
+
+// ensure Curl extension installed
+if(!extension_loaded("curl")) {
+	throw(new Exception("The Curl extension for PHP is required for PosterousAPI to work."));
+}
+
+/* Useful to catch this exception separately from standard PHP Exceptions */
+class PosterousException extends Exception {}
+
+/* This class contains functions for calling the Posterous API */
+class PosterousAPI {
+	private $user;
+	private $pass;
+
+	function __construct($user = NULL, $pass = NULL) {
+		$this->user = $user;
+		$this->pass = $pass;
+	}
+
+	/* Reading Methods - http://posterous.com/api/reading */
+	function getsites() {
+		$api_method = 'getsites';
+		$xml = $this->_call( $api_method );
+		return $xml;
+	}
+
+	function readposts($args) {
+		$api_method = 'readposts';
+
+		$valid_args = array('hostname','site_id','num_posts','page','tag');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	function gettags($args) {
+		$api_method = 'gettags';
+
+		$valid_args = array('hostname','site_id');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	/* Posting Methods - http://posterous.com/api/posting */
+	function newpost($args) {
+		$api_method = 'newpost';
+
+		if (!$this->_auth()) {
+			throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
+		}
+
+		$valid_args = array('site_id','media','title','body','autopost','private','date','tags','source','sourceLink');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	function updatepost($args) {
+		$api_method = 'updatepost';
+
+		if (!$this->_auth()) {
+			throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
+		}
+
+		$valid_args = array('post_id','media','title','body');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	function newcomment($args) {
+		$api_method = 'newcomment';
+
+		$valid_args = array('post_id','comment','name','email','date');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	/* Post.ly Methods - http://posterous.com/api/postly */
+
+	function getpost($args) {
+		$api_method = 'getpost';
+
+		$valid_args = array('id');
+		$method_args = $this->_validate($args, $valid_args);
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	/* Twitter Methods - http://posterous.com/api/twitter */
+	function upload() {
+		$api_method = 'upload';
+
+		$valid_args = array('username','password','media','message','body','source','sourceLink');
+		$method_args = $this->_validate( $args, $method_args );
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+	function uploadAndPost() {
+		$api_method = 'uploadAndPost';
+
+		$valid_args = array('username','password','media','message','body','source','sourceLink');
+		$method_args = $this->_validate( $args, $method_args );
+
+		$xml = $this->_call( $api_method, $method_args );
+		return $xml;
+	}
+
+
+	/* Helper Functions */
+	private function _call($api_method, $method_args = NULL) {
+		$method_url = POSTEROUS_API_URL . $api_method;
+
+		$user = $this->user();
+		$pass = $this->pass();
+
+		$ch = curl_init();
+		curl_setopt($ch, CURLOPT_URL, $method_url);
+		curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+		curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
+		curl_setopt($ch, CURLOPT_HEADER, false);
+		curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+
+		if (isset($user) && isset($pass) && $user != '' && $pass != '') {
+			curl_setopt($ch, CURLOPT_USERPWD, $user . ':' . $pass);
+		}
+
+		curl_setopt($ch, CURLOPT_POST, 1);
+
+		if ( is_array($method_args) && !empty($method_args) ) {
+			curl_setopt($ch, CURLOPT_POSTFIELDS, $method_args);
+		}
+
+		$data = curl_exec($ch);
+		//$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
+		curl_close($ch);
+
+		$xml = '';
+		try {
+			$xml = new SimpleXMLElement($data);
+
+			$response_status = $xml['stat'];
+			if ($response_status == 'ok') {
+				return $xml;
+			}
+			elseif ($response_status == 'fail') {
+				throw new PosterousException('Error Code ' . $xml->err['code'] . ': ' . $xml->err['msg']);
+			}
+			else {
+				throw new PosterousException('Error: Invalid Posterous response status.');
+			}
+		}
+		catch (Exception $e) {
+			throw $e;
+		}
+	}
+
+	private function _validate($args, $valid_args) {
+		$method_args = array();
+		foreach($args as $key => $value) {
+			if( in_array($key, $valid_args) ) {
+				$method_args[$key] = $value;
+			}
+		}
+
+		return $method_args;
+	}
+
+	private function _auth() {
+		//checks if object has user & password, does not verify w/ Posterous
+		if (isset($this->user) && isset($this->pass) && $this->user != '' && $this->pass != '') {
+			return TRUE;
+		}
+		else {
+			return FALSE;
+		}
+	}
+
+	/* Getters & Setters */
+	function user($user = NULL) {
+		if ($user) {
+			$this->user = $user;
+		}
+		return $this->user;
+	}
+
+	function pass($pass = NULL) {
+		if ($pass) {
+			$this->pass = $pass;
+		}
+		return $this->pass;
+	}
+}
+
+?>