cppyy wrapper for Lyncs
Project description
cppyy wrapper for Lyncs
In this package we provide some additional tools for the usage of cppyy in the Lyncs API.
Installation
The package can be installed via pip
:
pip install [--user] lyncs_cppyy
Documentation
The main documentation of cppyy is available at https://cppyy.readthedocs.io/en/latest/.
cppyy is an automatic, run-time, Python-C++ bindings generator, for calling C++ from Python [...]
Lyncs_cppyy is an additional layer between cppyy and the interfaces to libraries provided by Lyncs. In the following we give an overview of the additional functionalities.
Lib class
In cppyy, libraries are loaded and used as follow:
>>> import cppyy
>>> cppyy.include('zlib.h') # bring in C++ definitions
>>> cppyy.load_library('libz') # load linker symbols
>>> cppyy.gbl.zlibVersion() # use a zlib API
'1.2.11'
>>>
In lyncs_cppyy we have define the class Lib for holding the information on a library. It is used as follow
>>> from lyncs_cppyy import Lib
>>> zlib = Lib(header = 'zlib.h', library = 'libz')
>>> zlib.zlibVersion()
'1.2.11'
>>>
Lib returns a variable that represents the library.
The library is loaded at the first usage of the variable.
In most of the cases, accessing attributes of the variable is like accessing attributed of cppyy.gbl
.
Exceptions are made for the following options of Lib, e.g. zlib.header -> ['zlib.h']
,
or for macros defined in the header, e.g. zlib.ZLIB_VERSION -> '1.2.11'
.
This latter feature is not supported by cppyy.gbl.
The list of options of Lib
are:
-
header
: string(or list) of the header(s) to be included. -
check
: string(or list) of the function(s) to be checked for inclusion. This is needed to determine if the library has been already loaded or not. -
library
: string(or list) of the shared library(ies) to be loaded. A library can also be an instance of theLib
class. -
c_include
: if the library is a c library (True
) or a c++ library (False
, default) -
namespace
: in case of a c++ library, a string(or list) of the namespace(s) to be used. Equivalent tousing namespace ...
in c++. Without, symbols should be access aslib.namespace.*
. -
path
: string(or list) of the path(s) to the base directory of the library. Headers will be searched inPATH/include
and libraries inPATH/lib
. -
include
: string(or list) of the directory(ies) to include. Equivalent to-I
used at compile time. -
redefined
: dictionary of redefined symbols. See [Redefining symbols to avoid conflicts].
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.