The base commit

Author: habedi

.editorconfig

@@ -1,32 +1,25 @@
-# Top-most EditorConfig file
 root = true
 
-# Global settings (applicable to all files unless overridden)
 [*]
-charset = utf-8 # Default character encoding
-end_of_line = lf # Use LF for line endings (Unix-style)
-indent_style = space # Use spaces for indentation
-indent_size = 4 # Default indentation size
-insert_final_newline = true # Make sure files end with a newline
-trim_trailing_whitespace = true # Remove trailing whitespace
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true
 
-# Zig files
 [*.zig]
 max_line_length = 100
 
-# Markdown files
 [*.md]
 max_line_length = 120
-trim_trailing_whitespace = false # Don't remove trailing whitespace in Markdown files
+trim_trailing_whitespace = false
 
-# Bash scripts
 [*.sh]
 indent_size = 2
 
-# YAML files
 [*.{yml,yaml}]
 indent_size = 2
 
-# Python files
 [*.py]
 max_line_length = 100

.github/workflows/docs.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Install Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: '0.14.1'
+          version: '0.15.1'
 
       - name: Install System Dependencies
         run: |

.github/workflows/lints.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Install Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: '0.14.1'
+          version: '0.15.1'
 
       - name: Install Dependencies
         run: |

.github/workflows/tests.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Install Zig
         uses: goto-bus-stop/setup-zig@v2
         with:
-          version: '0.14.1'
+          version: '0.15.1'
 
       - name: Install Dependencies
         run: |

.pre-commit-config.yaml

@@ -22,21 +22,21 @@ repos:
   - repo: local
     hooks:
       - id: format
-        name: Format the code
+        name: Format Code
         entry: make format
         language: system
         pass_filenames: false
         stages: [ pre-commit ]
 
       - id: lint
-        name: Check code style
+        name: Check Code Style
         entry: make lint
         language: system
         pass_filenames: false
         stages: [ pre-commit ]
 
       - id: test
-        name: Run the tests
+        name: Run Test
         entry: make test
         language: system
         pass_filenames: false

CODE_OF_CONDUCT.md

@@ -1,3 +1,3 @@
-# Code of Conduct
+## Code of Conduct
 
 We adhere to the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) version 2.1.

CONTRIBUTING.md

@@ -1,34 +1,34 @@
-# Contribution Guidelines
+## Contribution Guidelines
 
 Thank you for considering contributing to this project!
 Contributions are always welcome and appreciated.
 
-## How to Contribute
+### How to Contribute
 
