A simple pyproject.toml which links to the sip, cpp and h files to be
used and a Custom build-factory which stops sip from building and
linking. These steps are to be done by CMake at a later stage.

Contributes to CURA-7924

This is taken directly from QGIS
https://github.com/qgis/QGIS/tree/master/cmake

Contributes to CURA-7924

To have better control over compiling and linking of the sip generated
source code. We decided to make CMake responsible for those processes.

The `add_sip_module`  will first generate the source-files using sip and
the previous commit build-factory. Which disables the compiling and
linking by sip. It will then collect and identify those generated files
and make a shared library of these. Compiler flags, user source files,
dependency libraries etc. can be specified in the main CMakeLists.txt

using an INTERFACE library.

The most basic usage is:
```cmake
find_package(SIP REQUIRED 6.5.0)

add_library(module_name INTERFACE <optional_cpp_source_files>)
target_link_libraries(module_name INTERFACE target_lib_for_the_bindings <optional_other_depending_targets>)
add_sip_module(module_name)
```

compile features and extra include directories can be specified in the
normal way, if needed.

```cmake
target_include_directories(module_name INTERFACE <optional_location_for_cpp_headers_and_sources>)
target_compile_features(module_name INTERFACE cxx_std_17)
```

The minimum pyproject.toml.in would consist of:
```toml
[build-system]
requires = ["sip >=6, <7"]
build-backend = "sipbuild.api"

[tool.sip.metadata]
name = "module_name"

[tool.sip.project]
builder-factory = "CMakeBuilder"
sip-files-dir = "location_of_the_sip_files"
build-dir = "${CMAKE_CURRENT_BINARY_DIR}/module_name/"

[tool.sip.bindings.module_name]
exceptions = true
release-gil = true
concatenate = 8
```

Make sure that the main sip definition file is named the same as the
module_name and that it contains the following line

```
%Module(name = module_name, call_super_init = True)
```
Contributes to CURA-7924

These are not needed for 'just' code generation

Contributes to CURA-7924

Contributes to CURA-7924

These changes are not fully tested locally. This is due to the way I
have personally setup my development environment.

This should generate a python module named `pyArcus.so` linking to in
Arcus.so both located in the build directory.

TODO: Add installing step.
TODO: propagate the name change to downstream dependencies

Contributes to CURA-7924

Contributes to CURA_7924

Contributes to CURA_7924

It can't find the CMakeBuilder.py on the build server otherwise

Contributes to CURA_7924

Contributes to CURA_7924

…CURA-7924_sip_cmake_build

Contributes to CURA-7924

This should add the current build_dir to the PYTHONPATH

Contributes to CURA-7924

Arcus (non-py version) still seems to be static though, so it doesn't work yet completely.

part of CURA-7924

Not tested on MacOS.

part of CURA-7924

part of CURA-7924

Contributes to CURA-7924

This file isn't project specific but an integral part of how the
CMake SIP build module works.

Contributes to CURA-7924

This will install the Python module and PEP 484 file in site-packages

Contributes to CURA-7924

Which is basically a call to sysconfig made by the find_package Python
and outputs the following extension

```python
sysconfig.get_config_var('EXT_SUFFIX')
'.cpython-310-x86_64-linux-gnu.so'
```

Contributes to CURA-7924

Not necessary for Arcus, but Savitar doesn't use user specified cpp
files and I think it's good practice to keep these modules in-sync.

Contributes to CURA-7924

part of CURA-7924

This reverts commit 95a2a26.

This reverts commit b1325c9.

Contributes to CURA-7924

Also, in earlier sip 4.x it was 'transparent' but now if you add that 'fix' of wrapping it in a namespace, you also have to refer to the namespace in Python, making awkward constructs like pyArcus.SocketState.SocketState.Closed or whatever.

done as part of CURA-7924

Cura 7924 sip cmake build

This module sets the rpaths relative from the executable
- rpath for Arcus -> ../lib
- rpath for pyArcus -> ../lib/python3.10/site-packages

It also transfers some other cmake logic out of the main CMakeLists.txt

Contributes to CURA-8640

Sets the RPATHS for targets (Linux and Windows,
these can either be absolute paths or relative to
the executable

Usage:
```
set_rpath(TARGETS <list of targets to set rpaths for>
           PATHS <list of paths>
           <optional> RELATIVE)
```
if the RELATIVE option is used the paths will be
specified from either $ORIGIN on Linux or
@executable_path on Mac

Contributes to CURA-8640

Contributes to CURA-8640

This reverts commit 2be1f55.

They are old and don't compile anymore, they are hardly used.
If people require an usage example they can look how Cura,
Uranium and CuraEngine use Arcus

Contributes to CURA-8640

Contributes to CURA-8640

We no longer use Jenkins

Contributes to CURA-8640

Contributes to CURA-8640

Contributes to CURA-8640

Contributes to CURA-8640

BUILD_STATIC was our own custom option while the BUILD_SHARED_LIBS
is a CMake global flag https://cmake.org/cmake/help/latest/variable/BUILD_SHARED_LIBS.html

Contributes to CURA-8640

We don't have any unit tests in this repo so no need for this
have this pipeline.

Contributes to CURA-8640

Contributes to CURA-8640

Contributes to CURA-8640

Contributes to CURA-8640

Contributes to CURA-8640