1

"""

     2

    Main entry point for the command-line interface

     3

"""

     4

     5

import gallery, commands, config as config_module

     6

     7

from optparse import OptionParser

     8

     9

def option_parser (command_name) :

    10

    """

    11

        Build the OptionParser that we use

    12

    """

    13

    14

    # create parser using the given command

    15

    parser = OptionParser(prog=command_name)

    16

    17

    # define options

    18

    parser.add_option('-G', "--gallery-path",   metavar='DIR',  dest='gallery_path',    default=None,

    19

            help="Use DIR as the Gallery path [default: CWD]")

    20

    21

    parser.add_option('-F', "--force-update",   dest='force_update', action="store_true", default=False,

    22

            help="--force-thumb + --force-html")

    23

    24

    parser.add_option("--force-thumb",          dest='force_thumb', action="store_true", default=False,

    25

            help="Force-update all thumbnails")

    26

    27

    parser.add_option("--force-html",           dest='force_html', action="store_true", default=False,

    28

            help="Force-update all .html files")

    29

    30

    parser.add_option('-d', "--debug",          dest='debug', action="store_true", default=False,

    31

            help="Show debug output")

    32

    33

    parser.add_option('-q', "--quiet",           dest='quiet', action="store_true", default=False,

    34

            help="Reduced output")

    35

    36

    return parser

    37

    38

def build_config (options) :

    39

    """

    40

        Build a configuration object with the given options

    41

    """

    42

    43

    # build default config

    44

    config = config_module.Configuration()

    45

    46

    # apply options

    47

    if options.gallery_path :

    48

        config.gallery_path = options.gallery_path

    49

    50

    if options.force_update :

    51

        config.force_html = True

    52

        config.force_thumb = True

    53

    54

    if options.force_thumb :

    55

        config.force_thumb = True

    56

    57

    if options.force_html :

    58

        config.force_html = True

    59

    60

    if options.debug :

    61

        config.log_level = config_module.logging.DEBUG

    62

    63

    if options.quiet :

    64

        config.log_level = config_module.logging.WARN

    65

    66

    # XXX: load config file(s)

    67

    68

    return config

    69

    70

def load_gallery (config) :

    71

    """

    72

        Create the Gallery object that we are manipulating

    73

    """

    74

    75

    # read path from config

    76

    return gallery.Gallery(config.gallery_path, config)

    77

    78

def load_command (config, args) :

    79

    """

    80

        Figure out what command to run and with what args

    81

    """

    82

    83

    # XXX: hardcoded

    84

    return commands.main, args, {}

    85

    86

def run_command (config, gallery, command, args, kwargs) :

    87

    """

    88

        Run the given command

    89

    """

    90

    91

    # setup the command execution context

    92

    command_ctx = command.setup(config, gallery)

    93

    94

    # run with error handling

    95

    return command_ctx.run()

    96

    97

def main (argv) :

    98

    """

    99

        Main entry point

   100

    """

   101

   102

    ## load commands

   103

    #commands = load_commands()

   104

   105

    # build optparser

   106

    parser = option_parser(argv[0])

   107

   108

    # parse the given argv

   109

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

   110

   111

    # build our config

   112

    config = build_config(options)

   113

   114

    # open gallery

   115

    gallery = load_gallery(config)

   116

   117

    # figure out what command to run

   118

    command, args, kwargs = load_command(config, args)

   119

   120

    # run the selected command

   121

    ret = run_command(config, gallery, command, args, kwargs)

   122

   123

    if ret is None :

   124

        # success

   125

        return 0

   126

   127

    else :

   128

        # exit with error code

   129

        assert isinstance(ret, int)

   130

        return ret

   131