libcppnetlib-dev 0.11.0-1.1 / usr / include / boost / mime.hpp

//
//          Copyright Marshall Clow 2009-2010
// Distributed under the Boost Software License, Version 1.0.
//    (See accompanying file LICENSE_1_0.txt or copy at
//          http://www.boost.org/LICENSE_1_0.txt)
//
//

#ifndef	_BOOST_MIME_HPP
#define	_BOOST_MIME_HPP

#include <list>
#include <string>
#include <vector>
#include <iosfwd>

#include <boost/spirit/include/qi.hpp>
#include <boost/fusion/include/std_pair.hpp>
#include <boost/spirit/include/phoenix.hpp>  // pulls in all of Phoenix
#include <boost/spirit/include/support_istream_iterator.hpp>
#include <boost/fusion/adapted/struct.hpp>

#include <boost/shared_ptr.hpp>
#include <boost/format.hpp>
#include <boost/algorithm/string/predicate.hpp>
#include <boost/algorithm/string.hpp>


// #define	DUMP_MIME_DATA	1


namespace boost { namespace mime {

//	Errors are reported using this exception class
class mime_parsing_error : public std::runtime_error {
public:
    explicit mime_parsing_error ( const std::string & msg ) : std::runtime_error ( msg ) {}
	};

template <class traits> class basic_mime;

namespace detail {

	static const char *k_crlf					= "\015\012";
	static const char *k_package_name			= "Proposed.Boost.Mime";
	static const char *k_package_version		= "0.1";
	static const char *k_content_type_header	= "Content-Type";
	static const char *k_mime_version_header	= "Mime-Version";

	struct default_types {
		typedef	std::string string_type;
	//	typedef std::pair < std::string, string_type > header_type;
		typedef std::vector<char> body_type;
		};


	template<typename string_type>
	struct find_mime_header {
		find_mime_header ( const char *str ) : searchFor ( str ) {}
		bool operator () ( const std::pair<std::string, string_type> &val ) const { return boost::iequals ( val.first, searchFor ); }
	private:
		const char *searchFor;
		};


#ifdef	DUMP_MIME_DATA
	struct tracer {
		tracer ( const char *fn ) : fn_ (fn) { std::cout << "->" << fn_ << std::endl; }
		~tracer () { std::cout << "<-" << fn_ << std::endl; }
		const char *fn_;
		};
#else
	struct tracer {
		tracer ( const char * ) {}
		~tracer () {}
		};
#endif

//	Parsing a Content-Type header
	typedef std::pair<std::string, std::string> phrase_t;
	typedef std::vector < phrase_t > phrase_container_t;
	struct mime_content_type {
		std::string			type;
		std::string 		sub_type;
		phrase_container_t	phrases;
		};
	

	namespace qi  = boost::spirit::qi;
	namespace phx = boost::phoenix;
	using boost::spirit::_val;
	using boost::spirit::_1;
	
	template <typename Iterator, typename Container>
	struct mime_header_parser : qi::grammar<Iterator, Container()>
	{
		mime_header_parser() : mime_header_parser::base_type(mime_headerList)
		{
			mime_headerList = *(mime_header) >> crlf;
			mime_header		= token >> qi::lit ( ':' ) >> value >> crlf;
			token			= qi::char_("a-zA-Z") >> *qi::char_("a-zA-Z_0-9\\-");

		//	In Classifieds/000001, a header begins with a CRLF
			value			= ( valuePart [ _val = _1 ] | qi::eps ) >> *(valueCont [ _val += "\015\012" + _1 ]);
			valueCont		= crlf >> contWS [ _val += _1 ] >> valuePart [ _val += _1 ];
			valuePart		= +qi::char_("\t -~");
			
			contWS			= +qi::char_( " \t");
			crlf			= qi::lit ( k_crlf );

		/*	mime_headerList.name("mime-header-list");
			mime_header.name    ("mime-header");
			token.name          ("mime-token");
			valuePart.name      ("mime-value-part");
			value.name          ("mime-value");

			qi::on_error<qi::fail> ( mime_headerList, 
				std::cout
					<< phoenix::val("Error! Expecting ") 
					<< qi::labels::_4 
					<< phoenix::val(" here: \"") 
					<< phoenix::construct<std::string>(qi::labels::_3, qi::labels::_2) 
					<< phoenix::val("\"")
					<< std::endl
				);
		*/	
		}
		
