Source   Edit  

working with data

bookmark

TLDR

• see dom96s response to this question before using marshal to parse json
• see data wrangling, for wrangling data
• parser modules generally start with parse
  • if dealing with html syntax trees, i believe the xml parsers work as well

links

• high impact
  • csv parser
  • json utils
  • json
  • logging
  • marshal
• niche
  • base object of a lexer
  • fusion ht/xml parser
  • fusion ht/xml tree
  • fusion htmlparser
  • ht/xml parser
  • ht/xml tree
  • ht/xml
  • html generator
  • html parser
  • json parser
  • var ints

json

• json imports parsejson module; no need to import it twice
• field axor, throws if not found
• {} field axor, nil/default value if not found; works?.like?.es6 operator
  • IMO use this over {"cuz", "u", "can", "do", "this"} {to: {dig:{ into: {an: obj }}}
• JObject preserves key ordering
• use std/option for maybe keys when marshalling a JsonNode to a custom type
• use somekey for some key thats some reserved nim keyword
• %* doesnt support heterogeneous arrays, sets in objects, or not nil annotations
• may require importing the underlying stdlib (e.g. tables) & jsonutils for extra helpers

json types

• JsonNodeObj base type
• JsonNode ref JsonNodeObj object variant representing any json type
• JsonNodeKind enum
  • all have a newJBlah constructor
  • JArray seqJsonNode
  • JBool bool
  • JFloat float
  • JInt BiggestInt
  • JNull nil
  • JObject OrderedTablestring, JsonNode
  • JString string

json procs

• kind get json node type
• parseJson parses string into a json node, i.e. JSON.parse
• getOrDefault from any j type
• getInt(defaultValue)
• getFloat(defaultValue)
• getStr(defaultValue)
• getBool(defaultValue)
• getBiggestInt(defaultValue)
• getElems(defaultValue) of an array
• getFields(defaultValue) of an object; requires import std/table
• to unmarshal a JsonNode to an arbitrary type

jsonutils

• (de)serialization for arbitrary types

jsonutil types

• EnumMode enum
  • joptEnumOrd|Symbol|String
• Joptions controls errors during fromJson serialization
  • allowExtraKeys json string can have more keys than nim object
  • allowMissingKeys json string can have less keys than expected in nim object
• JsonNodeMode enum controls toJson for JsonNode types
  • joptJsonNodeAsRef|CopyObject
    • ref returned as is
    • copy deep
    • object regular ref
• ToJsonOptions
  • enumMode: EnumMode
  • jsonNodeMode: JsonNodeMode

jsonutils procs

• fromJsonHook JsonNode -> any nim type
• toJsonHook any nim type -> JsonNode