refactor: Update include statements to match our latest style guidelines (resolves #140).

examples/quick-start/.clang-format

@@ -1,20 +1,20 @@
 BasedOnStyle: "InheritParentConfig"
 
 IncludeCategories:
-  # NOTE: A header is grouped by first matching regex
-  # Project headers
-  - Regex: "^\""
-    Priority: 4
-  # Library headers. Update when adding new libraries.
+  # NOTE: A header is grouped by first matching regex library headers.
   # NOTE: clang-format retains leading white-space on a line in violation of the YAML spec.
-  # Ex:
-  # - Regex: "<(fmt|spdlog)"
-  #   Priority: 3
-  - Regex: "^<(absl|boost|catch2|fmt|mariadb|msgpack|spdlog|spider)"
+  # Project library headers
+  - Regex: "^<spider"
+    Priority: 4
+  # External library headers. Update when adding new libraries.
+  - Regex: "^<(absl|boost|catch2|fmt|mariadb|msgpack|spdlog|ystdlib)"
     Priority: 3
   # C system headers
   - Regex: "^<.+\\.h>"
     Priority: 1
   # C++ standard libraries
   - Regex: "^<.+>"
     Priority: 2
+  # Project relative headers
+  - Regex: "^\".+\""
+    Priority: 5

src/spider/.clang-format

@@ -1,15 +1,12 @@
 BasedOnStyle: "InheritParentConfig"
 
 IncludeCategories:
-  # NOTE: A header is grouped by first matching regex
-  # Project headers
+  # NOTE: A header is grouped by first matching regex library headers.
+  # NOTE: clang-format retains leading white-space on a line in violation of the YAML spec.
+  # Project library headers
   - Regex: "^<spider"
     Priority: 4
-  # Library headers. Update when adding new libraries.
-  # NOTE: clang-format retains leading white-space on a line in violation of the YAML spec.
-  # Ex:
-  # - Regex: "<(fmt|spdlog)"
-  #   Priority: 3
+  # External library headers. Update when adding new libraries.
   - Regex: "^<(absl|boost|catch2|fmt|mariadb|msgpack|spdlog|ystdlib)"
     Priority: 3
   # C system headers
@@ -18,3 +15,6 @@ IncludeCategories:
   # C++ standard libraries
   - Regex: "^<.+>"
     Priority: 2
+  # Project relative headers
+  - Regex: "^\".+\""
+    Priority: 5

src/spider/CMakeLists.txt

@@ -43,7 +43,7 @@ set(SPIDER_CORE_HEADERS
 
 add_library(spider_core)
 target_sources(spider_core PRIVATE ${SPIDER_CORE_SOURCES})
-target_sources(spider_core PUBLIC ${SPIDER_CORE_HEADERS})
+target_include_directories(spider_core PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/..)
 target_link_libraries(
     spider_core
     PUBLIC

src/spider/client/Data.hpp

@@ -11,13 +11,13 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "../core/Error.hpp"
-#include "../io/MsgPack.hpp"  // IWYU pragma: keep
-#include "../io/Serializer.hpp"
-#include "../storage/DataStorage.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "../storage/StorageFactory.hpp"
-#include "Exception.hpp"
+#include <spider/client/Exception.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
+#include <spider/io/Serializer.hpp>
+#include <spider/storage/DataStorage.hpp>
+#include <spider/storage/StorageConnection.hpp>
+#include <spider/storage/StorageFactory.hpp>
 
 namespace spider {
 namespace core {

src/spider/client/Driver.cpp

@@ -12,13 +12,13 @@
 #include <boost/uuid/random_generator.hpp>
 #include <boost/uuid/uuid.hpp>
 
-#include "../core/Driver.hpp"
-#include "../core/Error.hpp"
-#include "../core/KeyValueData.hpp"
-#include "../io/BoostAsio.hpp"  // IWYU pragma: keep
-#include "../storage/mysql/MySqlStorageFactory.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "Exception.hpp"
+#include <spider/client/Exception.hpp>
+#include <spider/core/Driver.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/core/KeyValueData.hpp>
+#include <spider/io/BoostAsio.hpp>  // IWYU pragma: keep
+#include <spider/storage/mysql/MySqlStorageFactory.hpp>
+#include <spider/storage/StorageConnection.hpp>
 
 namespace spider {
 Driver::Driver(std::string const& storage_url)

src/spider/client/Driver.hpp

@@ -8,26 +8,26 @@
 #include <thread>
 #include <tuple>
 #include <type_traits>
+#include <utility>
 #include <vector>
 
 #include <boost/uuid/random_generator.hpp>
 #include <boost/uuid/uuid.hpp>
 #include <fmt/format.h>
 
-#include "../core/Error.hpp"
-#include "../core/TaskGraphImpl.hpp"
-#include "../io/Serializer.hpp"
-#include "../storage/JobSubmissionBatch.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "../storage/StorageFactory.hpp"
-#include "../worker/FunctionManager.hpp"
-#include "../worker/FunctionNameManager.hpp"
-#include "Data.hpp"
-#include "Exception.hpp"
-#include "Job.hpp"
-#include "task.hpp"
-#include "TaskGraph.hpp"
-#include "utility"
+#include <spider/client/Data.hpp>
+#include <spider/client/Exception.hpp>
+#include <spider/client/Job.hpp>
+#include <spider/client/task.hpp>
+#include <spider/client/TaskGraph.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/core/TaskGraphImpl.hpp>
+#include <spider/io/Serializer.hpp>
+#include <spider/storage/JobSubmissionBatch.hpp>
+#include <spider/storage/StorageConnection.hpp>
+#include <spider/storage/StorageFactory.hpp>
+#include <spider/worker/FunctionManager.hpp>
+#include <spider/worker/FunctionNameManager.hpp>
 
 /**
  * Registers a Task function with Spider

src/spider/client/Job.hpp

@@ -16,17 +16,17 @@
 #include <boost/uuid/uuid.hpp>
 #include <fmt/format.h>
 
-#include "../core/DataImpl.hpp"
-#include "../core/Error.hpp"
-#include "../core/JobMetadata.hpp"
-#include "../io/MsgPack.hpp"  // IWYU pragma: keep
-#include "../storage/MetadataStorage.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "../storage/StorageFactory.hpp"
-#include "Data.hpp"
-#include "Exception.hpp"
-#include "task.hpp"
-#include "type_utils.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/client/Exception.hpp>
+#include <spider/client/task.hpp>
+#include <spider/client/type_utils.hpp>
+#include <spider/core/DataImpl.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/core/JobMetadata.hpp>
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
+#include <spider/storage/MetadataStorage.hpp>
+#include <spider/storage/StorageConnection.hpp>
+#include <spider/storage/StorageFactory.hpp>
 
 namespace spider {
 namespace core {

src/spider/client/TaskContext.cpp

@@ -9,10 +9,10 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "../core/Error.hpp"
-#include "../core/KeyValueData.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "Exception.hpp"
+#include <spider/client/Exception.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/core/KeyValueData.hpp>
+#include <spider/storage/StorageConnection.hpp>
 
 namespace spider {
 auto TaskContext::get_id() const -> boost::uuids::uuid {

src/spider/client/TaskContext.hpp

@@ -15,17 +15,17 @@
 #include <boost/uuid/uuid.hpp>
 #include <fmt/format.h>
 
-#include "../core/Error.hpp"
-#include "../core/TaskGraph.hpp"
-#include "../core/TaskGraphImpl.hpp"
-#include "../io/Serializer.hpp"
-#include "../storage/StorageConnection.hpp"
-#include "../storage/StorageFactory.hpp"
-#include "Data.hpp"
-#include "Exception.hpp"
-#include "Job.hpp"
-#include "task.hpp"
-#include "TaskGraph.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/client/Exception.hpp>
+#include <spider/client/Job.hpp>
+#include <spider/client/task.hpp>
+#include <spider/client/TaskGraph.hpp>
+#include <spider/core/Error.hpp>
+#include <spider/core/TaskGraph.hpp>
+#include <spider/core/TaskGraphImpl.hpp>
+#include <spider/io/Serializer.hpp>
+#include <spider/storage/StorageConnection.hpp>
+#include <spider/storage/StorageFactory.hpp>
 
 namespace spider {
 namespace core {

src/spider/client/TaskGraph.hpp

@@ -4,7 +4,7 @@
 #include <memory>
 #include <utility>
 
-#include "task.hpp"
+#include <spider/client/task.hpp>
 
 namespace spider {
 namespace core {

src/spider/client/spider.hpp

@@ -2,11 +2,11 @@
 #define SPIDER_CLIENT_SPIDER_HPP
 
 // IWYU pragma: begin_exports
-#include "Data.hpp"
-#include "Driver.hpp"
-#include "Job.hpp"
-#include "TaskContext.hpp"
-#include "TaskGraph.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/client/Driver.hpp>
+#include <spider/client/Job.hpp>
+#include <spider/client/TaskContext.hpp>
+#include <spider/client/TaskGraph.hpp>
 
 // IWYU pragma: end_exports
 

src/spider/client/task.hpp

@@ -3,9 +3,9 @@
 
 #include <type_traits>
 
-#include "../io/Serializer.hpp"
-#include "Data.hpp"
-#include "type_utils.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/client/type_utils.hpp>
+#include <spider/io/Serializer.hpp>
 
 namespace spider {
 /**

src/spider/core/DataImpl.hpp

@@ -4,9 +4,9 @@
 #include <memory>
 #include <utility>
 
-#include "../client/Data.hpp"
-#include "../storage/StorageFactory.hpp"
-#include "Data.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/core/Data.hpp>
+#include <spider/storage/StorageFactory.hpp>
 
 namespace spider::core {
 class DataImpl {

src/spider/core/Task.cpp

@@ -9,8 +9,8 @@
 #include <boost/uuid/uuid_io.hpp>
 #include <spdlog/spdlog.h>
 
-#include "../io/MsgPack.hpp"  // IWYU pragma: keep
-#include "../io/Serializer.hpp"  // IWYU pragma: keep
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
+#include <spider/io/Serializer.hpp>  // IWYU pragma: keep
 
 namespace spider::core {
 auto Task::get_arg_buffers() const -> std::optional<std::vector<msgpack::sbuffer>> {

src/spider/core/Task.hpp

@@ -13,8 +13,8 @@
 #include <boost/uuid/random_generator.hpp>
 #include <boost/uuid/uuid.hpp>
 
-#include "../io/MsgPack.hpp"
-#include "Data.hpp"
+#include <spider/core/Data.hpp>
+#include <spider/io/MsgPack.hpp>
 
 namespace spider::core {
 class TaskInput {

src/spider/core/TaskContextImpl.hpp

@@ -5,10 +5,10 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "../client/TaskContext.hpp"
-#include "../storage/DataStorage.hpp"
-#include "../storage/MetadataStorage.hpp"
-#include "../storage/StorageFactory.hpp"
+#include <spider/client/TaskContext.hpp>
+#include <spider/storage/DataStorage.hpp>
+#include <spider/storage/MetadataStorage.hpp>
+#include <spider/storage/StorageFactory.hpp>
 
 namespace spider::core {
 class TaskContextImpl {

src/spider/core/TaskGraph.hpp

@@ -12,7 +12,7 @@
 #include <boost/uuid/random_generator.hpp>
 #include <boost/uuid/uuid.hpp>
 
-#include "Task.hpp"
+#include <spider/core/Task.hpp>
 
 namespace spider::core {
 class TaskGraph {

src/spider/core/TaskGraphImpl.hpp

@@ -11,14 +11,14 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "../client/Data.hpp"
-#include "../client/task.hpp"
-#include "../client/type_utils.hpp"
-#include "../core/Task.hpp"
-#include "../core/TaskGraph.hpp"
-#include "../io/MsgPack.hpp"  // IWYU pragma: keep
-#include "../io/Serializer.hpp"  // IWYU pragma: keep
-#include "../worker/FunctionNameManager.hpp"
+#include <spider/client/Data.hpp>
+#include <spider/client/task.hpp>
+#include <spider/client/type_utils.hpp>
+#include <spider/core/Task.hpp>
+#include <spider/core/TaskGraph.hpp>
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
+#include <spider/io/Serializer.hpp>  // IWYU pragma: keep
+#include <spider/worker/FunctionNameManager.hpp>
 
 namespace spider::core {
 class Data;

src/spider/io/Serializer.hpp

@@ -6,7 +6,7 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "MsgPack.hpp"  // IWYU pragma: keep
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
 
 template <>
 struct msgpack::adaptor::convert<boost::uuids::uuid> {

src/spider/io/msgpack_message.cpp

@@ -14,8 +14,8 @@
 
 #include <spdlog/spdlog.h>
 
-#include "BoostAsio.hpp"  // IWYU pragma: keep
-#include "MsgPack.hpp"  // IWYU pragma: keep
+#include <spider/io/BoostAsio.hpp>  // IWYU pragma: keep
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
 
 namespace {
 /**

src/spider/io/msgpack_message.hpp

@@ -4,8 +4,8 @@
 #include <functional>
 #include <optional>
 
-#include "BoostAsio.hpp"  // IWYU pragma: keep
-#include "MsgPack.hpp"  // IWYU pragma :keep
+#include <spider/io/BoostAsio.hpp>  // IWYU pragma: keep
+#include <spider/io/MsgPack.hpp>  // IWYU pragma: keep
 
 namespace spider::core {
 auto send_message(boost::asio::ip::tcp::socket& socket, msgpack::sbuffer const& buffer) -> bool;

src/spider/scheduler/FifoPolicy.cpp

@@ -10,10 +10,10 @@
 
 #include <boost/uuid/uuid.hpp>
 
-#include "../core/Task.hpp"
-#include "../storage/DataStorage.hpp"
-#include "../storage/MetadataStorage.hpp"
-#include "../storage/StorageConnection.hpp"
+#include <spider/core/Task.hpp>
+#include <spider/storage/DataStorage.hpp>
+#include <spider/storage/MetadataStorage.hpp>
+#include <spider/storage/StorageConnection.hpp>
 
 namespace spider::scheduler {
 FifoPolicy::FifoPolicy(