From 44ca0b19a64e2ad9d591a62bd156790e5761cb8e Mon Sep 17 00:00:00 2001
From: aaron <aaron.m.bray@gmail.com>
Date: Mon, 26 Oct 2015 23:42:56 -0500
Subject: [PATCH] Added clib interface file; populated ctypes

---
 docs/scenarios/clibs.rst | 42 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/scenarios/clibs.rst

diff --git a/docs/scenarios/clibs.rst b/docs/scenarios/clibs.rst
new file mode 100644
index 0000000..b3d80be
--- /dev/null
+++ b/docs/scenarios/clibs.rst
@@ -0,0 +1,42 @@
+Interfacing with C/C++ Libraries
+================================
+
+
+ctypes
+------
+
+`ctypes <https://docs.python.org/3/library/ctypes.html>`_ is the de facto
+library for interfacing with C/C++, and it provides not only full access to
+the native C interface of most major operating systems (e.g., kernel32 on
+Windows, or libc on *nix), but also provides support for loading and
+interfacing with dynamic libraries, such as DLLs or shared objects at runtime.
+It does bring along with it a whole host of types for interacting with system
+APIs, and allows you to rather easily define your own complex types, such
+as structs and unions, and allows you to modify things such as padding and
+alignment, if needed. It can be a bit crufty to use, but in conjunction with
+the `struct <https://docs.python.org/3.5/library/struct.html>`_ module, you
+are essentially provided full control over how your data types get translated
+into something something usable by a C(++).
+
+Struct Equivalents
+~~~~~~~~~~~~~~~~~~
+
+:file:`MyStruct.h`
+
+.. code-block:: c
+    :linenos:
+
+    struct my_struct {
+        int a;
+        int b;
+    };
+
+:file:`MyStruct.py`
+
+.. code-block:: python
+    :linenos:
+
+    import ctypes
+    class my_struct(ctypes.Structure):
+        _fields_ = [("a", c_int),
+                    ("b", c_int)]