diff --git a/README.md b/README.md index 33c0486..9662539 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ The application allows you to automate the process of generating a bibliography Supported citation styles: - ГОСТ Р 7.0.5-2008 +- American Psychological Association (APA7) ## Installation diff --git a/docs/source/index.rst b/docs/source/index.rst index f552b0d..b43e6bd 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,6 +7,7 @@ Поддерживаемые стили цитирования: - ГОСТ Р 7.0.5-2008 + - American Psychological Association (APA7) Установка ========= diff --git a/src/formatters/models.py b/src/formatters/models.py index c9236ca..1e4b255 100644 --- a/src/formatters/models.py +++ b/src/formatters/models.py @@ -78,3 +78,53 @@ class ArticlesCollectionModel(BaseModel): publishing_house: str year: int = Field(..., gt=0) pages: str + + +class JournalArticleModel(BaseModel): + + """ + Модель статьи из журнала: + + .. code-block:: + + JournalArticleModel( + authors="Иванов И.М., Петров С.Н.", + article_title="Наука как искусство", + journal_title="Образование и наука", + year=2020, + journal_issue=10, + pages="25-30", + ) + """ + + authors: str + article_title: str + journal_title: str + year: int = Field(..., gt=0) + journal_issue: int = Field(..., gt=0) + pages: str + + +class NewspaperArticleModel(BaseModel): + + """ + Модель статьи из газеты: + + .. code-block:: + + NewspaperArticleModel( + authors="Иванов И.М., Петров С.Н.", + article_title="Наука как искусство", + newspaper_title="Южный Урал", + year=1980, + date="01.10", + article_number=5, + ) + """ + + authors: str + article_title: str + newspaper_title: str + year: int = Field(..., gt=0) + date: str + article_number: int = Field(..., gt=0) diff --git a/src/formatters/styles/apa.py b/src/formatters/styles/apa.py new file mode 100644 index 0000000..084eab8 --- /dev/null +++ b/src/formatters/styles/apa.py @@ -0,0 +1,105 @@ +""" +Стиль цитирования по APA. +""" +from string import Template + +from pydantic import BaseModel + +from formatters.models import BookModel, InternetResourceModel +from formatters.styles.base import BaseCitationStyle +from logger import get_logger + + +logger = get_logger(__name__) + + +class APABook(BaseCitationStyle): + """ + Форматирование для книг. + """ + + data: BookModel + + @property + def template(self) -> Template: + return Template("$authors ($year). $title$edition. $publishing_house") + + def substitute(self) -> str: + + logger.info('Форматирование книги "%s" ...', self.data.title) + + return self.template.substitute( + authors=self.data.authors, + title=self.data.title, + edition=self.get_edition(), + city=self.data.city, + publishing_house=self.data.publishing_house, + year=self.data.year, + pages=self.data.pages, + ) + + def get_edition(self) -> str: + """ + Получение отформатированной информации об издательстве. + + :return: Информация об издательстве. + """ + + return f" ({self.data.edition} изд.)" if self.data.edition else "" + + +class APAInternetResource(BaseCitationStyle): + """ + Форматирование для интернет-ресурсов. + """ + + data: InternetResourceModel + + @property + def template(self) -> Template: + return Template("$website ($access_date) $article $link") + + def substitute(self) -> str: + + logger.info('Форматирование интернет-ресурса "%s" ...', self.data.article) + + return self.template.substitute( + article=self.data.article, + website=self.data.website, + link=self.data.link, + access_date=self.data.access_date, + ) + + +class APACitationFormatter: + """ + Базовый класс для итогового форматирования списка источников. + """ + + formatters_map = { + BookModel.__name__: APABook, + InternetResourceModel.__name__: APAInternetResource, + } + + def __init__(self, models: list[BaseModel]) -> None: + """ + Конструктор. + + :param models: Список объектов для форматирования + """ + + formatted_items = [] + for model in models: + if type(model).__name__ in self.formatters_map: + formatted_items.append(self.formatters_map.get(type(model).__name__)(model)) # type: ignore + + self.formatted_items = formatted_items + + def format(self) -> list[BaseCitationStyle]: + """ + Форматирование списка источников. + + :return: + """ + + return sorted(self.formatted_items, key=lambda item: item.formatted) diff --git a/src/formatters/styles/gost.py b/src/formatters/styles/gost.py index b237f8a..bb099b8 100644 --- a/src/formatters/styles/gost.py +++ b/src/formatters/styles/gost.py @@ -5,7 +5,13 @@ from pydantic import BaseModel -from formatters.models import BookModel, InternetResourceModel, ArticlesCollectionModel +from formatters.models import ( + BookModel, + InternetResourceModel, + ArticlesCollectionModel, + JournalArticleModel, + NewspaperArticleModel, +) from formatters.styles.base import BaseCitationStyle from logger import get_logger @@ -103,6 +109,64 @@ def substitute(self) -> str: ) +class GOSTJournalArticle(BaseCitationStyle): + """ + Форматирование для статьи из журнала. + """ + + data: JournalArticleModel + + @property + def template(self) -> Template: + return Template( + "$authors $article_title // $journal_title. $year. № $journal_issue. С. $pages." + ) + + def substitute(self) -> str: + + logger.info( + 'Форматирование статьи из журнала "%s" ...', self.data.article_title + ) + + return self.template.substitute( + authors=self.data.authors, + article_title=self.data.article_title, + journal_title=self.data.journal_title, + year=self.data.year, + journal_issue=self.data.journal_issue, + pages=self.data.pages, + ) + + +class GOSTNewspaperArticle(BaseCitationStyle): + """ + Форматирование для статьи из газеты. + """ + + data: NewspaperArticleModel + + @property + def template(self) -> Template: + return Template( + "$authors $article_title // $newspaper_title. $year. № $article_number. $date." + ) + + def substitute(self) -> str: + + logger.info( + 'Форматирование статьи из журнала "%s" ...', self.data.article_title + ) + + return self.template.substitute( + authors=self.data.authors, + article_title=self.data.article_title, + newspaper_title=self.data.newspaper_title, + year=self.data.year, + date=self.data.date, + article_number=self.data.article_number, + ) + + class GOSTCitationFormatter: """ Базовый класс для итогового форматирования списка источников. @@ -112,6 +176,8 @@ class GOSTCitationFormatter: BookModel.__name__: GOSTBook, InternetResourceModel.__name__: GOSTInternetResource, ArticlesCollectionModel.__name__: GOSTCollectionArticle, + JournalArticleModel.__name__: GOSTJournalArticle, + NewspaperArticleModel.__name__: GOSTNewspaperArticle, } def __init__(self, models: list[BaseModel]) -> None: @@ -123,7 +189,8 @@ def __init__(self, models: list[BaseModel]) -> None: formatted_items = [] for model in models: - formatted_items.append(self.formatters_map.get(type(model).__name__)(model)) # type: ignore + if type(model).__name__ in self.formatters_map: + formatted_items.append(self.formatters_map.get(type(model).__name__)(model)) # type: ignore self.formatted_items = formatted_items diff --git a/src/main.py b/src/main.py index 7a9fa8e..e9d70f2 100644 --- a/src/main.py +++ b/src/main.py @@ -5,6 +5,7 @@ import click +from formatters.styles.apa import APACitationFormatter from formatters.styles.gost import GOSTCitationFormatter from logger import get_logger from readers.reader import SourcesReader @@ -21,7 +22,6 @@ class CitationEnum(Enum): """ GOST = "gost" # ГОСТ Р 7.0.5-2008 - MLA = "mla" # Modern Language Association APA = "apa" # American Psychological Association @@ -77,14 +77,23 @@ def process_input( ) models = SourcesReader(path_input).read() - formatted_models = tuple( - str(item) for item in GOSTCitationFormatter(models).format() - ) - logger.info("Генерация выходного файла ...") - Renderer(formatted_models).render(path_output) + formatter_styles = { + CitationEnum.GOST.name: GOSTCitationFormatter, + CitationEnum.APA.name: APACitationFormatter, + } + + if citation in formatter_styles: + formatted_models = tuple( + str(item) for item in formatter_styles[citation](models).format() # type: ignore + ) + + logger.info("Генерация выходного файла ...") + Renderer(formatted_models).render(path_output) - logger.info("Команда успешно завершена.") + logger.info("Команда успешно завершена.") + else: + logger.error("Неизвестный стиль форматирования") if __name__ == "__main__": diff --git a/src/readers/reader.py b/src/readers/reader.py index 9007a80..b6b7d1e 100644 --- a/src/readers/reader.py +++ b/src/readers/reader.py @@ -7,7 +7,13 @@ import openpyxl from openpyxl.workbook import Workbook -from formatters.models import BookModel, InternetResourceModel, ArticlesCollectionModel +from formatters.models import ( + BookModel, + InternetResourceModel, + ArticlesCollectionModel, + JournalArticleModel, + NewspaperArticleModel, +) from logger import get_logger from readers.base import BaseReader @@ -90,6 +96,56 @@ def attributes(self) -> dict: } +class JournalArticleReader(BaseReader): + """ + Чтение модели статьи из журнала. + """ + + @property + def model(self) -> Type[JournalArticleModel]: + return JournalArticleModel + + @property + def sheet(self) -> str: + return "Статья из журнала" + + @property + def attributes(self) -> dict: + return { + "authors": {0: str}, + "article_title": {1: str}, + "journal_title": {2: str}, + "year": {3: int}, + "journal_issue": {4: int}, + "pages": {5: str}, + } + + +class NewspaperArticleReader(BaseReader): + """ + Чтение модели статьи из газеты. + """ + + @property + def model(self) -> Type[NewspaperArticleModel]: + return NewspaperArticleModel + + @property + def sheet(self) -> str: + return "Статья из газеты" + + @property + def attributes(self) -> dict: + return { + "authors": {0: str}, + "article_title": {1: str}, + "newspaper_title": {2: str}, + "year": {3: int}, + "date": {4: str}, + "article_number": {5: int}, + } + + class SourcesReader: """ Чтение из источника данных. @@ -100,6 +156,8 @@ class SourcesReader: BookReader, InternetResourceReader, ArticlesCollectionReader, + JournalArticleReader, + NewspaperArticleReader, ] def __init__(self, path: str) -> None: diff --git a/src/tests/conftest.py b/src/tests/conftest.py index ac5c9aa..b363fb2 100644 --- a/src/tests/conftest.py +++ b/src/tests/conftest.py @@ -3,7 +3,13 @@ """ import pytest -from formatters.models import BookModel, InternetResourceModel, ArticlesCollectionModel +from formatters.models import ( + BookModel, + InternetResourceModel, + ArticlesCollectionModel, + JournalArticleModel, + NewspaperArticleModel, +) @pytest.fixture @@ -58,3 +64,39 @@ def articles_collection_model_fixture() -> ArticlesCollectionModel: year=2020, pages="25-30", ) + + +@pytest.fixture +def journal_article_model_fixture() -> JournalArticleModel: + """ + Фикстура модели статьи из журнала. + + :return: JournalArticleModel + """ + + return JournalArticleModel( + authors="Иванов И.М., Петров С.Н.", + article_title="Наука как искусство", + journal_title="Образование и наука", + year=2020, + journal_issue=10, + pages="25-30", + ) + + +@pytest.fixture +def newspaper_article_model_fixture() -> NewspaperArticleModel: + """ + Фикстура модели статьи из газеты. + + :return: NewspaperArticleModel + """ + + return NewspaperArticleModel( + authors="Иванов И.М., Петров С.Н.", + article_title="Наука как искусство", + newspaper_title="Южный Урал", + year=1980, + date="01.10", + article_number=5, + ) diff --git a/src/tests/formatters/test_apa.py b/src/tests/formatters/test_apa.py new file mode 100644 index 0000000..cd9bf71 --- /dev/null +++ b/src/tests/formatters/test_apa.py @@ -0,0 +1,98 @@ +""" +Тестирование функций оформления списка источников по ГОСТ Р 7.0.5-2008. +""" + +from formatters.base import BaseCitationFormatter +from formatters.models import BookModel, InternetResourceModel, JournalArticleModel +from formatters.styles.apa import APABook, APAInternetResource +from formatters.styles.gost import GOSTJournalArticle + + +class TestAPA: + """ + Тестирование оформления списка источников согласно ГОСТ Р 7.0.5-2008. + """ + + def test_book(self, book_model_fixture: BookModel) -> None: + """ + Тестирование форматирования книги. + + :param BookModel book_model_fixture: Фикстура модели книги + :return: + """ + + model = APABook(book_model_fixture) + + assert ( + model.formatted + == "Иванов И.М., Петров С.Н. (2020). Наука как искусство (3-е изд.). Просвещение" + ) + + def test_internet_resource( + self, internet_resource_model_fixture: InternetResourceModel + ) -> None: + """ + Тестирование форматирования интернет-ресурса. + + :param InternetResourceModel internet_resource_model_fixture: Фикстура модели интернет-ресурса + :return: + """ + + model = APAInternetResource(internet_resource_model_fixture) + + assert ( + model.formatted + == "Ведомости (01.01.2021) Наука как искусство https://www.vedomosti.ru" + ) + + def test_citation_formatter( + self, + book_model_fixture: BookModel, + internet_resource_model_fixture: InternetResourceModel, + ) -> None: + """ + Тестирование функции итогового форматирования списка источников. + + :param BookModel book_model_fixture: Фикстура модели книги + :param InternetResourceModel internet_resource_model_fixture: Фикстура модели интернет-ресурса + :param ArticlesCollectionModel articles_collection_model_fixture: Фикстура модели сборника статей + :param JournalArticleModel journal_article_model_fixture: Фикстура модели статьи из журнала + :param NewspaperArticleModel newspaper_article_model_fixture: Фикстура модели статьи из газеты + :return: + """ + + models = [ + APABook(book_model_fixture), + APAInternetResource(internet_resource_model_fixture), + ] + result = BaseCitationFormatter(models).format() + + # тестирование сортировки списка источников + assert result[0] == models[1] + assert result[1] == models[0] + + def test_not_implemented_formats( + self, + book_model_fixture: BookModel, + internet_resource_model_fixture: InternetResourceModel, + journal_article_model_fixture: JournalArticleModel, + ) -> None: + """ + Тестирование функции итогового форматирования списка источников. + + :param BookModel book_model_fixture: Фикстура модели книги + :param InternetResourceModel internet_resource_model_fixture: Фикстура модели интернет-ресурса + :param JournalArticleModel journal_article_model_fixture: Фикстура модели статьи из журнала + :return: + """ + + models = [ + APABook(book_model_fixture), + APAInternetResource(internet_resource_model_fixture), + GOSTJournalArticle(journal_article_model_fixture), + ] + result = BaseCitationFormatter(models).format() + + # тестирование сортировки списка источников + assert result[0] == models[1] + assert result[1] == models[0] diff --git a/src/tests/formatters/test_gost.py b/src/tests/formatters/test_gost.py index c93e1e7..8c16437 100644 --- a/src/tests/formatters/test_gost.py +++ b/src/tests/formatters/test_gost.py @@ -3,8 +3,20 @@ """ from formatters.base import BaseCitationFormatter -from formatters.models import BookModel, InternetResourceModel, ArticlesCollectionModel -from formatters.styles.gost import GOSTBook, GOSTInternetResource, GOSTCollectionArticle +from formatters.models import ( + BookModel, + InternetResourceModel, + ArticlesCollectionModel, + JournalArticleModel, + NewspaperArticleModel, +) +from formatters.styles.gost import ( + GOSTBook, + GOSTInternetResource, + GOSTCollectionArticle, + GOSTJournalArticle, + GOSTNewspaperArticle, +) class TestGOST: @@ -61,11 +73,47 @@ def test_articles_collection( == "Иванов И.М., Петров С.Н. Наука как искусство // Сборник научных трудов. – СПб.: АСТ, 2020. – С. 25-30." ) + def test_journal_article( + self, journal_article_model_fixture: JournalArticleModel + ) -> None: + """ + Тестирование форматирования статьи из журнала. + + :param JournalArticleModel journal_article_model_fixture: Фикстура модели статьи из журнала + :return: + """ + + model = GOSTJournalArticle(journal_article_model_fixture) + + assert ( + model.formatted + == "Иванов И.М., Петров С.Н. Наука как искусство // Образование и наука. 2020. № 10. С. 25-30." + ) + + def test_newspaper_article( + self, newspaper_article_model_fixture: NewspaperArticleModel + ) -> None: + """ + Тестирование форматирования статьи из газеты. + + :param NewspaperArticleModel newspaper_article_model_fixture: Фикстура модели статьи из газеты + :return: + """ + + model = GOSTNewspaperArticle(newspaper_article_model_fixture) + + assert ( + model.formatted + == "Иванов И.М., Петров С.Н. Наука как искусство // Южный Урал. 1980. № 5. 01.10." + ) + def test_citation_formatter( self, book_model_fixture: BookModel, internet_resource_model_fixture: InternetResourceModel, articles_collection_model_fixture: ArticlesCollectionModel, + journal_article_model_fixture: JournalArticleModel, + newspaper_article_model_fixture: NewspaperArticleModel, ) -> None: """ Тестирование функции итогового форматирования списка источников. @@ -73,6 +121,8 @@ def test_citation_formatter( :param BookModel book_model_fixture: Фикстура модели книги :param InternetResourceModel internet_resource_model_fixture: Фикстура модели интернет-ресурса :param ArticlesCollectionModel articles_collection_model_fixture: Фикстура модели сборника статей + :param JournalArticleModel journal_article_model_fixture: Фикстура модели статьи из журнала + :param NewspaperArticleModel newspaper_article_model_fixture: Фикстура модели статьи из газеты :return: """ @@ -80,10 +130,14 @@ def test_citation_formatter( GOSTBook(book_model_fixture), GOSTInternetResource(internet_resource_model_fixture), GOSTCollectionArticle(articles_collection_model_fixture), + GOSTJournalArticle(journal_article_model_fixture), + GOSTNewspaperArticle(newspaper_article_model_fixture), ] result = BaseCitationFormatter(models).format() # тестирование сортировки списка источников - assert result[0] == models[2] - assert result[1] == models[0] - assert result[2] == models[1] + assert result[0] == models[3] + assert result[1] == models[2] + assert result[2] == models[4] + assert result[3] == models[0] + assert result[4] == models[1] diff --git a/src/tests/readers/test_readers.py b/src/tests/readers/test_readers.py index 67d863b..46aad6f 100644 --- a/src/tests/readers/test_readers.py +++ b/src/tests/readers/test_readers.py @@ -5,12 +5,20 @@ import pytest -from formatters.models import BookModel, InternetResourceModel, ArticlesCollectionModel +from formatters.models import ( + BookModel, + InternetResourceModel, + ArticlesCollectionModel, + JournalArticleModel, + NewspaperArticleModel, +) from readers.reader import ( BookReader, SourcesReader, InternetResourceReader, ArticlesCollectionReader, + JournalArticleReader, + NewspaperArticleReader, ) from settings import TEMPLATE_FILE_PATH @@ -104,6 +112,56 @@ def test_articles_collection(self, workbook: Any) -> None: # проверка общего количества атрибутов assert len(model_type.schema().get("properties", {}).keys()) == 7 + def test_journal_article(self, workbook: Any) -> None: + """ + Тестирование чтения статьи из журнала. + + :param workbook: Объект тестовой рабочей книги. + """ + + models = JournalArticleReader(workbook).read() + + assert len(models) == 1 + model = models[0] + + model_type = JournalArticleModel + + assert isinstance(model, model_type) + assert model.authors == "Иванов И.М., Петров С.Н." + assert model.article_title == "Наука как искусство" + assert model.journal_title == "Образование и наука" + assert model.year == 2020 + assert model.journal_issue == 10 + assert model.pages == "25-30" + + # проверка общего количества атрибутов + assert len(model_type.schema().get("properties", {}).keys()) == 6 + + def test_newspaper_article(self, workbook: Any) -> None: + """ + Тестирование чтения статьи из газеты. + + :param workbook: Объект тестовой рабочей книги. + """ + + models = NewspaperArticleReader(workbook).read() + + assert len(models) == 1 + model = models[0] + + model_type = NewspaperArticleModel + + assert isinstance(model, model_type) + assert model.authors == "Иванов И.М., Петров С.Н." + assert model.article_title == "Наука как искусство" + assert model.newspaper_title == "Южный Урал" + assert model.year == 1980 + assert model.date == "01.10" + assert model.article_number == 5 + + # проверка общего количества атрибутов + assert len(model_type.schema().get("properties", {}).keys()) == 6 + def test_sources_reader(self) -> None: """ Тестирование функции чтения всех моделей из источника. @@ -111,7 +169,7 @@ def test_sources_reader(self) -> None: models = SourcesReader(TEMPLATE_FILE_PATH).read() # проверка общего считанного количества моделей - assert len(models) == 8 + assert len(models) == 10 # проверка наличия всех ожидаемых типов моделей среди типов считанных моделей model_types = {model.__class__.__name__ for model in models} @@ -119,4 +177,6 @@ def test_sources_reader(self) -> None: BookModel.__name__, InternetResourceModel.__name__, ArticlesCollectionModel.__name__, + JournalArticleModel.__name__, + NewspaperArticleModel.__name__, }