docs: def parse_docopt_string(docopt_string):
      """returns a 2-tuple (usage, options)"""
      from re import match, DOTALL
      only_usage_pattern = r"""\s+Usage:\s+(?P<usage>.*)\s+"""
      usage_and_options_pattern = r"""\s+Usage:\s+(?P<usage>.*)\s+Options:\s+(?P<options>.*)\s+"""
      usage, options = '', ''
      if match(usage_and_options_pattern, docopt_string, DOTALL):
          usage = match(usage_and_options_pattern, docopt_string, DOTALL).groupdict()['usage']
          options = match(usage_and_options_pattern, docopt_string, DOTALL).groupdict()['options']
      elif match(only_usage_pattern, docopt_string, DOTALL):
          usage = match(only_usage_pattern, docopt_string, DOTALL).groupdict()['usage']
      return usage, options