chore(rix): bump rix-io submodule to v1.0.0

Author: GaspardKirira

CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to **Rix (umbrella)** will be documented in this file.
+
+This project follows **Semantic Versioning** (SemVer).
+
+📘 **README**: https://github.com/rixcpp/rix/blob/v0.2.0/README.md
+
+---
+
+## [v0.2.0] — 2025-12-27
+
+### 🔄 Changed
+
+- Updated `modules/rix-io` submodule to **v1.0.0** (first stable release of rix-io).
+  - Stabilized IO API (File/Buffer/reader/writer/util)
+  - Adopted collision-free naming conventions (STL-safe)
+  - Added/updated canonical examples and aligned tests
+
+### 📦 Submodules
+
+- `rix-io`: v1.0.0
+
+---
+
+## [v0.1.2] — (previous)
+
+## [v0.1.1] — (previous)
+
+## [v0.1.0] — (previous)

examples/rix-io/append_text.cpp

@@ -0,0 +1,44 @@
+#include <exception>
+#include <filesystem>
+#include <iostream>
+#include <string>
+
+#include "rix/io/reader.hpp"
+#include "rix/io/util.hpp"
+#include "rix/io/writer.hpp"
+
+using namespace rix::io;
+
+static int run_example()
+{
+    const auto path = temp_path("rix_io_append");
+
+    std::cout << "[rix-io] File: " << path << "\n";
+
+    write_file_text(path, "Line A\n", WriteMode::append);
+    write_file_text(path, "Line B\n", WriteMode::append);
+    write_file_text(path, "Line C\n", WriteMode::append);
+
+    const auto loaded = read_file_text(path);
+
+    std::cout << "[rix-io] Loaded:\n";
+    std::cout << "----------------\n";
+    std::cout << loaded;
+
+    std::error_code ec;
+    std::filesystem::remove(path, ec);
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/binary_read_write.cpp

@@ -0,0 +1,59 @@
+#include <cassert>
+#include <cstddef>
+#include <exception>
+#include <filesystem>
+#include <iostream>
+#include <span>
+#include <vector>
+
+#include "rix/io/reader.hpp"
+#include "rix/io/util.hpp"
+#include "rix/io/writer.hpp"
+
+using namespace rix::io;
+
+static std::vector<std::byte> make_bytes()
+{
+    std::vector<std::byte> out;
+    out.reserve(16);
+
+    for (int i = 0; i < 16; ++i)
+        out.push_back(static_cast<std::byte>(i));
+
+    return out;
+}
+
+static int run_example()
+{
+    const auto path = temp_path("rix_io_bin");
+
+    std::cout << "[rix-io] Binary file: " << path << "\n";
+
+    const auto bytes = make_bytes();
+    write_file_binary(path, std::span<const std::byte>(bytes.data(), bytes.size()));
+
+    const auto loaded = read_file_binary(path);
+
+    assert(loaded.size() == bytes.size());
+    for (std::size_t i = 0; i < bytes.size(); ++i)
+        assert(loaded[i] == bytes[i]);
+
+    std::cout << "[rix-io] OK: read_file_binary == written bytes (" << loaded.size() << " bytes)\n";
+
+    std::error_code ec;
+    std::filesystem::remove(path, ec);
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/buffer_text_roundtrip.cpp

@@ -0,0 +1,37 @@
+#include <cassert>
+#include <exception>
+#include <iostream>
+#include <string>
+
+#include "rix/io/buffer.hpp"
+
+using namespace rix::io;
+
+static int run_example()
+{
+    const std::string text = "Hello from rix::io::Buffer ✅\nLine2\n";
+
+    Buffer buf(text);
+    assert(buf.size() == text.size());
+    assert(!buf.empty());
+
+    const std::string out = buf.to_string();
+    assert(out == text);
+
+    std::cout << "[rix-io] Buffer roundtrip OK\n";
+    std::cout << out;
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/file_copy.cpp

@@ -0,0 +1,53 @@
+#include <cassert>
+#include <filesystem>
+#include <iostream>
+#include <span>
+#include <string>
+#include <vector>
+
+#include "rix/io/reader.hpp"
+#include "rix/io/util.hpp"
+#include "rix/io/writer.hpp"
+
+using namespace rix::io;
+
+static int run_example()
+{
+    const auto src = temp_path("rix_io_copy_src");
+    const auto dst = temp_path("rix_io_copy_dst");
+
+    std::cout << "[rix-io] src: " << src << "\n";
+    std::cout << "[rix-io] dst: " << dst << "\n";
+
+    const std::string content =
+        "Rix IO copy example\n"
+        "This file will be copied as bytes.\n";
+
+    write_file_text(src, content);
+
+    const std::vector<std::byte> bytes = read_file_binary(src);
+    write_file_binary(dst, std::span<const std::byte>(bytes.data(), bytes.size()));
+
+    const auto out = read_file_text(dst);
+    assert(out == content);
+
+    std::cout << "[rix-io] Copy OK\n";
+
+    std::error_code ec;
+    std::filesystem::remove(src, ec);
+    std::filesystem::remove(dst, ec);
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/read_write.cpp

@@ -0,0 +1,48 @@
+#include <filesystem>
+#include <iostream>
+#include <string>
+
+#include "rix/io/reader.hpp"
+#include "rix/io/util.hpp"
+#include "rix/io/writer.hpp"
+
+using namespace rix::io;
+
+static int run_example()
+{
+    const auto path = temp_path("rix_io_example");
+
+    std::cout << "[rix-io] Example file: " << path << "\n";
+
+    const std::string content =
+        "Rix IO example\n"
+        "--------------\n"
+        "This file was created by rix::io.\n";
+
+    write_file_text(path, content);
+
+    const auto loaded = read_file_text(path);
+
+    std::cout << "[rix-io] Loaded content:\n";
+    std::cout << "------------------------\n";
+    std::cout << loaded << "\n";
+
+    // cleanup best-effort
+    std::error_code ec;
+    std::filesystem::remove(path, ec);
+
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/try_read_missing.cpp

@@ -0,0 +1,39 @@
+#include <filesystem>
+#include <iostream>
+
+#include "rix/io/reader.hpp"
+
+using namespace rix::io;
+
+static int run_example()
+{
+    const std::filesystem::path missing =
+        "/tmp/rix_io_this_file_should_not_exist_123456789.txt";
+
+    const auto txt = try_read_file_text(missing);
+    if (!txt)
+        std::cout << "[rix-io] try_read_file_text: OK (nullopt for missing file)\n";
+    else
+        std::cout << "[rix-io] Unexpected: file exists?\n";
+
+    const auto bin = try_read_file_binary(missing);
+    if (!bin)
+        std::cout << "[rix-io] try_read_file_binary: OK (nullopt for missing file)\n";
+    else
+        std::cout << "[rix-io] Unexpected: file exists?\n";
+
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}

examples/rix-io/util_exists_and_size.cpp

@@ -0,0 +1,35 @@
+#include <filesystem>
+#include <iostream>
+
+#include "rix/io/util.hpp"
+#include "rix/io/writer.hpp"
+
+static int run_example()
+{
+    const auto path = rix::io::temp_path("rix_io_size");
+
+    std::cout << "[rix-io] Path: " << path << "\n";
+    std::cout << "[rix-io] exists(before) = " << (rix::io::path_exists(path) ? "true" : "false") << "\n";
+
+    rix::io::write_file_text(path, "1234567890\n");
+
+    std::cout << "[rix-io] exists(after)  = " << (rix::io::path_exists(path) ? "true" : "false") << "\n";
+    std::cout << "[rix-io] path_size      = " << rix::io::path_size(path) << " bytes\n";
+
+    std::error_code ec;
+    std::filesystem::remove(path, ec);
+    return 0;
+}
+
+int main()
+{
+    try
+    {
+        return run_example();
+    }
+    catch (const std::exception &ex)
+    {
+        std::cerr << "[rix-io] Example failed: " << ex.what() << "\n";
+        return 1;
+    }
+}