]> git.decadent.org.uk Git - dak.git/commitdiff
* dak/edit_transitions.py: Add --import option.
authorAnthony Towns <aj@azure.humbug.org.au>
Fri, 21 Mar 2008 19:54:07 +0000 (19:54 +0000)
committerAnthony Towns <aj@azure.humbug.org.au>
Fri, 21 Mar 2008 19:54:07 +0000 (19:54 +0000)
        Add --use-sudo option. Use fcntl locking for writing.
        Move writing into a function (write_transitions).
        Reinvoke self using sudo and --import if necessary.
        Move temporary file creation into a function, use mkstemp.
        Rename to "dak transitions".

ChangeLog
dak/dak.py
dak/edit_transitions.py [deleted file]
dak/transitions.py [new file with mode: 0755]

index 8766c80f35906c88722ebd9ac7b7bff4d04c1094..558c635c9eeec65783a78f48c0cda6e057424a50 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2008-03-22  Anthony Towns  <ajt@debian.org>
+
+       * dak/edit_transitions.py: Add --import option.
+       Add --use-sudo option. Use fcntl locking for writing.
+       Move writing into a function (write_transitions).
+       Reinvoke self using sudo and --import if necessary.
+       Move temporary file creation into a function, use mkstemp.
+       Rename to "dak transitions".
+
 2008-03-21  Joerg Jaspert  <joerg@debian.org>
 
        * dak/edit_transitions.py (edit_transitions): Use sudo to copy the
index 43da4dcb0861c3ab9a3dc76ca0b76958e25401c2..0eeb9d7b80255ef47281933719f5c5919de9456f 100755 (executable)
@@ -92,8 +92,8 @@ def init():
         ("clean-proposed-updates",
          "Remove obsolete .changes from proposed-updates"),
 
