From 329b076caf3c979a6ce3a94f0c1508a89aee18d4 Mon Sep 17 00:00:00 2001
From: Yunn Xairou <clement+hub@beaubestre.fr>
Date: Sat, 13 Sep 2025 21:36:12 +0200
Subject: [PATCH] Update argument names and documentation for clarity in
 main.py and README.md

---
 main.py   | 26 +++++++++++++++++++++-----
 readme.md |  8 ++++++++
 2 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/main.py b/main.py
index 198e35b..96fb4ee 100644
--- a/main.py
+++ b/main.py
@@ -30,7 +30,7 @@ class BookCollection(dict):
         keys = expand_range(sequence)
 
         for key in keys:
-            if not args.hors_series and not float(key).is_integer():
+            if not args.non_series and not float(key).is_integer():
                 continue
             self.setdefault(key, [])
             self[key].append(book.asin)
@@ -189,7 +189,7 @@ def main():
                     except requests.exceptions.HTTPError:
                         pass
 
-                if not found:
+                if not found and args.oncoming:
                     soon_to_release_books.append(key)
                     logger.debug(
                         "%s Book %d is yet to be released - %s",
@@ -216,9 +216,25 @@ def main():
 if __name__ == "__main__":
 
     parser = argparse.ArgumentParser()
-    parser.add_argument("-d", "--dev", action="store_true")
-    parser.add_argument("-v", "--verbose", action="store_true")
-    parser.add_argument("--hors-series", action="store_true")
+    # General flags
+    parser.add_argument(
+        "-v", "--verbose", action="store_true", help="Enable verbose logging"
+    )
+    parser.add_argument(
+        "-d", "--dev", action="store_true", help="Use development/mock connectors"
+    )
+
+    # Feature-specific flags
+    parser.add_argument(
+        "--non-series",
+        action="store_true",
+        help="Include non-series books (books not part of a numbered series)",
+    )
+    parser.add_argument(
+        "--oncoming",
+        action="store_true",
+        help="Show books to be released",
+    )
 
     args = parser.parse_args()
 
diff --git a/readme.md b/readme.md
index dcc3aa2..864f010 100644
--- a/readme.md
+++ b/readme.md
@@ -32,6 +32,14 @@ python main.py
 
 Logs are written to the `log` file.
 
+### Feature-specific Arguments
+
+- `--non-series`  
+  Include non-series books (books not part of a numbered series).
+
+- `--oncoming`  
+  Show books that are yet to be released.
+
 ## Project Structure
 
 - [main.py](main.py): Entry point and main logic