BidiTest.txt - libgrapheme - unicode string library
(HTM) git clone git://git.suckless.org/libgrapheme
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
BidiTest.txt (7959988B)
---
1 # BidiTest-17.0.0.txt
2 # Date: 2025-01-27, 18:09:05 GMT
3 # © 2025 Unicode®, Inc.
4 # Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. in the U.S. and other countries.
5 # For terms of use and license, see https://www.unicode.org/terms_of_use.html
6 #
7 # Unicode Character Database
8 # For documentation, see https://www.unicode.org/reports/tr44/
9 #
10 # This file provides a conformance test for UBA (Unicode Bidi Algorithm) implementations.
11 # It is designed to be reasonably compact, and yet provide a thorough test of all cases up to
12 # a given limit (currently 4). Additionally, it contains some longer cases useful for testing
13 # some common pitfalls of UBA implementations.
14 #
15 # Note that for the test cases in this file, it is assumed that no bidi
16 # paired brackets exist in the input that would affect the resolved levels
17 # or reordering. For test cases with bidi paired brackets and other
18 # character-code specific test cases, refer to BidiCharacterTest.txt.
19 # Implementations are expected to correctly cover all test cases in both
20 # test files.
21 #
22 # The test cases in this file are further limited in the following ways:
23 #
24 # - The Bidi_Class B (Paragraph_Separator) only appears as the last
25 # character in a sequence. Thus, each sequence is assumed to consist of
26 # only one paragraph. Implementations may need extra testing for rule P1
27 # of the UBA.
28 #
29 # - For the application of rules L1 and L2, it is assumed that all the
30 # characters in the input would be rendered on a single line, with no line
31 # breaks.
32 #
33 # - Implementation of rules L3 and L4 is platform- and character-specific
34 # and test cases for it are not provided in this data file.
35 #
36 #
37 # Format:
38 #
39 # All tokens may be separated by whitespaces (space or tab). There are three kinds of lines:
40 # Levels, Reorder, and data.
41 #
42 # A Levels line indicates that all following data lines, up to the next Levels line,
43 # have the same resulting ordering levels. It has the following format:
44 #
45 # @Levels: <levels>
46 #
47 # <levels> = An ordered space-delimited list of numbers indicating the resulting levels
48 # for each input property value. The UBA does not assign levels to certain values;
49 # those are indicated with an x. See the note below.
50 # Examples:
51 # @Levels: 1 0
52 # @Levels: x 1 x 2
53 #
54 # A Reorder line indicates that all following data lines, up to the next Reorder line,
55 # have the same resulting reordering. It has the following format:
56 #
57 # @Reorder: <ordering>
58 #
59 # <ordering> = An ordered space-delimited list of numbers indicating the resulting
60 # visual ordering from left to right. The numbers are zero-based, and
61 # are indexes into the input string. Items with a level of x are skipped.
62 # Thus "1 0" indicates what would happen with input of "L R" and an RTL
63 # paragraph direction.
64 # Example:
65 # @Reorder: 1 0
66 # @Reorder: 3 1
67 #
68 # A data line has the following format:
69
70 # <input> ; <bitset>
71
72 # <input> = An ordered list of BIDI property values
73 # <bitset> = A hex bitset for paragraph levels (P): 1 = auto-LTR, 2 = LTR, 4 = RTL
74 # Auto-LTR (standard BIDI) uses the first L/R/AL character, and is LTR if none is found.
75 # Example:
76 # L LRE R R; 7
77 # L LRE R AL; 7
78 #
79 # Any other line starting with @ is to be ignored (this allows some degree of forward compatibility).
80 #
81 # Usage:
82 #
83 # - If the implementation API allows a list of bidi property values as input:
84 #
85 # For each of the paragraph levels in the bitset:
86 # Find the levels in each line, and compare that to the last @Levels values.
87 # If they are different, the test fails.
88 # Reorder the elements, and compare to the @Reorder values.
89 # If they are different, the test fails.
90 #
91 # - If the implementation allows for a character string as input,
92 # randomly pick characters from those with the same Bidi_Class values,
93 # and test the reordering as above.
94 #
95 # Note that the UBA doesn'