tbr-deal-finder 0.1.7__tar.gz → 0.2.0__tar.gz

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/CHANGELOG.md

@@ -1,6 +1,35 @@
 
 # Change Log
 
+---
+
+## 0.2.0 (August 15, 2025)
+
+Notes: 
+* Added foundational Kindle support
+  * Library support is undecided right now
+    * Unable to find the endpoint
+  * Wishlist support is undecided right now
+    * Unable to find the endpoint 
+* Improvements to title matching for Audible & Chirp 
+* Improved request performance for Chirp & Libro
+
+BUG FIXES:
+* Fixed breaking import on Windows systems
+
+---
+
+## 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-0.1.7 → tbr_deal_finder-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tbr-deal-finder
-Version: 0.1.7
+Version: 0.2.0
 Summary: Track price drops and find deals on books in your TBR list across audiobook and ebook formats.
 License: MIT
 License-File: LICENSE
@@ -37,6 +37,9 @@ Track price drops and find deals on books in your TBR (To Be Read) and wishlist
 * Chirp
 * Libro.fm
 
+### EBooks
+* Kindle
+
 ### Locales
 * US
 * CA
@@ -56,7 +59,7 @@ Track price drops and find deals on books in your TBR (To Be Read) and wishlist
 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

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/README.md

@@ -19,6 +19,9 @@ Track price drops and find deals on books in your TBR (To Be Read) and wishlist
 * Chirp
 * Libro.fm
 
+### EBooks
+* Kindle
+
 ### Locales
 * US
 * CA
@@ -38,7 +41,7 @@ Track price drops and find deals on books in your TBR (To Be Read) and wishlist
 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

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tbr-deal-finder"
-version = "0.1.7"
+version = "0.2.0"
 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"

tbr_deal_finder-0.2.0/tbr_deal_finder/book.py

@@ -0,0 +1,206 @@
+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, echo_info
+
+_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 = get_normalized_title(title)
+        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]):
+    audiobooks = [book for book in books if book.format == BookFormat.AUDIOBOOK]
+    audiobooks = sorted(audiobooks, key=lambda book: book.deal_id)
+
+    ebooks = [book for book in books if book.format == BookFormat.EBOOK]
+    ebooks = sorted(ebooks, key=lambda book: book.deal_id)
+
+    for books_in_format in [audiobooks, ebooks]:
+        if not books_in_format:
+            continue
+
+        init_book = books_in_format[0]
+        echo_info(f"\n\n{init_book.format.value} Deals:")
+
+        prior_title_id = init_book.title_id
+        for book in books_in_format:
+            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_title(title: str) -> str:
+    return title.split(":")[0].split("(")[0].strip()
+
+
+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.7 → tbr_deal_finder-0.2.0}/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,
@@ -180,6 +180,10 @@ 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():
@@ -189,8 +193,6 @@ def latest_deals():
     except FileNotFoundError:
         config = _set_config()
 
-    asyncio.run(maybe_enrich_library_exports(config))
-
     db_conn = get_duckdb_conn()
     results = execute_query(
         db_conn,

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/tbr_deal_finder/config.py

@@ -83,6 +83,16 @@ 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 not library_export_paths:
             self.library_export_paths = []

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/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.7 → tbr_deal_finder-0.2.0}/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.7 → tbr_deal_finder-0.2.0}/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

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/tbr_deal_finder/retailer/__init__.py

@@ -1,9 +1,11 @@
 from tbr_deal_finder.retailer.audible import Audible
 from tbr_deal_finder.retailer.chirp import Chirp
+from tbr_deal_finder.retailer.kindle import Kindle
 from tbr_deal_finder.retailer.librofm import LibroFM
 
 RETAILER_MAP = {
     "Audible": Audible,
     "Chirp": Chirp,
     "Libro.FM": LibroFM,
+    "Kindle": Kindle,
 }

tbr_deal_finder-0.2.0/tbr_deal_finder/retailer/amazon.py

@@ -0,0 +1,85 @@
+import sys
+import os.path
+
+import audible
+import click
+from audible.login import build_init_cookies
+from textwrap import dedent
+
+if sys.platform != 'win32':
+    # Breaks Windows support but required for Mac
+    # Untested on Linux
+    import readline  # type: ignore
+
+from tbr_deal_finder import TBR_DEALS_PATH
+from tbr_deal_finder.config import Config
+from tbr_deal_finder.retailer.models import Retailer
+
+_AUTH_PATH = TBR_DEALS_PATH.joinpath("audible.json")
+
+
+def login_url_callback(url: str) -> str:
+    """Helper function for login with external browsers."""
+
+    try:
+        from playwright.sync_api import sync_playwright  # type: ignore
+    except ImportError:
+        pass
+    else:
+        with sync_playwright() as p:
+            iphone = p.devices["iPhone 12 Pro"]
+            browser = p.webkit.launch(headless=False)
+            context = browser.new_context(
+                **iphone
+            )
+            cookies = []
+            for name, value in build_init_cookies().items():
+                cookies.append(
+                    {
+                        "name": name,
+                        "value": value,
+                        "url": url
+                    }
+                )
+            context.add_cookies(cookies)
+            page = browser.new_page()
+            page.goto(url)
+
+            while True:
+                page.wait_for_timeout(600)
+                if "/ap/maplanding" in page.url:
+                    response_url = page.url
+                    break
+
+            browser.close()
+        return response_url
+
+    message = f"""\
+        Please copy the following url and insert it into a web browser of your choice to log into Amazon.
+        Note: your browser will show you an error page (Page not found). This is expected.
+        
+        {url}
+
+        Once you have logged in, please insert the copied url.
+    """
+    click.echo(dedent(message))
+    return input()
+
+
+class Amazon(Retailer):
+    _auth: audible.Authenticator = None
+    _client: audible.AsyncClient = None
+
+    async def set_auth(self):
+        if not os.path.exists(_AUTH_PATH):
+            auth = audible.Authenticator.from_login_external(
+                locale=Config.locale,
+                login_url_callback=login_url_callback
+            )
+
+            # Save credentials to file
+            auth.to_file(_AUTH_PATH)
+
+        self._auth = audible.Authenticator.from_file(_AUTH_PATH)
+        self._client = audible.AsyncClient(auth=self._auth)
+

