Ticket 48795 - Make various improvements to create_test.py
    
    Description:  Made the following improvements to the create_test.py script:
                      - Added a new line at the end of the generated script (pep8)
                      - Fixed the way replication agreement names were generated
                      - Added docstrings where needed (sphinx documentation)
                      - Added a new DEBUGGING flag that if set stops instances
                        instead of removing them, sets "verbose=True" for Dirsrv
                        objects, and adds an area where debugging steps can be set.
    
    https://fedorahosted.org/389/ticket/48795
    
    Reviewed by: spichugi(Thanks!)
    
    (cherry picked from commit 17f30c60cfdbd6b4f7a68f93ad0f9b6f0d8c52f5)
    (cherry picked from commit b69db2aba462fa504724f933b7f70104be0e019b)