		qi::rule<Iterator, Container()> mime_headerList ;
		qi::rule<Iterator, typename Container::value_type()> mime_header;
		qi::rule<Iterator, std::string()> token, value, valueCont, valuePart, contWS;
		qi::rule<Iterator> crlf;
	};
	
	template<typename Container, typename Iterator>
	static Container read_headers ( Iterator &begin, Iterator end ) {
		tracer t ( __func__ );
		Container retVal;

		mime_header_parser<Iterator, Container> mh_parser;
		bool b = qi::parse ( begin, end, mh_parser, retVal );
		if ( !b )
			throw mime_parsing_error ( "Failed to parse headers" );
			
#ifdef	DUMP_MIME_DATA
		std::cout             << "******Headers*******" << std::endl;
		for ( typename Container::const_iterator iter = retVal.begin (); iter != retVal.end (); ++iter ) {
			std::string val = iter->second;
			size_t idx;
			while ( std::string::npos != ( idx = val.find ( k_crlf )))
				val.replace ( idx, std::strlen ( k_crlf ), "\n" );
			std::cout << iter->first << ": " << val << std::endl;
			}
		std::cout << std::endl << "******Headers*******" << std::endl;
#endif

		return retVal;
		}

//	The structure of a Content-Type mime header is taken from RFC 2045
//		http://www.ietf.org/rfc/rfc2045.txt, section 5.1

	template <typename Iterator>
	struct mime_content_type_parser : qi::grammar<Iterator, mime_content_type()>
	{
		mime_content_type_parser() : mime_content_type_parser::base_type(content_type_header)
		{
				content_type_header =  *qi::lit(' ') >> part >> '/' >> sub_part >> *phrase ;
	
				part				=  token | extension_token;
				sub_part			=  token | extension_token;
	
				phrase				=  qi::lit ( ';' ) >> +ws >> attribute >> '=' >> value >> *ws;
				ws					=  qi::char_( " \t") | line_sep | comment;
				line_sep			=  qi::lexeme[ qi::lit ( k_crlf ) ];
				
				attribute			= token.alias();
				value				= token | quoted_string;
				
				token				= +(qi::char_( " -~" ) - qi::char_( " ()<>@,;:\\\"/[]?=" ));
				comment				=  qi::lit ('(') >> +(qi::char_(" -~" ) - ')' ) >> qi::lit(')');
				quoted_string		=  qi::lit ('"') >> +(qi::char_(" -~" ) - '"' ) >> qi::lit('"');
				extension_token		=  qi::char_ ( "Xx" ) >> qi::lit ( '-' ) >> token;
		}
		
		qi::rule<Iterator, mime_content_type()> content_type_header ;
		qi::rule<Iterator, phrase_t()> phrase ;
		qi::rule<Iterator, std::string()> part, sub_part, token, attribute, value, quoted_string, extension_token;
		qi::rule<Iterator> ws, line_sep, comment;
	};
	
	template<typename string_type>
	mime_content_type parse_content_type ( const string_type &theHeader ) {
		tracer t ( __func__ );
		mime_content_type retVal;
		typename string_type::const_iterator first = theHeader.begin ();
		mime_content_type_parser<typename string_type::const_iterator> ct_parser;
		bool b = qi::parse ( first, theHeader.end (), ct_parser, retVal );
		if (!b)
			throw mime_parsing_error ( "Failed to parse the 'Content-Type' header" );
		
		return retVal;
		}

	template<typename string_type>
	static string_type get_ct_value ( const string_type &ctString, const char *key ) {
		tracer t ( __func__ );
		mime_content_type mc = parse_content_type ( ctString );
		for ( phrase_container_t::const_iterator iter = mc.phrases.begin (); iter != mc.phrases.end (); ++iter )
			if ( boost::iequals ( iter->first, key ))
				return iter->second;
		
		throw std::runtime_error ( str ( boost::format ( "Couldn't find Content-Type phrase (%s)" ) % key ));
		}
	

