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!)