tbr-deal-finder 0.1.6__tar.gz → 0.1.8__tar.gz

tbr_deal_finder-0.1.8/CHANGELOG.md

@@ -0,0 +1,52 @@
+
+# Change Log
+
+---
+
+## 0.1.8 (August 13, 2025)
+
+Notes: 
+* Improved performance for tracking on libro
+* Preparing EBook support
+
+BUG FIXES:
+* Fixed initial login issue in libro.fm
+
+---
+
+## 0.1.7 (July 31, 2025)
+
+Notes: 
+* tbr-deal-finder no longer shows deals on books you own in the same format.
+  * Example: You own Dune on Audible so it won't show on Audible, Libro, or Chirp. It will show on Kindle (you don't own the ebook)
+* Improvements when attempting to match authors
+  * Chirp
+  * Libro.FM
+* Users no longer need to provide an export and can instead just track deals on their wishlist
+
+BUG FIXES:
+* Fixed wishlist pagination in libro.fm
+* Fixed issue forcing user to go through setup twice when running the setup command 
+
+---
+
+## 0.1.6 (July 30, 2025)
+
+Notes: 
+* tbr-deal-finder now also tracks deals on the books in your wishlist. Works for all retailers.   
+
+BUG FIXES:
+* Fixed issue where no deals would display if libro is the only tracked audiobook retailer.
+* Fixed retailer cli setup forcing a user to select at least two audiobook retailers.
+
+---
+
+## 0.1.5 (July 30, 2025)
+
+Notes: 
+* Added formatting to select messages to make the messages purpose clearer.
+
+BUG FIXES:
+* Fixed issue getting books from libro and chirp too aggressively
+* User must now track deals for at least one retailer 
+

tbr_deal_finder-0.1.8/DESIGN.md

@@ -0,0 +1,113 @@
+# TBR Deal Finder Design
+
+## Overview
+TBR Deal Finder is a CLI application that helps users track price drops and find deals on books in their To-Be-Read (TBR) list across various digital book retailers. The application is built with a modular architecture that separates data ingestion, processing, and output concerns.
+
+## Terms
+### Digital Book
+A book in electronic format, accessible via digital devices. Includes:
+- Audiobooks
+- E-books
+
+### Digital Book Retailer
+Platforms that sell or distribute digital books, such as:
+- Libro.fm (audiobooks)
+- Audible (audiobooks)
+- Kindle (e-books)
+- Chirp (discounted audiobooks)
+
+### Library Export
+A data file containing a user's reading list and status. Sources include:
+- **Automated Exports**:
+  - The StoryGraph
+  - Goodreads
+- **Manual CSVs**: Custom spreadsheets following the required format
+
+### TBR (To Be Read)
+A user's personal reading list of books they plan to read in the future.
+
+## Core Components
+
+### 1. Data Ingestion Layer
+- **Library Exports**: Handles importing book data from multiple sources:
+  - The StoryGraph exports
+  - Goodreads exports
+  - Custom CSV files
+- **Retailer APIs**: Interfaces with various digital book retailers to fetch current pricing and availability
+
+### 2. Core Data Model
+
+#### `Book` Class
+The central data structure that represents a book across the application:
+- **Purpose**: Serves as a consistent contract between different components
+- **Key Attributes**:
+  - Title and author information
+  - Format (Audiobook, Ebook, etc.)
+  - Pricing information (list price, current price)
+  - Retailer-specific metadata
+  - Timestamp for deal tracking
+
+### 3. Retailer Interface
+
+#### `Retailer` Base Class
+Abstract base class that defines the interface for all retailer implementations:
+- **Core Methods**:
+  - `get_book()`: Fetches book details from the retailer
+  - `get_wishlist()`: Retrieves the user's wishlist
+  - `get_library()`: Gets the user's purchased/owned books
+- **Current Implementations**:
+  - Audible
+  - Libro.fm
+  - Chirp
+  - Kindle (planned)
+
+### 4. Processing Pipeline
+1. **Data Collection**:
+   - Load TBR lists from configured sources
+   - Fetch owned books from retailers
+   - Retrieve current deals and pricing
+
+2. **Matching Logic**:
+   - Matches TBR books with retailer inventory
+   - Filters out owned books
+   - Identifies price drops and deals
+
+3. **Output Generation**:
+   - Formats results for CLI display
+   - Highlights best deals
+   - Provides purchase links
+
+## Data Flow
+
+```mermaid
+graph TD
+    A[Library Exports] -->|CSV/JSON| B[Book Objects]
+    C[Retailer APIs] -->|API Calls| B
+    B --> D[Deal Processing]
+    D --> E[CLI Output]
+    F[User Configuration] -->|Settings| C
+    F -->|Preferences| D
+```
+
+## Key Design Decisions
+
+### 1. Extensibility
+- Retailer implementations are pluggable through the `Retailer` base class
+- Support for multiple export formats and retailer APIs
+
+### 2. Performance
+- Asynchronous I/O for API calls
+- Caching of retailer responses
+- Efficient data structures for book matching
+
+### 3. User Experience
+- Clear, concise command-line interface
+- Configurable output formats
+- Progress indicators for long-running operations
+
+## Future Considerations
+- Support for more retailer APIs
+- Email notifications for price drops
+- Web interface for easier configuration
+- Integration with library lending services
+- Price history tracking

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tbr-deal-finder
-Version: 0.1.6
+Version: 0.1.8
 Summary: Track price drops and find deals on books in your TBR list across audiobook and ebook formats.
 License: MIT
 License-File: LICENSE