	//	Replace this with a spirit thing later.
	//	we're looking for '; boundary="<somevalue>".*'
	std::string get_boundary ( const std::string &ctString ) {
		tracer t ( __func__ );
		return get_ct_value ( ctString, "boundary" );
		}


	//	Read the body of a multipart 
	//	Return a Container of containers, where the first is the actual body,
	//	and the rest are the sub-parts.
	//	Note that the body of the multipart can be empty.
	//	If this is the case, then the first separator need not have a crlf

	//	if the marker is "abcde", we could have:
	//		Note that the separators are really CRLF--abcdeCRLF and CRLF--abcde--CRLF
	//
	//	multipart body
	//	--abcde
	//		sub part #1
	//	--abcde
	//		sub part #2
	//	--abcde--
	//
	//	** or **
	//	In this case, the first separator is --abcdeCRLF
	//
	//	--abcde		(no multipart body!)
	//		sub part #1
	//	--abcde
	//		sub part #2
	//	--abcde--
	
	typedef	std::vector<char>		sub_part_t;
	typedef std::vector<sub_part_t>	sub_parts_t;

	template<typename bodyContainer>
	struct multipart_body_type {
		bool							prolog_is_missing;
		bodyContainer					body_prolog;
		sub_parts_t						sub_parts;
		 bodyContainer					body_epilog;	
		};


	//	Parse a mulitpart body.
	//	Either "--boundaryCRLF" -- in which case the body is empty
	//	or		<some sequence of chars> "CRLF--boundaryCRLF" -- in which case we return the sequence
	//	
	//	I am deliberately not checking for a termination separator here
	template <typename Iterator, typename Container>
	struct multipart_body_parser : qi::grammar<Iterator, Container()> {
		multipart_body_parser( const std::string &boundary, bool &isMissing ) : multipart_body_parser::base_type(mimeBody), m_is_missing ( isMissing ) {
			m_is_missing = false;
		//	Thanks to Michael Caisse for the hint to get this working
			mimeBody	%= bareSep [ phx::ref ( m_is_missing ) = true ] | (+(qi::char_ - sep) >> sep ) ;
			bareSep	    = qi::lit("--") >> boundary >> crlf;
			sep	        = crlf >> bareSep;
			crlf 		= qi::lit ( k_crlf );
			}
	
		bool &m_is_missing;
		qi::rule<Iterator, Container()> mimeBody;
		qi::rule<Iterator> bareSep, sep, crlf;
		};
	
	
	//	Break up a multi-part into its' constituent sub parts.
	template <typename Iterator, typename Container>
	struct multipart_part_parser : qi::grammar<Iterator, Container()> {
		multipart_part_parser( const std::string &boundary ) : multipart_part_parser::base_type(mimeParts) {
			mimeParts	= (+(qi::char_ - sep) % (sep >> crlf)) > terminator ;
			sep	        = crlf >> qi::lit("--") >> boundary ;
			terminator	= sep >> qi::lit("--") >> crlf ;
			crlf 		= qi::lit ( k_crlf );
			}
		qi::rule<Iterator, Container()> mimeParts;
		qi::rule<Iterator> sep, terminator, crlf;
		};


