json_son 0.3.3

json_son: ^0.3.3 copied to clipboard

• Fixed documentation comments to properly escape angle brackets in type references

Enhanced JsonSon Class #

• Added error tracking with detailed path information for debugging and validation
• Implemented advanced constructors for different data sources:
  • fromApiResponse: Handle API responses that might be strings or maps
  • fromMapSafe: Safely create JsonSon instances with error handling
• Added batch operations for processing multiple keys or paths at once
• Implemented fallback keys to try multiple keys in sequence until a value is found
• Added transformation methods for mapping and merging JSON data
• Implemented validation methods for checking required keys and paths

Extensions #

• Created JsonSonMapExtension for direct access to JsonSon methods from Map objects
• Developed JsonSonApiExtension for common API patterns including:
  • Pagination information extraction
  • Error handling with code and message extraction
  • User information normalization
  • Timestamp handling

Validation Framework #

• Implemented JsonSonValidator with a fluent API for complex validation logic
• Added type validation for strings, integers, booleans, etc.
• Added format validation for emails, URLs, and custom patterns
• Implemented range validation for numeric values and string lengths
• Added support for custom validation rules
• Added nested validation for objects and array items

Testing #

• Added comprehensive test suite for all new features
• Created tests for extensions and the validation framework
• Ensured all tests pass with proper error handling

Documentation #

• Updated README with detailed examples and API documentation
• Added code examples for all new features
• Provided comprehensive API reference for all classes

• Added new class-based API with JsonSon class for more fluent and powerful JSON handling
• Added comprehensive example for the class-based approach
• Maintained full backward compatibility with the functional approach

• Added flexibleMapFromJson and flexibleMapNotNullFromJson functions for flexible map transformations

• Added comprehensive tests for flexibleListFromJson and flexibleListNotNullFromJson

• Added comprehensive tests for flexibleLowerStringFromJson and flexibleUpperStringFromJson

• Added comprehensive tests for flexibleTrimmedStringFromJson

• Added comprehensive tests for flexibleUriFromJson
• Fixed test expectations for flexibleUriFromJson to match actual behavior

• Added comprehensive tests for flexibleDateTimeFromJson

• Added comprehensive tests for flexibleNumFromJson

• Added comprehensive tests for flexibleStringFromJson

• Added comprehensive tests for flexibleBoolFromJson

• Added comprehensive tests for flexibleDoubleFromJson

• Added comprehensive tests for flexibleIntFromJson

• Ran dart format on the codebase
• Code formatting and documentation improvements across the codebase
• Removed unnecessary TODOs and improved code comments
• Enhanced code style consistency in method parameters and documentation

• Removed unused import.

• Renamed package to Just Straightens Out Nonsense (JSON) and to keep it short, made it json_son.

• Added flexibleUpperStringFromJson for converting strings to uppercase after trimming.

• Added flexibleLowerStringFromJson for converting strings to lowercase after trimming.

• Added flexibleTrimmedStringFromJson for trimming whitespace and converting empty strings to null.

• Added flexibleCommaSeparatedListFromJson for parsing comma-separated strings into List<String>?.

• Added flexibleListNotNullFromJson for guaranteeing a non-null list, even if the API returns null or a single item. Returns an empty list for null inputs.

• Added flexibleListFromJson for handling APIs that may return a single item instead of a list, or for parsing list items with a flexible item parser.

• Updated flexible JSON decoder functions:
  • flexibleNumFromJson
  • flexibleDateTimeFromJson
  • flexibleUriFromJson

• Initial release.
• Added flexible JSON decoder functions:
  • flexibleIntFromJson
  • flexibleDoubleFromJson
  • flexibleBoolFromJson
  • flexibleStringFromJson
  • Basic package setup including pubspec.yaml, README.md, and LICENSE.

• Initial version.