remove dependency on fmt library, using std::format instead

This bumps the standard version to C++23, so that the `formattable`
concept becomes available.

This removes the color support from `diff.cpp`, since that is not
available in std::format.

Author: mizvekov

.github/workflows/ci.yml

@@ -35,10 +35,10 @@ jobs:
         with:
           compilers: |
             gcc 14
-            clang 18
+            clang 20
             msvc >=14.40
             apple-clang *
-          standards: '20'
+          standards: '23'
           latest-factors: |
             msvc Optimized-Debug
             gcc Coverage
@@ -282,26 +282,6 @@ jobs:
           run-tests: false
           trace-commands: true
 
-      - name: Install Fmt
-        uses: alandefreitas/cpp-actions/[email protected]
-        with:
-          source-dir: ../third-party/fmt
-          git-repository: https://github.com/fmtlib/fmt
-          git-tag: 10.2.1
-          build-dir: ${sourceDir}/build
-          cc: ${{ steps.setup-cpp.outputs.cc }}
-          cxx: ${{ steps.setup-cpp.outputs.cxx }}
-          ccflags: ${{ matrix.ccflags }}
-          cxxflags: ${{ matrix.cxxflags }}
-          build-type: ${{ matrix.build-type }}
-          extra-args: |
-            -D FMT_DOC=OFF
-            -D FMT_TEST=OFF
-          install: true
-          install-prefix: ${sourceDir}/install
-          run-tests: false
-          trace-commands: true
-
       - name: Install Libxml2
         uses: alandefreitas/cpp-actions/[email protected]
         if: matrix.compiler == 'msvc'
@@ -378,7 +358,6 @@ jobs:
             -D Clang_ROOT=../third-party/llvm-project/install
             -D duktape_ROOT=../third-party/duktape/install
             -D Duktape_ROOT=../third-party/duktape/install
-            -D fmt_ROOT=../third-party/fmt/install
             ${{ runner.os == 'Windows' && '-D libxml2_ROOT=../third-party/libxml2/install' || '' }}
             ${{ runner.os == 'Windows' && '-D LibXml2_ROOT=../third-party/libxml2/install' || '' }}
           export-compile-commands: true

CMakeLists.txt