@@ -9,6 +9,7 @@ Requires-Dist: aiohttp>=3.12.14
 Requires-Dist: audible==0.8.2
 Requires-Dist: click>=8.2.1
 Requires-Dist: duckdb>=1.3.2
+Requires-Dist: levenshtein>=0.27.1
 Requires-Dist: pandas>=2.3.1
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: tqdm>=4.67.1
@@ -17,16 +18,17 @@ Description-Content-Type: text/markdown
 
 # tbr-deal-finder
 
-Track price drops and find deals on books in your TBR (To Be Read) list across audiobook and ebook formats.
+Track price drops and find deals on books in your TBR (To Be Read) and wishlist across digital book retailers.
 
 ## Features
-- Uses your StoryGraph exports, Goodreads exports, and custom csvs (spreadsheet) to track book deals
+- Use your StoryGraph exports, Goodreads exports, and custom csvs (spreadsheet) to track book deals
 - Supports multiple of the library exports above
 - Tracks deals on the wishlist of all your configured retailers like audible 
 - Supports multiple locales and currencies
-- Finds the latest and active deals from supported sellers
+- Find the latest and active deals from supported sellers
 - Simple CLI interface for setup and usage
 - Only get notified for new deals or view all active deals 
+- Filters out books you already own to prevent purchasing the same book on multiple retailers
 
 ## Support
 
@@ -54,7 +56,7 @@ Track price drops and find deals on books in your TBR (To Be Read) list across a
 1. If it's not already on your computer, download Python https://www.python.org/downloads/
    1. tbr-deal-finder requires Python3.13 or higher
 2. Optional: Install and use virtualenv
-3. Open your Terminal/Commmand Prompt
+3. Open your Terminal/Command Prompt
 4. Run `pip3.13 install tbr-deal-finder`
 
 ### UV
@@ -67,7 +69,7 @@ Track price drops and find deals on books in your TBR (To Be Read) list across a
    https://docs.astral.sh/uv/getting-started/installation/
 
 ## Configuration
-This tool relies on the csv generated by the app you use to track your TBRs.
+This tool can use the csv generated by the app you use to track your TBRs.
 Here are the steps to get your export.
 
 ### StoryGraph

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/README.md

@@ -1,15 +1,16 @@
 # tbr-deal-finder
 
-Track price drops and find deals on books in your TBR (To Be Read) list across audiobook and ebook formats.
+Track price drops and find deals on books in your TBR (To Be Read) and wishlist across digital book retailers.
 
 ## Features
-- Uses your StoryGraph exports, Goodreads exports, and custom csvs (spreadsheet) to track book deals
+- Use your StoryGraph exports, Goodreads exports, and custom csvs (spreadsheet) to track book deals
 - Supports multiple of the library exports above
 - Tracks deals on the wishlist of all your configured retailers like audible 
 - Supports multiple locales and currencies
-- Finds the latest and active deals from supported sellers
+- Find the latest and active deals from supported sellers
 - Simple CLI interface for setup and usage
 - Only get notified for new deals or view all active deals 
+- Filters out books you already own to prevent purchasing the same book on multiple retailers
 
 ## Support
 
@@ -37,7 +38,7 @@ Track price drops and find deals on books in your TBR (To Be Read) list across a
 1. If it's not already on your computer, download Python https://www.python.org/downloads/
    1. tbr-deal-finder requires Python3.13 or higher
 2. Optional: Install and use virtualenv
-3. Open your Terminal/Commmand Prompt
+3. Open your Terminal/Command Prompt
 4. Run `pip3.13 install tbr-deal-finder`
 
 ### UV
