/* * nextpnr -- Next Generation Place and Route * * Copyright (C) 2018 Clifford Wolf * Copyright (C) 2018 David Shah * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. * */ #ifndef COMMON_PYBINDINGS_H #define COMMON_PYBINDINGS_H #include #include #include #include #include #include using namespace boost::python; /* A wrapper for a Pythonised nextpnr Iterator. The actual class wrapped is a pair containing (current, end) */ template struct iterator_wrapper { typedef decltype(*(std::declval())) value_t; static value_t next(std::pair &iter) { if (iter.first != iter.second) { value_t val = *iter.first; ++iter.first; return val; } else { PyErr_SetString(PyExc_StopIteration, "End of range reached"); boost::python::throw_error_already_set(); // Should be unreachable, but prevent control may reach end of non-void throw std::runtime_error("unreachable"); } } static void wrap(const char *python_name) { class_>(python_name, no_init) .def("__next__", next); } }; /* A wrapper for a nextpnr Range. Ranges should have two functions, begin() and end() which return iterator-like objects supporting ++, * and != Full STL iterator semantics are not required, unlike the standard Boost wrappers */ template struct range_wrapper { typedef decltype(std::declval().begin()) iterator_t; static std::pair iter(T &range) { return std::make_pair(range.begin(), range.end()); } static void wrap(const char *range_name, const char *iter_name) { class_(range_name, no_init) .def("__iter__", iter); iterator_wrapper().wrap(iter_name); } }; /* A wrapper to enable custom type/ID to/from string conversions */ template struct string_wrapper { template struct from_pystring_converter { from_pystring_converter() { converter::registry::push_back( &convertible, &construct, boost::python::type_id()); }; static void* convertible(PyObject* object) { return PyUnicode_Check(object) ? object : 0; } static void construct( PyObject* object, converter::rvalue_from_python_stage1_data* data) { const wchar_t* value = PyUnicode_AsUnicode(object); const std::wstring value_ws(value); if (value == 0) throw_error_already_set(); void* storage = ( (boost::python::converter::rvalue_from_python_storage*) data)->storage.bytes; new (storage) T(fn(std::string(value_ws.begin(), value_ws.end()))); data->convertible = storage; } static F fn; }; template struct to_str_wrapper { static F fn; std::string str(T& x) { return fn(x); } }; template static void wrap(const char *type_name, F1 to_str_fn, F2 from_str_fn) { from_pystring_converter::fn = from_str_fn; from_pystring_converter(); to_str_wrapper::fn = to_str_fn; class_(type_name, no_init).def("__str__", to_str_wrapper::str); }; }; #define WRAP_RANGE(t) range_wrapper().wrap(#t "Range", #t "Iterator") void init_python(const char *executable); void deinit_python(); void execute_python_file(const char* python_file); std::string parse_python_exception(); void arch_appendinittab(); #endif /* end of include guard: COMMON_PYBINDINGS_HH */