NebulaJ 1.0.0

NebulaJ / NebulaStorage

NebulaStorage is a lightweight JSON storage library for .NET that allows you to store structured data in a simple and flexible way. It supports automatic increment of test counts, metadata, and integration with system information (hardware, IP, OS).

Features

• Store structured data like a mini SQL in JSON.
• Auto-increment a TestsCount field.
• Easily add metadata, arrays, objects, and custom fields.
• Integrates with system information:
  • Hardware (RAM, Storage)
  • IP Address
  • Operating System (OS) info
• Save JSON files locally or to a custom directory.++

Installation

Install the package via NuGet:

dotnet add package NebulaJ

Or include the NebulaStorage.cs file in your project manually.

Usage Example

using System;
using NebulaJ.JSON;

class Program
{
    static void Main()
    {
        // Create a new NebulaStorage instance
        // "Local" means the JSON will be saved in the same folder as Program.cs
        // "Nebula System Report" is the title of the JSON
        new NebulaStorage(ls =>
        {
            // Enable automatic increment for TestsCount
            ls.SetAutoIncrement(true)
              // Add package name
              .Package("NebulaJ")
              // Add version number
              .Version("2.0.0")
              // Add author name
              .Author("You")
              // Include hardware info (RAM and Storage)
              .IncludeHardwareInfo()
              // Include IP address info
              .IncludeIPInfo()
              // Include operating system info
              .IncludeOSInfo()
              // Add a description for this record
              .Description("Next-gen data + system integration JSON library")
              // Add tags for categorization
              .Tags("json", "nebula", "system");
        }, "Local", "Nebula System Report");
    }
}

JSON Output Example

After running the above code, NebulaLocalStorage.json will be generated in the same folder:

{
  "Title": "Nebula System Report",
  "Meta": {
    "AutoIncrementTests": true
  },
  "Records": [
    {
      "TestsCount": 1,
      "Title": "Nebula System Report",
      "Package": "NebulaJ",
      "Version": "2.0.0",
      "Author": "XYZ",
      "Hardware": {
        "RAM": "16384 MB",
        "Storage": "C:\ - Free: 102400 MB"
      },
      "IPInfo": {
        "Address": "192.168.0.10"
      },
      "OSInfo": {
        "System": "Microsoft Windows NT 10.0.22631.0",
        "Architecture": "x64",
        "AppDataPath": "C:\Users\XYZ\AppData\Roaming",
        "Desktop": "C:\Users\XYZ\Desktop"
      },
      "Description": "Next-gen data + system integration JSON library",
      "Tags": ["json", "nebula", "system"]
    }
  ]
}

Methods Overview

• SetAutoIncrement(bool) → Automatically increments TestsCount.
• Package(string), Version(string), Author(string), Description(string) → Add basic fields.
• IncludeHardwareInfo(), IncludeIPInfo(), IncludeOSInfo() → Automatically include system info.
• Tags(params string[]) → Add tags.
• Meta(string, object) → Add custom metadata.
• Add(string, object), AddArray(string, params object[]), AddObject(string, Dictionary<string, object>) → Add custom fields or objects.
• GetAll() → Returns all records.
• Last() → Returns the last record.

This library allows seamless integration of system information directly into structured JSON files for your .NET applications. It is ideal for logging, configuration, or system diagnostics.

Suports .NET 9.0 > .NET 7.0