PupaLib.Data 0.1.1

<div align="center">

🗃️ PupaLib.Data

PupaLib.Data is a lightweight recursive key-value storage with path-based access. 🎯

<img src="https://github.com/Artpupser/PupaLib.Data/blob/main/assets/banner.jpg" style="border-radius: 20px; max-height: 500px">

</div>

📎 Navigation

• ✨ Features
• 🧵 Usage
• 🚀 Installation
• 📦 Dependencies
• 🗃️ Devlog
• ⚖️️ License

✨️ Features

<div align="center">

| 🏆 Feature | 📝 Description | | ----------------------- | ---------------------------------------------------------- | | Recursive Structure | Tree-like data storage with nested nodes (Childs) | | Path-based Access | Access data via dot-separated paths (player.stats.hp) | | Thread-safe | Built on ConcurrentDictionary | | Deep Operations | DeepSet, DeepGet, DeepExists* for nested access | | Auto Node Creation | Nodes are created automatically during deep set operations | | Type Safety Checks | Validate types with ExistsWithType<T> | | Debug Visualization | Built-in ToString() for readable tree output | </div>

🚀 Installation

You can install the package through the NuGet Package Manager or via the command line

dotnet add package PupaLib.Data

Or through the NuGet Package Manager

Install-Package PupaLib.Data

🧵 Usage

📌 Create instance

var data = new RecursionData();

📌 Set values

// Simple set
data.Set("score", 100);

// Deep set (auto-creates structure)
data.DeepSet("player.stats.hp", 250);
data.DeepSet("player.stats.mana", 75);

📌 Get values

int score = data.Get<int>("score");

int hp = data.DeepGet<int>("player.stats.hp");

📌 Check existence

bool exists = data.ExistsAny("score");

bool deepExists = data.DeepExistsAny("player.stats.hp");

bool typed = data.ExistsWithType<int>("score");

bool deepTyped = data.DeepExistsWithType<int>("player.stats.hp");

📌 Debug output

Console.WriteLine(data);

Example output:

[score] -> 100
    /player
        /stats
            [hp] -> 250
            [mana] -> 75

📌 Path separator

RecursionData.SeparateSymbol = '.';

Default separator is .

📦 Dependencies

None

🗃️ Devlog

0.1.0

• Initial implementation of RecursionData
• Path-based access using . separator
• Thread-safe storage via ConcurrentDictionary
• Core API: Set, Get, Exists, Deep*

⚖️ License

This project is licensed under the MIT License.