talks.py

# -*- coding: utf-8 -*-
""" harvest_tools.talks

"""
import traceback


from automaton import Automaton
from base import family_name_fr, format_author_fr, MSG_CRASH, MSG_LOAD
from invenio_tools import CheckException
from plugin_dbui import UNDEF_ID


class Talks(Automaton):
    """Automaton for conference talks.

    """
    def check_record(self, record):
        """Check the content of the talk in order to fix non conformities.

        Args:
            record (RecordConf): record describing a conference.

        Returns:
            bool: ``False`` when a non conformity is found and can not be
                corrected.

        """
        if not Automaton.check_record(self, record):
            return False

        if self.dbg:
            print "check talk record"

        try:
            self.check.is_conference(record)
            self.check.country(record)
            self.check.conference_date(record)

            self.check.submitted(record)
            self.check.year(record)

            self.check.format_authors(record, format_author_fr)
            self.check.get_my_authors(record, family_name_fr)

        except CheckException as e:
            self.logs[-1].reject(e, record=record)
            return False

        except Exception as e:
            self.logs[-1].reject(MSG_CRASH % e, record=record, translate=False)
            print traceback.format_exc()
            return False

        return True

    def insert_record(self, record):
        """Insert a conference talk in the database.

        Args:
            record (RecordConf): record describing a conference.

        Returns:
            int: one when the record is inserted / updated in the database
                zero otherwise.

        """
        # alias
        oai_url = record.oai_url()
        year = record.year()

        # alias for the conference information
        conference_dates = record.conference_dates()
        conference_title = record.conference_title()
        first_author = record.first_author()
        id_country = self.search_country(record.conference_country())
        submitted = record.submitted()[0]
        title = record.title()

        # get the collaboration identifier
        id_collaboration = self.search_collaboration(record.collaboration())

        # get an already published talk
        fields = dict(conference_title=conference_title,
                      first_author=first_author,
                      title=title)

        rec_id, status = self.get_record_by_fields(oai_url, year, **fields)
        if rec_id:
            return status

        # eventually insert a new talk
        ret = 1
        if not self.dry_run:

            fields = dict(authors=record.authors(),
                          authors_institute=record.my_authors,
                          conference_dates=conference_dates,
                          conference_speaker=first_author,
                          conference_title=conference_title,
                          conference_town=record.conference_town(),
                          conference_url=record.conference_url(),
                          first_author=first_author,
                          id_categories=self.id_category,
                          id_collaborations=id_collaboration,
                          id_countries=id_country,
                          id_projects=self.id_project,
                          id_status=UNDEF_ID,
                          id_teams=self.id_team,
                          origin=oai_url,
                          submitted=submitted,
                          title=title,
                          year=year)

            ret = self._insert_in_db(log_year=year, **fields)

        if ret == 1:
            self.logs[-1].load(MSG_LOAD, year)
            return 1

        return 0