/usr/lib/python2.7/dist-packages/gphoto2cffi/backend.py is in python-gphoto2cffi 0.3~a1-1.
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)
|