	template<typename Iterator, typename bodyContainer>
	static void read_multipart_body ( Iterator &begin, Iterator end, multipart_body_type<bodyContainer> &mp_body, const std::string &separator ) {
		tracer t ( __func__ );
		typedef bodyContainer innerC;
		innerC mpBody;
		multipart_body_parser <Iterator, innerC> mb_parser (separator, mp_body.prolog_is_missing );
		if ( !qi::parse ( begin, end, mb_parser, mp_body.body_prolog ))
			throw mime_parsing_error ("Failed to parse mime body(1)");
		
		multipart_part_parser <Iterator, sub_parts_t> mp_parser ( separator );
		if ( !qi::parse ( begin, end, mp_parser, mp_body.sub_parts ))
			throw mime_parsing_error ( "Failed to parse mime body(2)");
		std::copy ( begin, end, std::back_inserter ( mp_body.body_epilog ));
		
	#ifdef	DUMP_MIME_DATA
			std::cout << std::endl << ">>****Multipart Body*******" << std::endl;
			std::cout << str ( boost::format ( "Body size %d, sub part count = %d, trailer size = %d %s" ) % mp_body.body_prolog.size () % mp_body.sub_parts.size () % mp_body.body_epilog.size () % ( mp_body.prolog_is_missing ? "(missing)" : "" )) << std::endl;
			std::cout << std::endl << "****** Multipart Body Prolog *******" << std::endl;
			std::copy ( mp_body.body_prolog.begin (), mp_body.body_prolog.end(), std::ostream_iterator<char> ( std::cout ));
			std::cout << std::endl << "****** Multipart Body Epilog *******" << std::endl;
			std::copy ( mp_body.body_epilog.begin (), mp_body.body_epilog.end(), std::ostream_iterator<char> ( std::cout ));
			std::cout << std::endl << "<<****Multipart Body*******" << std::endl;
	#endif
		}


	template<typename Container, typename Iterator>
	static Container read_simplepart_body ( Iterator &begin, Iterator end ) {
		tracer t ( __func__ );
		Container retVal;
		std::copy ( begin, end, std::back_inserter(retVal));
		
#ifdef	DUMP_MIME_DATA
		std::cout << std::endl << ">>****SinglePart Body*******" << std::endl;
		std::cout << str ( boost::format ( "Body size %d" ) % retVal.size ()) << std::endl;
		std::copy ( retVal.begin (), retVal.end(), std::ostream_iterator<char> ( std::cout ));
		std::cout << std::endl << "<<****SinglePart Body*******" << std::endl;
#endif
		return retVal;
		}

//	FIXME: Need to break the headers at 80 chars...
	template<typename headerList>
	void write_headers ( std::ostream &out, const headerList &headers ) {
		if ( headers.size () > 0 ) {
			for ( typename headerList::const_iterator iter = headers.begin (); iter != headers.end (); ++iter )
				out << iter->first << ':' << iter->second << detail::k_crlf;
			}
		out << detail::k_crlf;
		}
	
	template <typename bodyContainer>
	void write_body ( std::ostream &out, const bodyContainer &body ) {
		std::copy ( body.begin (), body.end (), std::ostream_iterator<char> ( out ));
		}
	
	inline void write_boundary ( std::ostream &out, std::string boundary, bool isLast, bool leadingCR = true ) {
		if ( leadingCR )
			out << detail::k_crlf;
		out << "--" << boundary;
		if ( isLast )
			out << "--";
		out << detail::k_crlf;
		}


	template<typename Iterator, typename traits>
	static boost::shared_ptr< basic_mime<traits> > parse_mime ( Iterator &begin, Iterator end, const char *default_content_type = "text/plain" );
	}


template <class traits = detail::default_types>
class basic_mime {
public:

	typedef enum { simple_part, multi_part, message_part } part_kind;
//	Types for headers
	typedef typename traits::string_type			string_type;
	typedef std::pair< std::string, string_type>	headerEntry;
	typedef std::list<headerEntry> 					headerList;
	typedef typename headerList::iterator			     headerIter;
	typedef typename headerList::const_iterator		constHeaderIter;

//	Types for the parts
	typedef boost::shared_ptr<basic_mime>		mimePtr;
	typedef std::vector<mimePtr>				partList;
	typedef typename partList::iterator				 partIter;
	typedef	typename partList::const_iterator	constPartIter;

//	Type for the body
	typedef	typename traits::body_type			bodyContainer;
	typedef boost::shared_ptr<bodyContainer>	mimeBody;
	
// -----------------------------------------------------------
//	Constructors, destructor, assignment, and swap
// -----------------------------------------------------------

