diff --git a/swh/loader/dir/loader.py b/swh/loader/dir/loader.py index cfe553b..1701925 100644 --- a/swh/loader/dir/loader.py +++ b/swh/loader/dir/loader.py @@ -1,527 +1,498 @@ # Copyright (C) 2015 The Software Heritage developers # See the AUTHORS file at the top-level directory of this distribution # License: GNU General Public License version 3, or any later version # See top-level LICENSE file for more information import logging import uuid import traceback import os import psycopg2 from retrying import retry from swh.core import config from swh.loader.dir import converters from swh.loader.dir.git import git from swh.loader.dir.git.git import GitType def send_in_packets(source_list, formatter, sender, packet_size, packet_size_bytes=None, *args, **kwargs): """Send objects from `source_list`, passed through `formatter` (with extra args *args, **kwargs), using the `sender`, in packets of `packet_size` objects (and of max `packet_size_bytes`). """ formatted_objects = [] count = 0 if not packet_size_bytes: packet_size_bytes = 0 for obj in source_list: formatted_object = formatter(obj, *args, **kwargs) if formatted_object: formatted_objects.append(formatted_object) else: continue if packet_size_bytes: count += formatted_object['length'] if len(formatted_objects) >= packet_size or count > packet_size_bytes: sender(formatted_objects) formatted_objects = [] count = 0 if formatted_objects: sender(formatted_objects) def retry_loading(error): """Retry policy when the database raises an integrity error""" if not isinstance(error, psycopg2.IntegrityError): return False logger = logging.getLogger('swh.loader.git.DirLoader') error_name = error.__module__ + '.' + error.__class__.__name__ logger.warning('Retry loading a batch', exc_info=False, extra={ 'swh_type': 'storage_retry', 'swh_exception_type': error_name, 'swh_exception': traceback.format_exception( error.__class__, error, error.__traceback__, ), }) return True class DirLoader(config.SWHConfig): """A bulk loader for a directory""" DEFAULT_CONFIG = { 'storage_class': ('str', 'remote_storage'), 'storage_args': ('list[str]', ['http://localhost:5000/']), 'send_contents': ('bool', True), 'send_directories': ('bool', True), 'send_revisions': ('bool', True), 'send_releases': ('bool', True), 'send_occurrences': ('bool', True), 'content_packet_size': ('int', 10000), 'content_packet_size_bytes': ('int', 1024 * 1024 * 1024), 'directory_packet_size': ('int', 25000), 'revision_packet_size': ('int', 100000), 'release_packet_size': ('int', 100000), 'occurrence_packet_size': ('int', 100000), - - # origin information - 'origin_url': ('str', 'file:///dev/null'), - - # occurrence information - 'branch': ('str', 'master'), - 'authority_id': ('int', 1), - 'validity': ('str', '2015-01-01 00:00:00+00'), - - # revision information - 'revision_author_name': ('str', 'swh author'), - 'revision_author_email': ('str', 'swh@inria.fr'), - 'revision_author_date': ('int', '1444054085'), - 'revision_author_offset': ('str', '+0200'), - 'revision_committer_name': ('str', 'swh committer'), - 'revision_committer_email': ('str', 'swh@inria.fr'), - 'revision_committer_date': ('int', '1444054085'), - 'revision_committer_offset': ('str', '+0200'), - 'revision_type': ('str', 'tar'), - 'revision_message': ('str', 'synthetic revision'), - - # release information - 'release_name': ('str', 'v0.0.1'), - 'release_date': ('int', '1444054085'), - 'release_offset': ('str', '+0200'), - 'release_author_name': ('str', 'swh author'), - 'release_author_email': ('str', 'swh@inria.fr'), - 'release_comment': ('str', 'synthetic release'), - } def __init__(self, config): self.config = config if self.config['storage_class'] == 'remote_storage': from swh.storage.api.client import RemoteStorage as Storage else: from swh.storage import Storage self.storage = Storage(*self.config['storage_args']) self.log = logging.getLogger('swh.loader.dir.DirLoader') @retry(retry_on_exception=retry_loading, stop_max_attempt_number=3) def send_contents(self, content_list): """Actually send properly formatted contents to the database""" num_contents = len(content_list) log_id = str(uuid.uuid4()) self.log.debug("Sending %d contents" % num_contents, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'content', 'swh_num': num_contents, 'swh_id': log_id, }) self.storage.content_add(content_list) self.log.debug("Done sending %d contents" % num_contents, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'content', 'swh_num': num_contents, 'swh_id': log_id, }) @retry(retry_on_exception=retry_loading, stop_max_attempt_number=3) def send_directories(self, directory_list): """Actually send properly formatted directories to the database""" num_directories = len(directory_list) log_id = str(uuid.uuid4()) self.log.debug("Sending %d directories" % num_directories, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'directory', 'swh_num': num_directories, 'swh_id': log_id, }) self.storage.directory_add(directory_list) self.log.debug("Done sending %d directories" % num_directories, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'directory', 'swh_num': num_directories, 'swh_id': log_id, }) @retry(retry_on_exception=retry_loading, stop_max_attempt_number=3) def send_revisions(self, revision_list): """Actually send properly formatted revisions to the database""" num_revisions = len(revision_list) log_id = str(uuid.uuid4()) self.log.debug("Sending %d revisions" % num_revisions, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'revision', 'swh_num': num_revisions, 'swh_id': log_id, }) self.storage.revision_add(revision_list) self.log.debug("Done sending %d revisions" % num_revisions, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'revision', 'swh_num': num_revisions, 'swh_id': log_id, }) @retry(retry_on_exception=retry_loading, stop_max_attempt_number=3) def send_releases(self, release_list): """Actually send properly formatted releases to the database""" num_releases = len(release_list) log_id = str(uuid.uuid4()) self.log.debug("Sending %d releases" % num_releases, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'release', 'swh_num': num_releases, 'swh_id': log_id, }) self.storage.release_add(release_list) self.log.debug("Done sending %d releases" % num_releases, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'release', 'swh_num': num_releases, 'swh_id': log_id, }) @retry(retry_on_exception=retry_loading, stop_max_attempt_number=3) def send_occurrences(self, occurrence_list): """Actually send properly formatted occurrences to the database""" num_occurrences = len(occurrence_list) log_id = str(uuid.uuid4()) self.log.debug("Sending %d occurrences" % num_occurrences, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'occurrence', 'swh_num': num_occurrences, 'swh_id': log_id, }) self.storage.occurrence_add(occurrence_list) self.log.debug("Done sending %d occurrences" % num_occurrences, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'occurrence', 'swh_num': num_occurrences, 'swh_id': log_id, }) def get_or_create_origin(self, origin_url): origin = converters.origin_url_to_origin(origin_url) origin['id'] = self.storage.origin_add_one(origin) return origin def dir_origin(self, root_dir, origin_url): log_id = str(uuid.uuid4()) self.log.debug('Creating origin for %s' % origin_url, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'origin', 'swh_num': 1, 'swh_id': log_id }) origin = self.get_or_create_origin(origin_url) self.log.debug('Done creating origin for %s' % origin_url, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'origin', 'swh_num': 1, 'swh_id': log_id }) return origin def dir_revision(self, root_dir, origin_url, revision_date, revision_offset, revision_committer_date, revision_committer_offset, revision_type, revision_message, revision_author, revision_committer): """Create a revision. """ log_id = str(uuid.uuid4()) self.log.debug('Creating origin for %s' % origin_url, extra={ 'swh_type': 'storage_send_start', 'swh_content_type': 'origin', 'swh_num': 1, 'swh_id': log_id }) self.get_or_create_origin(origin_url) self.log.debug('Done creating origin for %s' % origin_url, extra={ 'swh_type': 'storage_send_end', 'swh_content_type': 'origin', 'swh_num': 1, 'swh_id': log_id }) def bulk_send_blobs(self, objects, blobs, origin_id): """Format blobs as swh contents and send them to the database""" packet_size = self.config['content_packet_size'] packet_size_bytes = self.config['content_packet_size_bytes'] max_content_size = self.config['content_size_limit'] send_in_packets(blobs, converters.blob_to_content, self.send_contents, packet_size, packet_size_bytes=packet_size_bytes, log=self.log, max_content_size=max_content_size, origin_id=origin_id) def bulk_send_trees(self, objects, trees): """Format trees as swh directories and send them to the database""" packet_size = self.config['directory_packet_size'] send_in_packets(trees, converters.tree_to_directory, self.send_directories, packet_size, objects=objects, log=self.log) def bulk_send_commits(self, objects, commits): """Format commits as swh revisions and send them to the database""" packet_size = self.config['revision_packet_size'] send_in_packets(commits, converters.commit_to_revision, self.send_revisions, packet_size, objects=objects, log=self.log) def bulk_send_annotated_tags(self, objects, tags): """Format annotated tags (pygit2.Tag objects) as swh releases and send them to the database """ packet_size = self.config['release_packet_size'] send_in_packets(tags, converters.annotated_tag_to_release, self.send_releases, packet_size, log=self.log) def bulk_send_refs(self, objects, refs): """Format git references as swh occurrences and send them to the database """ packet_size = self.config['occurrence_packet_size'] send_in_packets(refs, lambda ref: ref, self.send_occurrences, packet_size) def compute_dir_ref(self, root_dir, branch, revision_hash, origin_id, authority_id, validity): """List all the refs from the given root directory root_dir. Args: - root_dir: the root directory - branch: occurrence's branch name - revision_hash: the revision hash - origin_id (int): the id of the origin from which the root_dir is taken - validity (datetime.datetime): the validity date for the repository's refs - authority_id (int): the id of the authority on `validity`. Returns: One dictionary with keys: - branch (str): name of the ref - revision (sha1_git): revision pointed at by the ref - origin (int) - validity (datetime.DateTime) - authority (int) Compatible with occurrence_add. """ log_id = str(uuid.uuid4()) self.log.debug("Computing occurrence %s representation at %s" % ( branch, revision_hash), extra={ 'swh_type': 'computing_occurrence_dir', 'swh_name': branch, 'swh_target': str(revision_hash), 'swh_id': log_id, }) return { 'branch': branch, 'revision': revision_hash, 'origin': origin_id, 'validity': validity, 'authority': authority_id, } def list_repo_objs(self, root_dir, info): """List all objects from root_dir. Args: - root_dir (path): the directory to list Returns: a dict containing lists of `Oid`s with keys for each object type: - CONTENT - DIRECTORY """ def get_objects_per_object_type(objects_per_path): m = { GitType.BLOB: [], GitType.TREE: [], GitType.COMM: [], GitType.RELE: [] } for tree_path in objects_per_path: objs = objects_per_path[tree_path] # print('tree_path: %s, objs: %s' % (tree_path, objs)) for obj in objs: m[obj['type']].append(obj) return m log_id = str(uuid.uuid4()) self.log.info("Started listing %s" % root_dir, extra={ 'swh_type': 'dir_list_objs_start', 'swh_repo': root_dir, 'swh_id': log_id, }) objects_per_path = git.walk_and_compute_sha1_from_directory(root_dir) objects = get_objects_per_object_type(objects_per_path) tree_hash = objects_per_path[git.ROOT_TREE_KEY][0]['sha1_git'] revision = git.compute_revision_git_sha1(tree_hash, info) objects.update({ GitType.COMM: [revision] }) revision_hash = revision['sha1_git'] release = git.compute_release(revision_hash, info) objects.update({ GitType.RELE: [release] }) self.log.info("Done listing the objects in %s: %d contents, " "%d directories, %d revisions, %d releases" % ( root_dir, len(objects[GitType.BLOB]), len(objects[GitType.TREE]), len(objects[GitType.COMM]), len(objects[GitType.RELE]) ), extra={ 'swh_type': 'dir_list_objs_end', 'swh_repo': root_dir, 'swh_num_blobs': len(objects[GitType.BLOB]), 'swh_num_trees': len(objects[GitType.TREE]), 'swh_num_commits': len(objects[GitType.COMM]), 'swh_num_releases': len(objects[GitType.RELE]), 'swh_id': log_id, }) return objects, objects_per_path def load_dir(self, root_dir, objects, objects_per_path, refs, origin_id): if self.config['send_contents']: self.bulk_send_blobs(objects_per_path, objects[GitType.BLOB], origin_id) else: self.log.info('Not sending contents') if self.config['send_directories']: self.bulk_send_trees(objects_per_path, objects[GitType.TREE]) else: self.log.info('Not sending directories') if self.config['send_revisions']: self.bulk_send_commits(objects_per_path, objects[GitType.COMM]) else: self.log.info('Not sending revisions') if self.config['send_releases']: self.bulk_send_annotated_tags(objects_per_path, objects[GitType.RELE]) else: self.log.info('Not sending releases') if self.config['send_occurrences']: self.bulk_send_refs(objects_per_path, refs) else: self.log.info('Not sending occurrences') def process(self, info): root_dir = info['dir_path'] if not os.path.exists(root_dir): self.log.info('Skipping inexistant directory %s' % root_dir, extra={ 'swh_type': 'dir_repo_list_refs', 'swh_repo': root_dir, 'swh_num_refs': 0, }) return files = os.listdir(root_dir) if not(files): self.log.info('Skipping empty directory %s' % root_dir, extra={ 'swh_type': 'dir_repo_list_refs', 'swh_repo': root_dir, 'swh_num_refs': 0, }) return # Add origin to storage if needed, use the one from config if not origin = self.dir_origin(root_dir, info['origin_url']) # We want to load the repository, walk all the objects objects, objects_per_path = self.list_repo_objs(root_dir, info) # Compute revision information (mixed from outside input + dir content) revision = objects[GitType.COMM][0] # Parse all the refs from our root_dir ref = self.compute_dir_ref(root_dir, info['branch'], revision['sha1_git'], origin['id'], info['authority_id'], info['validity']) # Finally, load the repository self.load_dir(root_dir, objects, objects_per_path, [ref], origin['id']) diff --git a/swh/loader/dir/tasks.py b/swh/loader/dir/tasks.py index d4c1c2e..0923650 100644 --- a/swh/loader/dir/tasks.py +++ b/swh/loader/dir/tasks.py @@ -1,135 +1,152 @@ # Copyright (C) 2015 The Software Heritage developers # See the AUTHORS file at the top-level directory of this distribution # License: GNU General Public License version 3, or any later version # See top-level LICENSE file for more information import subprocess import shutil from swh.core.scheduling import Task from swh.core import config from swh.loader.dir.loader import DirLoader class LoadDirRepository(Task): """Import a directory to Software Heritage """ task_queue = 'swh_loader_dir' CONFIG_BASE_FILENAME = 'loader/dir.ini' ADDITIONAL_CONFIG = {} def __init__(self): self.config = DirLoader.parse_config_file( base_filename=self.CONFIG_BASE_FILENAME, additional_configs=[self.ADDITIONAL_CONFIG], ) def run(self, info): """Import a directory. Args: info: Dictionary of information needed, keys are: - dir_path: directory to import - origin_url: origin url (e.g file:///dev/null) - branch: occurrence's branch name - authority_id: authority id (e.g. 1 for swh) - validity: validity date (e.g. 2015-01-01 00:00:00+00) - revision_author_name: revision's author name - revision_author_email: revision's author email - revision_author_date: timestamp (e.g. 1444054085) - revision_author_offset: date offset e.g. -0220, +0100 - revision_committer_name: revision's committer name - revision_committer_email: revision's committer email - revision_committer_date: timestamp - revision_committer_offset: date offset e.g. -0220, +0100 - revision_type: type of revision dir, tar - revision_message: synthetic message for the revision - release_name: release name - release_date: release timestamp (e.g. 1444054085) - release_offset: release date offset e.g. -0220, +0100 - release_author_name: release author's name - release_author_email: release author's email - release_comment: release's comment message """ loader = DirLoader(self.config) loader.log = self.log loader.process(info) def untar(tar_path, dir_path): """Decompress an archive tar_path to dir_path. At the end of this call, dir_path contains the tarball's uncompressed content. Args: tar_path: the path to access the tarball dir_path: The path where to extract the tarball's content. """ untar_cmd = ['tar', 'xavf', tar_path, '--preserve-permissions', '-C', dir_path] subprocess.check_call(untar_cmd, stderr=subprocess.STDOUT) class LoadTarRepository(LoadDirRepository): """Import a tarball to Software Heritage """ - mandatory_keys = ['tar_path', 'dir_path', - 'authority_id', 'validity', - 'revision_author_name', 'revision_author_email', - 'revision_author_date', 'revision_author_offset', - 'revision_committer_name', 'revision_committer_email', - 'revision_committer_date', 'revision_committer_offset', - 'revision_type', 'revision_message', - 'release_name', 'release_date', 'release_offset', - 'release_author_name', 'release_author_email', - 'release_comment'] - task_queue = 'swh_loader_tar' CONFIG_BASE_FILENAME = 'loader/tar.ini' ADDITIONAL_CONFIG = { 'dir_path': ('str', '/tmp/swh.loader.tar/'), - 'tar_path': ('str', '/some/path/to/tarball.tar') - } - - def check_for_missing_mandatory_data(self, info): - """Check for presence of mandatory information. - - Args: - Dictionary of mandatory values. - - Returns: - List of missing keys if any, an empty list otherwise. - - Note: - Does not check the values, just that they are present. - """ - missing_data = [] - for key in self.mandatory_keys: - if key not in info: - missing_data.append(key) - - return missing_data + # occurrence information + 'branch': ('str', 'master'), + 'authority_id': ('int', 1), + 'validity': ('str', '2015-01-01 00:00:00+00'), + + # revision information + 'revision_author_name': ('str', 'swh author'), + 'revision_author_email': ('str', 'swh@inria.fr'), + 'revision_author_date': ('int', 1444054085), + 'revision_author_offset': ('str', '+0200'), + 'revision_committer_name': ('str', 'swh committer'), + 'revision_committer_email': ('str', 'swh@inria.fr'), + 'revision_committer_date': ('int', 1444054085), + 'revision_committer_offset': ('str', '+0200'), + 'revision_type': ('str', 'tar'), + 'revision_message': ('str', 'synthetic revision'), + + # release information + 'release_name': ('str', 'v0.0.1'), + 'release_date': ('int', 1444054085), + 'release_offset': ('str', '+0200'), + 'release_author_name': ('str', 'swh author'), + 'release_author_email': ('str', 'swh@inria.fr'), + 'release_comment': ('str', 'synthetic release'), + } - def run(self, info): - """Import a tarball. + def run(self, tar_path): + """Import a tarball tar_path. """ - missing_data = self.check_for_missing_mandatory_data(info) - if not missing_data: - raise ValueError('%s are mandatory, failing!' % missing_data) - - config.prepare_folders(info, 'dir_path') - tar_path = info['tar_path'] + info = {} + for key in ['dir_path', + # origin + 'branch', 'authority_id', 'validity', + # revision + 'revision_author_name', 'revision_author_email', + 'revision_author_date', 'revision_author_offset', + 'revision_committer_name', 'revision_committer_email', + 'revision_committer_date', 'revision_committer_offset', + 'revision_type', 'revision_message', + # release + 'release_name', 'release_date', 'release_offset', + 'release_author_name', 'release_author_email', + 'release_comment']: + info.update({key: self.config[key]}) + + print(info) + + # unarchive in dir_path + config.prepare_folders(self.config, 'dir_path') dir_path = info['dir_path'] untar(tar_path, dir_path) - super().run(info) - shutil.rmtree(dir_path) + + # Update the origin's url + origin_url = 'file://' + tar_path + info.update({ + 'origin_url': origin_url + }) + + # Load the directory result + try: + super().run(info) + finally: # always clean up + shutil.rmtree(dir_path)