Jyson 1.1.19652

Jyson

Jyson is a Python-like JSON library for C#, making JSON parsing and manipulation as elegant and intuitive as Python while preserving the power of C# and LINQ.

Features

• Python-style API: Familiar methods like loads(), load(), dumps(), and dump()
• Dynamic access: Navigate JSON with dot notation (data.person.name instead of data["person"]["name"])
• Dictionary-like methods: Python-esque dictionary methods like Get() with default values
• LINQ integration: Convert JSON arrays to typed collections for powerful LINQ queries
• Deep nesting support: Handles complex nested JSON structures with ease
• Type conversion helpers: Safely convert between JSON types and C# types

Installation

Install via .NET CLI:

dotnet add package Jyson

Quick Start

using Archsoft.Json;

// Parse JSON string
string jsonString = @"{""name"":""John"",""age"":30,""hobbies"":[""reading"",""travel""]}";
dynamic data = Jyson.Loads(jsonString);

// Access properties with dot notation
Console.WriteLine($"Name: {data.name}");  // "John"
Console.WriteLine($"Age: {data.age}");    // 30

// Access arrays
foreach (var hobby in (List<object>)data.hobbies)
{
    Console.WriteLine($"Hobby: {hobby}");
}

// Dictionary-like methods
var dataDict = data as IDictionary<string, object>;
bool hasAddress = dataDict.Contains("address");               // false
string country = dataDict.Get("country", "USA").ToString();   // "USA" (default value)

// Create and serialize objects
var person = new { Name = "Jane", Age = 28 };
string json = Jyson.Dumps(person);
Jyson.Dump(person, "person.json");

LINQ Integration

string jsonString = @"{
    ""people"": [
        {""name"": ""Alice"", ""age"": 25, ""active"": true},
        {""name"": ""Bob"", ""age"": 32, ""active"": false},
        {""name"": ""Charlie"", ""age"": 28, ""active"": true}
    ]
}";

dynamic data = Jyson.Loads(jsonString);
var peopleArray = data.people as List<object>;

// Use LINQ with automatic type conversion
var activeUsers = peopleArray.AsEnumerable<dynamic>()
    .Where(p => p.active == true)
    .Select(p => p.name)
    .ToList();

// Using type-specific collections
var ages = peopleArray.AsEnumerable<dynamic>()
    .Select(p => (int)p.age)
    .ToList();
    
double averageAge = ages.Average();

Complex Nested JSON

Jyson handles deeply nested structures with ease:

string jsonString = @"{
    ""organization"": {
        ""name"": ""Acme Inc"",
        ""departments"": [
            {
                ""name"": ""Engineering"",
                ""teams"": [
                    {
                        ""name"": ""Backend"",
                        ""members"": [
                            {""name"": ""Alice"", ""role"": ""Developer""},
                            {""name"": ""Bob"", ""role"": ""Team Lead""}
                        ]
                    }
                ]
            }
        ]
    }
}";

dynamic data = Jyson.Loads(jsonString);

// Access deep nested properties with dot notation
string companyName = data.organization.name;
string teamName = data.organization.departments[0].teams[0].name;
string firstMemberRole = data.organization.departments[0].teams[0].members[0].role;

// LINQ query with nested data
var engineers = ((List<object>)data.organization.departments[0].teams[0].members)
    .AsEnumerable<dynamic>()
    .Where(m => m.role == "Developer")
    .Select(m => m.name)
    .ToList();

Dictionary Methods

// Get with default value (like Python's dict.get)
dynamic data = Jyson.Loads(@"{""user"":{""name"":""John""}}");
var userDict = data.user as IDictionary<string, object>;

string name = userDict.Get("name", "Unknown").ToString();     // "John"
string email = userDict.Get("email", "none@example.com").ToString(); // "none@example.com"

// Check if key exists (like Python's "key in dict")
bool hasName = userDict.Contains("name");      // true
bool hasAddress = userDict.Contains("address"); // false

Advanced Usage

Custom Type Conversion

// Convert JSON array to a typed list
dynamic data = Jyson.Loads(@"{""scores"":[95,87,92]}");
var scores = (data.scores as List<object>).AsList<int>();

// Convert a JSON object to a Dictionary
dynamic settings = Jyson.Loads(@"{""timeout"":30,""retries"":3}");
var settingsDict = (settings as IDictionary<string, object>).AsDictionary<int>();

File Operations

// Load from file
dynamic config = Jyson.Load("config.json");

// Save to file
var settings = new { ApiKey = "abc123", Timeout = 30 };
Jyson.Dump(settings, "settings.json", indent: true);

Compatibility

Jyson works with:

• .NET 7.0 or later