# -*- Mode:Python; indent-tabs-mode:nil; tab-width:4; encoding:utf-8 -*-
#
# Copyright 2014 Havard Gulldahl
#
# in part based on dpbxbackend.py:
# Copyright 2013 jno <jno@pisem.net>
#
# This file is part of duplicity.
#
# Duplicity is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2 of the License, or (at your
# option) any later version.
#
# Duplicity is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with duplicity; if not, write to the Free Software Foundation,
# Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
# stdlib
import logging
import posixpath
import duplicity.backend
# import duplicity stuff
from duplicity import log
from duplicity.errors import BackendException
[docs]def get_jotta_device(jfs):
jottadev = None
for j in jfs.devices: # find Jotta/Shared folder
if j.name == "Jotta":
jottadev = j
return jottadev
[docs]def get_root_dir(jfs):
jottadev = get_jotta_device(jfs)
root_dir = jottadev.mountPoints["Archive"]
return root_dir
[docs]def set_jottalib_logging_level(log_level):
logger = logging.getLogger("jottalib")
logger.setLevel(getattr(logging, log_level))
[docs]def set_jottalib_log_handlers(handlers):
logger = logging.getLogger("jottalib")
for handler in handlers:
logger.addHandler(handler)
[docs]def get_duplicity_log_level():
"""Get the current duplicity log level as a stdlib-compatible logging level"""
duplicity_log_level = log.LevelName(log.getverbosity())
# notice is a duplicity-specific logging level not supported by stdlib
if duplicity_log_level == "NOTICE":
duplicity_log_level = "INFO"
return duplicity_log_level
[docs]class JottaCloudBackend(duplicity.backend.Backend):
"""Connect to remote store using JottaCloud API"""
[docs] def __init__(self, parsed_url):
duplicity.backend.Backend.__init__(self, parsed_url)
# Import JottaCloud libraries.
try:
from jottalib import JFS
from jottalib.JFS import (
JFSNotFoundError,
JFSIncompleteFile,
)
except ImportError:
raise BackendException(
"JottaCloud backend requires jottalib" " (see https://pypi.python.org/pypi/jottalib)."
)
# Set jottalib loggers to the same verbosity as duplicity
duplicity_log_level = get_duplicity_log_level()
set_jottalib_logging_level(duplicity_log_level)
# Ensure jottalib and duplicity log to the same handlers
set_jottalib_log_handlers(log._logger.handlers)
# Will fetch jottacloud auth from environment or .netrc
self.client = JFS.JFS()
self.folder = self.get_or_create_directory(parsed_url.path.lstrip("/"))
log.Debug(f"Jottacloud folder for duplicity: {self.folder.path!r}")
[docs] def get_or_create_directory(self, directory_name):
root_directory = get_root_dir(self.client)
full_path = posixpath.join(root_directory.path, directory_name)
try:
return self.client.getObject(full_path)
except JFSNotFoundError:
return root_directory.mkdir(directory_name)
[docs] def _put(self, source_path, remote_filename):
# - Upload one file
# - Retried if an exception is thrown
resp = self.folder.up(source_path.open(), remote_filename)
log.Debug(f"jottacloud.put({source_path.name},{remote_filename}): {resp}")
[docs] def _get(self, remote_filename, local_path):
# - Get one file
# - Retried if an exception is thrown
remote_file = self.client.getObject(posixpath.join(self.folder.path, remote_filename))
log.Debug(f"jottacloud.get({remote_filename},{local_path.name}): {remote_file}")
with open(local_path.name, "wb") as to_file:
for chunk in remote_file.stream():
to_file.write(chunk)
[docs] def _list(self):
# - List all files in the backend
# - Return a list of filenames
# - Retried if an exception is thrown
return list(
[
f.name
for f in self.folder.files() # pylint: disable=no-value-for-parameter
if not f.is_deleted() and f.state != "INCOMPLETE"
]
)
[docs] def _delete(self, filename):
# - Delete one file
# - Retried if an exception is thrown
remote_path = posixpath.join(self.folder.path, filename)
remote_file = self.client.getObject(remote_path)
log.Debug(f"jottacloud.delete deleting: {remote_file} ({type(remote_file)})")
remote_file.delete()
[docs] def _query(self, filename):
"""Get size of filename"""
# - Query metadata of one file
# - Return a dict with a 'size' key, and a file size value (-1 for not found)
# - Retried if an exception is thrown
log.Info(f"Querying size of {filename}")
remote_path = posixpath.join(self.folder.path, filename)
try:
remote_file = self.client.getObject(remote_path)
except JFSNotFoundError:
return {"size": -1}
return {
"size": remote_file.size,
}
[docs] def _close(self):
# - If your backend needs to clean up after itself, do that here.
pass
duplicity.backend.register_backend("jottacloud", JottaCloudBackend)
""" jottacloud is a Norwegian backup company """