stud.ip-crawler/src/crawler.py

import os
import logging as log

from studip import Studip


class Crawler:

    def __init__(self, studip):
        self.studip = studip

    def download_folder(self, folder):
        """Download all documents in a folder.

        Parameters:
        folder(string): id of the folder to download
        """
        docs = self.studip.get_docs(folder)
        for doc in docs:
            log.info('found doc ' + doc)
            self.studip.download(doc)

    def download_folder_rec(self, folder, base_dir):
        """Download all documents in a folder and its subfolders.
        This keeps the folder structure.

        Parameters:
        folder(string): id of the folder to download
        base_dir(string): directory where to put the download
        """
        log.info('crawling folder ' + folder)
        self.create_dir(base_dir)
        self.download_folder(folder)
        subdirs = self.studip.get_subdirs(folder)
        os.chdir(base_dir)
        for subdir in subdirs:
            subdir_name = subdirs[subdir].replace('/', '-')
            subdir_path = os.path.join(base_dir, subdir_name)
            log.debug(subdir_path)
            self.create_dir(subdir_path)
            os.chdir(subdir_path)
            self.download_folder_rec(subdir, subdir_path)
        log.info('finished crawling folder ' + folder)

    def download_course(self, course, base_dir):
        """Download all documents in course.
        This keeps the folder structure.

        Parameters:
        course(string): id of the course to download
        base_dir(string): directory where to put the download
        """
        log.info('crawling course ' + course)
        self.create_dir(base_dir)
        os.chdir(base_dir)
        root = self.studip.get_top_folder(course)
        self.download_folder_rec(root, base_dir)
        log.info('finished crawling course ' + course)

    def download_curr_courses(self, base_dir):
        """Download all documents of all current courses.
        This keeps the folder structure.

        Parameters:
        base_dir(string): directory where to put the download
        """
        self.create_dir(base_dir)
        curr_courses = self.studip.get_curr_courses(
            self.studip.get_uid(), self.studip.get_curr_semester())
        log.info('crawling all current courses')
        os.chdir(base_dir)
        for course in curr_courses:
            log.debug('course is ' + curr_courses[course])
            course_name = curr_courses[course].replace('/', '-')
            path = os.path.join(base_dir, course_name)
            self.download_course(course, path)
        log.info('finished crawling all current courses')

    def create_dir(self, dir):
        """Creates a dir if it doesnt exist already.

        Parameters:
        dir(string): directory path to create
        """
        if not os.path.exists(dir):
            log.info('creating folder ' + dir)
            os.mkdir(dir)