v0.0.3 Alpha

.github/workflows/clang-format.yml

@@ -0,0 +1,20 @@
+name: clang-format
+on: [push, pull_request]
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install clang-format
+      run: sudo apt install -y cmake clang-format-19
+    - name: clang-format
+      # Create symbolic link to clang-format-19 and 
+      # add it to PATH so that 'clang-format' can 
+      # be used to run 'clang-format-19'.
+      run: |
+        ln -s $(which clang-format-19) clang-format
+        export PATH=$PWD:$PATH
+        cmake .
+        make lint

.github/workflows/cppcheck.yml

@@ -0,0 +1,15 @@
+name: cppcheck
+on: [push, pull_request]
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install cppcheck
+      run: sudo apt-get install -y cmake cppcheck
+    - name: Run cppcheck
+      run: |
+        cmake .
+        make check

.github/workflows/ruff.yml

@@ -0,0 +1,17 @@
+name: ruff
+on: [push, pull_request]
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+    - name: Install ruff
+      run: python3 -m pip install --upgrade pip ruff
+    - name: Run ruff
+      run: ruff check

.gitignore

@@ -1,9 +1,6 @@
 # Prerequisites
 *.d
 
-# Vscode settings
-.vscode/
-
 # Compiled Object files
 *.slo
 *.lo

.pre-commit-config.yaml

@@ -14,3 +14,7 @@ repos:
         pass_filenames: false
         always_run: true
         verbose: true
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.9
+    hooks:
+      - id: ruff-format

.vscode/c_cpp_properties.json

@@ -0,0 +1,22 @@
+{
+    "configurations": [
+        {
+            "name": "Mac",
+            "includePath": [
+                "${workspaceFolder}/cbxp",
+                "${workspaceFolder}/externals",
+                "/opt/homebrew/opt/python@3.12/Frameworks/Python.framework/Versions/3.12/include/python3.12",
+                "/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/include/python3.13"
+            ],
+            "defines": [
+                "__ptr32=",
+                "VERSION=\"test\""
+            ],
+            "compilerPath": "/usr/bin/clang",
+            "cStandard": "c11",
+            "cppStandard": "c++17",
+            "intelliSenseMode": "macos-clang-arm64"
+        }
+    ],
+    "version": 4
+}

CMakeLists.txt

@@ -1,28 +1,47 @@
 cmake_minimum_required(VERSION 3.15)
 
+project(CBXP VERSION 0.0.3
+             DESCRIPTION "A unified and standardized interface for extracting z/OS control block data."
+             LANGUAGES C CXX)
+
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "./dist")
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "./dist")
+
 execute_process(
     COMMAND uname
     OUTPUT_VARIABLE uname_output
     RESULT_VARIABLE uname_result
 )
 
+# ============================================================================
+# Compiler Info
+# ============================================================================
 set(CXX_STANDARD 17)
 
+set(
+    COMPILE_OPTIONS
+    -O2
+    -fzos-le-char-mode=ascii
+    -fstack-protector-strong
+    -Wno-trigraphs
+)
+
+set(LINK_OPTIONS -m64 -Wl,-b,edit=no)
+
 if(uname_output STREQUAL "OS/390\n")
     set(CMAKE_CXX_COMPILER "ibm-clang++64")
 else()
     set(CMAKE_CXX_COMPILER "clang")
 endif()
 
-set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "./dist")
-
-project(CBXP VERSION 0.0.2
-             DESCRIPTION "A unified and standardized interface for extracting z/OS control block data."
-             LANGUAGES C CXX)
-
+# ============================================================================
+# Sources
+# ============================================================================
 file(
-    GLOB CBXP_SRC 
-    "cbxp/*.cpp"
+    GLOB CBXP_SRC_LIB
+    "cbxp/cbxp.cpp"
+    "cbxp/control_block_explorer.cpp"
+    "cbxp/logger.cpp"
     "cbxp/control_blocks/*.cpp"
 )
 
@@ -38,50 +57,76 @@ file(
     "cbxp/**/*.h"
 )
 
