chore(changelog): update changelog for v1.1.0

.dockerignore

@@ -0,0 +1,3 @@
+__pycache__
+*.pyc
+data/

CHANGELOG.md

@@ -1,2 +1,20 @@
+## v1.1.0
+
+### Added
+- Docker support 🎉
+
+### Changed
+- Project source code moved to `/lbc-finder`
+- `id.json` and `logs` are now stored in `/data` for persistent storage (useful for Docker)
+
+## v1.0.1
+
+### Added
+- Retry-based error handling for ad handler calls (#3)
+- `contains` method in `ID` class (#3)
+
+### Changed
+- Bumped [lbc](https://github.com/etienne-hd/lbc) to v1.1.2
+
 ## v1.0.0
-* Initial release
+- Initial release

Dockerfile

@@ -0,0 +1,10 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY lbc-finder /app
+
+CMD ["python", "main.py"]

README.md

@@ -51,7 +51,6 @@ This project uses [lbc](https://github.com/etienne-hd/lbc), an unofficial librar
 * Easy integration with notifications (Discord, Telegram, email…) via handler
 
 ## Installation
-Docker support will be added soon.
 
 Required **Python 3.9+**
 1. **Clone the repository**
@@ -64,6 +63,53 @@ Required **Python 3.9+**
     pip install -r requirements.txt
     ```
 
+## Docker
+
+You can run **lbc-finder** using Docker without installing Python locally.
+
+### Pull the image
+
+The easiest way is to use the prebuilt image from Docker Hub:
+
+```bash
+docker pull etiennehode/lbc-finder:latest
+```
+
+### Build locally
+
+If you prefer to build the image yourself:
+
+```bash
+docker build -t lbc-finder .
+```
+
+### Run the container
+
+```bash
+docker run -d \
+  --name lbc-finder \
+  -v lbc_data:/app/data \
+  -v $(pwd)/config.py:/app/config.py \
+  etiennehode/lbc-finder:latest
+```
+
+### Volumes
+
+Two volumes are used:
+
+| Volume           | Description                         |
+| ---------------- | ----------------------------------- |
+| `/app/config.py` | Your search configuration file      |
+| `/app/data`      | Persistent storage for detected ads |
+
+Example:
+
+```bash
+-v $(pwd)/config.py:/app/config.py
+```
+
+This mounts your local `config.py` file into the container so you can easily edit your searches without rebuilding the image.
+
 ## Configuration
 A [config.py](config.py) file is provided by default in the project, it contains a basic configuration.
 
@@ -152,4 +198,4 @@ This project is licensed under the MIT License.
 
 <a href="https://www.buymeacoffee.com/etienneh" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
 
-You can contact me via [Telegram](https://t.me/etienne_hd) or [Discord](https://discord.com/users/1153975318990827552) if you need help with scraping services or want to write a library.
+You can reach out to me on [Telegram](https://t.me/etienne_hd) or [Discord](https://discord.com/users/1153975318990827552) if you're looking for custom scraping services.

lbc-finder/searcher/id.py

@@ -16,12 +16,13 @@ class ID:
 
     def _get_ids(self) -> List[str]:
         ids: List[str] = []
-        if os.path.exists("id.json"):
-            with open("id.json", "r") as f:
+        id_path = os.path.join("data", "id.json")
+        if os.path.exists(id_path):
+            with open(id_path, "r") as f:
                 try:
                     ids = json.load(f)
                 except json.JSONDecodeError:
-                    os.remove("id.json")
+                    os.remove(id_path)
                 except:
                     logger.exception("An error occurred while attempting to open the id.json file.")
         return ids
@@ -30,9 +31,10 @@ class ID:
         return id_ in self._ids
 
     def add(self, id_: str) -> bool:
+        id_path = os.path.join("data", "id.json")
         if not id_ in self._ids:
             self._ids.append(id_)
-            with open("id.json", "w") as f:
+            with open(id_path, "w") as f:
                 json.dump(self._ids[-MAX_ID:], f, indent=3)
             self._ids = self._ids[-MAX_ID:]
             return True

lbc-finder/searcher/logger.py

@@ -4,8 +4,8 @@ from datetime import datetime
 
 # File management
 timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
-file_path: str = os.path.join("logs", f"log_{timestamp}.log")
-os.makedirs("logs", exist_ok=True)
+file_path: str = os.path.join("data", "logs", f"log_{timestamp}.log")
+os.makedirs(os.path.join("data", "logs"), exist_ok=True)
 
 # Config logging
 logger = logging.getLogger("lbc-finder")