keystone/HACKING.rst

891 B

Keystone Style Commandments

Keystone Specific Commandments

  • Avoid using "double quotes" where you can reasonably use 'single quotes'

TODO vs FIXME

  • TODO(name): implies that something should be done (cleanup, refactoring, etc), but is expected to be functional.
  • FIXME(name): implies that the method/function/etc shouldn't be used until that code is resolved and bug fixed.

Logging

Use the common logging module, and ensure you getLogger:

from keystone.openstack.common import log

LOG = log.getLogger(__name__)

LOG.debug('Foobar')

AssertEqual argument order

assertEqual method's arguments should be in ('expected', 'actual') order.