	basic_mime ( const char *type, const char *subtype )
		: m_body_prolog_is_missing ( false ), m_body ( new bodyContainer ), m_body_epilog ( new bodyContainer ) {
		if ( NULL == type || NULL == subtype || 0 == std::strlen ( type ) || 0 == std::strlen ( subtype ))
			throw std::runtime_error ( "Can't create a mime part w/o a type or subtype" );
		
	//	We start with just two headers, "Content-Type:" and "Mime-Version"
	//	Everything else is optional.
		m_part_kind = part_kind_from_string_pair ( type, subtype );
		std::string ctString = str ( boost::format ( "%s/%s" ) % type % subtype );
		set_header_value ( detail::k_content_type_header, ctString );
		set_header_value ( detail::k_mime_version_header, str ( boost::format ( "1.0 (%s %s)" ) % detail::k_package_name % detail::k_package_version ));
		}
	
	basic_mime ( const headerList &theHeaders, const string_type &default_content_type )
		: m_body_prolog_is_missing ( false ), m_body ( new bodyContainer ), m_body_epilog ( new bodyContainer ),
			m_default_content_type ( default_content_type ) {
		string_type ct = m_default_content_type;
	
		constHeaderIter found = std::find_if ( theHeaders.begin (), theHeaders.end (), 
									detail::find_mime_header<string_type> ( detail::k_content_type_header ));
		if ( found != theHeaders.end ())
			ct = found->second;
		
		detail::mime_content_type mct = detail::parse_content_type ( ct );
		m_part_kind = part_kind_from_string_pair ( mct.type, mct.sub_type );
		m_headers = theHeaders;
		}
	
	basic_mime ( const basic_mime &rhs )
			: m_part_kind ( rhs.m_part_kind ), m_headers ( rhs.m_headers ), m_body_prolog_is_missing ( rhs.m_body_prolog_is_missing ), 
		  	m_body ( new bodyContainer ( *rhs.m_body )), m_body_epilog ( new bodyContainer ( *rhs.m_body_epilog )),
		/*	m_subparts ( rhs.m_subparts ), */ m_default_content_type ( rhs.m_default_content_type )
		{
	//	Copy the parts -- not just the shared pointers
		for ( typename partList::const_iterator iter = rhs.subpart_begin (); iter != rhs.subpart_end (); ++iter )
			m_subparts.push_back ( mimePtr ( new basic_mime ( **iter )));
		}

//	Simple, copy constructor-based assignment
//	If this is not efficient enough, then I can optimize it later
	basic_mime & operator = ( const basic_mime &rhs ) {
		basic_mime temp ( rhs );
		this->swap ( temp );
		return *this;
		}	

	void swap ( basic_mime &rhs ) throw () {
		std::swap ( m_part_kind,				rhs.m_part_kind );
		std::swap ( m_headers,					rhs.m_headers );
		std::swap ( m_body_prolog_is_missing,	rhs.m_body_prolog_is_missing );
		std::swap ( m_body,						rhs.m_body );
		std::swap ( m_body_epilog,				rhs.m_body_epilog );
		std::swap ( m_subparts,					rhs.m_subparts );
		std::swap ( m_default_content_type, 	rhs.m_default_content_type );
		}

	~basic_mime () {}
	

//	What kind of part is this (simple, multi, message)
	part_kind get_part_kind () const { return m_part_kind; }

//	Sub-part information
//	FIXME: Need some error checking here
//		No sub-parts for simple parts, for example.
	size_t part_count () const { return m_subparts.size (); }

	boost::shared_ptr <basic_mime> operator [] ( std::size_t idx ) const {
		check_subpart_index ( idx );
		return m_subparts [ idx ];
		}

	void append_part ( boost::shared_ptr<basic_mime> newPart ) {
		check_subpart_append ();
		m_subparts.push_back ( newPart );
		}
	
