Falcor Path Utils

This repository contains utilities for transforming and manipulating Falcor paths.

Utility functions:

• collapse(paths) Simplifies a set of paths. Example:

  var util = require("falcor-path-utils");
  var collapsedPaths = util.collapse([
    ["genres", 0, "titles", 0, "name"],
    ["genres", 0, "titles", 0, "rating"],
    ["genres", 0, "titles", 1, "name"],
    ["genres", 0, "titles", 1, "rating"]
  ]);
  
  // collapsed paths is ["genres", 0, "titles", {from: 0, to: 1}, ["name", "rating"]]

• iterateKeySet(keySet, note) Takes in a keySet and a note and attempts to iterate over it.

• toTree(paths) Converts paths to a tree with null leaves. (see spec)

• toPaths(lengths) Converts a lengthTree to paths. (see spec)

• pathsComplementFromTree(paths, tree) Returns a list of these paths that are not in the tree. (see spec)

• pathsComplementFromLengthTree(paths, lengthTree) Like above, but for use with length tree.

• hasIntersection(tree, path, depth) Tests to see if the intersection should be stripped from the total paths.

• optimizePathSets(cache, paths, maxRefFollow) (see spec)

• pathCount(pathSet) Returns the number of paths in a PathSet.

  var util = require("falcor-path-utils");
  console.log(util.pathCount(["titlesById", [512, 628], ["name","rating"]]))
  // prints 4, because ["titlesById", [512, 628], ["name","rating"]] contains...
  // ["titlesById", 512, "name"]
  // ["titlesById", 512, "rating"]
  // ["titlesById", 628, "name"]
  // ["titlesById", 628, "rating"]

• escape(string) Escapes untrusted input to make it safe to include in a path.

• unescape(string) Unescapes a string encoded with escape.

• materialize(pathSet, value) Construct a JsonGraph of value at pathSet paths.