-        ("edit-transitions",
-         "Edit the release transition file"),
+        ("transitions",
+         "Manage the release transition file"),
         ("check-overrides",
          "Override cruft checks"),
         ("check-proposed-updates",
diff --git a/dak/edit_transitions.py b/dak/edit_transitions.py
deleted file mode 100755 (executable)
index e283a46..0000000
+++ /dev/null
@@ -1,334 +0,0 @@
-#!/usr/bin/env python
-
-# Edit and then check the release managers transition file for correctness
-# and outdated transitions
-# Copyright (C) 2008 Joerg Jaspert <joerg@debian.org>
-
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-################################################################################
-
-# <elmo> if klecker.d.o died, I swear to god, I'm going to migrate to gentoo.
-
-################################################################################
-
-import os, pg, sys, time, errno
-import apt_pkg
-import daklib.database
-import daklib.utils
-import syck
-
-# Globals
-Cnf = None
-Options = None
-projectB = None
-
-################################################################################
-
-def init():
-    global Cnf, Options, projectB
-
-    apt_pkg.init()
-
-    Cnf = daklib.utils.get_conf()
-
-    Arguments = [('h',"help","Edit-Transitions::Options::Help"),
-                 ('e',"edit","Edit-Transitions::Options::Edit"),
-                 ('c',"check","Edit-Transitions::Options::check"),
-                 ('n',"no-action","Edit-Transitions::Options::No-Action")]
-
-    for i in ["help", "no-action", "edit", "check"]:
-        if not Cnf.has_key("Edit-Transitions::Options::%s" % (i)):
-            Cnf["Edit-Transitions::Options::%s" % (i)] = ""
-
-    apt_pkg.ParseCommandLine(Cnf, Arguments, sys.argv)
-
-    Options = Cnf.SubTree("Edit-Transitions::Options")
-
-    projectB = pg.connect(Cnf["DB::Name"], Cnf["DB::Host"], int(Cnf["DB::Port"]))
-    daklib.database.init(Cnf, projectB)
-    
-    if Options["help"]:
-        usage()
-
-################################################################################
-
-def usage (exit_code=0):
-    print """Usage: edit_transitions [OPTION]...
-  Check the release managers transition file for correctness and outdated transitions
-  -h, --help                show this help and exit.
-  -e, --edit                edit the transitions file
-  -c, --check               check the transitions file, remove outdated entries
-  -n, --no-action           don't do anything
-
-  Called without an option this tool will check the transition file for outdated
-  transitions and remove them."""
-    sys.exit(exit_code)
-
-################################################################################
-
-def lock_file(lockfile):
-    retry = 0
-    while retry < 10:
-        try:
-            lock_fd = os.open(lockfile, os.O_RDONLY | os.O_CREAT | os.O_EXCL)
-            retry = 10
-        except OSError, e:
-            if errno.errorcode[e.errno] == 'EACCES' or errno.errorcode[e.errno] == 'EEXIST':
-                retry += 1
-                if (retry >= 10):
-                    daklib.utils.fubar("Couldn't obtain lock for %s." % (lockfile) )
-                else:
-                    print("Unable to get lock for %s (try %d of 10)" % (lockfile, retry) )
-                    time.sleep(60)
-            else:
-                raise
-
-
-################################################################################
-
-def edit_transitions():
-    trans_file = Cnf["Dinstall::Reject::ReleaseTransitions"]
-
-    lockfile="/tmp/transitions.lock"
-    lock_file(lockfile)
-
-    tempfile = "./%s.transition.tmp" % (os.getpid() )
-
-    daklib.utils.copy(trans_file, tempfile)
-
-    editor = os.environ.get("EDITOR", "vi")
-
-    while True:
-        result = os.system("%s %s" % (editor, tempfile))
-        if result != 0:
-            os.unlink(tempfile)
-            os.unlink(lockfile)
-            daklib.utils.fubar("%s invocation failed for %s, not removing tempfile." % (editor, tempfile))
-    
-        # Now try to load the new file
-        test = load_transitions(tempfile)
-
-        if test == None:
-            # Edit is broken
-            answer = "XXX"
-            prompt = "Broken edit: [E]dit again, Drop changes?"
-
-            while prompt.find(answer) == -1:
-                answer = daklib.utils.our_raw_input(prompt)
-                if answer == "":
-                    answer = "E"
-                answer = answer[:1].upper()
-
-            if answer == 'E':
-                continue
-            elif answer == 'D':
-                os.unlink(tempfile)
-                os.unlink(lockfile)
-                print "OK, discarding changes"
-                sys.exit(0)
-        else:
-            # No problems in loading the new file, jump out of the while loop
-            break
-
-    # We seem to be done and also have a working file. Copy over.
-    # We are not using daklib.utils.copy here, as we use sudo to get this file copied, to
-    # limit the rights needed to edit transitions
-    os.spawnl(os.P_WAIT, "/usr/bin/sudo", "/usr/bin/sudo", "-u", "dak", "-H", 
-              "cp", tempfile, trans_file)
-
-    os.unlink(tempfile)
-    os.unlink(lockfile)
-
-    # Before we finish print out transition info again
-    print "\n\n------------------------------------------------------------------------"
-    print "Edit done, file saved, currently defined transitions:\n"
-    transitions = load_transitions(Cnf["Dinstall::Reject::ReleaseTransitions"])
-    transition_info(transitions)
-
-################################################################################
-
-def load_transitions(trans_file):
-    # Parse the yaml file
-    sourcefile = file(trans_file, 'r')
-    sourcecontent = sourcefile.read()
-    try:
-        trans = syck.load(sourcecontent)
-    except syck.error, msg:
-        # Someone fucked it up
-        print "ERROR: %s" % (msg)
-        return None
-    return trans
-
-################################################################################
-
-def print_info(trans, source, expected, rm, reason, packages):
-        print """
-Looking at transition: %s
- Source:      %s
- New Version: %s
- Responsible: %s
- Description: %s
- Blocked Packages (total: %d): %s
-""" % (trans, source, expected, rm, reason, len(packages), ", ".join(packages))
-        return
-
-################################################################################
-
-def transition_info(transitions):
-    for trans in transitions:
-        t = transitions[trans]
-        source = t["source"]
-        expected = t["new"]
-
-        # Will be None if nothing is in testing.
-        current = daklib.database.get_suite_version(source, "testing")
-
-        print_info(trans, source, expected, t["rm"], t["reason"], t["packages"])
-
-        if current == None:
-            # No package in testing
-            print "Transition source %s not in testing, transition still ongoing." % (source)
-        else:
-            compare = apt_pkg.VersionCompare(current, expected)
-            print "Apt compare says: %s" % (compare)
-            if compare < 0:
-                # This is still valid, the current version in database is older than
-                # the new version we wait for
-                print "This transition is still ongoing, we currently have version %s" % (current)
-            else:
-                print "This transition is over, the target package reached testing, should be removed"
-                print "%s wanted version: %s, has %s" % (source, expected, current)
-        print "-------------------------------------------------------------------------"
-
-################################################################################
-
-def check_transitions(transitions):
-    to_dump = 0
-    to_remove = []
-    # Now look through all defined transitions
-    for trans in transitions:
-        t = transitions[trans]
-        source = t["source"]
-        expected = t["new"]
-
-        # Will be None if nothing is in testing.
-        current = daklib.database.get_suite_version(source, "testing")
-
-        print_info(trans, source, expected, t["rm"], t["reason"], t["packages"])
-
-        if current == None:
-            # No package in testing
-            print "Transition source %s not in testing, transition still ongoing." % (source)
-        else:
-            compare = apt_pkg.VersionCompare(current, expected)
-            if compare < 0:
-                # This is still valid, the current version in database is older than
-                # the new version we wait for
-                print "This transition is still ongoing, we currently have version %s" % (current)
-            else:
-                print "REMOVE: This transition is over, the target package reached testing. REMOVE"
-                print "%s wanted version: %s, has %s" % (source, expected, current)
-                to_remove.append(trans)
-                to_dump = 1
-        print "-------------------------------------------------------------------------"
-
-    if to_dump:
-        prompt = "Removing: "
-        for remove in to_remove:
-            prompt += remove
-            prompt += ","
-
-        prompt += " Commit Changes? (y/N)"
-        answer = ""
-
-        if Options["no-action"]:
-            answer="n"
-        else:
-            answer = daklib.utils.our_raw_input(prompt).lower()
-
-        if answer == "":
-            answer = "n"
-
-        if answer == 'n':
-            print "Not committing changes"
-            sys.exit(0)
-        elif answer == 'y':
-            print "Committing"
-            for remove in to_remove:
-                del transitions[remove]
-
-            lockfile="/tmp/transitions.lock"
-            lock_file(lockfile)
-            tempfile = "./%s.transition.tmp" % (os.getpid() )
-
-            destfile = file(tempfile, 'w')
-            syck.dump(transitions, destfile)
-            destfile.close()
-
-            os.spawnl(os.P_WAIT, "/usr/bin/sudo", "/usr/bin/sudo", "-u", "dak", "-H", 
-                      "cp", tempfile, Cnf["Dinstall::Reject::ReleaseTransitions"])
-
-            os.unlink(tempfile)
-            os.unlink(lockfile)
-            print "Done"
-        else:
-            print "WTF are you typing?"
-            sys.exit(0)
-
-################################################################################
-
-def main():
-    global Cnf
-
-    init()
-    
-    # Only check if there is a file defined (and existant) with checks. It's a little bit
-    # specific to Debian, not much use for others, so return early there.
-    if not Cnf.has_key("Dinstall::Reject::ReleaseTransitions") or not os.path.exists("%s" % (Cnf["Dinstall::Reject::ReleaseTransitions"])):
-        daklib.utils.warn("Dinstall::Reject::ReleaseTransitions not defined or file %s not existant." %
-                          (Cnf["Dinstall::Reject::ReleaseTransitions"]))
-        sys.exit(1)
-    
-    # Parse the yaml file
-    transitions = load_transitions(Cnf["Dinstall::Reject::ReleaseTransitions"])
-    if transitions == None:
-        # Something very broken with the transitions, exit
-        daklib.utils.warn("Not doing any work, someone fucked up the transitions file outside our control")
-        sys.exit(2)
-
-    if Options["edit"]:
-        # Output information about the currently defined transitions.
-        print "Currently defined transitions:"
-        transition_info(transitions)
-        daklib.utils.our_raw_input("Press enter to continue...")
-
-        # Lets edit the transitions file
-        edit_transitions()
-    elif Options["check"]:
-        # Check and remove outdated transitions
-        check_transitions(transitions)
-    else:
-        # Output information about the currently defined transitions.
-        transition_info(transitions)
-
-        # Nothing requested, doing nothing besides the above display of the transitions
-        sys.exit(0)
-    
-
-################################################################################
-
-if __name__ == '__main__':
-    main()
diff --git a/dak/transitions.py b/dak/transitions.py
new file mode 100755 (executable)
index 0000000..a38ab26
--- /dev/null
@@ -0,0 +1,370 @@
+#!/usr/bin/env python
+
+# Display, edit and check the release manager's transition file.
+# Copyright (C) 2008 Joerg Jaspert <joerg@debian.org>
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+################################################################################
+
+# <elmo> if klecker.d.o died, I swear to god, I'm going to migrate to gentoo.
+
+################################################################################
+
+import os, pg, sys, time, errno, fcntl, tempfile
+import apt_pkg
+import daklib.database
+import daklib.utils
+import syck
+
+# Globals
+Cnf = None
+Options = None
+projectB = None
+
+################################################################################
+
+def init():
+    global Cnf, Options, projectB
+
+    apt_pkg.init()
+
+    Cnf = daklib.utils.get_conf()
+
+    Arguments = [('h',"help","Edit-Transitions::Options::Help"),
+                 ('e',"edit","Edit-Transitions::Options::Edit"),
+                 ('i',"import","Edit-Transitions::Options::Import", "HasArg"),
+                 ('c',"check","Edit-Transitions::Options::Check"),
+                 ('S',"use-sudo","Edit-Transitions::Options::Sudo"),
+                 ('n',"no-action","Edit-Transitions::Options::No-Action")]
+
+    for i in ["help", "no-action", "edit", "import", "check", "sudo"]:
+        if not Cnf.has_key("Edit-Transitions::Options::%s" % (i)):
+            Cnf["Edit-Transitions::Options::%s" % (i)] = ""
+
+    apt_pkg.ParseCommandLine(Cnf, Arguments, sys.argv)
+
+    Options = Cnf.SubTree("Edit-Transitions::Options")
+
+    projectB = pg.connect(Cnf["DB::Name"], Cnf["DB::Host"], int(Cnf["DB::Port"]))
+    daklib.database.init(Cnf, projectB)
+    
+    if Options["help"]:
+        usage()
+
+################################################################################
+
+def usage (exit_code=0):
+    print """Usage: edit_transitions [OPTION]...
+Update and check the release managers transition file.
+transitions.
+
+Options:
+
+  -h, --help                show this help and exit.
+  -e, --edit                edit the transitions file
+  -i, --import <file>       check and import transitions from file
+  -c, --check               check the transitions file, remove outdated entries
+  -S, --sudo                use sudo to update transitions file
+  -n, --no-action           don't do anything"""
+
+    sys.exit(exit_code)
+
+################################################################################
+
+def load_transitions(trans_file):
+    # Parse the yaml file
+    sourcefile = file(trans_file, 'r')
+    sourcecontent = sourcefile.read()
+    try:
+        trans = syck.load(sourcecontent)
+    except syck.error, msg:
+        # Someone fucked it up
+        print "ERROR: %s" % (msg)
+        return None
+    # could do further validation here
+    return trans
+
+################################################################################
+
+def lock_file(file):
+    for retry in range(10):
+        lock_fd = os.open(file, os.O_RDWR | os.O_CREAT)
+        try:
+            fcntl.lockf(lock_fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
+            return lock_fd
+        except OSError, e:
+            if errno.errorcode[e.errno] == 'EACCES' or errno.errorcode[e.errno] == 'EEXIST':
+                print "Unable to get lock for %s (try %d of 10)" % \
+                        (file, retry+1)
+                time.sleep(60)
+            else:
+                raise
+
+    daklib.utils.fubar("Couldn't obtain lock for %s." % (lockfile))
+
+################################################################################
+
+def write_transitions(from_trans):
+    """Update the active transitions file safely.
+       This function takes a parsed input file (which avoids invalid
+       files or files that may be be modified while the function is
+       active), and ensure the transitions file is updated atomically
+       to avoid locks."""
+
+    trans_file = Cnf["Dinstall::Reject::ReleaseTransitions"]
+    trans_temp = trans_file + ".tmp"
+  
+    trans_lock = lock_file(trans_file)
+    temp_lock  = lock_file(trans_temp)
+
+    destfile = file(trans_temp, 'w')
+    syck.dump(from_trans, destfile)
+    destfile.close()
+
+    os.rename(trans_temp, trans_file)
+    os.close(temp_lock)
+    os.close(trans_lock)
+
+################################################################################
+
+class ParseException(Exception):
+    pass
+
+def write_transitions_from_file(from_file):
+    """We have a file we think is valid; if we're using sudo, we invoke it
+       here, otherwise we just parse the file and call write_transitions"""
+
+    if Options["sudo"]:
+        os.spawnl(os.P_WAIT, "/usr/bin/sudo", "/usr/bin/sudo", "-u", "dak", "-H", 
+              "/usr/local/bin/dak", "edit-transitions", "--import", from_file)
+    else:
+        trans = load_transitions(from_file)
+        if trans is None:
+            raise ParseException, "Unparsable transitions file %s" % (file)
+        write_transitions(trans)
+
+################################################################################
+
+def temp_transitions_file(transitions):
+    # NB: file is unlinked by caller, but fd is never actually closed.
+
+    (fd, path) = tempfile.mkstemp("","transitions")
+    f = open(path, "w")
+    syck.dump(transitions, f)
+    return path
+
+################################################################################
+
+def edit_transitions():
+    trans_file = Cnf["Dinstall::Reject::ReleaseTransitions"]
+    edit_file = temp_transitions_file(load_transitions(trans_file))
+
+    editor = os.environ.get("EDITOR", "vi")
+
+    while True:
+        result = os.system("%s %s" % (editor, edit_file))
+        if result != 0:
+            os.unlink(edit_file)
+            daklib.utils.fubar("%s invocation failed for %s, not removing tempfile." % (editor, edit_file))
+    
+        # Now try to load the new file
+        test = load_transitions(edit_file)
+
+        if test == None:
+            # Edit is broken
+            answer = "XXX"
+            prompt = "Broken edit: [E]dit again, Drop changes?"
+
+            while prompt.find(answer) == -1:
+                answer = daklib.utils.our_raw_input(prompt)
+                if answer == "":
+                    answer = "E"
+                answer = answer[:1].upper()
+
+            if answer == 'E':
+                continue
+            elif answer == 'D':
+                os.unlink(edit_file)
+                print "OK, discarding changes"
+                sys.exit(0)
+        else:
+            # No problems in loading the new file, jump out of the while loop
+            break
+
+    # We seem to be done and also have a working file. Copy over.
+    write_transitions_from_file(edit_file)
+    os.unlink(edit_file)
+
+    # Before we finish print out transition info again
+    print "\n\n------------------------------------------------------------------------"
+    print "Edit done, file saved, currently defined transitions:\n"
+    transition_info(load_transitions(trans_file))
+
+################################################################################
+
+def check_transitions(transitions):
+    to_dump = 0
+    to_remove = []
+    # Now look through all defined transitions
+    for trans in transitions:
+        t = transitions[trans]
+        source = t["source"]
+        expected = t["new"]
+
+        # Will be None if nothing is in testing.
+        current = daklib.database.get_suite_version(source, "testing")
+
+        print_info(trans, source, expected, t["rm"], t["reason"], t["packages"])
+
+        if current == None:
+            # No package in testing
+            print "Transition source %s not in testing, transition still ongoing." % (source)
+        else:
+            compare = apt_pkg.VersionCompare(current, expected)
+            if compare < 0:
+                # This is still valid, the current version in database is older than
+                # the new version we wait for
+                print "This transition is still ongoing, we currently have version %s" % (current)
+            else:
+                print "REMOVE: This transition is over, the target package reached testing. REMOVE"
+                print "%s wanted version: %s, has %s" % (source, expected, current)
+                to_remove.append(trans)
+                to_dump = 1
+        print "-------------------------------------------------------------------------"
+
+    if to_dump:
+        prompt = "Removing: "
+        for remove in to_remove:
+            prompt += remove
+            prompt += ","
+
+        prompt += " Commit Changes? (y/N)"
+        answer = ""
+
+        if Options["no-action"]:
+            answer="n"
+        else:
+            answer = daklib.utils.our_raw_input(prompt).lower()
+
+        if answer == "":
+            answer = "n"
+
+        if answer == 'n':
+            print "Not committing changes"
+            sys.exit(0)
+        elif answer == 'y':
+            print "Committing"
+            for remove in to_remove:
+                del transitions[remove]
+    
+            edit_file = temp_transitions_file(transitions)
+            write_transitions_from_file(edit_file)
+
+            print "Done"
+        else:
+            print "WTF are you typing?"
+            sys.exit(0)
+
+################################################################################
+
+def print_info(trans, source, expected, rm, reason, packages):
+        print """
+Looking at transition: %s
+ Source:      %s
+ New Version: %s
+ Responsible: %s
+ Description: %s
+ Blocked Packages (total: %d): %s
+""" % (trans, source, expected, rm, reason, len(packages), ", ".join(packages))
+        return
+
+################################################################################
+
+def transition_info(transitions):
+    for trans in transitions:
+        t = transitions[trans]
+        source = t["source"]
+        expected = t["new"]
+
+        # Will be None if nothing is in testing.
+        current = daklib.database.get_suite_version(source, "testing")
+
+        print_info(trans, source, expected, t["rm"], t["reason"], t["packages"])
+
+        if current == None:
+            # No package in testing
+            print "Transition source %s not in testing, transition still ongoing." % (source)
+        else:
+            compare = apt_pkg.VersionCompare(current, expected)
+            print "Apt compare says: %s" % (compare)
+            if compare < 0:
+                # This is still valid, the current version in database is older than
+                # the new version we wait for
+                print "This transition is still ongoing, we currently have version %s" % (current)
+            else:
+                print "This transition is over, the target package reached testing, should be removed"
+                print "%s wanted version: %s, has %s" % (source, expected, current)
+        print "-------------------------------------------------------------------------"
+
+################################################################################
+
+def main():
+    global Cnf
+
+    init()
+    
+    # Check if there is a file defined (and existant)
+    transpath = Cnf.get("Dinstall::Reject::ReleaseTransitions", "")
+    if transpath == "":
+        daklib.utils.warn("Dinstall::Reject::ReleaseTransitions not defined")
+        sys.exit(1)
+    if not os.path.exists(transpath):
+        daklib.utils.warn("ReleaseTransitions file, %s, not found." %
+                          (Cnf["Dinstall::Reject::ReleaseTransitions"]))
+        sys.exit(1)
+   
+    if Options["import"]:
+        try:
+            write_transitions_from_file(Options["import"])
+        except ParseException, m:
+            print m
+            sys.exit(2)
+        sys.exit(0)
+
+    # Parse the yaml file
+    transitions = load_transitions(transpath)
+    if transitions == None:
+        # Something very broken with the transitions, exit
+        daklib.utils.warn("Could not parse existing transitions file. Aborting.")
+        sys.exit(2)
+
+    if Options["edit"]:
+        # Let's edit the transitions file
+        edit_transitions()
+    elif Options["check"]:
+        # Check and remove outdated transitions
+        check_transitions(transitions)
+    else:
+        # Output information about the currently defined transitions.
+        print "Currently defined transitions:"
+        transition_info(transitions)
+
+    sys.exit(0)
+    
+################################################################################
+
+if __name__ == '__main__':
+    main()