Chris@16: // Copyright David Abrahams 2002.
Chris@16: // Distributed under the Boost Software License, Version 1.0. (See
Chris@16: // accompanying file LICENSE_1_0.txt or copy at
Chris@16: // http://www.boost.org/LICENSE_1_0.txt)
Chris@16: #ifndef ARG_TO_PYTHON_DWA200265_HPP
Chris@16: # define ARG_TO_PYTHON_DWA200265_HPP
Chris@16: 
Chris@16: # include <boost/python/ptr.hpp>
Chris@16: # include <boost/python/tag.hpp>
Chris@16: # include <boost/python/to_python_indirect.hpp>
Chris@16: 
Chris@16: # include <boost/python/converter/registered.hpp>
Chris@16: # include <boost/python/converter/registered_pointee.hpp>
Chris@16: # include <boost/python/converter/arg_to_python_base.hpp>
Chris@16: # include <boost/python/converter/shared_ptr_to_python.hpp>
Chris@16: // Bring in specializations
Chris@16: # include <boost/python/converter/builtin_converters.hpp>
Chris@16: 
Chris@16: # include <boost/python/object/function_handle.hpp>
Chris@16: 
Chris@16: # include <boost/python/base_type_traits.hpp>
Chris@16: 
Chris@16: # include <boost/python/detail/indirect_traits.hpp>
Chris@16: # include <boost/python/detail/convertible.hpp>
Chris@16: # include <boost/python/detail/string_literal.hpp>
Chris@16: # include <boost/python/detail/value_is_shared_ptr.hpp>
Chris@16: 
Chris@16: # include <boost/type_traits/cv_traits.hpp>
Chris@16: # include <boost/type_traits/composite_traits.hpp>
Chris@16: # include <boost/type_traits/function_traits.hpp>
Chris@16: 
Chris@16: 
Chris@16: # include <boost/mpl/or.hpp>
Chris@16: 
Chris@16: namespace boost { namespace python { namespace converter { 
Chris@16: 
Chris@16: template <class T> struct is_object_manager;
Chris@16: 
Chris@16: namespace detail
Chris@16: {
Chris@16:   template <class T>
Chris@16:   struct function_arg_to_python : handle<>
Chris@16:   {
Chris@16:       function_arg_to_python(T const& x);
Chris@16:   };
Chris@16: 
Chris@16:   template <class T>
Chris@16:   struct reference_arg_to_python : handle<>
Chris@16:   {
Chris@16:       reference_arg_to_python(T& x);
Chris@16:    private:
Chris@16:       static PyObject* get_object(T& x);
Chris@16:   };
Chris@16: 
Chris@16:   template <class T>
Chris@16:   struct shared_ptr_arg_to_python : handle<>
Chris@16:   {
Chris@16:       shared_ptr_arg_to_python(T const& x);
Chris@16:    private:
Chris@16:       static PyObject* get_object(T& x);
Chris@16:   };
Chris@16: 
Chris@16:   template <class T>
Chris@16:   struct value_arg_to_python : arg_to_python_base
Chris@16:   {
Chris@16:       // Throw an exception if the conversion can't succeed
Chris@16:       value_arg_to_python(T const&);
Chris@16:   };
Chris@16: 
Chris@16:   template <class Ptr>
Chris@16:   struct pointer_deep_arg_to_python : arg_to_python_base
Chris@16:   {
Chris@16:       // Throw an exception if the conversion can't succeed
Chris@16:       pointer_deep_arg_to_python(Ptr);
Chris@16:   };
Chris@16: 
Chris@16:   template <class Ptr>
Chris@16:   struct pointer_shallow_arg_to_python : handle<>
Chris@16:   {
Chris@16:       // Throw an exception if the conversion can't succeed
Chris@16:       pointer_shallow_arg_to_python(Ptr);
Chris@16:    private:
Chris@16:       static PyObject* get_object(Ptr p);
Chris@16:   };
Chris@16: 
Chris@16:   // Convert types that manage a Python object to_python
Chris@16:   template <class T>
Chris@16:   struct object_manager_arg_to_python
Chris@16:   {
Chris@16:       object_manager_arg_to_python(T const& x) : m_src(x) {}
Chris@16:       
Chris@16:       PyObject* get() const
Chris@16:       {
Chris@16:           return python::upcast<PyObject>(get_managed_object(m_src, tag));
Chris@16:       }
Chris@16:       
Chris@16:    private:
Chris@16:       T const& m_src;
Chris@16:   };
Chris@16: 
Chris@16:   template <class T>
Chris@16:   struct select_arg_to_python
Chris@16:   {
Chris@16:       typedef typename unwrap_reference<T>::type unwrapped_referent;
Chris@16:       typedef typename unwrap_pointer<T>::type unwrapped_ptr;
Chris@16: 
Chris@16:       typedef typename mpl::if_<
Chris@16:           // Special handling for char const[N]; interpret them as char
Chris@16:           // const* for the sake of conversion
Chris@16:           python::detail::is_string_literal<T const>
Chris@16:         , arg_to_python<char const*>
Chris@16: 
Chris@16:         , typename mpl::if_<
Chris@16:               python::detail::value_is_shared_ptr<T>
Chris@16:             , shared_ptr_arg_to_python<T>
Chris@16:       
Chris@16:             , typename mpl::if_<
Chris@16:                 mpl::or_<
Chris@16:                     is_function<T>
Chris@16:                   , indirect_traits::is_pointer_to_function<T>
Chris@16:                   , is_member_function_pointer<T>
Chris@16:                 >
Chris@16:                 , function_arg_to_python<T>
Chris@16: 
Chris@16:                 , typename mpl::if_<
Chris@16:                       is_object_manager<T>
Chris@16:                     , object_manager_arg_to_python<T>
Chris@16: 
Chris@16:                     , typename mpl::if_<
Chris@16:                           is_pointer<T>
Chris@16:                         , pointer_deep_arg_to_python<T>
Chris@16: 
Chris@16:                         , typename mpl::if_<
Chris@16:                               is_pointer_wrapper<T>
Chris@16:                             , pointer_shallow_arg_to_python<unwrapped_ptr>
Chris@16: 
Chris@16:                             , typename mpl::if_<
Chris@16:                                   is_reference_wrapper<T>
Chris@16:                                 , reference_arg_to_python<unwrapped_referent>
Chris@16:                                 , value_arg_to_python<T>
Chris@16:                               >::type
Chris@16:                           >::type
Chris@16:                       >::type
Chris@16:                   >::type
Chris@16:               >::type
Chris@16:           >::type
Chris@16:       >::type
Chris@16:       
Chris@16:       type;
Chris@16:   };
Chris@16: }
Chris@16: 
Chris@16: template <class T>
Chris@16: struct arg_to_python
Chris@16:     : detail::select_arg_to_python<T>::type
Chris@16: {
Chris@16:     typedef typename detail::select_arg_to_python<T>::type base;
Chris@16:  public: // member functions
Chris@16:     // Throw an exception if the conversion can't succeed
Chris@16:     arg_to_python(T const& x);
Chris@16: };
Chris@16: 
Chris@16: //
Chris@16: // implementations
Chris@16: //
Chris@16: namespace detail
Chris@16: {
Chris@16:   // reject_raw_object_ptr -- cause a compile-time error if the user
Chris@16:   // should pass a raw Python object pointer
Chris@16:   using python::detail::yes_convertible;
Chris@16:   using python::detail::no_convertible;
Chris@16:   using python::detail::unspecialized;
Chris@16:   
Chris@16:   template <class T> struct cannot_convert_raw_PyObject;
Chris@16: 
Chris@16:   template <class T, class Convertibility>
Chris@16:   struct reject_raw_object_helper
Chris@16:   {
Chris@16:       static void error(Convertibility)
Chris@16:       {
Chris@16:           cannot_convert_raw_PyObject<T*>::to_python_use_handle_instead();
Chris@16:       }
Chris@16:       static void error(...) {}
Chris@16:   };
Chris@16:   
Chris@16:   template <class T>
Chris@16:   inline void reject_raw_object_ptr(T*)
Chris@16:   {
Chris@16:       reject_raw_object_helper<T,yes_convertible>::error(
Chris@16:           python::detail::convertible<PyObject const volatile*>::check((T*)0));
Chris@16:       
Chris@16:       typedef typename remove_cv<T>::type value_type;
Chris@16:       
Chris@16:       reject_raw_object_helper<T,no_convertible>::error(
Chris@16:           python::detail::convertible<unspecialized*>::check(
Chris@16:               (base_type_traits<value_type>*)0
Chris@16:               ));
Chris@16:   }
Chris@16:   // ---------
Chris@16:       
Chris@16:   template <class T>
Chris@16:   inline function_arg_to_python<T>::function_arg_to_python(T const& x)
Chris@16:       : handle<>(python::objects::make_function_handle(x))
Chris@16:   {
Chris@16:   }
Chris@16: 
Chris@16:   template <class T>
Chris@16:   inline value_arg_to_python<T>::value_arg_to_python(T const& x)
Chris@16:       : arg_to_python_base(&x, registered<T>::converters)
Chris@16:   {
Chris@16:   }
Chris@16: 
Chris@16:   template <class Ptr>
Chris@16:   inline pointer_deep_arg_to_python<Ptr>::pointer_deep_arg_to_python(Ptr x)
Chris@16:       : arg_to_python_base(x, registered_pointee<Ptr>::converters)
Chris@16:   {
Chris@16:       detail::reject_raw_object_ptr((Ptr)0);
Chris@16:   }
Chris@16: 
Chris@16:   template <class T>
Chris@16:   inline PyObject* reference_arg_to_python<T>::get_object(T& x)
Chris@16:   {
Chris@16:       to_python_indirect<T&,python::detail::make_reference_holder> convert;
Chris@16:       return convert(x);
Chris@16:   }
Chris@16: 
Chris@16:   template <class T>
Chris@16:   inline reference_arg_to_python<T>::reference_arg_to_python(T& x)
Chris@16:       : handle<>(reference_arg_to_python<T>::get_object(x))
Chris@16:   {
Chris@16:   }
Chris@16: 
Chris@16:   template <class T>
Chris@16:   inline shared_ptr_arg_to_python<T>::shared_ptr_arg_to_python(T const& x)
Chris@16:       : handle<>(shared_ptr_to_python(x))
Chris@16:   {
Chris@16:   }
Chris@16: 
Chris@16:   template <class Ptr>
Chris@16:   inline pointer_shallow_arg_to_python<Ptr>::pointer_shallow_arg_to_python(Ptr x)
Chris@16:       : handle<>(pointer_shallow_arg_to_python<Ptr>::get_object(x))
Chris@16:   {
Chris@16:       detail::reject_raw_object_ptr((Ptr)0);
Chris@16:   }
Chris@16: 
Chris@16:   template <class Ptr>
Chris@16:   inline PyObject* pointer_shallow_arg_to_python<Ptr>::get_object(Ptr x)
Chris@16:   {
Chris@16:       to_python_indirect<Ptr,python::detail::make_reference_holder> convert;
Chris@16:       return convert(x);
Chris@16:   }
Chris@16: }
Chris@16: 
Chris@16: template <class T>
Chris@16: inline arg_to_python<T>::arg_to_python(T const& x)
Chris@16:     : base(x)
Chris@16: {}
Chris@16: 
Chris@16: }}} // namespace boost::python::converter
Chris@16: 
Chris@16: #endif // ARG_TO_PYTHON_DWA200265_HPP