-add_executable(cbxp ${CBXP_SRC})
+# ============================================================================
+# Build '/lib/libcbxp.a'
+# ============================================================================
+add_library(libcbxp STATIC ${CBXP_SRC_LIB})
+set_target_properties(libcbxp PROPERTIES OUTPUT_NAME "cbxp")
 
 target_include_directories(
-    cbxp PUBLIC
+    libcbxp PUBLIC
     cbxp
     cbxp/control_blocks
     externals
     /usr/include/zos
 )
 
+target_compile_options(libcbxp PUBLIC ${COMPILE_OPTIONS})
+target_link_options(libcbxp PUBLIC ${LINK_OPTIONS})
+
+# ============================================================================
+# Build '/bin/cbxp'
+# ============================================================================
+add_executable(cbxp "cbxp/main.cpp")
+
+target_link_libraries(cbxp libcbxp)
+
+target_include_directories(cbxp PUBLIC cbxp externals)
+
 target_compile_definitions(
-    cbxp
-    PUBLIC
+    cbxp PUBLIC
     VERSION="${CMAKE_PROJECT_VERSION}"
 )
 
-target_compile_options(
-    cbxp PUBLIC 
-    -fzos-le-char-mode=ascii
-    -Wno-trigraphs
-)
+target_compile_options(cbxp PUBLIC ${COMPILE_OPTIONS})
+target_link_options(cbxp PUBLIC ${LINK_OPTIONS})
 
+# ============================================================================
+# Packaging
+# ============================================================================
 add_custom_target(
     package
     COMMAND "mkdir"
                 "-p"
                 "cbxp-${CMAKE_PROJECT_VERSION}/bin"
+                "cbxp-${CMAKE_PROJECT_VERSION}/lib"
+                "cbxp-${CMAKE_PROJECT_VERSION}/include"
     COMMAND "cp"
                 "LICENSE"
                 "cbxp-${CMAKE_PROJECT_VERSION}/"
     COMMAND "cp"
                 "NOTICES"
                 "cbxp-${CMAKE_PROJECT_VERSION}/"
     COMMAND "cp"
-                "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/cbxp"
+                "./dist/cbxp"
                 "cbxp-${CMAKE_PROJECT_VERSION}/bin/"
+    COMMAND "cp"
+                "./dist/libcbxp.a"
+                "cbxp-${CMAKE_PROJECT_VERSION}/lib/"
+    COMMAND "cp"
+                "./cbxp/cbxp.h"
+                "cbxp-${CMAKE_PROJECT_VERSION}/include/"
     COMMAND "pax"
-                "-wzf"
-                "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/cbxp-${CMAKE_PROJECT_VERSION}.pax.Z"
-                "-o saveext"
+                "-x" "pax"
+                "-wzvf"
+                "./dist/cbxp-${CMAKE_PROJECT_VERSION}.pax.Z"
                 "cbxp-${CMAKE_PROJECT_VERSION}/*"
-    DEPENDS cbxp
+    DEPENDS libcbxp cbxp
 )
 
+# ============================================================================
+# Cppcheck
+# ============================================================================
 add_custom_target(
     check
     COMMAND "cppcheck"
@@ -101,6 +146,9 @@ add_custom_target(
                 "${CMAKE_CURRENT_SOURCE_DIR}/cbxp"
 )
 
+# ============================================================================
+# Lint
+# ============================================================================
 add_custom_target(
     lint
     COMMAND "clang-format"
@@ -109,15 +157,21 @@ add_custom_target(
                 ${CBXP_SRC_ALL}
 )
 
+# ============================================================================
+# Format
+# ============================================================================
 add_custom_target(
     format
     COMMAND "clang-format"
                 "-i"
                 ${CBXP_SRC_ALL}
 )
 
+# ============================================================================
+# Test
+# ============================================================================
 add_custom_target(
     test
     COMMAND "./tests/test.sh"
-    DEPENDS cbxp
+    DEPENDS libcbxp cbxp
 )