View on Asset Store (opens in new tab)
Package details
- Latest version
- 1.0.1
- Last updated
- First released
- Unity version
- 2022.3.62 or later
- Package size
- 7.0 MB
- Files
- 49
- Views in the past week
- 4
Price tracking
- Last checked
- Tracked since
- Lowest recorded
- $7.50 on
Keywords
Canley CSV-Standard
Including CSV Lite, Canley CSV Standard can take your CSV data and get it onto your hierarchy with ease. It offers RFC 4180-compliant parsing and automatic matching of your data to your classes.
Affiliate link · Purchases support this site
Price history
Last 6 months
USDAsset preview
1 / 7
Canley CSV-Standard screenshot 1
About this asset
CSV Standard: Automated Object Hydration
Takes your data and gets it into your hierarchy
Canley CSV Standard builds upon the Lite core by adding a sophisticated "Hydration Engine" that eliminates manual data entry.
- One-Line Table Population: Use Load() to automatically ingest an entire CSV file, instantly matching headers to C# fields and hydrating a full list of objects.
- Smart Type Orchestration: Native support for all C# Scalars (strings, decimals, primitives), Enums, and Bools.
- Unity Spatial Structs: Automatically hydrates complex Unity types including Vector2, Vector3, Color, and Quaternions (supporting both Euler and raw formats).
- Custom Extensibility: Includes OnImport and OnExport hooks to intercept any custom string format and hydrate your objects exactly how you need them.
Includes CSV Lite: The Performance Foundation
Lite is designed for developers who need a reliable, high-speed reader and writer without the overhead of complex class mapping.
- RFC 4180 Compliance: Handles complex CSV features like fields containing commas, double-quotes, or literal newlines without corruption.
- Zero-Allocation Access: Optimized for sub-millisecond parsing with minimal garbage collection pressure.
- Engineered Stability: Uses a character-based state machine and an automatic BOM (Byte Order Mark) stripper to fix common Excel export issues.
From the publisher's Asset Store listing.
Technical details
Canley CSV Standard includes CSV Lite
Canley CSV Standard: Technical Specifications
The orchestration layer. Includes all Lite features plus the automated Hydration Pipeline.
- Architecture: ScriptableObject-driven database using a dual-table architecture (Master Data in Resources vs. Dynamic User Data in Persistent Data).
- Orchestration: CSVTable<T> manages the data lifecycle, providing a structured List<T> of programmable objects instead of a raw string grid.
- GetRecord() / GetRecords(): Database-style querying using IDs, Labels, or Predicate Lambda filters (e.g., r => r.health > 10).Primary Public Methods:
Load() / LoadPolymorphic(): The primary entry point. One-line command to locate files, clear memory, and populate the table.
SaveTable(): Smart serialization that merges live game data with the Shadow Dictionary to prevent data loss. - Regional Normalization: Smart parsing that detects and converts regional decimal separators (e.g., converting "1,5" to "1.5") for global compatibility.Advanced Unity Type Support:
Native Mapping: Automatically translates CSV strings into Vector2/3, Color (Hex), Enums, Booleans, and Quaternions (Euler or Raw modes). - Hardened Type Gate: Validation modes (Silent, Warn, Fail) that ensure data integrity during the hydration process.Data Integrity:
Shadow Dictionary: A private rawValues dictionary in every CSVRecord that preserves 100% of source data, including columns not defined in your C# class. - Intervention Hooks: OnImport and OnExport virtual methods for custom asset bridging (e.g., hydrating Sprites from a filename).
- UI Automation: Built-in SpawnUI method that uses the ICSVDisplayable<T> interface to instantly instantiate and populate prefabs from your data.
Canley CSV Lite: Technical Specifications
The high-performance core. Optimized for speed, memory efficiency, and data integrity.
- Engine: Character-based State Machine (Non-allocating parser).
- Compliance: Full RFC 4180 support (Handles escaped commas, quotes, and multiline cells).
- Performance: Sub-millisecond parsing; zero-allocation data access paths.
- File I/O: Supports Resources, StreamingAssets, and Persistent Data paths.
- Reliability: Automatic BOM (Byte Order Mark) stripping and structural column validation.
- Compatibility: Unity 2022.3+ (including Unity 6), all platforms (PC, Mobile, WebGL).
Compatibility
| Unity version | Built-in | URP | HDRP |
|---|---|---|---|
| 2022.3.62f3 | Compatible | Compatible | Not listed |
Pipeline & Unity 6 Ready
Fully compatible with Built-in, URP, and HDRP. This is a pure C# utility with zero rendering dependencies, making the core logic completely UI-agnostic.
- Unity 6 Verified: Follows modern SRP standards with clean Assembly Definition isolation.
- Demo Scenes: Built for Built-in & URP, utilizing TextMesh Pro for crisp, multi-pipeline visual consistency.
As listed on the Asset Store.