PyCS/pycs/labels/LabelProvider.py

import typing


class LabelProvider:
    def __init__(self, root_folder, configuration):
        """
        prepare everything needed to provide labels

        :param root_folder: relative path to label folder
        :param configuration: object parsed from configuration.json
        """
        raise NotImplementedError

    def close(self):
        """
        is called everytime a label provider is not used anymore

        :return:
        """
        raise NotImplementedError

    def get_labels(self) -> typing.List[dict]:
        """
        return all available labels

        :return:
        """
        raise NotImplementedError

    # TODO documentation
    @staticmethod
    def create_label(identifier, name):
        return {
            'id': identifier,
            'name': name
        }