	partIter		subpart_begin ()		{ return m_subparts.begin (); }
	partIter		subpart_end   ()		{ return m_subparts.end   (); }
	constPartIter	subpart_begin () const	{ return m_subparts.begin (); }
	constPartIter	subpart_end   () const	{ return m_subparts.end   (); }
	
//	Reading the raw headers
	headerIter 		header_begin ()			{ return m_headers.begin (); }
	headerIter 		header_end   ()			{ return m_headers.end   (); }
	constHeaderIter header_begin () const	{ return m_headers.begin (); }
	constHeaderIter header_end   () const	{ return m_headers.end   (); }

// -----------------------------------------------------------
//	Header manipulation
// -----------------------------------------------------------

//	The 'tag' part of the header is still a std::string
	bool header_exists ( const char *key ) const {
		return header_end () != find_header ( key );
		}
		
	string_type header_value  ( const char *key ) const  {
		constHeaderIter found = find_header ( key );
		if ( found == header_end ())
			throw std::runtime_error ( "'header_value' not found" );
		return found->second;
		}
	
	void set_header_value  ( const char *key, const string_type &value, bool replace = false ) {
		if ( !replace )
			m_headers.push_back ( std::make_pair ( std::string ( key ), value ));
		else {
			headerIter found = find_header ( key );
			if ( found == m_headers.end ())
				throw std::runtime_error ( "'header_value' not found - can't replace" );
			found->second = value;
			}
		}

		
	string_type	get_content_type_header () const {
		constHeaderIter found = find_header ( detail::k_content_type_header );
		return found != header_end () ? found->second : m_default_content_type;
		}
	
	
	string_type	get_content_type () const {
		detail::mime_content_type mct = detail::parse_content_type ( get_content_type_header ());
		return string_type ( mct.type ) + '/' + mct.sub_type;
		}
	

//	Special purpose helper routine
	void	append_phrase_to_content_type ( const char *key, const string_type &value ) {
		headerIter found = find_header ( detail::k_content_type_header );
	
	//	Create a Content-Type header if there isn't one
		if ( m_headers.end () == found ) {
			m_headers.push_back ( std::make_pair ( std::string ( detail::k_content_type_header ), m_default_content_type ));
			found = find_header ( detail::k_content_type_header );
			}
	
		detail::mime_content_type mct = detail::parse_content_type ( found->second );
		detail::phrase_container_t::const_iterator p_found =
			std::find_if ( mct.phrases.begin (), mct.phrases.end (), 
				detail::find_mime_header<std::string> ( key ));
		if ( p_found != mct.phrases.end ())
			throw std::runtime_error ( "phrase already exists" );
		found->second += str ( boost::format ( "; %s=\"%s\"" ) % key % value );
	}	
	
	
//	Body get/set methods
	mimeBody body ()		const { return m_body; }
	mimeBody body_prolog ()	const { return m_body; }
	mimeBody body_epilog ()	const { return m_body_epilog; }

	std::size_t body_size () const { return m_body->size (); }

	template <typename Iterator>
	void set_body ( Iterator begin, Iterator end ) {
		bodyContainer temp;
		std::copy ( begin, end, std::back_inserter ( temp ));
		m_body->swap ( temp );
		}

	void set_body ( const char *contents, size_t sz ) { set_body ( contents, contents + sz ); }
	void set_body ( std::istream &in )                { set_body ( std::istream_iterator<char> ( in ), std::istream_iterator<char> ()); }
	void set_body ( const bodyContainer &new_body )   { *m_body = new_body; }

