refactor(sdk)!: rename package & namespace plotjuggler_core -> plotjuggler_sdk (#114)

The repository was renamed plotjuggler_core -> plotjuggler_sdk; make the Conan
package and CMake identity match. Version stays 0.6.0 — this folds into the
existing release (the v0.6.0 tag will be re-pointed). The code and ABI are
byte-identical; only the package/target identifiers change.

- Conan: name = "plotjuggler_sdk"; class PlotjugglerSdkConan; cmake_file_name and
  the component cmake_target_name -> plotjuggler_sdk::{base,plugin_sdk,plugin_host};
  url + docstring updated.
- CMake: project(plotjuggler_sdk); install(EXPORT plotjuggler_sdkTargets);
  NAMESPACE plotjuggler_sdk::; install dir cmake/plotjuggler_sdk; rename
  plotjuggler_coreConfig.cmake.in -> plotjuggler_sdkConfig.cmake.in; module ALIAS
  targets -> plotjuggler_sdk::*.
- test_sdk_install.sh, examples/sdk_consumer, build.sh, CI workflows, README,
  CLAUDE.md, and docs updated.
- pj_base/abi/baseline.abi left untouched: its two "plotjuggler_core" strings are
  CI-runner corpus paths in the abidw dump, not ABI, and abidiff ignores them.

BREAKING CHANGE: consumers must switch find_package(plotjuggler_core ...) ->
find_package(plotjuggler_sdk ...), the plotjuggler_core:: CMake namespace ->
plotjuggler_sdk::, and conan `requires plotjuggler_core/...` -> `plotjuggler_sdk/...`.
The ABI is unchanged, so already-built plugin .so files keep loading.

Verified: ./build.sh + ./test_sdk_install.sh (find_package(plotjuggler_sdk)
COMPONENTS base/plugin_sdk/plugin_host all OK).

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: facontidavide

.github/workflows/linux-ci.yml

@@ -168,14 +168,14 @@ jobs:
         run: >
           conan install . --output-folder=build --build=missing
           -s build_type=RelWithDebInfo -s compiler.cppstd=20
-          -o "plotjuggler_core/*:with_tests=True"
+          -o "plotjuggler_sdk/*:with_tests=True"
 
       - name: Save Conan cache to ghcr.io
         # Only push from the canonical repo on real pushes (forks lack write
         # access to ghcr.io packages). Skip on exact cache HIT — the tag content
         # is already up to date, no point re-uploading the same bytes. Skip if
         # neither oras install path succeeded (graceful degradation).
-        if: github.event_name == 'push' && github.repository == 'PlotJuggler/plotjuggler_core' && env.CONAN_CACHE_EXACT_HIT != '1' && (steps.setup_oras.outcome == 'success' || steps.setup_oras_fallback.outcome == 'success')
+        if: github.event_name == 'push' && github.repository == 'PlotJuggler/plotjuggler_sdk' && env.CONAN_CACHE_EXACT_HIT != '1' && (steps.setup_oras.outcome == 'success' || steps.setup_oras_fallback.outcome == 'success')
         shell: bash
         run: |
           set -euo pipefail

.github/workflows/macos-ci.yml

@@ -29,7 +29,7 @@ jobs:
         run: >
           conan install . --output-folder=build --build=missing
           -s build_type=RelWithDebInfo -s compiler.cppstd=20
-          -o "plotjuggler_core/*:with_tests=True"
+          -o "plotjuggler_sdk/*:with_tests=True"
 
       - name: Configure
         run: >

.github/workflows/release.yml

@@ -7,7 +7,7 @@ name: Release
 #
 # Why a matrix: Cloudsmith stores one binary package per platform/compiler
 # (package_id). A single ubuntu job only ever publishes a Linux/gcc binary, so
-# macOS and Windows consumers are forced to build plotjuggler_core from source
+# macOS and Windows consumers are forced to build plotjuggler_sdk from source
 # via `--build=missing`. That is slow and, on macOS specifically, fragile: a
 # from-source build depends on the recipe's exported sources being intact in
 # the cache, which breaks (e.g. after a version is re-published with a new
@@ -130,7 +130,7 @@ jobs:
             conan remote login plotjuggler-cloudsmith "$CLOUDSMITH_USER" -p "$CLOUDSMITH_API_KEY"
           fi
 
-          conan list "plotjuggler_core/${version}#*" -r plotjuggler-cloudsmith --format=json \
+          conan list "plotjuggler_sdk/${version}#*" -r plotjuggler-cloudsmith --format=json \
             > /tmp/remote_revs.json 2>/dev/null || true
 
           if grep -q "RECIPEUNKNOWN" /tmp/remote_revs.json; then
@@ -141,11 +141,11 @@ jobs:
           elif grep -q "${local_rrev}" /tmp/remote_revs.json; then
             echo "Recipe revision ${local_rrev} is already published for ${version} — idempotent re-run, proceeding."
           else
-            echo "::error::plotjuggler_core/${version} is already published with a different recipe revision."
+            echo "::error::plotjuggler_sdk/${version} is already published with a different recipe revision."
             echo "::error::This build would publish ${local_rrev}, which is not on the remote. Refusing to overwrite a released version."
             echo "::error::Cut a new version, or re-run via workflow_dispatch with allow_republish=true to repair a botched release."
             echo "Currently published for ${version}:"
-            conan list "plotjuggler_core/${version}#*" -r plotjuggler-cloudsmith 2>/dev/null || true
+            conan list "plotjuggler_sdk/${version}#*" -r plotjuggler-cloudsmith 2>/dev/null || true
             exit 1
           fi
 
@@ -218,7 +218,7 @@ jobs:
         # concurrent recipe uploads are idempotent — only the per-platform
         # binary differs. `--check` verifies integrity before/after transfer.
         run: |
-          conan upload "plotjuggler_core/${{ needs.prepare.outputs.version }}" \
+          conan upload "plotjuggler_sdk/${{ needs.prepare.outputs.version }}" \
             -r plotjuggler-cloudsmith \
             --confirm \
             --check
@@ -238,7 +238,7 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.prepare.outputs.tag }}
-          name: plotjuggler_core ${{ needs.prepare.outputs.tag }}
+          name: plotjuggler_sdk ${{ needs.prepare.outputs.tag }}
           generate_release_notes: true
           body: |
             ## Install via Conan
