Files
python-saharaclient/HACKING.rst
Ngo Quoc Cuong 6b2fa6adb6 Clone sahara hacking checks to saharaclient
These such rules are:
- [S366, S367] Organize your imports according to the ``Import order``
- [S368] Must use a dict comprehension instead of a dict constructor with
         a sequence of key-value pairs.
- [S373] Don't translate logs
- [S375] Use jsonutils from oslo_serialization instead of json

Change-Id: I909da6772f733e8282a8f304b829aab9b25d6203
2017-07-18 22:37:08 -04:00

46 lines
1.3 KiB
ReStructuredText

Sahara Style Commandments
=========================
- Step 1: Read the OpenStack Style Commandments
https://docs.openstack.org/hacking/latest/
- Step 2: Read on
Sahara Specific Commandments
----------------------------
Commit Messages
---------------
Using a common format for commit messages will help keep our git history
readable. Follow these guidelines:
- [S365] First, provide a brief summary of 50 characters or less. Summaries
of greater than 72 characters will be rejected by the gate.
- [S364] The first line of the commit message should provide an accurate
description of the change, not just a reference to a bug or blueprint.
Imports
-------
- [S366, S367] Organize your imports according to the ``Import order``
Dictionaries/Lists
------------------
- [S360] Ensure default arguments are not mutable.
- [S368] Must use a dict comprehension instead of a dict constructor with a
sequence of key-value pairs. For more information, please refer to
http://legacy.python.org/dev/peps/pep-0274/
Logs
----
- [S373] Don't translate logs
- [S374] You used a deprecated log level
Importing json
--------------
- [S375] It's more preferable to use ``jsonutils`` from ``oslo_serialization``
instead of ``json`` for operating with ``json`` objects.