-Please check the [issue tracker](https://github.com/habedi/ordered/issues) to see if there is an issue you
+Please check the [issue tracker](https://github.com/CogitatorTech/ordered/issues) to see if there is an issue you
 would like to work on or if it has already been resolved.
 
-### Reporting Bugs
+#### Reporting Bugs
 
-1. Open an issue on the [issue tracker](https://github.com/habedi/ordered/issues).
+1. Open an issue on the [issue tracker](https://github.com/CogitatorTech/ordered/issues).
 2. Include information such as steps to reproduce the observed behavior and relevant logs or screenshots.
 
-### Suggesting Features
+#### Suggesting Features
 
-1. Open an issue on the [issue tracker](https://github.com/habedi/ordered/issues).
+1. Open an issue on the [issue tracker](https://github.com/CogitatorTech/ordered/issues).
 2. Provide details about the feature, its purpose, and potential implementation ideas.
 
-## Submitting Pull Requests
+### Submitting Pull Requests
 
 - Ensure all tests pass before submitting a pull request.
 - Write a clear description of the changes you made and the reasons behind them.
 
 > [!IMPORTANT]
 > It's assumed that by submitting a pull request, you agree to license your contributions under the project's license.
 
-## Development Workflow
+### Development Workflow
 
-### Prerequisites
+#### Prerequisites
 
 Install GNU Make on your system if it's not already installed.
 
@@ -39,22 +39,22 @@ sudo apt-get install make
 
 - Use the `make install-deps` command to install the development dependencies.
 
-### Code Style
+#### Code Style
 
 - Use the `make format` command to format the code.
 
-### Running Tests
+#### Running Tests
 
 - Use the `make test` command to run the tests.
 
-### Running Linters
+#### Running Linters
 
 - Use the `make lint` command to run the linters.
 
-### See Available Commands
+#### See Available Commands
 
 - Run `make help` to see all available commands for managing different tasks.
 
-## Code of Conduct
+### Code of Conduct
 
-We adhere to the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) version 2.1.
+We adhere to the project's [Code of Conduct](CODE_OF_CONDUCT.md).

Makefile

@@ -1,12 +1,13 @@
 # ################################################################################
 # # Configuration and Variables
 # ################################################################################
-ZIG    ?= $(shell which zig || echo ~/.local/share/zig/0.14.1/zig)
+ZIG    ?= $(shell which zig || echo ~/.local/share/zig/0.15.1/zig)
 BUILD_TYPE    ?= Debug
 BUILD_OPTS      = -Doptimize=$(BUILD_TYPE)
 JOBS          ?= $(shell nproc || echo 2)
 SRC_DIR       := src
 EXAMPLES_DIR  := examples
+BENCHMARKS_DIR:= benches
 BUILD_DIR     := zig-out
 CACHE_DIR     := .zig-cache
 BINARY_NAME   := example
@@ -18,14 +19,18 @@ JUNK_FILES := *.o *.obj *.dSYM *.dll *.so *.dylib *.a *.lib *.pdb temp/
 EXAMPLES      := $(patsubst %.zig,%,$(notdir $(wildcard examples/*.zig)))
 EXAMPLE       ?= all
 
+# Automatically find all benchmark names
+BENCHMARKS    := $(patsubst %.zig,%,$(notdir $(wildcard benches/*.zig)))
+BENCHMARK ?= all
+
 SHELL         := /usr/bin/env bash
 .SHELLFLAGS   := -eu -o pipefail -c
 
 ################################################################################
 # Targets
 ################################################################################
 
-.PHONY: all help build rebuild run test release clean lint format docs serve-docs install-deps setup-hooks test-hooks
+.PHONY: all help build rebuild run bench test release clean lint format docs serve-docs install-deps setup-hooks test-hooks
 .DEFAULT_GOAL := help
 
 help: ## Show the help messages for all targets
@@ -43,7 +48,7 @@ build: ## Build project (e.g. 'make build BUILD_TYPE=ReleaseSmall' or 'make buil
 
 rebuild: clean build  ## clean and build
 
-run: ## Run an example (e.g. 'make run EXAMPLE=sorted_set' or 'make run' to run all examples)
+run: ## Run an example (like 'make run EXAMPLE=e1_btree_map' or 'make run' to run all examples)
 	@if [ "$(EXAMPLE)" = "all" ]; then \
 	   echo "--> Running all examples..."; \
 	   for ex in $(EXAMPLES); do \
@@ -56,6 +61,19 @@ run: ## Run an example (e.g. 'make run EXAMPLE=sorted_set' or 'make run' to run
 	   $(ZIG) build run-$(EXAMPLE) $(BUILD_OPTS); \
 	fi
 
+bench: ## Run a benchmark (like 'make bench BENCHMARK=b1_btree_map' or 'make run' to run all benchmarks)
+	@if [ "$(BENCHMARK)" = "all" ]; then \
+	   echo "--> Running all benchmarks..."; \
+	   for ex in $(BENCHMARKS); do \
+		  echo ""; \
+		  echo "--> Running '$$ex'"; \
+		  $(ZIG) build bench-$$ex $(BUILD_OPTS); \
+	   done; \
+	else \
+	   echo "--> Running benchmark: $(BENCHMARK)"; \
+	   $(ZIG) build bench-$(BENCHMARK) $(BUILD_OPTS); \
+	fi
+
 test: ## Run tests
 	@echo "Running tests..."
 	@$(ZIG) build test $(BUILD_OPTS) -j$(JOBS) $(TEST_FLAGS)

README.md

@@ -6,34 +6,50 @@
 
 <h2>Ordered</h2>
 
-[![Tests](https://img.shields.io/github/actions/workflow/status/habedi/ordered/tests.yml?label=tests&style=flat&labelColor=282c34&logo=github)](https://github.com/habedi/ordered/actions/workflows/tests.yml)
-[![CodeFactor](https://img.shields.io/codefactor/grade/github/habedi/ordered?label=code%20quality&style=flat&labelColor=282c34&logo=codefactor)](https://www.codefactor.io/repository/github/habedi/ordered)
-[![Zig Version](https://img.shields.io/badge/Zig-0.14.1-orange?logo=zig&labelColor=282c34)](https://ziglang.org/download/)
-[![Docs](https://img.shields.io/github/v/tag/habedi/ordered?label=docs&color=blue&style=flat&labelColor=282c34&logo=read-the-docs)](https://habedi.github.io/ordered/)
-[![Release](https://img.shields.io/github/release/habedi/ordered.svg?label=release&style=flat&labelColor=282c34&logo=github)](https://github.com/habedi/ordered/releases/latest)
-[![License](https://img.shields.io/badge/license-MIT-007ec6?label=license&style=flat&labelColor=282c34&logo=open-source-initiative)](https://github.com/habedi/ordered/blob/main/LICENSE)
+[![Tests](https://img.shields.io/github/actions/workflow/status/CogitatorTech/ordered/tests.yml?label=tests&style=flat&labelColor=282c34&logo=github)](https://github.com/CogitatorTech/ordered/actions/workflows/tests.yml)
+[![CodeFactor](https://img.shields.io/codefactor/grade/github/CogitatorTech/ordered?label=code%20quality&style=flat&labelColor=282c34&logo=codefactor)](https://www.codefactor.io/repository/github/CogitatorTech/ordered)
+[![Zig Version](https://img.shields.io/badge/Zig-0.15.1-orange?logo=zig&labelColor=282c34)](https://ziglang.org/download/)
+[![Docs](https://img.shields.io/badge/docs-view-blue?style=flat&labelColor=282c34&logo=read-the-docs)](https://CogitatorTech.github.io/ordered/)
+[![Examples](https://img.shields.io/badge/examples-view-green?style=flat&labelColor=282c34&logo=zig)](https://github.com/CogitatorTech/ordered/tree/main/examples)
+[![Release](https://img.shields.io/github/release/CogitatorTech/ordered.svg?label=release&style=flat&labelColor=282c34&logo=github)](https://github.com/CogitatorTech/ordered/releases/latest)
+[![License](https://img.shields.io/badge/license-MIT-007ec6?label=license&style=flat&labelColor=282c34&logo=open-source-initiative)](https://github.com/CogitatorTech/ordered/blob/main/LICENSE)
 
-A Zig library of common data structures that keep data in order
+A collection of data structures that keep data in order
 
 </div>
 
 ---
 
-Ordered Zig library includes implementations of popular data structures including B-tree, skip list, trie, and
-red-black tree.
+Ordered library includes fast and efficient implementations of popular data structures including
+B-tree, skip list, trie, and red-black tree for Zig programming language.
 
-### Features
+### Supported Data Structures
 
-- Implementations for common data structures that maintain the order of keys:
-    - [`BTreeMap`](src/btree_map.zig): A balanced tree map that maintains order of keys.
-    - [`OrderedSet`](src/sorted_set.zig): A set with ordered elements.
-    - [`SkipList`](src/skip_list.zig): A probabilistic data structure that allows fast search, insertion, and deletion.
-    - [`Trie`](src/trie.zig): A prefix tree for fast retrieval of keys with common prefixes.
-    - [`RedBlackTree`](src/red_black_tree.zig): A self-balancing binary search tree that maintains order of keys.
+Currently supported data structures include:
+
+- [B-tree](src/ordered/btree_map.zig): a balanced n-array tree that maintains the order of keys.
+- [Sorted set](src/ordered/sorted_set.zig): a set with ordered elements based on keys.
+- [Skip list](src/ordered/skip_list.zig): a probabilistic data structure that maintains sorted order using multiple linked lists.
+- [Trie](src/ordered/trie.zig): a prefix tree that supports efficient retrieval of keys with common prefixes.
+- [Red-black tree](src/ordered/red_black_tree.zig): A self-balancing binary search tree that maintains the order of keys
+- [Cartesian tree](src/ordered/cartesian_tree.zig): A binary tree that maintains both a binary search tree property on keys and a heap property on priorities.
+
+| # | Data Structure | Build Complexity | Memory Complexity | Search Complexity    |  
+|---|----------------|------------------|-------------------|----------------------|
+| 1 | B-tree         | $O(\log n)$      | $O(n)$            | $O(\log n)$          |  
+| 2 | Cartesian tree | $O(\log n)$\*    | $O(n)$            | $O(\log n)$\* |  
+| 3 | Red-black tree | $O(\log n)$      | $O(n)$            | $O(\log n)$          |  
+| 4 | Skip list      | $O(\log n)$\*    | $O(n)$            | $O(\log n)$\* |  
+| 5 | Sorted set     | $O(n)$           | $O(n)$            | $O(\log n)$          |
+| 6 | Trie           | $O(m)$           | $O(n \cdot m)$    | $O(m)$               |  
+
+- $n$: number of stored elements
+- $m$: maximum length of a key
+- \*: average case complexity
 
 > [!IMPORTANT]
-> Zig-DbC is in early development, so bugs and breaking API changes are expected.
-> Please use the [issues page](https://github.com/habedi/zig-dbc/issues) to report bugs or request features.
+> Ordered is in early development, so bugs and breaking API changes are expected.
+> Please use the [issues page](https://github.com/CogitatorTech/ordered/issues) to report bugs or request features.
 
 ---
 
@@ -45,15 +61,15 @@ To be added.
 
 ### Documentation
 
-You can find the API documentation for the latest release of Ordered [here](https://habedi.github.io/ordered/).
+You can find the API documentation for the latest release of Ordered [here](https://CogitatorTech.github.io/ordered/).
 
 Alternatively, you can use the `make docs` command to generate the documentation for the current version of Ordered.
 This will generate HTML documentation in the `docs/api` directory, which you can serve locally with `make serve-docs`
 and view in a web browser.
 
 ### Examples
 
-Check out the [examples](examples/) directory for example usages of Ordered.
+Check out the [examples](examples) directory for example usages of Ordered.
 
 ---
 
@@ -67,4 +83,4 @@ Ordered is licensed under the MIT License (see [LICENSE](LICENSE)).
 
 ### Acknowledgements
 
-* The logo is from [SVG Repo](https://www.svgrepo.com/svg/469537/zig-zag-left-right-arrow).
+* The logo is from [SVG Repo](https://www.svgrepo.com/svg/469537/zig-zag-left-right-arrow) with some modifications.