@@ -250,16 +250,16 @@ jobs:
             Add to your `conanfile.py` / `conanfile.txt`:
 
             ```python
-            requires = ("plotjuggler_core/${{ needs.prepare.outputs.version }}",)
+            requires = ("plotjuggler_sdk/${{ needs.prepare.outputs.version }}",)
             ```
 
             Link in CMake:
 
             ```cmake
-            find_package(plotjuggler_core REQUIRED COMPONENTS plugin_sdk)
-            target_link_libraries(my_plugin PRIVATE plotjuggler_core::plugin_sdk)
+            find_package(plotjuggler_sdk REQUIRED COMPONENTS plugin_sdk)
+            target_link_libraries(my_plugin PRIVATE plotjuggler_sdk::plugin_sdk)
             ```
 
-            See [README.md](https://github.com/PlotJuggler/plotjuggler_core/blob/main/README.md)
+            See [README.md](https://github.com/PlotJuggler/plotjuggler_sdk/blob/main/README.md)
             for available components (`base`, `plugin_sdk`, `plugin_host`)
             and consumer examples.

.github/workflows/windows-ci.yml

@@ -138,14 +138,14 @@ jobs:
         run: >
           conan install . --output-folder=build --build=missing
           -s build_type=Release -s compiler.cppstd=20
-          -o "plotjuggler_core/*:with_tests=True"
+          -o "plotjuggler_sdk/*:with_tests=True"
 
       - name: Save Conan cache to ghcr.io
         # Only push from the canonical repo on real pushes (forks lack write
         # access to ghcr.io packages). Skip on exact cache HIT — the tag content
         # is already up to date, no point re-uploading the same bytes. Skip if
         # neither oras install path succeeded (graceful degradation).
-        if: github.event_name == 'push' && github.repository == 'PlotJuggler/plotjuggler_core' && env.CONAN_CACHE_EXACT_HIT != '1' && (steps.setup_oras.outcome == 'success' || steps.setup_oras_fallback.outcome == 'success')
+        if: github.event_name == 'push' && github.repository == 'PlotJuggler/plotjuggler_sdk' && env.CONAN_CACHE_EXACT_HIT != '1' && (steps.setup_oras.outcome == 'success' || steps.setup_oras_fallback.outcome == 'success')
         shell: pwsh
         run: |
           $tag = "${{ steps.conan_cache.outputs.tag }}"

CLAUDE.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-PlotJuggler Core — C++20 foundation libraries that make up the PlotJuggler plugin SDK and host-side
+PlotJuggler SDK — C++20 foundation libraries that make up the PlotJuggler plugin SDK and host-side
 plugin loading. **Read-only submodule** inside PJ4: consumed as-is; changes happen in this repo,
 not in the PJ4 superproject. This file is the single navigation node for the whole submodule — the
 two modules below have no own CLAUDE.md.
@@ -92,7 +92,7 @@ The bump is decided by **plugin impact**, semver-style:
   installed header) take **no bump**.
 
 **Plugin compatibility range.** A plugin built and tested on `X.Y.Z` works on every later
-MINOR/PATCH up to the next MAJOR, so it pins `plotjuggler_core/[>=X.Y.Z <(X+1).0.0]` — e.g. built on
+MINOR/PATCH up to the next MAJOR, so it pins `plotjuggler_sdk/[>=X.Y.Z <(X+1).0.0]` — e.g. built on
 `1.4.2` → `[>=1.4.2 <2.0.0]`. The lower bound is the version that introduced the newest feature the
 plugin actually uses (a plugin that does not adopt `0.6`'s additions stays at `>=0.5.2`); the upper
 bound is the next MAJOR. Write the range **explicitly** — do not rely on caret/tilde shorthand.

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.22)
-project(plotjuggler_core LANGUAGES CXX)
+project(plotjuggler_sdk LANGUAGES CXX)
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
@@ -16,7 +16,7 @@ include(PjPluginManifest)
 option(PJ_ASSERT_THROWS "Use exceptions instead of assert() for PJ_ASSERT" OFF)
 option(PJ_ENABLE_SANITIZERS "Enable ASAN for Debug builds" OFF)
 option(PJ_ENABLE_TSAN "Enable ThreadSanitizer for Debug builds" OFF)
-option(PJ_INSTALL_SDK "Install plotjuggler_core CMake package (base/plugin_sdk/plugin_host)" OFF)
+option(PJ_INSTALL_SDK "Install plotjuggler_sdk CMake package (base/plugin_sdk/plugin_host)" OFF)
 option(PJ_BUILD_PORTED_PLUGINS "Build pj_ported_plugins (ported plugins collection)" ON)
 option(PJ_BUILD_TESTS "Build tests, benchmarks, and examples" ON)
 option(PJ_ENABLE_ABI_CHECK "Enable abidiff-based ABI drift gate (requires libabigail)" OFF)
@@ -77,7 +77,7 @@ target_link_libraries(pj_internal_fmt INTERFACE ${PJ_FMT_TARGET})
 
 # fast_float backs the floating-point branch of PJ::parseNumber. Header-only;
 # linked PRIVATE under a BUILD_INTERFACE scope by pj_base so it never appears
-# in the installed plotjuggler_coreTargets file. Conan ships the CMake
+# in the installed plotjuggler_sdkTargets file. Conan ships the CMake
 # package under the capitalised name `FastFloat`.
 find_package(FastFloat REQUIRED)
 
@@ -98,9 +98,9 @@ if(PJ_BUILD_PORTED_PLUGINS AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/pj_ported_plu
 endif()
 
 # ---------------------------------------------------------------------------
-# plotjuggler_core package install
+# plotjuggler_sdk package install
 #
-# Exported CMake namespace: plotjuggler_core::
+# Exported CMake namespace: plotjuggler_sdk::
 # Components:
 #   base         — vocabulary types (always available)
 #   plugin_sdk   — plugin-author surface: base + dialog SDK + parser SDK
@@ -112,28 +112,28 @@ if(PJ_INSTALL_SDK)
   include(CMakePackageConfigHelpers)
 
   set(PJ_PACKAGE_VERSION "0.6.0")
-  set(PJ_PACKAGE_CMAKE_DIR ${CMAKE_INSTALL_LIBDIR}/cmake/plotjuggler_core)
+  set(PJ_PACKAGE_CMAKE_DIR ${CMAKE_INSTALL_LIBDIR}/cmake/plotjuggler_sdk)
 
-  install(EXPORT plotjuggler_coreTargets
-    NAMESPACE plotjuggler_core::
+  install(EXPORT plotjuggler_sdkTargets
+    NAMESPACE plotjuggler_sdk::
     DESTINATION ${PJ_PACKAGE_CMAKE_DIR}
   )
 
   configure_package_config_file(
-    cmake/plotjuggler_coreConfig.cmake.in
-    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_coreConfig.cmake"
+    cmake/plotjuggler_sdkConfig.cmake.in
+    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_sdkConfig.cmake"
     INSTALL_DESTINATION ${PJ_PACKAGE_CMAKE_DIR}
   )
 
   write_basic_package_version_file(
-    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_coreConfigVersion.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_sdkConfigVersion.cmake"
     VERSION ${PJ_PACKAGE_VERSION}
     COMPATIBILITY SameMajorVersion
   )
 
   install(FILES
-    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_coreConfig.cmake"
-    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_coreConfigVersion.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_sdkConfig.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/plotjuggler_sdkConfigVersion.cmake"
     cmake/PjPluginManifest.cmake
     DESTINATION ${PJ_PACKAGE_CMAKE_DIR}
   )

LICENSE

@@ -1,4 +1,4 @@
-PlotJuggler Core is licensed per-module. Every source file carries an
+PlotJuggler SDK is licensed per-module. Every source file carries an
 SPDX-License-Identifier header that is authoritative for that file.
 
   Module          License        Full text

README.md

@@ -1,7 +1,7 @@
-# PlotJuggler Core
+# PlotJuggler SDK
 
-[![Linux CI](https://github.com/PlotJuggler/plotjuggler_core/actions/workflows/linux-ci.yml/badge.svg)](https://github.com/PlotJuggler/plotjuggler_core/actions/workflows/linux-ci.yml)
-[![Windows CI](https://github.com/PlotJuggler/plotjuggler_core/actions/workflows/windows-ci.yml/badge.svg)](https://github.com/PlotJuggler/plotjuggler_core/actions/workflows/windows-ci.yml)
+[![Linux CI](https://github.com/PlotJuggler/plotjuggler_sdk/actions/workflows/linux-ci.yml/badge.svg)](https://github.com/PlotJuggler/plotjuggler_sdk/actions/workflows/linux-ci.yml)
+[![Windows CI](https://github.com/PlotJuggler/plotjuggler_sdk/actions/workflows/windows-ci.yml/badge.svg)](https://github.com/PlotJuggler/plotjuggler_sdk/actions/workflows/windows-ci.yml)
 
 C++20 foundation libraries for [PlotJuggler](https://github.com/facontidavide/PlotJuggler).
 
@@ -29,7 +29,7 @@ sudo apt install clangd-22 clang-format-22 clang-tidy-22
 
 ```bash
 git clone <this repo>
-cd plotjuggler_core
+cd plotjuggler_sdk
 
 ./build.sh              # RelWithDebInfo (build/)
 ./build.sh --debug      # Debug + ASAN (build/debug_asan)
@@ -47,7 +47,7 @@ docs/                      Project-wide design guides
 
 ## License
 
-PlotJuggler Core is **Apache-2.0** ([LICENSE-APACHE](LICENSE-APACHE)); each
+PlotJuggler SDK is **Apache-2.0** ([LICENSE-APACHE](LICENSE-APACHE)); each
 source file carries an authoritative `SPDX-License-Identifier` header. You may
 build **proprietary plugins and applications** on the SDK without restriction;
 Apache-2.0 also grants an explicit patent license.

build.sh

@@ -69,7 +69,7 @@ build_config() {
 
   conan install "$SCRIPT_DIR" --output-folder="$build_dir" --build=missing \
     -s build_type="$build_type" -s compiler.cppstd=20 \
-    -o "plotjuggler_core/*:with_tests=True" \
+    -o "plotjuggler_sdk/*:with_tests=True" \
     "${conan_extra[@]+"${conan_extra[@]}"}"
 
   # Install dependencies from subdirectory conanfiles (e.g. pj_ported_plugins)

cmake/plotjuggler_coreConfig.cmake.in cmake/plotjuggler_sdkConfig.cmake.incmake/plotjuggler_coreConfig.cmake.in renamed to cmake/plotjuggler_sdkConfig.cmake.in

@@ -4,35 +4,35 @@ include(CMakeFindDependencyMacro)
 
 # Default to plugin_sdk if no components requested — the most common
 # consumer (a plugin author) wants the plugin-author SDK surface.
-if(NOT plotjuggler_core_FIND_COMPONENTS)
-  set(plotjuggler_core_FIND_COMPONENTS plugin_sdk)
+if(NOT plotjuggler_sdk_FIND_COMPONENTS)
+  set(plotjuggler_sdk_FIND_COMPONENTS plugin_sdk)
 endif()
 
-# Include the exported targets (defines plotjuggler_core::base, etc.).
-include("${CMAKE_CURRENT_LIST_DIR}/plotjuggler_coreTargets.cmake")
+# Include the exported targets (defines plotjuggler_sdk::base, etc.).
+include("${CMAKE_CURRENT_LIST_DIR}/plotjuggler_sdkTargets.cmake")
 
 # Per-component dependencies and validation.
-foreach(_comp ${plotjuggler_core_FIND_COMPONENTS})
+foreach(_comp ${plotjuggler_sdk_FIND_COMPONENTS})
   if(_comp STREQUAL "base")
-    set(plotjuggler_core_base_FOUND TRUE)
+    set(plotjuggler_sdk_base_FOUND TRUE)
 
   elseif(_comp STREQUAL "plugin_sdk")
     find_dependency(nlohmann_json)
     # Ship the cmake/PjPluginManifest.cmake helper so plugin authors can call
     # pj_emit_plugin_manifest() without copying the helper into their tree.
     include("${CMAKE_CURRENT_LIST_DIR}/PjPluginManifest.cmake")
-    set(plotjuggler_core_plugin_sdk_FOUND TRUE)
+    set(plotjuggler_sdk_plugin_sdk_FOUND TRUE)
 
   elseif(_comp STREQUAL "plugin_host")
     find_dependency(nlohmann_json)
-    set(plotjuggler_core_plugin_host_FOUND TRUE)
+    set(plotjuggler_sdk_plugin_host_FOUND TRUE)
 
   else()
-    set(plotjuggler_core_${_comp}_FOUND FALSE)
-    if(plotjuggler_core_FIND_REQUIRED_${_comp})
-      message(FATAL_ERROR "plotjuggler_core: unknown component \"${_comp}\"")
+    set(plotjuggler_sdk_${_comp}_FOUND FALSE)
+    if(plotjuggler_sdk_FIND_REQUIRED_${_comp})
+      message(FATAL_ERROR "plotjuggler_sdk: unknown component \"${_comp}\"")
     endif()
   endif()
 endforeach()
 
-check_required_components(plotjuggler_core)
+check_required_components(plotjuggler_sdk)