Checklist
| Sl.No | Checkpoints |
|---|---|
| A | Naming Convention |
| A.1 | All Command files will have a prefix kobman-XXXX.sh and XXXX must be the command name |
| A.2 | All Environment files will have a prefix kobman-XXXXX.sh and XXXXX must be the environment name |
| A.3 | All Internal kobman functions that will be called in other kob scripts must begin with __kob |
| A.4 | All function names should have meaningful names which denote what they are intended to do |
| A.5 | All kobman environment scripts should have standard set of functions included in them and follow the following naming convention __kob_XXXX_YYYY() function where XXXX is the corresponding command and YYYY is the environment name For example, if the environment name is "yyyy", then the corresponding commands would look like:- __kobman_install_yyyy() __kobman_uninstall_yyyy() __kobman_update_yyyy() __kobman_upgrade_yyyy() __kobman_validate_yyyy() __kobman_start_yyyy() __kobman_stop_yyyy() |
| B | Variable definition & Scoping |
| B.1 | All environment variables should be in caps (eg kobman_VERSION) |
| B.2 | All export variables used in a script should be initiatlized in kobman-init.sh |
| B.3 | The environment variables should be invoked using export (in the beginning of the script) if they are intended to be used as is in the script |
| B.4 | All local variables should be in small letters (eg argument(1)) |
| B.5 | The scope of local variables newly introduced should be confined to the functions they are defined in or within the script they have been defined |
| B.6 | Any variable defined in a script which is to be reused in another script should be defined as Environment Variable |
| C | Function Usage |
| C.1 | __kobman_echo function should be used instead of echo to display messages in the script |
| C.2 | __kobman_echo_debug function should be used to display specific error message in the script |
| C.3 | Functions to return -1 if they encounter any error during execution or don't satisfy the condition being validated or processed |
| C.4 | Return code from function execution other than 0 to be processed for exiting from script |
| D | Test Scripts |
| D.1 | All command scripts should have their correspondiing test scripts available for verification purpose and be made available along with code changes during code submission |
| D.2 | All environment scripts should have their corresponding test scripts available for verification purpose and be made available along with code changes during code submission |
| D.3 | All test scripts should have the following standard set of functions included in them :– test_kob_init() __test_kob_execute() test_kob_validate() test_kob_cleanup() test_kob_run() |
| E | Raising Pull Request |
| E.1 | Pull request should be raised only after the code has been tested in the local environment by the developer, code reviewed & feedback comments closed by the developer |
| E.2 | Code reviewers should raise pull request against the developer's repository to share feedback comments |
| E.3 | Proper comments should be given explaining the changes in the code at a high level while raising the pull request |
| E.4 | Verify if code can be optimized further - * Remove indented if else loops with appropriate case statements * Group lines of code into a function (if they are intended to achieve a specific objective) * Reuse of existing defined functions than creating newer functions |