Initial commit.

Author: dvnrrs

.github/workflows/build.yml

@@ -0,0 +1,22 @@
+name: build
+
+on: push
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Configure
+        run: |
+          mkdir build
+          cmake -B build
+      - name: Build
+        run: cmake --build build
+      - name: Install
+        run: sudo cmake --build build --target install

.github/workflows/doxygen.yml

@@ -0,0 +1,38 @@
+name: doxygen
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Generate documentation
+        uses: mattnotmitt/doxygen-action@1.9.5
+        with:
+          working-directory: docs
+      - name: Setup pages
+        uses: actions/configure-pages@v3
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: docs/html
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v1

.gitignore

@@ -0,0 +1 @@
+/build/

.vscode/c_cpp_properties.json

@@ -0,0 +1,15 @@
+{
+	"version": 4,
+	"configurations": [
+		{
+			"name": "g++",
+			"compilerPath": "/usr/bin/g++",
+			"cStandard": "c11",
+			"cppStandard": "c++17",
+			"intelliSenseMode": "gcc-x64",
+			"includePath": [
+				"${workspaceFolder}/include"
+			]
+		}
+	]
+}

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+	"editor.detectIndentation": true,
+	"editor.insertSpaces": false,
+	"editor.tabSize": 4,
+	"editor.useTabStops": true,
+	"files.exclude": {
+		"build/": true
+	},
+}

CMakeLists.txt

@@ -0,0 +1,39 @@
+cmake_minimum_required(VERSION 3.16)
+
+project(
+	cppwrap
+	VERSION		1.3.0
+	DESCRIPTION	"A collection of C++ wrappers for native APIs")
+
+option(ENABLE_LINUX		"Build wrappers for non-POSIX Linux functions"	ON)
+option(ENABLE_POSIX		"Build wrappers for POSIX functions"			ON)
+option(ENABLE_SOCKETS	"Build wrappers for BSD sockets functions"		ON)
+option(ENABLE_WX_IPV6	"Build the IPv6 extensions (requires sockets)"	ON)
+option(ENABLE_WX_SLURP	"Build the slurp and spew extensions"			ON)
+
+set(SOURCES
+	$<$<STREQUAL:$<UPPER_CASE:${ENABLE_LINUX}>,ON>:src/w/linux.cpp>
+	$<$<STREQUAL:$<UPPER_CASE:${ENABLE_POSIX}>,ON>:src/w/posix.cpp>
+	$<$<STREQUAL:$<UPPER_CASE:${ENABLE_SOCKETS}>,ON>:src/w/sockets.cpp>
+	$<$<STREQUAL:$<UPPER_CASE:${ENABLE_WX_IPV6}>,ON>:src/wx/ipv6.cpp>
+	$<$<STREQUAL:$<UPPER_CASE:${ENABLE_WX_SLURP}>,ON>:src/wx/slurp.cpp>
+)
+
+add_library(${PROJECT_NAME} SHARED ${SOURCES})
+
+set_target_properties(${PROJECT_NAME} PROPERTIES
+	CXX_STANDARD			17
+	CXX_STANDARD_REQUIRED	yes
+	CXX_EXTENSIONS			no
+	SOVERSION				${CMAKE_PROJECT_VERSION}
+)
+
+target_include_directories(${PROJECT_NAME}
+	PUBLIC
+		$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+		$<INSTALL_INTERFACE:include>)
+
+install(TARGETS ${PROJECT_NAME} EXPORT ${PROJECT_NAME})
+install(DIRECTORY include DESTINATION ${CMAKE_INSTALL_PREFIX} FILES_MATCHING PATTERN "*.hpp")
+install(EXPORT ${PROJECT_NAME} DESTINATION lib/cmake/${PROJECT_NAME})
+install(FILES cmake/${PROJECT_NAME}Config.cmake DESTINATION lib/cmake/${PROJECT_NAME})

LICENSE.txt

@@ -0,0 +1,21 @@
+libcppwrap - A collection of C++ wrappers for native APIs
+Copyright 2021-2023 David A. Norris <danorris@gmail.com>
+Published under the MIT license - https://opensource.org/licenses/MIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,60 @@
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![build](https://github.com/dvnrrs/libcppwrap/actions/workflows/build.yml/badge.svg)](https://github.com/dvnrrs/libcppwrap/actions/workflows/build.yml)
+[![doxygen](https://github.com/dvnrrs/libcppwrap/actions/workflows/doxygen.yml/badge.svg)](https://github.com/dvnrrs/libcppwrap/actions/workflows/doxygen.yml)
+
+# libcppwrap<br><small><sub>A collection of C++ wrappers for native APIs</sub></small>
+
+`libcppwrap` is a collection of low-level C++ wrappers around native C APIs such as POSIX
+functions and BSD sockets. It provides the following features on top of the native functions,
+while duplicating the function signatures as closely as possible:
+
+* Errors are thrown as `std::system_error` exceptions instead of returning error codes.
+* Since return values are no longer used for error reporting, output parameters can be returned as
+  values instead, wherever practical.
+* The [RAII](https://en.wikipedia.org/wiki/Resource_acquisition_is_initialization) pattern is
+  applied to resources such as file handles, preventing leaks, using a sophisticated and flexible
+  `w::handle` type.
+* Functions such as `fcntl()` and `ioctl()`, which can take input and/or output parameters of
+  arbitrary type, are implemented as type-safe templates.
+* Derived POD structures for types such as `sockaddr_in` are provided with useful constructors for
+  initialization. Use of the derived structures is always optional.
+
+The philosophy of the library is to stay as faithful as possible to the native API, while ensuring
+type- and exception-safety and resource management as robustly as possible. Some helper functions
+which deviate from the native APIs or add missing functionality are implemented in a separate,
+optional namespace, which can be disabled.
+
+The library is currently very POSIX-centric, being developed for and tested on Linux. It could and
+may eventually be extended to include native APIs for other platforms like Windows.
+
+# Usage
+
+`libcppwrap` exposes two namespaces, `w` and `wx`. The `w` namespace contains the core wrappers,
+which follow the native APIs as closely as possible. The `wx` namespace contains useful extensions
+which deviate from the native API but provide low-level functionality that would not necessarily
+justify a separate library.
+
+    #include <w/posix.hpp>
+
+	auto fd = w::open("file.txt", "at");
+	w::write(fd, "hello", 5);
+	// fd is automatically closed when it goes out of scope
+
+See the **[Doxygen API reference](https://dvnrrs.github.io/libcppwrap/)** for details.
+
+# Building
+
+`libcppwrap` has no dependencies, requiring only a C++ compiler that supports C++17.
+
+It can be built easily with [CMake](https://cmake.org/):
+
+    mkdir build
+	cd build
+	cmake ..
+	make
+	sudo make install
+
+# License
+
+`libcppwrap` is published under the [MIT License](https://opensource.org/license/mit/). See
+[LICENSE.txt](LICENSE.txt) for the full license text.

cmake/cppwrapConfig.cmake

@@ -0,0 +1,2 @@
+get_filename_component(SELF_DIR "${CMAKE_CURRENT_LIST_FILE}" PATH)
+include(${SELF_DIR}/cppwrap.cmake)

docs/.gitignore

@@ -0,0 +1 @@
+/html/