Start refactoring examples

Signed-off-by: Tim Paine <3105306+timkpaine@users.noreply.github.com>

Author: timkpaine

cpp/csp/adapters/CMakeLists.txt

@@ -11,6 +11,4 @@ if(CSP_BUILD_WS_CLIENT_ADAPTER)
     add_subdirectory(websocket)
 endif()
 
-
-add_subdirectory(c)
 add_subdirectory(utils)

cpp/csp/adapters/c/CMakeLists.txt

@@ -46,5 +46,3 @@ if(CSP_BUILD_WS_CLIENT_ADAPTER)
     target_link_libraries(websocketadapterimpl csp_core csp_engine cspimpl csp_websocket_client_adapter)
     install(TARGETS websocketadapterimpl RUNTIME DESTINATION ${CSP_RUNTIME_INSTALL_SUBDIR})
 endif()
-
-add_subdirectory(c)

cpp/csp/python/adapters/CMakeLists.txt

@@ -24,3 +24,8 @@ Output:
 2020-01-01 00:00:05 input:fun
 2020-01-01 00:00:05 output:UNFAY
 ```
+
+> [!WARNING]
+> This example is for demonstration, and is a pattern CSP uses internally for fast nodes.
+> It is not recommended to use as the C++ API is not stable and may change without notice. Use at your own risk.
+> For adapters, we have a stable C API that is recommended to use instead. See [C API Adapter](../4_c_api_adapter/README.md) example for more details.

cpp/csp/python/adapters/c/CMakeLists.txt

@@ -13,3 +13,8 @@ Run:
 ```bash
 python -m mystruct
 ```
+
+> [!WARNING]
+> This example is for demonstration, and is a pattern CSP uses internally for fast nodes.
+> It is not recommended to use as the C++ API is not stable and may change without notice. Use at your own risk.
+> For adapters, we have a stable C API that is recommended to use instead. See [C API Adapter](../4_c_api_adapter/README.md) example for more details.

examples/05_cpp/1_cpp_node/README.md

@@ -0,0 +1,6 @@
+# Custom C++ Adapter
+
+> [!WARNING]
+> This example is for demonstration, and is a pattern CSP uses internally for adapters.
+> It is not recommended to use as the C++ API is not stable and may change without notice. Use at your own risk.
+> For adapters, we have a stable C API that is recommended to use instead. See [C API Adapter](../4_c_api_adapter/README.md) example for more details.

examples/05_cpp/2_cpp_node_with_struct/README.md

@@ -0,0 +1 @@
+# Custom C++ Adapter via C API

examples/05_cpp/3_cpp_adapter/README.md

@@ -36,3 +36,32 @@ install(TARGETS csp_c_example_adapter
         RUNTIME DESTINATION ${CSP_RUNTIME_INSTALL_SUBDIR}
         LIBRARY DESTINATION lib/
 )
+
+# Python bindings for example C adapters
+
+# This creates a Python extension module
+Python_add_library(_exampleadapterimpl MODULE exampleadapterimpl.c)
+
+# Link with the example adapter library
+target_link_libraries(_exampleadapterimpl PRIVATE
+    csp_c_example_adapter
+)
+
+# Include directories
+target_include_directories(_exampleadapterimpl PRIVATE
+    ${CMAKE_SOURCE_DIR}/cpp
+    ${Python_INCLUDE_DIRS}
+)
+
+# Set output name without lib prefix
+set_target_properties(_exampleadapterimpl PROPERTIES
+    PREFIX ""
+    C_STANDARD 11
+    C_STANDARD_REQUIRED ON
+)
+
+# Install to the Python package location
+install(TARGETS _exampleadapterimpl
+    LIBRARY DESTINATION ${CSP_RUNTIME_INSTALL_SUBDIR}
+    RUNTIME DESTINATION ${CSP_RUNTIME_INSTALL_SUBDIR}
+)