This file is indexed.

/usr/lib/python2.7/dist-packages/gphoto2cffi/backend.py is in python-gphoto2cffi 0.3~a1-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
import logging

from enum import IntEnum

from . import errors
from _backend import ffi, lib as _lib


#: Root logger that all other libgphoto2 loggers are children of
LOGGER = logging.getLogger("libgphoto2")


#: Mapping from libgphoto2 file type constants to human-readable strings.
FILE_TYPES = {
    'normal': _lib.GP_FILE_TYPE_NORMAL,
    'exif': _lib.GP_FILE_TYPE_EXIF,
    'metadata': _lib.GP_FILE_TYPE_METADATA,
    'preview': _lib.GP_FILE_TYPE_PREVIEW,
    'raw': _lib.GP_FILE_TYPE_RAW,
    'audio': _lib.GP_FILE_TYPE_AUDIO}


#: Mapping from libgphoto2 types to their appropriate constructor functions.
CONSTRUCTORS = {
    "Camera":       _lib.gp_camera_new,
    "GPPortInfo":   _lib.gp_port_info_new,
    "CameraList":   _lib.gp_list_new,
    "CameraAbilitiesList": _lib.gp_abilities_list_new,
    "GPPortInfoList": _lib.gp_port_info_list_new}


#: Mapping from libgphoto2 widget type constants to human-readable strings
WIDGET_TYPES = {
    _lib.GP_WIDGET_MENU:     "selection",
    _lib.GP_WIDGET_RADIO:    "selection",
    _lib.GP_WIDGET_TEXT:     "text",
    _lib.GP_WIDGET_RANGE:    "range",
    _lib.GP_WIDGET_DATE:     "date",
    _lib.GP_WIDGET_TOGGLE:   "toggle",
    _lib.GP_WIDGET_WINDOW:   "window",
    _lib.GP_WIDGET_SECTION:  "section"}


#: Mapping from libgphoto2 logging levels to Python logging levels.
LOG_LEVELS = {
    _lib.GP_LOG_ERROR:   logging.ERROR,
    _lib.GP_LOG_VERBOSE: logging.INFO,
    _lib.GP_LOG_DEBUG:   logging.DEBUG}


FILE_OPS = IntEnum(b'FileOperations', {
    'remove': _lib.GP_FILE_OPERATION_DELETE,
    'extract_preview': _lib.GP_FILE_OPERATION_PREVIEW,
    'extract_raw': _lib.GP_FILE_OPERATION_RAW,
    'extract_audio': _lib.GP_FILE_OPERATION_AUDIO,
    'extract_exif': _lib.GP_FILE_OPERATION_EXIF})


CAM_OPS = IntEnum(b'CameraOperations', {
    'capture_image': _lib.GP_OPERATION_CAPTURE_IMAGE,
    'capture_video': _lib.GP_OPERATION_CAPTURE_VIDEO,
    'capture_audio': _lib.GP_OPERATION_CAPTURE_AUDIO,
    'capture_preview': _lib.GP_OPERATION_CAPTURE_PREVIEW,
    'update_config': _lib.GP_OPERATION_CONFIG,
    'trigger_capture': _lib.GP_OPERATION_TRIGGER_CAPTURE})


DIR_OPS = IntEnum(b'DirectoryOperations', {
    'remove': _lib.GP_FOLDER_OPERATION_REMOVE_DIR,
    'create': _lib.GP_FOLDER_OPERATION_MAKE_DIR,
    'delete_all': _lib.GP_FOLDER_OPERATION_DELETE_ALL,
    'upload': _lib.GP_FOLDER_OPERATION_PUT_FILE})


def _logging_callback(level, domain, message, data):
    """ Callback that outputs libgphoto2's logging message via
        Python's standard logging facilities.

    :param level:   libgphoto2 logging level
    :param domain:  component the message originates from
    :param message: logging message
    :param data:    Other data in the logging record (unused)
    """
    domain = ffi.string(domain).decode()
    message = ffi.string(message).decode()
    logger = LOGGER.getChild(domain)

    if level not in LOG_LEVELS:
        return
    logger.log(LOG_LEVELS[level], message)


class LibraryWrapper(object):
    NO_ERROR_CHECK = (
        "gp_log_add_func",
        "gp_context_new",
        "gp_list_count",
        "gp_result_as_string",
        "gp_library_version",)

    def __init__(self, to_wrap):
        """ Wrapper around our FFI object that performs error checking.

        Wraps functions inside an anonymous function that checks the inner
        function's return code for libgphoto2 errors and throws a
        :py:class:`gphoto2.errors.GPhoto2Error` if needed.

        :param to_wrap:     FFI library to wrap
        """
        self._lib = to_wrap

    @staticmethod
    def _check_error(rval):
        """ Check a return value for a libgphoto2 error. """
        if rval < 0:
            raise errors.error_from_code(rval)
        else:
            return rval

    def __getattr__(self, name):
        val = getattr(self._lib, name)
        if not isinstance(val, int) and name not in self.NO_ERROR_CHECK:
            return lambda *a, **kw: self._check_error(val(*a, **kw))
        else:
            return val


# Register logging callback with FFI
logging_cb = ffi.callback(
    "void(GPLogLevel, const char*, const char*, void*)",
    _logging_callback)


#: The wrapped library
lib = LibraryWrapper(_lib)