@@ -50,7 +51,7 @@ Track price drops and find deals on books in your TBR (To Be Read) list across a
    https://docs.astral.sh/uv/getting-started/installation/
 
 ## Configuration
-This tool relies on the csv generated by the app you use to track your TBRs.
+This tool can use the csv generated by the app you use to track your TBRs.
 Here are the steps to get your export.
 
 ### StoryGraph

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tbr-deal-finder"
-version = "0.1.6"
+version = "0.1.8"
 description = "Track price drops and find deals on books in your TBR list across audiobook and ebook formats."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -10,6 +10,7 @@ dependencies = [
     "audible==0.8.2",
     "click>=8.2.1",
     "duckdb>=1.3.2",
+    "levenshtein>=0.27.1",
     "pandas>=2.3.1",
     "questionary>=2.1.0",
     "tqdm>=4.67.1",

tbr_deal_finder-0.1.8/tbr_deal_finder/book.py

@@ -0,0 +1,189 @@
+import re
+from datetime import datetime
+from enum import Enum
+from typing import Union
+
+import click
+from Levenshtein import ratio
+from unidecode import unidecode
+
+from tbr_deal_finder.config import Config
+from tbr_deal_finder.utils import get_duckdb_conn, execute_query, get_query_by_name
+
+_AUTHOR_RE = re.compile(r'[^a-zA-Z0-9]')
+
+class BookFormat(Enum):
+    AUDIOBOOK = "Audiobook"
+    EBOOK = "E-Book"
+    NA = "N/A"  # When the format doesn't matter
+
+
+class Book:
+
+    def __init__(
+        self,
+        retailer: str,
+        title: str,
+        authors: str,
+        timepoint: datetime,
+        format: Union[BookFormat, str],
+        list_price: float = 0,
+        current_price: float = 0,
+        ebook_asin: str = None,
+        audiobook_isbn: str = None,
+        audiobook_list_price: float = 0,
+        deleted: bool = False,
+        exists: bool = True,
+    ):
+        self.retailer = retailer
+        self.title = title.split(":")[0].split("(")[0].strip()
+        self.authors = authors
+        self.timepoint = timepoint
+
+        self.ebook_asin = ebook_asin
+        self.audiobook_isbn = audiobook_isbn
+        self.audiobook_list_price = audiobook_list_price
+        self.deleted = deleted
+        self.exists = exists
+
+        self.list_price = list_price
+        self.current_price = current_price
+        self.normalized_authors = get_normalized_authors(authors)
+
+        if isinstance(format, str):
+            format = BookFormat(format)
+        self.format = format
+
+    def discount(self) -> int:
+        return int((self.list_price/self.current_price - 1) * 100)
+
+    @staticmethod
+    def price_to_string(price: float) -> str:
+        return f"{Config.currency_symbol()}{price:.2f}"
+
+    @property
+    def deal_id(self) -> str:
+        return f"{self.title}__{self.normalized_authors}__{self.format}__{self.retailer}"
+
+    @property
+    def title_id(self) -> str:
+        return f"{self.title}__{self.normalized_authors}__{self.format}"
+
+    @property
+    def full_title_str(self) -> str:
+        return f"{self.title}__{self.normalized_authors}"
+
+    @property
+    def current_price(self) -> float:
+        return self._current_price
+
+    @current_price.setter
+    def current_price(self, price: float):
+        self._current_price = round(price, 2)
+
+    @property
+    def list_price(self) -> float:
+        return self._list_price
+
+    @list_price.setter
+    def list_price(self, price: float):
+        self._list_price = round(price, 2)
+
+    def list_price_string(self):
+        return self.price_to_string(self.list_price)
+
+    def current_price_string(self):
+        return self.price_to_string(self.current_price)
+
+    def __str__(self) -> str:
+        price = self.current_price_string()
+        book_format = self.format.value
+        title = self.title
+        if len(self.title) > 75:
+            title = f"{title[:75]}..."
+        return f"{title} by {self.authors} - {price} - {self.discount()}% Off at {self.retailer}"
+
+    def dict(self):
+        return {
+            "retailer": self.retailer,
+            "title": self.title,
+            "authors": self.authors,
+            "list_price": self.list_price,
+            "current_price": self.current_price,
+            "timepoint": self.timepoint,
+            "format": self.format.value,
+            "deleted": self.deleted,
+            "deal_id": self.deal_id,
+        }
+
+    def tbr_dict(self):
+        return {
+            "title": self.title,
+            "authors": self.authors,
+            "format": self.format.value,
+            "ebook_asin": self.ebook_asin,
+            "audiobook_isbn": self.audiobook_isbn,
+            "audiobook_list_price": self.audiobook_list_price,
+            "book_id": self.title_id,
+        }
+
+
+def get_deals_found_at(timepoint: datetime) -> list[Book]:
+    db_conn = get_duckdb_conn()
+    query_response = execute_query(
+        db_conn,
+        get_query_by_name("get_deals_found_at.sql"),
+        {"timepoint": timepoint}
+    )
+    return [Book(**book) for book in query_response]
+
+
+def get_active_deals() -> list[Book]:
+    db_conn = get_duckdb_conn()
+    query_response = execute_query(
+        db_conn,
+        get_query_by_name("get_active_deals.sql")
+    )
+    return [Book(**book) for book in query_response]
+
+
+def print_books(books: list[Book]):
+    prior_title_id = books[0].title_id
+    for book in books:
+        if prior_title_id != book.title_id:
+            prior_title_id = book.title_id
+            click.echo()
+
+        click.echo(str(book))
+
+
+def get_full_title_str(title: str, authors: Union[list, str]) -> str:
+    return f"{title}__{get_normalized_authors(authors)}"
+
+
+def get_title_id(title: str, authors: Union[list, str], book_format: BookFormat) -> str:
+    return f"{title}__{get_normalized_authors(authors)}__{book_format.value}"
+
+
+def get_normalized_authors(authors: Union[str, list[str]]) -> list[str]:
+    if isinstance(authors, str):
+        authors = [i for i in authors.split(",")]
+
+    return sorted([_AUTHOR_RE.sub('', unidecode(author)).lower() for author in authors])
+
+
+def is_matching_authors(a1: list[str], a2: list[str]) -> bool:
+    """Checks if two normalized authors are matching.
+    Matching here means that they are at least 80% similar using levenshtein distance.
+
+    Score is calculated as follows:
+        1 - (distance / (len1 + len2))
+
+    :param a1:
+    :param a2:
+    :return:
+    """
+    return any(
+        any(ratio(author1, author2, score_cutoff=.8) for author2 in a2)
+        for author1 in a1
+    )

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/tbr_deal_finder/cli.py

@@ -9,11 +9,11 @@ import click
 import questionary
 
 from tbr_deal_finder.config import Config
-from tbr_deal_finder.library_exports import maybe_enrich_library_exports
 from tbr_deal_finder.migrations import make_migrations
 from tbr_deal_finder.book import get_deals_found_at, print_books, get_active_deals
 from tbr_deal_finder.retailer import RETAILER_MAP
 from tbr_deal_finder.retailer_deal import get_latest_deals
+from tbr_deal_finder.tracked_books import reprocess_incomplete_tbr_books
 from tbr_deal_finder.utils import (
     echo_err,
     echo_info,
@@ -28,12 +28,6 @@ from tbr_deal_finder.utils import (
 def cli():
     make_migrations()
 
-    # Check that the config exists for all commands ran
-    try:
-        Config.load()
-    except FileNotFoundError:
-        _set_config()
-
 
 def _add_path(existing_paths: list[str]) -> Union[str, None]:
     try:
@@ -68,24 +62,26 @@ def _set_library_export_paths(config: Config):
     Ensures that only valid, unique paths are added. Updates the config in-place.
     """
     while True:
-        if config.library_export_paths:
-            if len(config.library_export_paths) > 1:
-                choices = ["Add new path", "Remove path", "Done"]
-            else:
-                choices = ["Add new path", "Done"]
-
-            try:
-                user_selection = questionary.select(
-                    "What change would you like to make to your library export paths",
-                    choices=choices,
-                ).ask()
-            except (KeyError, KeyboardInterrupt, TypeError):
-                return
+        if len(config.library_export_paths) > 0:
+            choices = ["Add new path", "Remove path", "Done"]
         else:
-            click.echo("Add your library export path.")
-            user_selection = "Add new path"
+            choices = ["Add new path", "Done"]
+
+        try:
+            user_selection = questionary.select(
+                "What change would you like to make to your library export paths",
+                choices=choices,
+            ).ask()
+        except (KeyError, KeyboardInterrupt, TypeError):
+            return
 
         if user_selection == "Done":
+            if not config.library_export_paths:
+                if not click.confirm(
+                    "Don't add a GoodReads or StoryGraph export and use wishlist entirely? "
+                    "Note: Wishlist checks will still work even if you add your StoryGraph/GoodReads export."
+                ):
+                    continue
             return
         elif user_selection == "Add new path":
             if new_path := _add_path(config.library_export_paths):
@@ -184,13 +180,18 @@ def _set_config() -> Config:
 def setup():
     _set_config()
 
+    # Retailers may have changed causing some books to need reprocessing
+    config = Config.load()
+    reprocess_incomplete_tbr_books(config)
+
 
 @cli.command()
 def latest_deals():
     """Find book deals from your Library export."""
-    config = Config.load()
-
-    asyncio.run(maybe_enrich_library_exports(config))
+    try:
+        config = Config.load()
+    except FileNotFoundError:
+        config = _set_config()
 
     db_conn = get_duckdb_conn()
     results = execute_query(

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/tbr_deal_finder/config.py

@@ -62,10 +62,16 @@ class Config:
         tracked_retailers_str = parser.get('DEFAULT', 'tracked_retailers')
         locale = parser.get('DEFAULT', 'locale', fallback="us")
         cls.set_locale(locale)
+
+        if export_paths_str:
+            library_export_paths = [i.strip() for i in export_paths_str.split(",")]
+        else:
+            library_export_paths = []
+
         return cls(
             max_price=parser.getfloat('DEFAULT', 'max_price', fallback=8.0),  
             min_discount=parser.getint('DEFAULT', 'min_discount', fallback=35),
-            library_export_paths=[i.strip() for i in export_paths_str.split(",")],
+            library_export_paths=library_export_paths,
             tracked_retailers=[i.strip() for i in tracked_retailers_str.split(",")]
         )
 
@@ -77,8 +83,20 @@ class Config:
     def tracked_retailers_str(self) -> str:
         return ", ".join(self.tracked_retailers)
 
+    def is_tracking_format(self, book_format) -> bool:
+        from tbr_deal_finder.retailer import RETAILER_MAP
+
+        for retailer_str in self.tracked_retailers:
+            retailer = RETAILER_MAP[retailer_str]()
+            if retailer.format == book_format:
+                return True
+
+        return False
+
     def set_library_export_paths(self, library_export_paths: Union[str, list[str]]):
-        if isinstance(library_export_paths, str):
+        if not library_export_paths:
+            self.library_export_paths = []
+        elif isinstance(library_export_paths, str):
             self.library_export_paths = [i.strip() for i in library_export_paths.split(",")]
         else:
             self.library_export_paths = library_export_paths

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/tbr_deal_finder/migrations.py

@@ -46,6 +46,22 @@ _MIGRATIONS = [
             );
             """
     ),
+    TableMigration(
+        version=1,
+        table_name="tbr_book",
+        sql="""
+            CREATE TABLE tbr_book
+            (
+                title                VARCHAR,
+                authors              VARCHAR,
+                format               VARCHAR,
+                ebook_asin           VARCHAR,
+                audiobook_isbn       VARCHAR,
+                audiobook_list_price FLOAT,
+                book_id              VARCHAR
+            );
+            """
+    ),
 ]
 
 

tbr_deal_finder-0.1.8/tbr_deal_finder/owned_books.py

@@ -0,0 +1,18 @@
+from tbr_deal_finder.book import Book
+from tbr_deal_finder.config import Config
+from tbr_deal_finder.retailer import RETAILER_MAP
+from tbr_deal_finder.retailer.models import Retailer
+
+
+async def get_owned_books(config: Config) -> list[Book]:
+    owned_books = []
+
+    for retailer_str in config.tracked_retailers:
+        retailer: Retailer = RETAILER_MAP[retailer_str]()
+        await retailer.set_auth()
+
+        owned_books.extend(
+            await retailer.get_library(config)
+        )
+
+    return owned_books

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/tbr_deal_finder/queries/get_active_deals.sql

@@ -1,4 +1,4 @@
-SELECT *
+SELECT * exclude(deal_id)
 FROM retailer_deal
 QUALIFY	ROW_NUMBER() OVER (PARTITION BY title, authors, retailer, format ORDER BY timepoint DESC) = 1 AND deleted IS NOT TRUE
 ORDER BY title, authors, retailer, format

{tbr_deal_finder-0.1.6 → tbr_deal_finder-0.1.8}/tbr_deal_finder/queries/get_deals_found_at.sql

@@ -1,4 +1,4 @@
-SELECT *
+SELECT * exclude(deal_id)
 FROM retailer_deal
 WHERE timepoint = $timepoint AND deleted IS NOT TRUE
 ORDER BY title, authors, retailer, format