ssokolow · January 8, 2022 17:43 · Jul 10, 2013 · Jul 8, 2011 · Jul 8, 2011 · Jul 21, 2009
diff --git a/boilerplate.py b/boilerplate.py
@@ -14,11 +14,17 @@
 
 if __name__ == '__main__':
     from optparse import OptionParser
-    parser = OptionParser(description=__doc__, version="%%prog v%s" % __version__)
+    parser = OptionParser(version="%%prog v%s" % __version__,
+            usage="%prog [options] <argument> ...",
+            description=__doc__.replace('\r\n', '\n').split('\n--snip--\n')[0])
     parser.add_option('-v', '--verbose', action="count", dest="verbose",
-        default=2, help="Increase the verbosity. Can be used twice for extra effect.")
+        default=2, help="Increase the verbosity. Use twice for extra effect")
     parser.add_option('-q', '--quiet', action="count", dest="quiet",
-        default=0, help="Decrease the verbosity. Can be used twice for extra effect.")
+        default=0, help="Decrease the verbosity. Use twice for extra effect")
+    #Reminder: %default can be used in help strings.
+
+    # Allow pre-formatted descriptions
+    parser.formatter.format_description = lambda description: description
 
     opts, args  = parser.parse_args()
 

diff --git a/boilerplate.py b/boilerplate.py
@@ -17,7 +17,7 @@
     parser = OptionParser(description=__doc__, version="%%prog v%s" % __version__)
     parser.add_option('-v', '--verbose', action="count", dest="verbose",
         default=2, help="Increase the verbosity. Can be used twice for extra effect.")
-    parser.add_option('-q', '--verbose', action="count", dest="quiet",
+    parser.add_option('-q', '--quiet', action="count", dest="quiet",
         default=0, help="Decrease the verbosity. Can be used twice for extra effect.")
 
     opts, args  = parser.parse_args()

diff --git a/Python Boilerplate b/Python Boilerplate
@@ -1,21 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""[application description here]"""
-
-__appname__ = "[application name here]"
-__author__  = "Stephan Sokolow (deitarion/SSokolow)"
-__version__ = "0.0pre0"
-__license__ = "GNU GPL 3.0 or later"
-
-import logging
-logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s')
-
-# -- Code Here --
-
-if __name__ == '__main__':
-    from optparse import OptionParser
-    parser = OptionParser(description=__doc__, version="%%prog v%s" % __version__)
-    #parser.add_option('-v', '--verbose', action="store_true", dest="verbose",
-    #    default=False, help="Increase verbosity")
-
-    opts, args = parser.parse_args()

diff --git a/boilerplate.py b/boilerplate.py
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""[application description here]"""
+
+__appname__ = "[application name here]"
+__author__  = "Stephan Sokolow (deitarion/SSokolow)"
+__version__ = "0.0pre0"
+__license__ = "GNU GPL 3.0 or later"
+
+import logging
+log = logging.getLogger(__name__)
+
+# -- Code Here --
+
+if __name__ == '__main__':
+    from optparse import OptionParser
+    parser = OptionParser(description=__doc__, version="%%prog v%s" % __version__)
+    parser.add_option('-v', '--verbose', action="count", dest="verbose",
+        default=2, help="Increase the verbosity. Can be used twice for extra effect.")
+    parser.add_option('-q', '--verbose', action="count", dest="quiet",
+        default=0, help="Decrease the verbosity. Can be used twice for extra effect.")
+
+    opts, args  = parser.parse_args()
+
+    # Set up clean logging to stderr
+    log_levels = [logging.CRITICAL, logging.ERROR, logging.WARNING,
+                  logging.INFO, logging.DEBUG]
+    opts.verbose = min(opts.verbose - opts.quiet, len(log_levels) - 1)
+    opts.verbose = max(opts.verbose, 0)
+    logging.basicConfig(level=log_levels[opts.verbose],
+                        format='%(levelname)s: %(message)s')
+
diff --git a/Python Boilerplate b/Python Boilerplate
@@ -0,0 +1,21 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""[application description here]"""
+
+__appname__ = "[application name here]"
+__author__  = "Stephan Sokolow (deitarion/SSokolow)"
+__version__ = "0.0pre0"
+__license__ = "GNU GPL 3.0 or later"
+
+import logging
+logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s')
+
+# -- Code Here --
+
+if __name__ == '__main__':
+    from optparse import OptionParser
+    parser = OptionParser(description=__doc__, version="%%prog v%s" % __version__)
+    #parser.add_option('-v', '--verbose', action="store_true", dest="verbose",
+    #    default=False, help="Increase verbosity")
+
+    opts, args = parser.parse_args()