https://github.com/pythongssapi/k5test

A library for setting up self-contained Kerberos 5 environments (based on code from MIT krb5, but supports Heimdal)
https://github.com/pythongssapi/k5test

Last synced: 12 days ago
JSON representation

A library for setting up self-contained Kerberos 5 environments (based on code from MIT krb5, but supports Heimdal)

• Host: GitHub
• URL: https://github.com/pythongssapi/k5test
• Owner: pythongssapi
• License: other
• Created: 2015-06-02T18:48:48.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2024-03-20T02:47:31.000Z (8 months ago)
• Last Synced: 2024-04-25T21:45:46.197Z (7 months ago)
• Language: Python
• Homepage:
• Size: 54.7 KB
• Stars: 5
• Watchers: 5
• Forks: 11
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
K5Test

======

*k5test* is a library for setting up self-contained Kerberos 5 environments,

and running Python unit tests inside those environments.  It is based on

the file of the same name found alongside the MIT Kerberos 5 unit tests.

Using k5test to set up a Kerberos 5 deployment

----------------------------------------------

*k5test* can be used to set up a self-contained MIT krb5 or Heimdal

environment.  This is useful for testing applications without having to

manipulate existing Kerberos realms, or having to set up a full Kerberos

deployment by hand.

To set up a realm, use the `k5test.K5Realm` class.  The constructor accepts

several useful arguments for controlling which parts get set up; refer to the

inline documentation for more information.

Using k5test to run unit tests

------------------------------

Instead of having test cases inherit from `unittest.TestCase`, inherit from

`k5test.KerberosTestCase`, which will automatically set up a Kerberos 5

environment, before the test case, and tear it down afterwards.

Additionally, several decorators are defined.  the

`k5test.gssapi_extension_test(extension_name, human_readable_name)` decorator

(which requires `python-gssapi`) allows you to skip tests with installations

that don't support a particular GSSAPI extension.  The the

`k5test.krb_minversion_test(target_version, problem_name)` decorator allows

you to skip tests when running a version of krb5 less that the required

version.  The `k5test.krb_plugin_test(plugin_type, plugin_name)` decorator

allows you to skip tests for installations that don't have a particular plugin

installed.