1

"""

     2

    Configuration

     3

"""

     4

     5

import copy, logging

     6

     7

class InstanceContext (object) :

     8

    """

     9

        An object that behaves like a dict, performing all item lookups as attribute lookups on the given object.

    10

    11

        Useful for binding an exec statement's locals.

    12

    """

    13

    14

    def __init__ (self, obj) : self.obj = obj

    15

    def __getitem__ (self, key) : return getattr(self.obj, key)

    16

    def __setitem__ (self, key, value) : setattr(self.obj, key, value)

    17

    18

class ConfigurationMachinery (object) :

    19

    """

    20

        The low-level configuration machinery.

    21

    """

    22

    23

    def import_py (self, path) :

    24

        """

    25

            Import python-style configuration from the given File object into this one.

    26

    27

            This runs the file's code using exec, using a context mapped to this object.

    28

        """

    29

    30

        # the code

    31

        file = open(path)

    32

    33

        # build suitable locals/globals to proxy this object

    34

        locals = InstanceContext(self)

    35

    36

        # run

    37

        exec file in {}, locals

    38

    39

    def import_file (self, path) :

    40

        """

    41

            Import configuration from the given File into this one.

    42

        """

    43

    44

        # as python code

    45

        self.import_py(path)

    46

    47

    def load (self, path) :

    48

        """

    49

            Loads the configuration from the given File, creating a new Configuration with defaults from this one.

    50

        """

    51

    52

        # copy ourself

    53

        new = copy.copy(self)

    54

    55

        # import into it

    56

        new.import_file(path)

    57

    58

        # return

    59

        return new

    60

    61

class Configuration (ConfigurationMachinery) :

    62

    """

    63

        Various configuration settings

    64

    """

    65

    66

    # the path to the gallery root

    67

    # only valid in top-level config

    68

    gallery_path        = "."

    69

    70

    # force-update items

    71

    force_thumb         = False

    72

    force_html          = False

    73

    74

    def get_force_update (self) :

    75

        return self.force_thumb or self.force_html

    76

    77

    def set_force_update (self, value) :

    78

        self.force_thumb = self.force_html = value

    79

    80

    force_update = property(get_force_update, set_force_update)

    81

    82

    # minimum logging level

    83

    log_level           = logging.INFO

    84

    85

    def quiet (self) : self.log_level = logging.WARN

    86

    def debug (self) : self.log_level = logging.DEBUG

    87

    88

    # number of threads to use for concurrency

    89

    thread_count        = 2

    90

    91

    # the name of this folder, only applies on one level

    92

    # default applies to the root gallery

    93

    title               = "Image Gallery"

    94

    95

    # recognized image extensions, case-insensitive

    96

    image_exts          = ('jpg', 'jpeg', 'png', 'gif', 'bmp')

    97

    98

    # subdirectory names used for generated thumbnails/previews

    99

    thumb_dir           = 'thumbs'

   100

    preview_dir         = 'previews'

   101

   102

    # size of generated thumbnails/previews as (width, height) tuples

   103

    thumb_size          = (160, 120)

   104

    preview_size        = (640, 480)

   105

   106

    # number of images displayed per folder page

   107

    images_per_page     = 50

   108

   109

    # load Exif data for images, this may be slow

   110

    with_exif           = False

   111

   118

    # exif tags used in output

   119

    # Copyright (C) 2008, Santtu Pajukanta <santtu@pajukanta.fi>

   120

    # XXX: import from dexif?

   121

    exif_tags           = (

   122

        # TODO Create date is in a useless format, needs some strptime love

   123

        ("CreateDate",              "Create date"               ),

   124

        ("Model",                   "Camera model"              ),

   125

        ("Aperture",                "Aperture"                  ),

   126

        ("ExposureMode",            "Exposure mode"             ),

   127

        ("ExposureCompensation",    "Exposure compensation"     ),

   128

        ("ExposureTime",            "Exposure time"             ),

   129

        ("Flash",                   "Flash mode"                ),

   130

        ("ISO",                     "ISO"                       ),

   131

        ("ShootingMode",            "Shooting mode"             ),

   132

        ("LensType",                "Lens type"                 ),

   133

        ("FocalLength",             "Focal length"              ),

   134

    )

   135

   136

    # XXX: move elsewhere?

   137

    def is_image (self, file) :

   138

        """

   139

            Tests if the given File is an image, based on its file extension

   140

   141

        """

   142

   143

        return file.matchext(self.image_exts)

   144