pyrad 2.4__py3-none-any.whl → 2.5.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. docs/Makefile +20 -0
  2. docs/make.bat +36 -0
  3. docs/source/_static/logo.png +0 -0
  4. docs/source/api/client.rst +10 -0
  5. docs/source/api/dictionary.rst +10 -0
  6. docs/source/api/host.rst +7 -0
  7. docs/source/api/packet.rst +48 -0
  8. docs/source/api/proxy.rst +7 -0
  9. docs/source/api/server.rst +13 -0
  10. docs/source/conf.py +158 -0
  11. docs/source/index.rst +75 -0
  12. example/acct.py +41 -0
  13. example/auth.py +37 -0
  14. example/auth_async.py +164 -0
  15. example/client-coa.py +61 -0
  16. example/coa.py +40 -0
  17. example/dictionary +405 -0
  18. example/dictionary.freeradius +91 -0
  19. example/pyrad.log +0 -0
  20. example/server.py +68 -0
  21. example/server_async.py +117 -0
  22. example/status.py +26 -0
  23. pyrad/__init__.py +3 -3
  24. pyrad/client.py +14 -6
  25. pyrad/client_async.py +16 -13
  26. pyrad/dictfile.py +2 -5
  27. pyrad/dictionary.py +6 -7
  28. pyrad/host.py +1 -1
  29. pyrad/packet.py +145 -114
  30. pyrad/proxy.py +2 -2
  31. pyrad/server.py +3 -7
  32. pyrad/server_async.py +3 -4
  33. pyrad/tests/__init__.py +5 -0
  34. pyrad/tests/mock.py +145 -0
  35. pyrad/tests/test_bidict.py +56 -0
  36. pyrad/tests/test_client.py +183 -0
  37. pyrad/tests/test_dictionary.py +357 -0
  38. pyrad/tests/test_host.py +87 -0
  39. pyrad/tests/test_packet.py +679 -0
  40. pyrad/tests/test_proxy.py +96 -0
  41. pyrad/tests/test_server.py +323 -0
  42. pyrad/tests/test_tools.py +126 -0
  43. pyrad/tools.py +254 -158
  44. {pyrad-2.4.dist-info → pyrad-2.5.1.dist-info}/METADATA +45 -22
  45. pyrad-2.5.1.dist-info/RECORD +51 -0
  46. {pyrad-2.4.dist-info → pyrad-2.5.1.dist-info}/WHEEL +1 -1
  47. {pyrad-2.4.dist-info → pyrad-2.5.1.dist-info/licenses}/LICENSE.txt +1 -1
  48. pyrad-2.5.1.dist-info/top_level.txt +3 -0
  49. pyrad-2.4.dist-info/RECORD +0 -19
  50. pyrad-2.4.dist-info/top_level.txt +0 -1
  51. {pyrad-2.4.dist-info → pyrad-2.5.1.dist-info}/zip-safe +0 -0