{tbr_deal_finder-0.1.7 → tbr_deal_finder-0.2.0}/tbr_deal_finder/retailer/audible.py

@@ -1,74 +1,12 @@
 import asyncio
 import math
-import os.path
-from datetime import datetime
-from textwrap import dedent
-import readline  # type: ignore
 
-
-import audible
-import click
-from audible.login import build_init_cookies
-
-from tbr_deal_finder import TBR_DEALS_PATH
 from tbr_deal_finder.config import Config
-from tbr_deal_finder.retailer.models import Retailer
-from tbr_deal_finder.book import Book, BookFormat
-
-_AUTH_PATH = TBR_DEALS_PATH.joinpath("audible.json")
-
-
-def login_url_callback(url: str) -> str:
-    """Helper function for login with external browsers."""
-
-    try:
-        from playwright.sync_api import sync_playwright  # type: ignore
-    except ImportError:
-        pass
-    else:
-        with sync_playwright() as p:
-            iphone = p.devices["iPhone 12 Pro"]
-            browser = p.webkit.launch(headless=False)
-            context = browser.new_context(
-                **iphone
-            )
-            cookies = []
-            for name, value in build_init_cookies().items():
-                cookies.append(
-                    {
-                        "name": name,
-                        "value": value,
-                        "url": url
-                    }
-                )
-            context.add_cookies(cookies)
-            page = browser.new_page()
-            page.goto(url)
-
-            while True:
-                page.wait_for_timeout(600)
-                if "/ap/maplanding" in page.url:
-                    response_url = page.url
-                    break
-
-            browser.close()
-        return response_url
-
-    message = f"""\
-        Please copy the following url and insert it into a web browser of your choice to log into Amazon.
-        Note: your browser will show you an error page (Page not found). This is expected.
-        
-        {url}
+from tbr_deal_finder.retailer.amazon import Amazon
+from tbr_deal_finder.book import Book, BookFormat, get_normalized_title
 
-        Once you have logged in, please insert the copied url.
-    """
-    click.echo(dedent(message))
-    return input()
 
-
-class Audible(Retailer):
-    _auth: audible.Authenticator = None
-    _client: audible.AsyncClient = None
+class Audible(Amazon):
 
     @property
     def name(self) -> str:
@@ -78,23 +16,9 @@ class Audible(Retailer):
     def format(self) -> BookFormat:
         return BookFormat.AUDIOBOOK
 
-    async def set_auth(self):
-        if not os.path.exists(_AUTH_PATH):
-            auth = audible.Authenticator.from_login_external(
-                locale=Config.locale,
-                login_url_callback=login_url_callback
-            )
-
-            # Save credentials to file
-            auth.to_file(_AUTH_PATH)
-
-        self._auth = audible.Authenticator.from_file(_AUTH_PATH)
-        self._client = audible.AsyncClient(auth=self._auth)
-
     async def get_book(
         self,
         target: Book,
-        runtime: datetime,
         semaphore: asyncio.Semaphore
     ) -> Book:
         title = target.title
@@ -112,29 +36,18 @@ class Audible(Retailer):
             )
 
             for product in match.get("products", []):
-                if product["title"] != title:
+                if get_normalized_title(product["title"]) != title:
+                    continue
+                try:
+                    target.list_price = product["price"]["list_price"]["base"]
+                    target.current_price = product["price"]["lowest_price"]["base"]
+                    target.exists = True
+                    return target
+                except KeyError:
                     continue
 
-                return Book(
-                    retailer=self.name,
-                    title=title,
-                    authors=authors,
-                    list_price=product["price"]["list_price"]["base"],
-                    current_price=product["price"]["lowest_price"]["base"],
-                    timepoint=runtime,
-                    format=BookFormat.AUDIOBOOK
-                )
-
-            return Book(
-                retailer=self.name,
-                title=title,
-                authors=authors,
-                list_price=0,
-                current_price=0,
-                timepoint=runtime,
-                format=BookFormat.AUDIOBOOK,
-                exists=False,
-            )
+            target.exists = False
+            return target
 
     async def get_wishlist(self, config: Config) -> list[Book]:
         wishlist_books = []