Clarify compat vs enhanced modes

[danielendler]

Summary

• expose a datason.json package that directly re-exports the stdlib module
• add save/save_string helpers and document breaking differences for enhanced loads
• document Compat vs Enhanced usage in new Two Modes guide and link from navigation

Testing

• pre-commit run --files README.md datason/__init__.py datason/api.py datason/json/__init__.py docs/api/modern-deserialization.md docs/api/modern-serialization.md docs/two-modes.md mkdocs.yml tests/unit/test_json_parity.py scripts/simple_json_check.py
• pytest tests/unit/test_json_parity.py tests/unit/test_api_json_replacement_coverage.py

---

https://chatgpt.com/codex/tasks/task_e_6895376b9eb48325bf6586df5cb09879

[danielendler]

🚀 DataSON PR Performance Analysis

PR #74 | Commit: c9362d82945ca72a5a4950bb2e72f9400696b0c7

📊 Benchmark Results

Suite: pr_optimized | Tests Run: 5 | Success Rate: 100.0%

🎯 DataSON Performance Summary

Metric	Result	Benchmark Details	Status
Serialization (avg)	1.141 ms	5 measurements across 5 scenarios	✅
Deserialization (avg)	0.000 ms	0 measurements	❌
Success Rate	100.0%	5 scenarios tested with 5 iterations each	✅
Performance Range	0.118 - 3.718 ms	Min to max serialization times	✅

📋 Test Scenarios

Scenario	Status	Serialization	Deserialization
Web Api Response	✅ Passed	1.444 ms	N/A
Ml Training Batch	✅ Passed	3.718 ms	N/A
Financial Transaction	✅ Passed	0.176 ms	N/A
Mixed Types Challenge	✅ Passed	0.247 ms	N/A
Security Pii Test	✅ Passed	0.118 ms	N/A

ℹ️ Baseline Status

No baseline available for comparison. Future PRs will compare against this baseline.

✅ Status: Ready for Review

All benchmarks passed! No significant performance regressions detected.

---

Generated by datason-benchmarks • Comprehensive Performance Analysis

[codecov]

Codecov Report

❌ Patch coverage is 75.00000% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
datason/api.py	50.00%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!