Metadata-Version: 2.1
Name: cinterop
Version: 0.9.0
Summary: A Python package for reusable interop with native resources from a C API
Home-page: https://github.com/csiro-hydroinformatics/rcpp-interop-commons
Author: Jean-Michel Perraud
Author-email: per202@csiro.au
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/csiro-hydroinformatics/rcpp-interop-commons/issues
Project-URL: Source, https://github.com/csiro-hydroinformatics/rcpp-interop-commons
Keywords: interop python native-libraries reference-counting handle cffi
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development 
Classifier: Topic :: Software Development :: Object Brokering
Classifier: Programming Language :: C++
Classifier: Programming Language :: C
Classifier: Topic :: Software Development :: Code Generators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# cinterop



<!-- [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/csiro-hydroinformatics/rcpp-interop-commons/blob/master/bindings/python/cinterop/LICENSE.txt) ![status](https://img.shields.io/badge/status-beta-blue.svg) [![Documentation Status](https://readthedocs.org/projects/pycinterop/badge/?version=latest)](https://pycinterop.readthedocs.io/en/latest/?badge=latest) master: [![Build status - master](https://ci.appveyor.com/api/projects/status/vmwq7xarxxj8s564/branch/master?svg=true)](https://ci.appveyor.com/project/jmp75/pycinterop/branch/master) testing: [![Build status - devel](https://ci.appveyor.com/api/projects/status/vmwq7xarxxj8s564/branch/testing?svg=true)](https://ci.appveyor.com/project/jmp75/pycinterop/branch/testing)

 -->



![CFFI interop convenience wrapper](./docs/img/cinterop-principles.png "CFFI interop convenience wrapper")





This package is primarily for managing and marshalling resources in native libraries, written for instance in C++, from Python. 



## License



MIT (see [License.txt](https://github.com/csiro-hydroinformatics/rcpp-interop-commons/blob/master/bindings/python/cinterop/LICENSE.txt))



## Documentation



Placeholder



<!-- Hosted at [pycinterop.readthedocs.io](https://pycinterop.readthedocs.io/en/latest/?badge=latest) -->



## Source code



[Marshalling data between C, C++ and other programming languages onGitHub](https://github.com/csiro-hydroinformatics/rcpp-interop-commons)



## Installation



```sh

pip install cinterop

```



From source:



```sh

pip install -r requirements.txt

python setup.py install

```



## Sample use



Placeholder section



## Related work



Placeholder section



### Ancestry, acknowledgements



This python package `cinterop` relates loosely to prior work for interoperability between C++, R and .NET ([R.NET](https://github.com/rdotnet/rdotnet))



`cinterop` features using `cffi` were also significantly informed by Kevin Plastow's [work](https://search.informit.com.au/documentSummary;dn=823898220073899;res=IELENG) while he was at the Australian Bureau of Meteorology; this contribution is gratefully acknowledged.



In you have native interop needs you may also want to look at:



* the nuget package [dynamic-interop-dll](https://github.com/rdotnet/dynamic-interop-dll) for .NET/native interop.

* Reference counting package [refcount](https://github.com/csiro-hydroinformatics/pyrefcount)

* a C# library for [generating interop glue code on top of C API glue code](https://github.com/csiro-hydroinformatics/c-api-wrapper-generation).



### Other python packages



Placeholder



