object_path 0.0.1-dev.1

Access and manipulate deep properties and any intermediaries using list notation ['a','b',c'] OR dot notation "a.b.c".

object_path

Create nested values and any intermediaries using list notation ['a','b',c'] OR dot notation "a.b.c".

Still in development, will be ready very soon (1 week max)

This is a Dart copy of the js projects set-value by Jon Schlinkert and object-path by Mario Casciaro. Please consider following either (or all) projects and giving some stars ⭐ to show your ❤️ and support. Also, feel free to make pull requests, open issues, or just let me know if I've messed up. The goal is to keep this project functionality in-line with the originals as far as possible. Bear in mind that some functionality is slightly different to accommodate for the typed nature of Dart, as well as my personal preference (if you want anything changed...my arm can be twisted).

Lastly, please consider following the project author Ferdinand Steenkamp.

Install

Install with pub.dev, add this to your pubspec.yaml:

dependencies:
    object_path:

Then run flutter pub get.

Usage

Import the package:

import 'package:object_path/object_path.dart';

Note: I made strong distinctions between list and dot-notation to prevent confusion.

Using dot notation:

void main() {
    
    var mock = <String, dynamic>{}
    var objPath = ObjectPath();
    
    // set a value in a map
    mock = objPath.setDot(mock, 'a.b.c', 'Value', splitAt = '.', escapeWith = '\\');
    
    // unset value in a map
    mock = objPath.unsetDot(mock, 'a.b.c');
    
    // get value in a map, returns null if it doesn't exists
    print(objPath.getDot(mock, 'a.b.c'));

    // escape split character
    mock = objPath.setDot(mock, 'a.b.c\\.d', 'Value');
}

Notes:

Escaping: You can escape a split character using \\, alternatively, you can add your own escape character using the optional escapeWith option.

Dot Notation: The dot notation obviously uses...dots. Alternatively, you can add your own dot character using the optional splitAt option.

Using List<String> method:

void main() {
    
    var mock = <String, dynamic>{}
    var objPath = ObjectPath();
    
    // set a value in a map
    mock = objPath.set(mock, ['a', 'b', 'c'], 'Value');
    
    // unset value in a map
    mock = objPath.unset(mock, ['a', 'b', 'c']);
    
    //get value in a map, returns null if it doesn't exists
    print(objPath.get(mock, ['a','b','c']));
}

About

Pull requests and issues always welcome. There is a lot more information on this project at the original set-value.

Author

Ferdinand Steenkamp

• Website
• GitHub Profile
• Twitter Profile
• LinkedIn Profile

License

Copyright © 2020, Ferdinand Steenkamp. Released under the BSD License.