pyStaticTokens.h

Go to the documentation of this file.

//
// Copyright 2016 Pixar
//
// Licensed under the terms set forth in the LICENSE.txt file available at
// https://openusd.org/license.
//
 
#ifndef PXR_BASE_TF_PY_STATIC_TOKENS_H
#define PXR_BASE_TF_PY_STATIC_TOKENS_H
 
 
#include "pxr/pxr.h"
 
#include <locale>
 
#include "pxr/base/tf/staticTokens.h"
#include "pxr/base/tf/preprocessorUtilsLite.h"
 
#include "pxr/external/boost/python/class.hpp"
#include "pxr/external/boost/python/scope.hpp"
 
PXR_NAMESPACE_OPEN_SCOPE
 
#define TF_PY_WRAP_PUBLIC_TOKENS(name, key, seq)                        \
    pxr_boost::python::class_<                                          \
        _TF_TOKENS_STRUCT_NAME(key), pxr_boost::python::noncopyable>(   \
            name, pxr_boost::python::no_init)                           \
        _TF_PY_TOKENS_WRAP_SEQ(key, seq)
 
#define TF_PY_WRAP_PUBLIC_TOKENS_IN_CURRENT_SCOPE(key, seq)                 \
    _TF_PY_TOKENS_WRAP_ATTR_SEQ(key, seq)
 
// Private macros to add a single data member.
#define _TF_PY_TOKENS_WRAP_ATTR_MEMBER(r, key, name)                        \
    pxr_boost::python::scope().attr(                                            \
        TF_PP_STRINGIZE(name)) = key->name.GetString();
 
// We wrap tokens as Python strings, but simply wrapping the token using 
// def_readonly bypasses to-Python conversion, leading to the error
// that there's no Python type for the C++ TfToken type. See:
// https://www.boost.org/doc/libs/release/libs/python/doc/html/faq/why_is_my_automatic_to_python_co.html
//
// So we use add_static_property and wrap a function that performs the
// conversion instead.
#define _TF_PY_TOKENS_WRAP_MEMBER(r, key, name)                             \
    .add_static_property(TF_PP_STRINGIZE(name),                             \
        +[]() { return key->name.GetString(); })                            \
 
// Private macros to wrap a single element in a sequence.
#define _TF_PY_TOKENS_WRAP_ELEMENT(key, elem)                               \
    _TF_PY_TOKENS_WRAP_MEMBER(r, key, _TF_PY_TOKEN_GET_ELEM(elem))
 
#define _TF_PY_TOKENS_WRAP_ATTR_ELEMENT(key, elem)                          \
    _TF_PY_TOKENS_WRAP_ATTR_MEMBER(r, key, _TF_PY_TOKEN_GET_ELEM(elem))
 
#define _TF_PY_TOKEN_GET_ELEM(elem)                                         \
    _TF_PP_IFF(TF_PP_IS_TUPLE(elem),                                        \
        TF_PP_TUPLE_ELEM(0, elem), elem)
 
// Private macros to wrap a sequence.
#define _TF_PY_TOKENS_WRAP_SEQ(key, seq)                                    \
    TF_PP_SEQ_FOR_EACH(_TF_PY_TOKENS_WRAP_ELEMENT, key, seq)
 
#define _TF_PY_TOKENS_WRAP_ATTR_SEQ(key, seq)                               \
    TF_PP_SEQ_FOR_EACH(_TF_PY_TOKENS_WRAP_ATTR_ELEMENT, key, seq)
 
PXR_NAMESPACE_CLOSE_SCOPE
 
#endif // PXR_BASE_TF_PY_STATIC_TOKENS_H