summaryrefslogtreecommitdiff
path: root/test/data/parse/README
blob: f1cc46a62f94774203d7b54256a84d07feec6465 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Parser testcases
================

Format
------

#data
<css source data>
#errors
<list of expected errors, with line/col offsets> (ignored at present)
#expected
<rule list, as below>
#reset

Format of rule list
-------------------

  line     ::= rule | bytecode
  rule     ::= '| ' type ' '+ name
  name     ::= .+
  type     ::= [0-9]+
  bytecode ::= '|  ' ' '* hexnum (' '+ hexnum)*
  hexnum   ::= '0x' [0-9a-fA-F]+

Type corresponds to css_rule_type. Consult the library sources for the values.

Bytecode may be split over multiple lines for readability. All bytecode is
associated with the most-recently-declared rule. Consult the bytecode
documentation for what the hexnums should be representing.

Example
-------

#data
* { color: #ff0000 }
#errors
#expected
| 1 *
|   0x0200000f 0xff000000
#reset

TODO
----

  + Permit nesting of rules (for nested block support)
  + There's no way of flagging a pointer in the bytecode (ideally, this will
    be defined in such a way that we'll be able to validate the data pointed
    to, too)