- Timestamp:
- 8 Mar 2012, 19:00:51 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
main/waeup.kofa/trunk/src/waeup/kofa/accesscodes/accesscode.txt
r7321 r7811 1 :mod:`waeup. sirp.accesscodes.accesscode` -- access codes (aka PINs)1 :mod:`waeup.kofa.accesscodes.accesscode` -- access codes (aka PINs) 2 2 ******************************************************************* 3 3 4 .. module:: waeup. sirp.accesscodes.accesscode4 .. module:: waeup.kofa.accesscodes.accesscode 5 5 6 6 Components that represent access codes and related. 7 7 8 8 .. :NOdoctest: 9 .. :NOlayer: waeup. sirp.testing.SIRPUnitTestLayer9 .. :NOlayer: waeup.kofa.testing.KOFAUnitTestLayer 10 10 11 11 About access-codes … … 28 28 unique random number of 10 digits. 29 29 30 For the generation of the random number :mod:`waeup. sirp` requires a30 For the generation of the random number :mod:`waeup.kofa` requires a 31 31 'urandom' entropy provider which is available with most standard 32 32 Unix/Linux systems. This makes the generated numbers relatively … … 57 57 58 58 The class implements 59 :mod:`waeup. sirp.accesscodes.interfaces.IAccessCode`:60 61 >>> from waeup. sirp.accesscodes.interfaces import IAccessCode62 >>> from waeup. sirp.accesscodes.accesscodes import AccessCode59 :mod:`waeup.kofa.accesscodes.interfaces.IAccessCode`: 60 61 >>> from waeup.kofa.accesscodes.interfaces import IAccessCode 62 >>> from waeup.kofa.accesscodes.accesscodes import AccessCode 63 63 >>> from zope.interface.verify import verifyClass 64 64 >>> verifyClass(IAccessCode, AccessCode) … … 150 150 151 151 A persistent :class:`grok.Model`. It implements 152 :class:`waeup. sirp.accesscodes.interfaces.IAccessCodeBatch`.152 :class:`waeup.kofa.accesscodes.interfaces.IAccessCodeBatch`. 153 153 154 154 When creating a batch, all entries (access-codes) are generated as … … 306 306 :class:`AccessCodeBatch` implements :class:`IAccessCodeBatch`: 307 307 308 >>> from waeup. sirp.accesscodes.interfaces import IAccessCodeBatch309 >>> from waeup. sirp.accesscodes.accesscodes import AccessCodeBatch308 >>> from waeup.kofa.accesscodes.interfaces import IAccessCodeBatch 309 >>> from waeup.kofa.accesscodes.accesscodes import AccessCodeBatch 310 310 >>> from zope.interface.verify import verifyClass 311 311 >>> verifyClass(IAccessCodeBatch, AccessCodeBatch) … … 317 317 318 318 >>> import datetime 319 >>> from waeup. sirp.accesscodes.accesscodes import AccessCodeBatch319 >>> from waeup.kofa.accesscodes.accesscodes import AccessCodeBatch 320 320 >>> batch = AccessCodeBatch( 321 321 ... datetime.datetime(2009, 12, 23), 'Fred','APP', 12.12, 3, num=10) … … 331 331 332 332 >>> [x for x in batch.entries()] 333 [<waeup. sirp...AccessCode object at 0x...>, ...]333 [<waeup.kofa...AccessCode object at 0x...>, ...] 334 334 335 335 Getting a single entry from the batch: … … 338 338 >>> ac = batch.getAccessCode(ac_id) 339 339 >>> ac 340 <waeup. sirp...AccessCode object at 0x...>340 <waeup.kofa...AccessCode object at 0x...> 341 341 342 342 >>> ac is list(batch.entries())[0] … … 374 374 # 375 375 # >>> batch.getAccessCodeForStudentId('some_user_id') 376 # <waeup. sirp...AccessCode object at 0x...>376 # <waeup.kofa...AccessCode object at 0x...> 377 377 # 378 378 #Non-existent values will cause a :exc:`KeyError`: … … 440 440 >>> result = batch.search(0, 'serial') 441 441 >>> result 442 [<waeup. sirp...AccessCode object at 0x...>]442 [<waeup.kofa...AccessCode object at 0x...>] 443 443 444 444 >>> result[0].batch_serial … … 545 545 Creating a batch container: 546 546 547 >>> from waeup. sirp.accesscodes.accesscodes import (547 >>> from waeup.kofa.accesscodes.accesscodes import ( 548 548 ... AccessCodeBatchContainer) 549 549 >>> container = AccessCodeBatchContainer() … … 561 561 562 562 >>> container.search(1, 'serial') 563 [<waeup. sirp...AccessCode object at 0x...>,564 <waeup. sirp...AccessCode object at 0x...>]563 [<waeup.kofa...AccessCode object at 0x...>, 564 <waeup.kofa...AccessCode object at 0x...>] 565 565 566 566 >>> container.search('not-a-number', 'serial') … … 569 569 >>> result = container.search('1', 'serial') 570 570 >>> result 571 [<waeup. sirp...AccessCode object at 0x...>,572 <waeup. sirp...AccessCode object at 0x...>]571 [<waeup.kofa...AccessCode object at 0x...>, 572 <waeup.kofa...AccessCode object at 0x...>] 573 573 574 574 Searching for ACs: … … 576 576 >>> ac = result[0] 577 577 >>> container.search(ac.representation, 'pin') 578 [<waeup. sirp...AccessCode object at 0x...>]578 [<waeup.kofa...AccessCode object at 0x...>] 579 579 580 580 Searching for student IDs: … … 583 583 # ... ac.representation, 'some_user') 584 584 # >>> container.search('some_user', 'stud_id') 585 # [<waeup. sirp...AccessCode object at 0x...>]585 # [<waeup.kofa...AccessCode object at 0x...>] 586 586 587 587 … … 591 591 .. class:: AccessCodePlugin 592 592 593 A `waeup. sirp` plugin that updates existing SIRPuniversity593 A `waeup.kofa` plugin that updates existing KOFA university 594 594 instances so that they provide support for access-codes. 595 595 596 .. attribute:: grok.implements(I SIRPPluggable)596 .. attribute:: grok.implements(IKOFAPluggable) 597 597 .. attribute:: grok.name('accesscodes') 598 598 … … 608 608 609 609 The AccessCodePlugin is available as a global named utility for the 610 I SIRPPluggable interface named ``accesscodes``.610 IKOFAPluggable interface named ``accesscodes``. 611 611 612 612 It is looked up by a university instance when created, so that this … … 615 615 616 616 >>> from zope.component import getUtility 617 >>> from waeup. sirp.interfaces import ISIRPPluggable618 >>> plugin = getUtility(I SIRPPluggable, name='accesscodes')617 >>> from waeup.kofa.interfaces import IKOFAPluggable 618 >>> plugin = getUtility(IKOFAPluggable, name='accesscodes') 619 619 >>> plugin 620 <waeup. sirp.accesscodes.accesscodes.AccessCodePlugin object at 0x...>620 <waeup.kofa.accesscodes.accesscodes.AccessCodePlugin object at 0x...> 621 621 622 622 It provides a `setup()` and an `update()` method. Both have to be
Note: See TracChangeset for help on using the changeset viewer.