Add converters package

fimfarchive/converters/__init__.py

@@ -0,0 +1,30 @@
+"""
+Converter module.
+"""
+
+
+#
+# Fimfarchive, preserves stories from Fimfiction.
+# Copyright (C) 2015  Joakim Soderlund
+#
+# This program 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 3 of the License, or
+# (at your option) any later version.
+#
+# This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+
+from .base import Converter
+
+
+__all__ = (
+    'Converter',
+)

fimfarchive/converters/base.py

@@ -0,0 +1,50 @@
+"""
+Converter base class.
+"""
+
+
+#
+# Fimfarchive, preserves stories from Fimfiction.
+# Copyright (C) 2015  Joakim Soderlund
+#
+# This program 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 3 of the License, or
+# (at your option) any later version.
+#
+# This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+
+from abc import ABC, abstractmethod
+
+from fimfarchive.stories import Story
+
+
+__all__ = (
+    'Converter',
+)
+
+
+class Converter(ABC):
+    """
+    Converter for stories.
+    """
+
+    @abstractmethod
+    def __call__(self, story: Story) -> Story:
+        """
+        Applies the conversion.
+
+        Args:
+            *story: The story to convert.
+
+        Returns:
+            A converted story.
+        """

tests/test_imports.py

@@ -27,6 +27,7 @@ import pytest
 
 MODULES = (
     'commands',
+    'converters',
     'exceptions',
     'fetchers',
     'flavors',