Metadata-Version: 2.1
Name: goodreads-export
Version: 1.7.3
Summary: Convert goodreads books to markdown files, for example for Obsidian.
Home-page: https://andgineer.github.io/goodreads-export/en/
Author: Andrey Sorokin
Author-email: andrey@sorokin.engineer
Keywords: goodreads book markdown obsidian
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: beautifulsoup4==4.12.2
Requires-Dist: certifi==2023.7.22
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: click==8.1.7
Requires-Dist: idna==3.4
Requires-Dist: jinja2==3.1.2
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: markdownify==0.11.6
Requires-Dist: markupsafe==2.1.3
Requires-Dist: mdurl==0.1.2
Requires-Dist: numpy==1.26.2
Requires-Dist: pandas==2.1.3
Requires-Dist: pygments==2.16.1
Requires-Dist: python-dateutil==2.8.2
Requires-Dist: pytz==2023.3.post1
Requires-Dist: requests==2.31.0
Requires-Dist: rich==13.6.0
Requires-Dist: rich-click==1.7.1
Requires-Dist: six==1.16.0
Requires-Dist: soupsieve==2.5
Requires-Dist: tqdm==4.66.1
Requires-Dist: typing-extensions==4.8.0
Requires-Dist: tzdata==2023.3
Requires-Dist: urllib3==2.0.7
Requires-Dist: tomli>=1.1.0; python_version < "3.11"

[![Build Status](https://github.com/andgineer/goodreads-export/workflows/Test/badge.svg)](https://github.com/andgineer/goodreads-export/actions)
[![Coverage](https://raw.githubusercontent.com/andgineer/goodreads-export/python-coverage-comment-action-data/badge.svg)](https://htmlpreview.github.io/?https://github.com/andgineer/goodreads-export/blob/python-coverage-comment-action-data/htmlcov/index.html)
# Export goodreads books into markdown files (Obsidian etc)

Transform your goodreads.com book reviews into structured markdown files,
ideal for use in [Obsidian](https://obsidian.md/) and other markdown-based applications.

- **Goodreads Book Page Links:** Each markdown file contains a direct link to the corresponding book's page on Goodreads.
- **Calibre Integration:** Includes a [Calibre](https://calibre-ebook.com/) URL for each book, allowing quick searches
in your local Calibre collection.
- **Tagging Based on Goodreads Shelves:** Reviews are automatically categorized with tags derived from your Goodreads shelves.
- **Customizable Templates:** Utilizing Jinja2 templates, the output format can be easily customized to suit your specific needs or preferences.

# User manual

[goodreads-export](https://andgineer.github.io/goodreads-export/en/)

# Developers
### Codebase structure
[Auto-generated reference](https://andgineer.github.io/goodreads-export/docstrings/).

### Create / activate environment
    . ./activate.sh

It will also install the package in [edit mode](https://realpython.com/what-is-pip/#installing-packages-in-editable-mode-to-ease-development).

### Setting Up Pre-commit for Formatting and Static Checks

1. **Install Pre-commit**:
   ```bash
   pip install pre-commit
   ```

2. **Configure Pre-commit**:
   ```bash
   pre-commit install
   ```

This sets up `pre-commit` in your local environment to run the same static checks as the `static` GitHub Action.

### Scripts
    make help

## Coverage report
* [Codecov](https://app.codecov.io/gh/andgineer/goodreads-export/tree/main/src%2Fgoodreads_export)
* [Coveralls](https://coveralls.io/github/andgineer/goodreads-export)