@@ -0,0 +1,357 @@
1
+ import unittest
2
+ import operator
3
+ import os
4
+ from io import StringIO
5
+
6
+ from . import home
7
+ from pyrad.dictionary import Attribute
8
+ from pyrad.dictionary import Dictionary
9
+ from pyrad.dictionary import ParseError
10
+ from pyrad.tools import DecodeAttr
11
+ from pyrad.dictfile import DictFile
12
+
13
+
14
+ class AttributeTests(unittest.TestCase):
15
+ def testInvalidDataType(self):
16
+ self.assertRaises(ValueError, Attribute, 'name', 'code', 'datatype')
17
+
18
+ def testConstructionParameters(self):
19
+ attr = Attribute('name', 'code', 'integer', False, 'vendor')
20
+ self.assertEqual(attr.name, 'name')
21
+ self.assertEqual(attr.code, 'code')
22
+ self.assertEqual(attr.type, 'integer')
23
+ self.assertEqual(attr.is_sub_attribute, False)
24
+ self.assertEqual(attr.vendor, 'vendor')
25
+ self.assertEqual(len(attr.values), 0)
26
+ self.assertEqual(len(attr.sub_attributes), 0)
27
+
28
+ def testNamedConstructionParameters(self):
29
+ attr = Attribute(name='name', code='code', datatype='integer',
30
+ vendor='vendor')
31
+ self.assertEqual(attr.name, 'name')
32
+ self.assertEqual(attr.code, 'code')
33
+ self.assertEqual(attr.type, 'integer')
34
+ self.assertEqual(attr.vendor, 'vendor')
35
+ self.assertEqual(len(attr.values), 0)
36
+
37
+ def testValues(self):
38
+ attr = Attribute('name', 'code', 'integer', False, 'vendor',
39
+ dict(pie='custard', shake='vanilla'))
40
+ self.assertEqual(len(attr.values), 2)
41
+ self.assertEqual(attr.values['shake'], 'vanilla')
42
+
43
+
44
+ class DictionaryInterfaceTests(unittest.TestCase):
45
+ def testEmptyDictionary(self):
46
+ dict = Dictionary()
47
+ self.assertEqual(len(dict), 0)
48
+
49
+ def testContainment(self):
50
+ dict = Dictionary()
51
+ self.assertEqual('test' in dict, False)
52
+ self.assertEqual(dict.has_key('test'), False)
53
+ dict.attributes['test'] = 'dummy'
54
+ self.assertEqual('test' in dict, True)
55
+ self.assertEqual(dict.has_key('test'), True)
56
+
57
+ def testReadonlyContainer(self):
58
+ dict = Dictionary()
59
+ self.assertRaises(TypeError,
60
+ operator.setitem, dict, 'test', 'dummy')
61
+ self.assertRaises(AttributeError,
62
+ operator.attrgetter('clear'), dict)
63
+ self.assertRaises(AttributeError,
64
+ operator.attrgetter('update'), dict)
65
+
66
+
67
+ class DictionaryParsingTests(unittest.TestCase):
68
+
69
+ simple_dict_values = [
70
+ ('Test-String', 1, 'string'),
71
+ ('Test-Octets', 2, 'octets'),
72
+ ('Test-Integer', 0x03, 'integer'),
73
+ ('Test-Ip-Address', 4, 'ipaddr'),
74
+ ('Test-Ipv6-Address', 5, 'ipv6addr'),
75
+ ('Test-If-Id', 6, 'ifid'),
76
+ ('Test-Date', 7, 'date'),
77
+ ('Test-Abinary', 8, 'abinary'),
78
+ ('Test-Tlv', 9, 'tlv'),
79
+ ('Test-Tlv-Str', 1, 'string'),
80
+ ('Test-Tlv-Int', 2, 'integer'),
81
+ ('Test-Integer64', 10, 'integer64'),
82
+ ('Test-Integer64-Hex', 10, 'integer64'),
83
+ ('Test-Integer64-Oct', 10, 'integer64'),
84
+ ]
85
+
86
+ def setUp(self):
87
+ self.path = os.path.join(home, 'data')
88
+ self.dict = Dictionary(os.path.join(self.path, 'simple'))
89
+
90
+ def testParseEmptyDictionary(self):
91
+ dict = Dictionary(StringIO(''))
92
+ self.assertEqual(len(dict), 0)
93
+
94
+ def testParseMultipleDictionaries(self):
95
+ dict = Dictionary(StringIO(''))
96
+ self.assertEqual(len(dict), 0)
97
+ one = StringIO('ATTRIBUTE Test-First 1 string')
98
+ two = StringIO('ATTRIBUTE Test-Second 2 string')
99
+ dict = Dictionary(StringIO(''), one, two)
100
+ self.assertEqual(len(dict), 2)
101
+
102
+ def testParseSimpleDictionary(self):
103
+ self.assertEqual(len(self.dict), len(self.simple_dict_values))
104
+ for (attr, code, type) in self.simple_dict_values:
105
+ attr = self.dict[attr]
106
+ self.assertEqual(attr.code, code)
107
+ self.assertEqual(attr.type, type)
108
+
109
+ def testAttributeTooFewColumnsError(self):
110
+ try:
111
+ self.dict.ReadDictionary(
112
+ StringIO('ATTRIBUTE Oops-Too-Few-Columns'))
113
+ except ParseError as e:
114
+ self.assertEqual('attribute' in str(e), True)
115
+ else:
116
+ self.fail()
117
+
118
+ def testAttributeUnknownTypeError(self):
119
+ try:
120
+ self.dict.ReadDictionary(StringIO('ATTRIBUTE Test-Type 1 dummy'))
121
+ except ParseError as e:
122
+ self.assertEqual('dummy' in str(e), True)
123
+ else:
124
+ self.fail()
125
+
126
+ def testAttributeUnknownVendorError(self):
127
+ try:
128
+ self.dict.ReadDictionary(StringIO('ATTRIBUTE Test-Type 1 Simplon'))
129
+ except ParseError as e:
130
+ self.assertEqual('Simplon' in str(e), True)
131
+ else:
132
+ self.fail()
133
+
134
+ def testAttributeOptions(self):
135
+ self.dict.ReadDictionary(StringIO(
136
+ 'ATTRIBUTE Option-Type 1 string has_tag,encrypt=1'))
137
+ self.assertEqual(self.dict['Option-Type'].has_tag, True)
138
+ self.assertEqual(self.dict['Option-Type'].encrypt, 1)
139
+
140
+ def testAttributeEncryptionError(self):
141
+ try:
142
+ self.dict.ReadDictionary(StringIO(
143
+ 'ATTRIBUTE Test-Type 1 string encrypt=4'))
144
+ except ParseError as e:
145
+ self.assertEqual('encrypt' in str(e), True)
146
+ else:
147
+ self.fail()
148
+
149
+ def testValueTooFewColumnsError(self):
150
+ try:
151
+ self.dict.ReadDictionary(StringIO('VALUE Oops-Too-Few-Columns'))
152
+ except ParseError as e:
153
+ self.assertEqual('value' in str(e), True)
154
+ else:
155
+ self.fail()
156
+
157
+ def testValueForUnknownAttributeError(self):
158
+ try:
159
+ self.dict.ReadDictionary(StringIO(
160
+ 'VALUE Test-Attribute Test-Text 1'))
161
+ except ParseError as e:
162
+ self.assertEqual('unknown attribute' in str(e), True)
163
+ else:
164
+ self.fail()
165
+
166
+ def testIntegerValueParsing(self):
167
+ self.assertEqual(len(self.dict['Test-Integer'].values), 0)
168
+ self.dict.ReadDictionary(StringIO('VALUE Test-Integer Value-Six 5'))
169
+ self.assertEqual(len(self.dict['Test-Integer'].values), 1)
170
+ self.assertEqual(
171
+ DecodeAttr('integer',
172
+ self.dict['Test-Integer'].values['Value-Six']),
173
+ 5)
174
+
175
+ def testInteger64ValueParsing(self):
176
+ self.assertEqual(len(self.dict['Test-Integer64'].values), 0)
177
+ self.dict.ReadDictionary(StringIO('VALUE Test-Integer64 Value-Six 5'))
178
+ self.assertEqual(len(self.dict['Test-Integer64'].values), 1)
179
+ self.assertEqual(
180
+ DecodeAttr('integer64',
181
+ self.dict['Test-Integer64'].values['Value-Six']),
182
+ 5)
183
+
184
+ def testStringValueParsing(self):
185
+ self.assertEqual(len(self.dict['Test-String'].values), 0)
186
+ self.dict.ReadDictionary(StringIO(
187
+ 'VALUE Test-String Value-Custard custardpie'))
188
+ self.assertEqual(len(self.dict['Test-String'].values), 1)
189
+ self.assertEqual(
190
+ DecodeAttr('string',
191
+ self.dict['Test-String'].values['Value-Custard']),
192
+ 'custardpie')
193
+
194
+ def testOctetValueParsing(self):
195
+ self.assertEqual(len(self.dict['Test-Octets'].values), 0)
196
+ self.dict.ReadDictionary(StringIO(
197
+ 'ATTRIBUTE Test-Octets 1 octets\n'
198
+ 'VALUE Test-Octets Value-A 65\n' # "A"
199
+ 'VALUE Test-Octets Value-B 0x42\n')) # "B"
200
+ self.assertEqual(len(self.dict['Test-Octets'].values), 2)
201
+ self.assertEqual(
202
+ DecodeAttr('octets',
203
+ self.dict['Test-Octets'].values['Value-A']),
204
+ b'A')
205
+ self.assertEqual(
206
+ DecodeAttr('octets',
207
+ self.dict['Test-Octets'].values['Value-B']),
208
+ b'B')
209
+
210
+ def testTlvParsing(self):
211
+ self.assertEqual(len(self.dict['Test-Tlv'].sub_attributes), 2)
212
+ self.assertEqual(self.dict['Test-Tlv'].sub_attributes, {1: 'Test-Tlv-Str', 2: 'Test-Tlv-Int'})
213
+
214
+ def testSubTlvParsing(self):
215
+ for (attr, _, _) in self.simple_dict_values:
216
+ if attr.startswith('Test-Tlv-'):
217
+ self.assertEqual(self.dict[attr].is_sub_attribute, True)
218
+ self.assertEqual(self.dict[attr].parent, self.dict['Test-Tlv'])
219
+ else:
220
+ self.assertEqual(self.dict[attr].is_sub_attribute, False)
221
+ self.assertEqual(self.dict[attr].parent, None)
222
+
223
+ # tlv with vendor
224
+ full_dict = Dictionary(os.path.join(self.path, 'full'))
225
+ self.assertEqual(full_dict['Simplon-Tlv-Str'].is_sub_attribute, True)
226
+ self.assertEqual(full_dict['Simplon-Tlv-Str'].parent, full_dict['Simplon-Tlv'])
227
+ self.assertEqual(full_dict['Simplon-Tlv-Int'].is_sub_attribute, True)
228
+ self.assertEqual(full_dict['Simplon-Tlv-Int'].parent, full_dict['Simplon-Tlv'])
229
+
230
+ def testVenderTooFewColumnsError(self):
231
+ try:
232
+ self.dict.ReadDictionary(StringIO('VENDOR Simplon'))
233
+ except ParseError as e:
234
+ self.assertEqual('vendor' in str(e), True)
235
+ else:
236
+ self.fail()
237
+
238
+ def testVendorParsing(self):
239
+ self.assertRaises(ParseError, self.dict.ReadDictionary,
240
+ StringIO('ATTRIBUTE Test-Type 1 integer Simplon'))
241
+ self.dict.ReadDictionary(StringIO('VENDOR Simplon 42'))
242
+ self.assertEqual(self.dict.vendors['Simplon'], 42)
243
+ self.dict.ReadDictionary(StringIO(
244
+ 'ATTRIBUTE Test-Type 1 integer Simplon'))
245
+ self.assertEqual(self.dict.attrindex['Test-Type'], (42, 1))
246
+
247
+ def testVendorOptionError(self):
248
+ self.assertRaises(ParseError, self.dict.ReadDictionary,
249
+ StringIO('ATTRIBUTE Test-Type 1 integer Simplon'))
250
+ try:
251
+ self.dict.ReadDictionary(StringIO('VENDOR Simplon 42 badoption'))
252
+ except ParseError as e:
253
+ self.assertEqual('option' in str(e), True)
254
+ else:
255
+ self.fail()
256
+
257
+ def testVendorFormatError(self):
258
+ self.assertRaises(ParseError, self.dict.ReadDictionary,
259
+ StringIO('ATTRIBUTE Test-Type 1 integer Simplon'))
260
+ try:
261
+ self.dict.ReadDictionary(StringIO(
262
+ 'VENDOR Simplon 42 format=5,4'))
263
+ except ParseError as e:
264
+ self.assertEqual('format' in str(e), True)
265
+ else:
266
+ self.fail()
267
+
268
+ def testVendorFormatSyntaxError(self):
269
+ self.assertRaises(ParseError, self.dict.ReadDictionary,
270
+ StringIO('ATTRIBUTE Test-Type 1 integer Simplon'))
271
+ try:
272
+ self.dict.ReadDictionary(StringIO(
273
+ 'VENDOR Simplon 42 format=a,1'))
274
+ except ParseError as e:
275
+ self.assertEqual('Syntax' in str(e), True)
276
+ else:
277
+ self.fail()
278
+
279
+ def testBeginVendorTooFewColumns(self):
280
+ try:
281
+ self.dict.ReadDictionary(StringIO('BEGIN-VENDOR'))
282
+ except ParseError as e:
283
+ self.assertEqual('begin-vendor' in str(e), True)
284
+ else:
285
+ self.fail()
286
+
287
+ def testBeginVendorUnknownVendor(self):
288
+ try:
289
+ self.dict.ReadDictionary(StringIO('BEGIN-VENDOR Simplon'))
290
+ except ParseError as e:
291
+ self.assertEqual('Simplon' in str(e), True)
292
+ else:
293
+ self.fail()
294
+
295
+ def testBeginVendorParsing(self):
296
+ self.dict.ReadDictionary(StringIO(
297
+ 'VENDOR Simplon 42\n'
298
+ 'BEGIN-VENDOR Simplon\n'
299
+ 'ATTRIBUTE Test-Type 1 integer'))
300
+ self.assertEqual(self.dict.attrindex['Test-Type'], (42, 1))
301
+
302
+ def testEndVendorUnknownVendor(self):
303
+ try:
304
+ self.dict.ReadDictionary(StringIO('END-VENDOR'))
305
+ except ParseError as e:
306
+ self.assertEqual('end-vendor' in str(e), True)
307
+ else:
308
+ self.fail()
309
+
310
+ def testEndVendorUnbalanced(self):
311
+ try:
312
+ self.dict.ReadDictionary(StringIO(
313
+ 'VENDOR Simplon 42\n'
314
+ 'BEGIN-VENDOR Simplon\n'
315
+ 'END-VENDOR Oops\n'))
316
+ except ParseError as e:
317
+ self.assertEqual('Oops' in str(e), True)
318
+ else:
319
+ self.fail()
320
+
321
+ def testEndVendorParsing(self):
322
+ self.dict.ReadDictionary(StringIO(
323
+ 'VENDOR Simplon 42\n'
324
+ 'BEGIN-VENDOR Simplon\n'
325
+ 'END-VENDOR Simplon\n'
326
+ 'ATTRIBUTE Test-Type 1 integer'))
327
+ self.assertEqual(self.dict.attrindex['Test-Type'], 1)
328
+
329
+ def testInclude(self):
330
+ try:
331
+ self.dict.ReadDictionary(StringIO(
332
+ '$INCLUDE this_file_does_not_exist\n'
333
+ 'VENDOR Simplon 42\n'
334
+ 'BEGIN-VENDOR Simplon\n'
335
+ 'END-VENDOR Simplon\n'
336
+ 'ATTRIBUTE Test-Type 1 integer'))
337
+ except IOError as e:
338
+ self.assertEqual('this_file_does_not_exist' in str(e), True)
339
+ else:
340
+ self.fail()
341
+
342
+ def testDictFilePostParse(self):
343
+ f = DictFile(StringIO(
344
+ 'VENDOR Simplon 42\n'))
345
+ for _ in f:
346
+ pass
347
+ self.assertEqual(f.File(), '')
348
+ self.assertEqual(f.Line(), -1)
349
+
350
+ def testDictFileParseError(self):
351
+ tmpdict = Dictionary()
352
+ try:
353
+ tmpdict.ReadDictionary(os.path.join(self.path, 'dictfiletest'))
354
+ except ParseError as e:
355
+ self.assertEqual('dictfiletest' in str(e), True)
356
+ else:
357
+ self.fail()
@@ -0,0 +1,87 @@
1
+ import unittest
2
+ from pyrad.host import Host
3
+ from pyrad.packet import Packet
4
+ from pyrad.packet import AuthPacket
5
+ from pyrad.packet import AcctPacket
6
+
7
+
8
+ class ConstructionTests(unittest.TestCase):
9
+ def testSimpleConstruction(self):
10
+ host = Host()
11
+ self.assertEqual(host.authport, 1812)
12
+ self.assertEqual(host.acctport, 1813)
13
+
14
+ def testParameterOrder(self):
15
+ host = Host(123, 456, 789, 101)
16
+ self.assertEqual(host.authport, 123)
17
+ self.assertEqual(host.acctport, 456)
18
+ self.assertEqual(host.coaport, 789)
19
+ self.assertEqual(host.dict, 101)
20
+
21
+ def testNamedParameters(self):
22
+ host = Host(authport=123, acctport=456, coaport=789, dict=101)
23
+ self.assertEqual(host.authport, 123)
24
+ self.assertEqual(host.acctport, 456)
25
+ self.assertEqual(host.coaport, 789)
26
+ self.assertEqual(host.dict, 101)
27
+
28
+
29
+ class PacketCreationTests(unittest.TestCase):
30
+ def setUp(self):
31
+ self.host = Host()
32
+
33
+ def testCreatePacket(self):
34
+ packet = self.host.CreatePacket(id=15)
35
+ self.assertTrue(isinstance(packet, Packet))
36
+ self.assertTrue(packet.dict is self.host.dict)
37
+ self.assertEqual(packet.id, 15)
38
+
39
+ def testCreateAuthPacket(self):
40
+ packet = self.host.CreateAuthPacket(id=15)
41
+ self.assertTrue(isinstance(packet, AuthPacket))
42
+ self.assertTrue(packet.dict is self.host.dict)
43
+ self.assertEqual(packet.id, 15)
44
+
45
+ def testCreateAcctPacket(self):
46
+ packet = self.host.CreateAcctPacket(id=15)
47
+ self.assertTrue(isinstance(packet, AcctPacket))
48
+ self.assertTrue(packet.dict is self.host.dict)
49
+ self.assertEqual(packet.id, 15)
50
+
51
+
52
+ class MockPacket:
53
+ packet = object()
54
+ replypacket = object()
55
+ source = object()
56
+
57
+ def Packet(self):
58
+ return self.packet
59
+
60
+ def ReplyPacket(self):
61
+ return self.replypacket
62
+
63
+
64
+ class MockFd:
65
+ data = None
66
+ target = None
67
+
68
+ def sendto(self, data, target):
69
+ self.data = data
70
+ self.target = target
71
+
72
+
73
+ class PacketSendTest(unittest.TestCase):
74
+ def setUp(self):
75
+ self.host = Host()
76
+ self.fd = MockFd()
77
+ self.packet = MockPacket()
78
+
79
+ def testSendPacket(self):
80
+ self.host.SendPacket(self.fd, self.packet)
81
+ self.assertTrue(self.fd.data is self.packet.packet)
82
+ self.assertTrue(self.fd.target is self.packet.source)
83
+
84
+ def testSendReplyPacket(self):
85
+ self.host.SendReplyPacket(self.fd, self.packet)
86
+ self.assertTrue(self.fd.data is self.packet.replypacket)
87
+ self.assertTrue(self.fd.target is self.packet.source)