1

"""

     2

    Main entry point for the command-line interface

     3

"""

     4

     6

     7

from optparse import OptionParser

     8

import os.path

     9

    17

def build_config () :

    18

    """

    19

        Build the default configuration to use

    20

    """

    21

    22

    return config.Configuration()

    23

    25

    """

    27

    """

    28

    29

    parser = OptionParser(prog=exec_name, description="Degal - A photo gallery", version="Degal %s" % version.VERSION_STRING)

    30

    32

    parser.add_option('-C', "--config",         metavar='PATH', dest="_load_config_path",

    33

            help="Load configuration from PATH")

    34

    35

    parser.add_option('-H', "--gallery-path",   metavar='DIR',

    36

            help="Use DIR as the Gallery path instead of the CWD")

    37

    38

    parser.add_option("--with-exif",            action="store_true",

    39

            help="Include Exif metadata in updated .html files")

    40

    41

    parser.add_option("--exif-handler",         metavar='NAME', dest="exif_handler_name",

    42

            help="Use named Exif handler: pyexiv2, EXIFpy")

    43

    44

    parser.add_option('-c', "--thread-count",   metavar='COUNT', type="int",

    45

            help="Use COUNT threads for concurrent tasks")

    46

    47

    parser.add_option('-d', "--debug",          action="store_const", dest="log_level", const=config.logging.DEBUG,

    48

            help="Show debug output")

    49

    50

    parser.add_option('-q', "--quiet",          action="store_const", dest="log_level", const=config.logging.WARN,

    51

            help="Reduced output (only warnings)")

    52

    56

    return parser

    57

    58

def parse_args (config, parser, args) :

    59

    """

    60

        Parse command-line options/arguments.

    61

    62

        Returns the remaining positional arguments.

    63

    """

    64

    65

    # parse the given arguments, storing output directly in the config

    66

    _, args = parser.parse_args(args=args, values=config)

    67

    68

    # return the posargs

    69

    return args

    70

    71

def postprocess_config (config) :

    72

    """

    73

        Post-process our Configuration after our command-line arguments have been parsed.

    74

    75

        This will attempt to load any additional configuration.

    76

    """

    77

    78

    # figure out what, if any, path to import

    79

    if hasattr(config, '_load_config_path') :

    80

        path = config._load_config_path

    81

    82

    elif os.path.exists('degal.cfg') :

    83

        path = 'degal.cfg'

    84

    85

    else :

    86

        return

    87

    88

    # import it

    89

    config.import_file(path)

    90

    91

def load_gallery (config) :

    92

    """

    93

        Create the Gallery object that we are manipulating

    94

    """

    95

    96

    # read path from config

    97

    return gallery.Gallery(config.gallery_path, config)

    98

    99

def main (argv) :

   100

    """

   101

        Main entry point

   102

    """

   103

   104

    ## load commands

   106

   107

    # build our default config

   108

    config = build_config()

   113

   114

    # build optparser

   116

   117

    # parse the args into our config

   118

    args = parse_args(config, parser, argv[1:])

   119

   120

    # postprocess

   121

    postprocess_config(config)

   122

   123

    # open gallery

   124

    gallery = load_gallery(config)

   125

   126

    # run the selected command

   129

   130

   131

    if ret is None :

   132

        # success

   133

        return 0

   134

   135

    else :

   136

        # exit with error code

   137

        assert isinstance(ret, int)

   138

        return ret

   139