/*
	grive: an GPL program to sync a local directory with Google Drive
	Copyright (C) 2012  Wan Wai Ho

	This program is free software; you can redistribute it and/or
	modify it under the terms of the GNU General Public License
	as published by the Free Software Foundation version 2
	of the License.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
*/

#pragma once

#include <memory>
#include <string>
#include <vector>

namespace gr { namespace http {

typedef std::vector<std::string> Headers ;

class Receivable ;

/*!	\class	Agent
	\brief	class to provide HTTP access
	
	This class provides functions to send HTTP request in many methods (e.g. get, post and put).
	Normally the HTTP response is returned in a Receivable.
*/
class Agent
{
public :
	Agent() ;
	~Agent() ;
	
	void SetLogFile( const std::string& prefix ) ;
	
	long Put(
		const std::string&		url,
		const std::string&		data,
		Receivable				*dest,
		const http::Headers&	hdr = http::Headers() ) ;

	long Get(
		const std::string& 		url,
		Receivable				*dest,
		const http::Headers&	hdr = http::Headers() ) ;
	
	long Post(
		const std::string& 		url,
		const std::string&		data,
		Receivable				*dest,
		const http::Headers&	hdr = http::Headers() ) ;
	
	long Custom(
		const std::string&		method,
		const std::string&		url,
		Receivable				*dest,
		const http::Headers&	hdr = http::Headers() ) ;
	
	std::string RedirLocation() const ;
	
	std::string Escape( const std::string& str ) ;
	std::string Unescape( const std::string& str ) ;

private :
	static std::size_t HeaderCallback( void *ptr, size_t size, size_t nmemb, Agent *pthis ) ;
	static std::size_t Receive( void* ptr, size_t size, size_t nmemb, Receivable *recv ) ;
	
	void SetHeader( const http::Headers& hdr ) ;
	long ExecCurl(
		Receivable				*dest,
		const http::Headers&	hdr) ;
		
private :
	struct Impl ;
	std::auto_ptr<Impl>	m_pimpl ;
} ;

} } // end of namespace