1 ======================================
2 doctest for path.py
3
4 Uncomplete, and tests POSIX paths only
5 ======================================
6
7 >>> from mypath import path
8
9 # Test root
10
11 >>> path.ROOT
12 path.ROOT
13
14 >>> path.ROOT == path.ROOT
15 True
16 >>> path.ROOT < path.ROOT
17 False
18 >>> path.ROOT > path.ROOT
19 False
20
21 >>> path.ROOT == 'e'
22 False
23 >>> path.ROOT < 'h'
24 True
25 >>> path.ROOT > 'b'
26 False
27 >>> path.ROOT > 3
28 Traceback (most recent call last):
29 ...
30 TypeError: Comparison not defined
31
32 >>> 'a' == path.ROOT
33 False
34 >>> 'a' < path.ROOT
35 False
36 >>> 'a' > path.ROOT
37 True
38 >>> 3 > path.ROOT
39 Traceback (most recent call last):
40 ...
41 TypeError: Comparison not defined
42
43
44 # Basic path creation
45
46 >>> path('/bin/arch')
47 path('/bin/arch')
48 >>> p = _
49 >>> p[0]
50 path.ROOT
51 >>> p[1]
52 'bin'
53 >>> p[2]
54 'arch'
55 >>> len(p)
56 3
57 >>> path('hello/what')
58 path('hello/what')
59 >>> p = _
60 >>> p[0]
61 'hello'
62 >>> p[1]
63 'what'
64 >>> len(p)
65 2
66 >>> path('.')
67 path('.')
68 >>> len(_)
69 0
70 >>> path('')
71 path('.')
72 >>> path()
73 path('.')
74 >>> path('/')
75 path('/')
76
77 # Constructing from a string
78
79 >>> path('hello//what')
80 path('hello/what')
81 >>> path('hello//what/')
82 path('hello/what')
83 >>> path('/hello//what/')
84 path('/hello/what')
85 >>> path('//hello//what/')
86 Traceback (most recent call last):
87 ...
88 NotImplementedError: Paths with two leading slashes aren't supported.
89 >>> path('///hello//what/')
90 path('/hello/what')
91
92 # Constructing from an iterable
93
94 >>> path(['hello', 'how'])
95 path('hello/how')
96 >>> path([path.ROOT, 'hello', 'how'])
97 path('/hello/how')
98 >>> path(['hello', path.ROOT, 'how'])
99 Traceback (most recent call last):
100 ...
101 TypeError: Element path.ROOT is of a wrong type
102
103 # Concatenation
104
105 >>> path('hello/a') + path('b')
106 path('hello/a/b')
107 >>> path('hello/a') + 'b'
108 path('hello/a/b')
109 >>> path('hello/a') + 'b/c'
110 path('hello/a/b/c')
111 >>> 'b/c' + path('hello/a')
112 path('b/c/hello/a')
113 >>> 'b/c' + path('/hello/a')
114 Traceback (most recent call last):
115 ...
116 ValueError: Right operand should be a relative path
117 >>> path('hello/a') + '/b/c'
118 Traceback (most recent call last):
119 ...
120 ValueError: Right operand should be a relative path
121
122 # Slicing
123
124 >>> p = path('/hello/a')
125 >>> p[:2]
126 path('/hello')
127 >>> p[-1]
128 'a'
129 >>> p[:-1]
130 path('/hello')
131
132 # Multiplication
133
134 >>> path('hello/a') * 3
135 path('hello/a/hello/a/hello/a')
136 >>> path('/hello/a') * 3
137 Traceback (most recent call last):
138 ...
139 ValueError: Only relative paths can be multiplied
140
141 >>> 3 * path('hello/a')
142 path('hello/a/hello/a/hello/a')
143 >>> 3 * path('/hello/a')
144 Traceback (most recent call last):
145 ...
146 ValueError: Only relative paths can be multiplied
147
148 # Comparison
149
150 >>> L = ['/home/noam', '/home/allon', '/home/noam2', '/home/bbbb',
151 ... 'home/bbbb', 'home/noam', 'home/noam2', 'home/allon', 'a/b', '/b/c']
152 >>> L.extend([path(x) for x in L])
153 >>> L.sort()
154 >>> L
155 ['/b/c', path('/b/c'), '/home/allon', path('/home/allon'), '/home/bbbb', path('/home/bbbb'), '/home/noam', path('/home/noam'), '/home/noam2', path('/home/noam2'), 'a/b', path('a/b'), 'home/allon', path('home/allon'), 'home/bbbb', path('home/bbbb'), 'home/noam', path('home/noam'), 'home/noam2', path('home/noam2')]
156
157
158
159 # Matching
160
161 >>> path('a/b').match('a/b')
162 True
163 >>> path('a/b').match('a/c')
164 False
165 >>> path('a/b').match('a')
166 False
167 >>> path('a/b').match('a/c*')
168 False
169 >>> path('a/b').match('a/b*')
170 True
171 >>> path('a/b').match('**')
172 True