	void set_multipart_prolog_is_missing ( bool isMissing ) { m_body_prolog_is_missing = isMissing; }
	void set_body_prolog ( const bodyContainer &new_body_prolog ) { *m_body        = new_body_prolog; }
	void set_body_epilog ( const bodyContainer &new_body_epilog ) { *m_body_epilog = new_body_epilog; }

// -----------------------------------------------------------
//	Output
// -----------------------------------------------------------
	void stream_out ( std::ostream &out ) {	// called by operator << 
		if ( m_part_kind == simple_part ) {
			detail::write_headers ( out, m_headers );
			detail::write_body ( out, *m_body );
			}
		else if ( m_part_kind == message_part ) {
			if ( m_subparts.size () != 1 )
				throw std::runtime_error ( "message part w/wrong number of sub-parts - should be 1" );
				
			detail::write_headers ( out, m_headers );
			m_subparts [ 0 ]->stream_out ( out );
			}
		else { //	multi-part
		//	Find or invent a boundary string
			std::string boundary;
			try { boundary = detail::get_boundary ( get_content_type_header ()); }
			catch ( std::runtime_error & ) {
			//	FIXME: Make boundary strings (more?) unique
				boundary = str ( boost::format ( "------=_NextPart-%s.%08ld" ) % detail::k_package_name % std::clock ());
				append_phrase_to_content_type ( "boundary", boundary );
				}
			
		//	If the body prolog is missing, we don't want a CRLF on the front of the first sub-part.
		//	Note that there's a (subtle) difference between an zero length body and a missing one.
		//	See the comments in the parser code for more information.
			detail::write_headers ( out, m_headers );
			bool writeCR = body_prolog ()->size () > 0 || !m_body_prolog_is_missing;
			detail::write_body ( out, *body_prolog ());
			for ( typename partList::const_iterator iter = m_subparts.begin (); iter != m_subparts.end (); ++iter ) {
				detail::write_boundary ( out, boundary, false, writeCR );
				(*iter)->stream_out ( out );
				writeCR = true;
				}
			detail::write_boundary ( out, boundary, true );
			detail::write_body ( out, *body_epilog ());
			}
	//	out << detail::k_crlf;
		}
	
//	Build a simple mime part
	template <typename Iterator>
	static basic_mime make_simple_part ( const char *type, const char *subtype, Iterator begin, Iterator end ) {
		basic_mime retval ( type, subtype );
		retval.set_body ( begin, end );
		return retval;
		}

//	Build a mime part from a pair of iterators
	template <typename Iterator>
	static boost::shared_ptr< basic_mime<traits> > parse_mime ( Iterator &begin, Iterator end ) {
		return detail::parse_mime<Iterator, traits> ( begin, end );
		}

//	Build a mime part from a stream
	static boost::shared_ptr < basic_mime > parse_mime ( std::istream &in ) {
		boost::spirit::istream_iterator first (in);
		boost::spirit::istream_iterator last;
		return parse_mime ( first, last );
		}
		

private:
	basic_mime ();	// Can't create a part w/o a type

	headerIter	find_header ( const char *key ) {
		return std::find_if ( header_begin (), header_end (), detail::find_mime_header<string_type> ( key ));
		}
	
	constHeaderIter find_header ( const char *key ) const {
		return std::find_if ( header_begin (), header_end (), detail::find_mime_header<string_type> ( key ));
		}

	static part_kind part_kind_from_string_pair ( const std::string &type, const std::string &sub_type ) {
		if ( boost::iequals ( type, "multipart" ))
			return multi_part;
			
		part_kind retVal = simple_part;
	//	I expect that this will get more complicated as time goes on....
	//
	//	message/delivery-status is a simple type.
	//	RFC 3464 defines message/delivery-status <http://www.faqs.org/rfcs/rfc3464.html>
	//	The body of a message/delivery-status consists of one or more
	//	   "fields" formatted according to the ABNF of RFC 822 header "fields"
	//	   (see [RFC822]).  
		if ( boost::iequals ( type, "message" ))
			if ( !boost::iequals ( sub_type, "delivery-status" ))
				retVal = message_part;
		return retVal;
		}
	
	void check_subpart_index ( size_t idx ) const {
		if ( get_part_kind () == simple_part )
			throw std::runtime_error ( "Simple Mime parts don't have sub-parts" );
		else if ( get_part_kind () == multi_part ) {
				if ( idx >= m_subparts.size ())
					throw std::runtime_error ( 
						str ( boost::format ( "Trying to access part %d (of %d) sub-part to a multipart/xxx mime part" ) % idx %  m_subparts.size ()));
			}
		else {	// message-part
			if ( get_part_kind () == message_part )
				if ( m_subparts.size () > 1 )
					throw std::runtime_error ( "How did a message/xxx mime parts get more than one sub-part?" );

			if ( idx >= m_subparts.size ())
				throw std::runtime_error ( 
					str ( boost::format ( "Trying to access part %d (of %d) sub-part to a message/xxx mime part" ) % idx %  m_subparts.size ()));
			}
		}

