Sprint Notes PyCon 2017 - jdiegodcp/ramlfications GitHub Wiki

Notes for freddrake and I during sprints for PyCon 2017

Example/s

• need to know if we're !include something.json because:
  • validating based on JSON Schema / XSD or other outside schema definitions requires knowing what kind of data is being worked on
  • maybe need to parse external json/xml/raml/yaml included objects right after loading
    • per file-type validation
    • assert additional properties etc are not defined

!include

• including additional RAML / YAML should probably just graft the node into place

• including non-RAML / non-YAML should present something about type of inclusion, since structural interpretation can be significantly different

Missing values where None is a legal value

We should define a NoValue / Undefined singleton that can be used for object attributes where None is considered an explicit value (likely specified as an explicit map key with no value in the YAML syntax).