/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt for Python. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "sbkconverter.h" #include "sbkconverter_p.h" #include "sbkarrayconverter_p.h" #include "basewrapper_p.h" #include "bindingmanager.h" #include "autodecref.h" #include "sbkdbg.h" #include "helper.h" #include "voidptr.h" #include static SbkConverter** PrimitiveTypeConverters; typedef std::unordered_map ConvertersMap; static ConvertersMap converters; namespace Shiboken { namespace Conversions { void initArrayConverters(); void init() { static SbkConverter* primitiveTypeConverters[] = { Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), Primitive::createConverter(), VoidPtr::createConverter() }; PrimitiveTypeConverters = primitiveTypeConverters; assert(converters.empty()); converters["PY_LONG_LONG"] = primitiveTypeConverters[SBK_PY_LONG_LONG_IDX]; converters["bool"] = primitiveTypeConverters[SBK_BOOL_IDX_1]; converters["char"] = primitiveTypeConverters[SBK_CHAR_IDX]; converters["const char *"] = primitiveTypeConverters[SBK_CONSTCHARPTR_IDX]; converters["double"] = primitiveTypeConverters[SBK_DOUBLE_IDX]; converters["float"] = primitiveTypeConverters[SBK_FLOAT_IDX]; converters["int"] = primitiveTypeConverters[SBK_INT_IDX]; converters["long"] = primitiveTypeConverters[SBK_LONG_IDX]; converters["short"] = primitiveTypeConverters[SBK_SHORT_IDX]; converters["signed char"] = primitiveTypeConverters[SBK_SIGNEDCHAR_IDX]; converters["std::string"] = primitiveTypeConverters[SBK_STD_STRING_IDX]; converters["unsigned PY_LONG_LONG"] = primitiveTypeConverters[SBK_UNSIGNEDPY_LONG_LONG_IDX]; converters["unsigned char"] = primitiveTypeConverters[SBK_UNSIGNEDCHAR_IDX]; converters["unsigned int"] = primitiveTypeConverters[SBK_UNSIGNEDINT_IDX]; converters["unsigned long"] = primitiveTypeConverters[SBK_UNSIGNEDLONG_IDX]; converters["unsigned short"] = primitiveTypeConverters[SBK_UNSIGNEDSHORT_IDX]; converters["void*"] = primitiveTypeConverters[SBK_VOIDPTR_IDX]; initArrayConverters(); } SbkConverter *createConverterObject(PyTypeObject *type, PythonToCppFunc toCppPointerConvFunc, IsConvertibleToCppFunc toCppPointerCheckFunc, CppToPythonFunc pointerToPythonFunc, CppToPythonFunc copyToPythonFunc) { SbkConverter* converter = new SbkConverter; converter->pythonType = type; // PYSIDE-595: All types are heaptypes now, so provide reference. Py_XINCREF(type); converter->pointerToPython = pointerToPythonFunc; converter->copyToPython = copyToPythonFunc; if (toCppPointerCheckFunc && toCppPointerConvFunc) converter->toCppPointerConversion = std::make_pair(toCppPointerCheckFunc, toCppPointerConvFunc); converter->toCppConversions.clear(); return converter; } SbkConverter* createConverter(SbkObjectType* type, PythonToCppFunc toCppPointerConvFunc, IsConvertibleToCppFunc toCppPointerCheckFunc, CppToPythonFunc pointerToPythonFunc, CppToPythonFunc copyToPythonFunc) { SbkConverter *converter = createConverterObject(reinterpret_cast(type), toCppPointerConvFunc, toCppPointerCheckFunc, pointerToPythonFunc, copyToPythonFunc); PepType_SOTP(type)->converter = converter; return converter; } SbkConverter* createConverter(PyTypeObject* type, CppToPythonFunc toPythonFunc) { return createConverterObject(type, 0, 0, 0, toPythonFunc); } void deleteConverter(SbkConverter* converter) { if (converter) { converter->toCppConversions.clear(); delete converter; } } void setCppPointerToPythonFunction(SbkConverter* converter, CppToPythonFunc pointerToPythonFunc) { converter->pointerToPython = pointerToPythonFunc; } void setPythonToCppPointerFunctions(SbkConverter* converter, PythonToCppFunc toCppPointerConvFunc, IsConvertibleToCppFunc toCppPointerCheckFunc) { converter->toCppPointerConversion = std::make_pair(toCppPointerCheckFunc, toCppPointerConvFunc); } void addPythonToCppValueConversion(SbkConverter* converter, PythonToCppFunc pythonToCppFunc, IsConvertibleToCppFunc isConvertibleToCppFunc) { converter->toCppConversions.push_back(std::make_pair(isConvertibleToCppFunc, pythonToCppFunc)); } void addPythonToCppValueConversion(SbkObjectType* type, PythonToCppFunc pythonToCppFunc, IsConvertibleToCppFunc isConvertibleToCppFunc) { addPythonToCppValueConversion(PepType_SOTP(type)->converter, pythonToCppFunc, isConvertibleToCppFunc); } PyObject* pointerToPython(SbkObjectType *type, const void *cppIn) { return pointerToPython(PepType_SOTP(type)->converter, cppIn); } PyObject* pointerToPython(const SbkConverter *converter, const void *cppIn) { assert(converter); if (!cppIn) Py_RETURN_NONE; if (!converter->pointerToPython) { warning(PyExc_RuntimeWarning, 0, "pointerToPython(): SbkConverter::pointerToPython is null for \"%s\".", PepType(converter->pythonType)->tp_name); Py_RETURN_NONE; } return converter->pointerToPython(cppIn); } PyObject* referenceToPython(SbkObjectType *type, const void *cppIn) { return referenceToPython(PepType_SOTP(type)->converter, cppIn); } PyObject* referenceToPython(const SbkConverter *converter, const void *cppIn) { assert(cppIn); PyObject *pyOut = reinterpret_cast(BindingManager::instance().retrieveWrapper(cppIn)); if (pyOut) { Py_INCREF(pyOut); return pyOut; } if (!converter->pointerToPython) { warning(PyExc_RuntimeWarning, 0, "referenceToPython(): SbkConverter::pointerToPython is null for \"%s\".", PepType(converter->pythonType)->tp_name); Py_RETURN_NONE; } return converter->pointerToPython(cppIn); } static inline PyObject* CopyCppToPython(const SbkConverter *converter, const void *cppIn) { if (!cppIn) Py_RETURN_NONE; if (!converter->copyToPython) { warning(PyExc_RuntimeWarning, 0, "CopyCppToPython(): SbkConverter::copyToPython is null for \"%s\".", PepType(converter->pythonType)->tp_name); Py_RETURN_NONE; } return converter->copyToPython(cppIn); } PyObject* copyToPython(SbkObjectType *type, const void *cppIn) { return CopyCppToPython(PepType_SOTP(type)->converter, cppIn); } PyObject* copyToPython(const SbkConverter *converter, const void *cppIn) { return CopyCppToPython(converter, cppIn); } PythonToCppFunc isPythonToCppPointerConvertible(SbkObjectType *type, PyObject *pyIn) { assert(pyIn); return PepType_SOTP(type)->converter->toCppPointerConversion.first(pyIn); } static inline PythonToCppFunc IsPythonToCppConvertible(const SbkConverter *converter, PyObject *pyIn) { assert(pyIn); const ToCppConversionList& convs = converter->toCppConversions; for (ToCppConversionList::const_iterator conv = convs.begin(), end = convs.end(); conv != end; ++conv) { PythonToCppFunc toCppFunc = 0; if ((toCppFunc = (*conv).first(pyIn))) return toCppFunc; } return 0; } PythonToCppFunc isPythonToCppValueConvertible(SbkObjectType *type, PyObject *pyIn) { return IsPythonToCppConvertible(PepType_SOTP(type)->converter, pyIn); } PythonToCppFunc isPythonToCppConvertible(const SbkConverter *converter, PyObject *pyIn) { return IsPythonToCppConvertible(converter, pyIn); } PythonToCppFunc isPythonToCppConvertible(const SbkArrayConverter *converter, int dim1, int dim2, PyObject *pyIn) { assert(pyIn); for (IsArrayConvertibleToCppFunc f : converter->toCppConversions) { if (PythonToCppFunc c = f(pyIn, dim1, dim2)) return c; } return nullptr; } PythonToCppFunc isPythonToCppReferenceConvertible(SbkObjectType *type, PyObject *pyIn) { if (pyIn != Py_None) { PythonToCppFunc toCpp = isPythonToCppPointerConvertible(type, pyIn); if (toCpp) return toCpp; } return isPythonToCppValueConvertible(type, pyIn); } void nonePythonToCppNullPtr(PyObject*, void* cppOut) { assert(cppOut); *((void**)cppOut) = 0; } void* cppPointer(PyTypeObject* desiredType, SbkObject* pyIn) { assert(pyIn); if (!ObjectType::checkType(desiredType)) return pyIn; SbkObjectType *inType = reinterpret_cast(Py_TYPE(pyIn)); if (ObjectType::hasCast(inType)) return ObjectType::cast(inType, pyIn, desiredType); return Object::cppPointer(pyIn, desiredType); } void pythonToCppPointer(SbkObjectType* type, PyObject* pyIn, void* cppOut) { assert(type); assert(pyIn); assert(cppOut); *reinterpret_cast(cppOut) = pyIn == Py_None ? 0 : cppPointer(reinterpret_cast(type), reinterpret_cast(pyIn)); } void pythonToCppPointer(const SbkConverter *converter, PyObject *pyIn, void *cppOut) { assert(converter); assert(pyIn); assert(cppOut); *reinterpret_cast(cppOut) = pyIn == Py_None ? 0 : cppPointer(reinterpret_cast(converter->pythonType), reinterpret_cast(pyIn)); } static void _pythonToCppCopy(const SbkConverter *converter, PyObject *pyIn, void *cppOut) { assert(converter); assert(pyIn); assert(cppOut); PythonToCppFunc toCpp = IsPythonToCppConvertible(converter, pyIn); if (toCpp) toCpp(pyIn, cppOut); } void pythonToCppCopy(SbkObjectType *type, PyObject *pyIn, void *cppOut) { assert(type); _pythonToCppCopy(PepType_SOTP(type)->converter, pyIn, cppOut); } void pythonToCppCopy(const SbkConverter *converter, PyObject *pyIn, void *cppOut) { _pythonToCppCopy(converter, pyIn, cppOut); } bool isImplicitConversion(SbkObjectType *type, PythonToCppFunc toCppFunc) { // This is the Object Type or Value Type conversion that only // retrieves the C++ pointer held in the Python wrapper. if (toCppFunc == PepType_SOTP(type)->converter->toCppPointerConversion.second) return false; // Object Types doesn't have any kind of value conversion, // only C++ pointer retrieval. if (PepType_SOTP(type)->converter->toCppConversions.empty()) return false; // The first conversion of the non-pointer conversion list is // a Value Type's copy to C++ function, which is not an implicit // conversion. // Otherwise it must be one of the implicit conversions. // Note that we don't check if the Python to C++ conversion is in // the list of the type's conversions, for it is expected that the // caller knows what he's doing. ToCppConversionList::iterator conv = PepType_SOTP(type)->converter->toCppConversions.begin(); return toCppFunc != (*conv).second; } void registerConverterName(SbkConverter* converter , const char* typeName) { ConvertersMap::iterator iter = converters.find(typeName); if (iter == converters.end()) converters.insert(std::make_pair(typeName, converter)); } SbkConverter* getConverter(const char* typeName) { ConvertersMap::const_iterator it = converters.find(typeName); if (it != converters.end()) return it->second; if (Py_VerboseFlag > 0) SbkDbg() << "Can't find type resolver for type '" << typeName << "'."; return 0; } SbkConverter* primitiveTypeConverter(int index) { return PrimitiveTypeConverters[index]; } bool checkSequenceTypes(PyTypeObject* type, PyObject* pyIn) { assert(type); assert(pyIn); if (PySequence_Size(pyIn) < 0) { // clear the error if < 0 which means no length at all PyErr_Clear(); return false; } const Py_ssize_t size = PySequence_Size(pyIn); for (Py_ssize_t i = 0; i < size; ++i) { if (!PyObject_TypeCheck(AutoDecRef(PySequence_GetItem(pyIn, i)), type)) return false; } return true; } bool convertibleSequenceTypes(const SbkConverter *converter, PyObject *pyIn) { assert(converter); assert(pyIn); if (!PySequence_Check(pyIn)) return false; const Py_ssize_t size = PySequence_Size(pyIn); for (Py_ssize_t i = 0; i < size; ++i) { if (!isPythonToCppConvertible(converter, AutoDecRef(PySequence_GetItem(pyIn, i)))) return false; } return true; } bool convertibleSequenceTypes(SbkObjectType *type, PyObject *pyIn) { assert(type); return convertibleSequenceTypes(PepType_SOTP(type)->converter, pyIn); } bool checkPairTypes(PyTypeObject* firstType, PyTypeObject* secondType, PyObject* pyIn) { assert(firstType); assert(secondType); assert(pyIn); if (!PySequence_Check(pyIn)) return false; if (PySequence_Size(pyIn) != 2) return false; if (!PyObject_TypeCheck(AutoDecRef(PySequence_GetItem(pyIn, 0)), firstType)) return false; if (!PyObject_TypeCheck(AutoDecRef(PySequence_GetItem(pyIn, 1)), secondType)) return false; return true; } bool convertiblePairTypes(const SbkConverter *firstConverter, bool firstCheckExact, const SbkConverter *secondConverter, bool secondCheckExact, PyObject *pyIn) { assert(firstConverter); assert(secondConverter); assert(pyIn); if (!PySequence_Check(pyIn)) return false; if (PySequence_Size(pyIn) != 2) return false; AutoDecRef firstItem(PySequence_GetItem(pyIn, 0)); if (firstCheckExact) { if (!PyObject_TypeCheck(firstItem, firstConverter->pythonType)) return false; } else if (!isPythonToCppConvertible(firstConverter, firstItem)) { return false; } AutoDecRef secondItem(PySequence_GetItem(pyIn, 1)); if (secondCheckExact) { if (!PyObject_TypeCheck(secondItem, secondConverter->pythonType)) return false; } else if (!isPythonToCppConvertible(secondConverter, secondItem)) { return false; } return true; } bool checkDictTypes(PyTypeObject* keyType, PyTypeObject* valueType, PyObject* pyIn) { assert(keyType); assert(valueType); assert(pyIn); if (!PyDict_Check(pyIn)) return false; PyObject* key; PyObject* value; Py_ssize_t pos = 0; while (PyDict_Next(pyIn, &pos, &key, &value)) { if (!PyObject_TypeCheck(key, keyType)) return false; if (!PyObject_TypeCheck(value, valueType)) return false; } return true; } bool convertibleDictTypes(const SbkConverter * keyConverter, bool keyCheckExact, const SbkConverter *valueConverter, bool valueCheckExact, PyObject *pyIn) { assert(keyConverter); assert(valueConverter); assert(pyIn); if (!PyDict_Check(pyIn)) return false; PyObject* key; PyObject* value; Py_ssize_t pos = 0; while (PyDict_Next(pyIn, &pos, &key, &value)) { if (keyCheckExact) { if (!PyObject_TypeCheck(key, keyConverter->pythonType)) return false; } else if (!isPythonToCppConvertible(keyConverter, key)) { return false; } if (valueCheckExact) { if (!PyObject_TypeCheck(value, valueConverter->pythonType)) return false; } else if (!isPythonToCppConvertible(valueConverter, value)) { return false; } } return true; } PyTypeObject* getPythonTypeObject(const SbkConverter *converter) { if (converter) return converter->pythonType; return 0; } PyTypeObject* getPythonTypeObject(const char* typeName) { return getPythonTypeObject(getConverter(typeName)); } bool pythonTypeIsValueType(const SbkConverter *converter) { // Unlikely to happen but for multi-inheritance SbkObjs // the converter is not defined, hence we need a default return. if (!converter) return false; return converter->pointerToPython && converter->copyToPython; } bool pythonTypeIsObjectType(const SbkConverter *converter) { return converter->pointerToPython && !converter->copyToPython; } bool pythonTypeIsWrapperType(const SbkConverter *converter) { return converter->pointerToPython != 0; } SpecificConverter::SpecificConverter(const char* typeName) : m_type(InvalidConversion) { m_converter = getConverter(typeName); if (!m_converter) return; const Py_ssize_t len = strlen(typeName); char lastChar = typeName[len -1]; if (lastChar == '&') { m_type = ReferenceConversion; } else if (lastChar == '*' || pythonTypeIsObjectType(m_converter)) { m_type = PointerConversion; } else { m_type = CopyConversion; } } PyObject* SpecificConverter::toPython(const void* cppIn) { switch (m_type) { case CopyConversion: return copyToPython(m_converter, cppIn); case PointerConversion: return pointerToPython(m_converter, *((const void**)cppIn)); case ReferenceConversion: return referenceToPython(m_converter, cppIn); default: PyErr_SetString(PyExc_RuntimeError, "tried to use invalid converter in 'C++ to Python' conversion"); } return 0; } void SpecificConverter::toCpp(PyObject* pyIn, void* cppOut) { switch (m_type) { case CopyConversion: pythonToCppCopy(m_converter, pyIn, cppOut); break; case PointerConversion: pythonToCppPointer(m_converter, pyIn, cppOut); break; case ReferenceConversion: pythonToCppPointer(m_converter, pyIn, &cppOut); break; default: PyErr_SetString(PyExc_RuntimeError, "tried to use invalid converter in 'Python to C++' conversion"); } } } } // namespace Shiboken::Conversions