helper: created Fds class and its test. Moved timespec test.

Author: YoSTEALTH

README.md

@@ -1,4 +1,8 @@
-# Liburing (Work in Process...) [![Python](https://img.shields.io/badge/python-3.10--3.14-blue)](https://www.python.org/) [![Zig](https://img.shields.io/badge/zig-0.15.2-orange)](https://ziglang.org/) [![PyPI - Downloads](https://img.shields.io/pypi/dm/liburing)] [![Test status](https://github.com/YoSTEALTH/Liburing/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/YoSTEALTH/Liburing/actions/workflows/test.yml) 
+# Liburing
+[![Python](https://img.shields.io/badge/python-3.10--3.14-blue)](https://www.python.org/)
+[![Zig](https://img.shields.io/badge/zig-0.15.2-orange)](https://ziglang.org/)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/liburing)
+[![Test status](https://github.com/YoSTEALTH/Liburing/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/YoSTEALTH/Liburing/actions/workflows/test.yml) 
 
 Liburing is Python + Zig wrapper around [C Liburing](https://github.com/axboe/Liburing), which is a helper to setup and tear-down io_uring instances.
 
@@ -29,23 +33,17 @@ python3 -m pip uninstall liburing           # uninstall
 ## To compile & install directly from GitHub
 
 ```bash
-# Note:
-#   - Make sure you have Zig 0.15.2 installed on your system.
-#   - Change bellow code to your Python setup.
-
-python3 -m pip install --upgrade pyoz
+# note: make sure you have Zig 0.15.2 installed on your system.
 
 cd /tmp
-
 git clone --recurse-submodules https://github.com/YoSTEALTH/Liburing
-
 cd Liburing
 
+python3 -m pip install pyoz
 python3 -m pyoz build
-
 python3 -m pip install dist/*.whl
 
-# To Uninstall
+# uninstall
 python3 -m pip uninstall liburing pyoz
 ```
 
@@ -156,8 +154,8 @@ if __name__ == '__main__':
  - This project has been moved to using Zig as back-end, thus leading to breaking changes from previous release.
  - Try using latest Linux if possible to enable all `io_uring` features.
 
-## Other Project
-<!-- - [Shakti](https://github.com/YoSTEALTH/Shakti) -->
+## Other Projects
+- [Shakti](https://github.com/YoSTEALTH/Shakti)
 - [PyOZ](https://pyoz.dev/)
 
 ## License

build.zig.zon

@@ -1,6 +1,6 @@
 .{
     .name = .liburing,
-    .version = "2026.3.7",
+    .version = "2026.3.8",
     .fingerprint = 0x26de882ff0030dfe,
     .dependencies = .{
         .PyOZ = .{

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pyoz.backend"
 name = "liburing"
 readme = "README.md"
 license = "CC0-1.0"
-version = "2026.3.7"
+version = "2026.3.8"
 authors = [{name="Ritesh"}]
 keywords = ["python", "socket", "async", "cython", "file", "python3", "io", "syscall", "futex", "statx",
             "io-uring", "uring", "liburing"]
@@ -53,7 +53,7 @@ module-name = "liburing"
 py-packages = ["liburing"]
 
 # Optimization level for release builds: "Debug", "ReleaseSafe", "ReleaseFast", "ReleaseSmall"
-optimize = "ReleaseSafe"
+optimize = "Debug"
 
 # Strip debug symbols in release builds
 # strip = true

src/liburing/__init__.py

@@ -2,4 +2,4 @@
 from .version import *  # noqa
 
 
-__version__ = "2026.3.7"
+__version__ = "2026.3.8"

src/liburing/class.zig

@@ -320,15 +320,15 @@ pub const SQE = extern struct {
 ///    >>> sqe[1].user_data = 2
 ///
 ///    # *** MUST DO ***
-///    >>> if io_uring_put_sqe(ring, sqe):
+///    >>> if put_sqe(ring, sqe):
 ///    ...     io_uring_submit(ring)
 ///
 ///Note
 ///    - This class has dual usage:
 ///        1. It works as a base class for `io_uring_get_sqe()` return.
 ///        2. It can also be used as `sqe = Sqe(<int>)`, rather than "get" sqe(s)
 ///        you are going to "put" pre-made sqe(s) into the ring later. Refer to
-///        `help(io_uring_put_sqe)` to see more detail.
+///        `help(put_sqe)` to see more detail.
 ///    - `Sqe(no)` is limited to max `0-255` items.
 pub const Sqe = extern struct {
     _parent: SQE,

src/liburing/helper.zig

@@ -6,6 +6,56 @@ const std = @import("std");
 
 const Timespec = @import("class.zig").Timespec;
 
+/// File Descriptors Holder
+///
+///Example
+///    >>> fds = liburing.Fds([-1, -1, 3])
+///    >>> fds[1]
+///    -1
+///    >>> fds.update([4, 5, 6])
+///    >>> fds[1]
+///    5
+///
+///Note
+///    - Makes copy of the list provided.
+pub const Fds = extern struct {
+    _fds: [*]i32,
+    _len: usize,
+
+    const Self = @This();
+
+    pub fn __new__(list: oz.ListView(i32)) !Self {
+        const _len = list.len();
+        var fds = try std.heap.c_allocator.alloc(i32, _len);
+        for (0.._len) |i| {
+            if (list.get(i)) |fd| {
+                fds[i] = fd;
+            } else return error.TypeError;
+        }
+        return .{ ._fds = @ptrCast(fds), ._len = _len };
+    }
+
+    pub fn __getitem__(self: *const Self, index: usize) !i32 {
+        if (index < self._len) return self._fds[index];
+        return error.IndexError;
+    }
+
+    pub fn update(self: *Self, list: oz.ListView(i32)) !void {
+        const _len = list.len();
+        if (self._len != _len) return error.ValueError;
+
+        for (0.._len) |i| {
+            if (list.get(i)) |fd| {
+                self._fds[i] = fd;
+            } else return error.ValueError;
+        }
+    }
+
+    pub fn __del__(self: *Self) void {
+        std.heap.c_allocator.free(self._fds[0..self._len]);
+    }
+};
+
 ///Probe your system to find out which `io_uring` operations are available.
 ///
 ///Example

test/time_test.py test/helper_test.pytest/time_test.py renamed to test/helper_test.py

@@ -1,7 +1,22 @@
-from pytest import raises
+import pytest
 import liburing
 
 
+def test_fds():
+    fds = liburing.Fds([-1, -1, 3])
+    assert fds[1] == -1
+    fds.update([4, 5, 6])
+    assert fds[1] == 5
+
+    # error
+    pytest.skip("PyOZ bug.")
+    with pytest.raises(ValueError):
+        fds.update([4, 5, 6, 7, 8, 9])  # PyOZ raises `RuntimeError: ValueError`
+
+    with pytest.raises(TypeError):  # PyOZ raises `RuntimeError: TypeError`
+        fds.update([4, 5, "s"])
+
+
 def test_timespec():
     ts = liburing.timespec(1)
     assert ts.sec == 1
@@ -23,6 +38,6 @@ def test_timespec():
     assert ts.sec == 1
     assert ts.nsec == 500_000
 
-    with raises(MemoryError):
+    with pytest.raises(MemoryError):
         ts = liburing.Timespec()
         assert ts.sec == 123