	void check_subpart_append () const {
		if ( get_part_kind () == simple_part )
			throw std::runtime_error ( "Simple Mime parts don't have sub-parts" );
		else if ( get_part_kind () == message_part ) {
			if ( m_subparts.size () > 0 )
				throw std::runtime_error ( "Can't add a second sub-part to a message/xxx mime part" );
			}
	//	else { /* Multi-part */ }	// We can always add to a multi-part
		}
	
	part_kind	m_part_kind;
	headerList	m_headers;
	bool		m_body_prolog_is_missing;	// only for multiparts
	mimeBody	m_body;
	mimeBody	m_body_epilog;				// only for multiparts
	partList	m_subparts;					// only for multiparts or message
	string_type	m_default_content_type;
	};


namespace detail {

	template<typename Iterator, typename traits>
	static boost::shared_ptr< basic_mime<traits> > parse_mime ( Iterator &begin, Iterator end, const char *default_content_type ) {
		tracer t ( __func__ );
		typedef	typename boost::mime::basic_mime<traits>	mime_part;
		
		shared_ptr < mime_part > retVal (
			new mime_part ( detail::read_headers<typename mime_part::headerList> ( begin, end ), default_content_type ));
	
		std::string content_type = retVal->get_content_type ();

#ifdef	DUMP_MIME_DATA
		std::cout << "Content-Type: " << content_type << std::endl;
		std::cout << str ( boost::format ( "retVal->get_part_kind () = %d" ) % ((int) retVal->get_part_kind ())) << std::endl;
#endif

		if ( retVal->get_part_kind () == mime_part::simple_part )
			retVal->set_body ( detail::read_simplepart_body<typename mime_part::bodyContainer, Iterator> ( begin, end ));
		else if ( retVal->get_part_kind () == mime_part::message_part ) {
		//	If we've got a message/xxxx, then there is no body, and we have a single
		//	embedded mime_part (which, of course, could be a multipart)
			retVal->append_part ( parse_mime<Iterator, traits> ( begin, end ));
			}
		else /* multi_part */ {
		//	Find or invent a boundary string
			std::string part_separator = detail::get_boundary ( retVal->get_content_type_header ());
			const char *cont_type = boost::iequals ( content_type, "multipart/digest" ) ? "message/rfc822" : "text/plain";
			
			detail::multipart_body_type<typename traits::body_type> body_and_subParts;
			detail::read_multipart_body ( begin, end, body_and_subParts, part_separator );

			retVal->set_body_prolog ( body_and_subParts.body_prolog );
			retVal->set_multipart_prolog_is_missing ( body_and_subParts.prolog_is_missing );
			for ( typename sub_parts_t::const_iterator iter = body_and_subParts.sub_parts.begin ();
					iter != body_and_subParts.sub_parts.end (); ++iter ) {
				typedef typename sub_part_t::const_iterator iter_type;
				iter_type b = iter->begin ();
				iter_type e = iter->end ();
				retVal->append_part ( parse_mime<iter_type, traits> ( b, e, cont_type ));
				}
			retVal->set_body_epilog ( body_and_subParts.body_epilog );
			}
		
		return retVal;
		}	
	
	}


// -----------------------------------------------------------
//
//	Streaming
//
// -----------------------------------------------------------

template<typename traits>
inline std::ostream & operator << ( std::ostream &stream, basic_mime<traits> &part ) {
	part.stream_out ( stream );
	return stream;
	}

template<typename traits>
inline std::ostream & operator << ( std::ostream &stream, boost::shared_ptr <basic_mime<traits> > part ) {
	return stream << *part;
	}


		
}}

BOOST_FUSION_ADAPT_STRUCT(
   boost::mime::detail::mime_content_type,
   (std::string, type)
   (std::string, sub_type)
   (boost::mime::detail::phrase_container_t, phrases)
)

#endif	// _BOOST_MIME_HPP