@@ -119,9 +119,6 @@ llvm_map_components_to_libnames(llvm_libs all)
 string(REGEX REPLACE " /W[0-4]" "" CMAKE_C_FLAGS "${CMAKE_C_FLAGS}")
 string(REGEX REPLACE " /W[0-4]" "" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
 
-# fmt
-find_package(fmt REQUIRED CONFIG)
-
 # Duktape
 find_package(Duktape CONFIG)
 if (NOT DUKTAPE_FOUND)
@@ -214,7 +211,7 @@ list(APPEND LIB_SOURCES
     ${CMAKE_CURRENT_BINARY_DIR}/src/lib/Lib/PublicSettings.cpp
 )
 add_library(mrdocs-core ${LIB_SOURCES})
-target_compile_features(mrdocs-core PUBLIC cxx_std_20)
+target_compile_features(mrdocs-core PUBLIC cxx_std_23)
 target_include_directories(mrdocs-core
     PUBLIC
     "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include/>"
@@ -234,7 +231,6 @@ target_compile_definitions(
 # Dependencies
 target_include_directories(mrdocs-core SYSTEM PUBLIC ${LLVM_INCLUDE_DIRS})
 target_include_directories(mrdocs-core SYSTEM PUBLIC ${CLANG_INCLUDE_DIRS})
-target_link_libraries(mrdocs-core PUBLIC fmt::fmt)
 target_include_directories(mrdocs-core SYSTEM PRIVATE ${DUKTAPE_INCLUDE_DIRS})
 target_link_libraries(mrdocs-core PRIVATE ${DUKTAPE_LIBRARY})
 

docs/modules/ROOT/pages/install.adoc

@@ -41,27 +41,9 @@ These instructions assume all dependencies are installed in the `third-party` di
 Feel free to install them anywhere you want and adjust the main MrDocs configuration command later.
 ====
 
-[#install-fmt]
+[#install-vcpkg]
 === Fmt
 
-MrDocs uses the `fmt` library for formatting strings.
-From the `third-party` directory, you can clone the `fmt` repository and install it with the following commands:
-
-[source,bash]
-----
-git clone https://github.com/fmtlib/fmt --branch 10.2.1 --depth 1 <.>
-cd fmt
-cmake -S . -B ./build -DCMAKE_BUILD_TYPE=Release -D FMT_DOC=OFF -D FMT_TEST=OFF <.>
-cmake --build ./build --config Release <.>
-cmake --install ./build --prefix ./install <.>
-cd ..
-----
-
-<.> Shallow clones the fmt repository.
-<.> Configure the fmt library with CMake, excluding the documentation and tests.
-<.> Builds the fmt library in the `build` directory.
-<.> Installs the fmt library in the `install` directory.
-
 [IMPORTANT]
 ====
 All instructions in this document assume you are using a CMake version above 3.26.
@@ -82,12 +64,10 @@ Windows PowerShell::
 git clone https://github.com/microsoft/vcpkg.git -b master <.>
 cd vcpkg
 bootstrap-vcpkg.bat <.>
-vcpkg.exe install fmt --triplet x64-windows <.>
 ----
 
 <.> Clones the Vcpkg repository.
 <.> Bootstraps Vcpkg.
-<.> Installs the `fmt` library.
 --
 
 Unix Variants::
@@ -98,18 +78,16 @@ Unix Variants::
 git clone https://github.com/microsoft/vcpkg.git -b master <.>
 cd vcpkg
 ./bootstrap-vcpkg.sh <.>
-./vcpkg install fmt <.>
 ----
 
 <.> Clones the Vcpkg repository.
 <.> Bootstraps Vcpkg.
-<.> Installs the `fmt` library.
 --
 ====
 
 [NOTE]
 ====
-You can also install `fmt` with Vcpkg in _Manifest mode_.
+You can also install the dependencies with Vcpkg in _Manifest mode_.
 In https://learn.microsoft.com/en-us/vcpkg/users/manifests[manifest mode,windows=blank_], you declare your project's direct dependencies in a manifest file named `vcpkg.json`.
 MrDocs includes a `vcpkg.json.example` file you can duplicate or create a symlink as `vcpkg.json` to use this mode.
 This file includes all the dependencies MrDocs needs, except for LLVM.
@@ -238,7 +216,7 @@ cd vcpkg
 --
 ====
 
-NOTE: These examples assume VcPkg is already installed in the `third-party/vcpkg` directory (see the <<install-fmt>> section).
+NOTE: These examples assume VcPkg is already installed in the `third-party/vcpkg` directory (see the <<install-vcpkg>> section).
 
 === Libxml2
 
@@ -292,7 +270,7 @@ cd vcpkg
 --
 ====
 
-NOTE: These examples assume VcPkg is already installed in the `third-party/vcpkg` directory (see the <<install-fmt>> section).
+NOTE: These examples assume VcPkg is already installed in the `third-party/vcpkg` directory (see the <<install-vcpkg>> section).
 
 === LLVM
 

include/mrdocs/Dom/Object.ipp

@@ -149,14 +149,15 @@ Object::visit(F&& fn) const
 //------------------------------------------------
 
 template<>
-struct fmt::formatter<clang::mrdocs::dom::Object>
-    : fmt::formatter<std::string>
+struct std::formatter<clang::mrdocs::dom::Object>
+    : std::formatter<std::string>
 {
+    template <class FmtContext>
     auto format(
         clang::mrdocs::dom::Object const& value,
-        fmt::format_context& ctx) const
+        FmtContext& ctx) const
     {
-        return fmt::formatter<std::string>::format(
+        return std::formatter<std::string>::format(
             toString(value), ctx);
     }
 };

include/mrdocs/Dom/String.hpp

@@ -11,9 +11,9 @@
 #ifndef MRDOCS_API_DOM_STRING_HPP
 #define MRDOCS_API_DOM_STRING_HPP
 
+#include <format>
 #include <mrdocs/Platform.hpp>
 #include <mrdocs/Support/String.hpp>
-#include <fmt/format.h>
 
 namespace clang {
 namespace mrdocs {
@@ -341,17 +341,13 @@ class MRDOCS_DECL
 
 //------------------------------------------------
 
-template<>
-struct fmt::formatter<clang::mrdocs::dom::String>
-    : fmt::formatter<std::string_view>
-{
-    auto format(
-        clang::mrdocs::dom::String const& value,
-        fmt::format_context& ctx) const
-    {
-        return fmt::formatter<std::string_view>::format(
-            value.get(), ctx);
-    }
+template <>
+struct std::formatter<clang::mrdocs::dom::String>
+    : std::formatter<std::string_view> {
+  template <class FmtContext>
+  auto format(clang::mrdocs::dom::String const &value, FmtContext &ctx) const {
+    return std::formatter<std::string_view>::format(value.get(), ctx);
+  }
 };
 
 #endif

include/mrdocs/Dom/Value.hpp

@@ -11,18 +11,19 @@
 #ifndef MRDOCS_API_DOM_VALUE_HPP
 #define MRDOCS_API_DOM_VALUE_HPP
 
-#include <mrdocs/Platform.hpp>
+#include <charconv>
+#include <compare>
+#include <format>
+#include <mrdocs/ADT/Optional.hpp>
 #include <mrdocs/Dom/Array.hpp>
-#include <mrdocs/Dom/Kind.hpp>
 #include <mrdocs/Dom/Function.hpp>
+#include <mrdocs/Dom/Kind.hpp>
 #include <mrdocs/Dom/Object.hpp>
 #include <mrdocs/Dom/String.hpp>
-#include <mrdocs/ADT/Optional.hpp>
+#include <mrdocs/Platform.hpp>
 #include <mrdocs/Support/Error.hpp>
 #include <optional> // BAD
 #include <string>
-#include <charconv>
-#include <compare>
 
 namespace clang {
 namespace mrdocs {
@@ -849,17 +850,13 @@ safeString(SV const& str) {
 
 //------------------------------------------------
 
-template<>
-struct fmt::formatter<clang::mrdocs::dom::Value>
-    : public fmt::formatter<std::string>
-{
-    auto format(
-        clang::mrdocs::dom::Value const& value,
-        fmt::format_context& ctx) const
-    {
-        return fmt::formatter<std::string>::format(
-            toString(value), ctx);
-    }
+template <>
+struct std::formatter<clang::mrdocs::dom::Value>
+    : public std::formatter<std::string> {
+  template <class FmtContext>
+  auto format(clang::mrdocs::dom::Value const &value, FmtContext &ctx) const {
+    return std::formatter<std::string>::format(toString(value), ctx);
+  }
 };
 
 #endif

include/mrdocs/Metadata/Javadoc.hpp

@@ -13,15 +13,16 @@
 #ifndef MRDOCS_API_METADATA_JAVADOC_HPP
 #define MRDOCS_API_METADATA_JAVADOC_HPP
 
-#include <mrdocs/Platform.hpp>
-#include <mrdocs/Metadata/SymbolID.hpp>
-#include <mrdocs/Support/Visitor.hpp>
-#include <mrdocs/Support/Concepts.hpp>
+#include <algorithm>
+#include <memory>
 #include <mrdocs/ADT/Polymorphic.hpp>
-#include <mrdocs/Dom/String.hpp>
-#include <mrdocs/Dom/LazyObject.hpp>
 #include <mrdocs/Dom/LazyArray.hpp>
-#include <memory>
+#include <mrdocs/Dom/LazyObject.hpp>
+#include <mrdocs/Dom/String.hpp>
+#include <mrdocs/Metadata/SymbolID.hpp>
+#include <mrdocs/Platform.hpp>
+#include <mrdocs/Support/Concepts.hpp>
+#include <mrdocs/Support/Visitor.hpp>
 #include <string>
 #include <type_traits>
 #include <utility>

include/mrdocs/Support/Error.hpp

@@ -12,17 +12,18 @@
 #ifndef MRDOCS_API_SUPPORT_ERROR_HPP
 #define MRDOCS_API_SUPPORT_ERROR_HPP
 
-#include <mrdocs/Platform.hpp>
-#include <mrdocs/Support/source_location.hpp>
-#include <fmt/format.h>
 #include <exception>
+#include <format>
+#include <functional>
 #include <memory>
+#include <mrdocs/Platform.hpp>
+#include <mrdocs/Support/source_location.hpp>
 #include <string>
 #include <string_view>
+#include <system_error>
 #include <type_traits>
 #include <utility>
 #include <vector>
-#include <functional>
 
 namespace clang::mrdocs {
 
@@ -256,28 +257,20 @@ struct std::hash<::clang::mrdocs::Error>
     }
 };
 
-template<>
-struct fmt::formatter<clang::mrdocs::Error>
-    : fmt::formatter<std::string_view>
-{
-    auto format(
-        clang::mrdocs::Error const& err,
-        fmt::format_context& ctx) const
-    {
-        return fmt::formatter<std::string_view>::format(err.message(), ctx);
-    }
+template <>
+struct std::formatter<clang::mrdocs::Error> : std::formatter<std::string_view> {
+  template <class FmtContext>
+  auto format(clang::mrdocs::Error const &err, FmtContext &ctx) const {
+    return std::formatter<std::string_view>::format(err.message(), ctx);
+  }
 };
 
-template<>
-struct fmt::formatter<std::error_code>
-    : fmt::formatter<std::string_view>
-{
-    auto format(
-        std::error_code const& ec,
-        fmt::format_context& ctx) const
-    {
-        return fmt::formatter<std::string_view>::format(ec.message(), ctx);
-    }
+template <>
+struct std::formatter<std::error_code> : std::formatter<std::string_view> {
+  template <class FmtContext>
+  auto format(std::error_code const &ec, FmtContext &ctx) const {
+    return std::formatter<std::string_view>::format(ec.message(), ctx);
+  }
 };
 
 namespace clang::mrdocs {
@@ -353,9 +346,8 @@ formatError(
     Args&&... args)
 {
     std::string s;
-    fmt::vformat_to(
-        std::back_inserter(s),
-        fs.fs, fmt::make_format_args(args...));
+    std::vformat_to(std::back_inserter(s), fs.fs,
+                    std::make_format_args(args...));
     return Error(std::move(s), fs.loc);
 }
 

include/mrdocs/Support/Expected.hpp

@@ -12,19 +12,18 @@
 #ifndef MRDOCS_API_SUPPORT_EXPECTED_HPP
 #define MRDOCS_API_SUPPORT_EXPECTED_HPP
 
-#include <mrdocs/Platform.hpp>
-#include <mrdocs/Support/source_location.hpp>
-#include <mrdocs/Support/Error.hpp>
-#include <fmt/format.h>
 #include <exception>
+#include <functional>
 #include <iterator>
 #include <memory>
+#include <mrdocs/Platform.hpp>
+#include <mrdocs/Support/Error.hpp>
+#include <mrdocs/Support/source_location.hpp>
 #include <string>
 #include <string_view>
 #include <type_traits>
 #include <utility>
 #include <vector>
-#include <functional>
 
 namespace clang::mrdocs {