Why Sponsor Oils? | source | all docs for version 0.19.0 | all versions | oilshell.org

Warning: Work in progress! Leave feedback on Zulip or Github if you'd like this doc to be updated.

Data Languages

This chapter in the Oils Reference describes data languages: J8 Notation and Packle.

This is a quick reference, not the official spec.

J8 Strings

json-escape \n

surrogate-pair

Inherited from JSON

See Surrogate Pair Blog Post.

j8-escape \yff

j-prefix j""

JSON8

These are simply JSON strings with the two J8 Escapes, and the optional J prefix.

Null

Bool

Int

Float aka number

Str

List aka array

Dict aka object

TSV8

These are the J8 Primitives (Bool, Int, Float, Str), separated by tabs.

column-attrs

!tsv8    name    age
!type    Str     Int
         Alice   42
         Bob     25

column-types

The primitives:

• Null
• Bool
• Int
• Float
• Str

UTF8 Errors

This is for reference.

bad-byte

expected-start

expected-cont

incomplete-seq

overlong

bad-code-point

e.g. decoded to something in the surrogate range

Packle

• Binary data represented length-prefixed without encode/decode
• Exact float representation
• Represent graphs, not just trees. ("JSON key sharing")