Releases: marsonwork/Raspberry-Pi-5-Stock-Tracker
Raspberry Pi 5 Stock Tracker: v2.0.0
Overview
This release introduces the initial version (v1.0) of the Product Availability Tracker script. The script is designed to monitor the availability of products on specified webpages and notify users via email when a product becomes available. It includes features for configuration loading, email notification, and product status tracking.
Key Features
1. Stock Availability Checking
- The
stock_availability
function checks the availability of a product on a given webpage by parsing the HTML content. - It extracts and cleans the stock availability information, providing users with up-to-date product status.
2. Email Configuration
- The
config_email
function loads email configuration from a JSON file, including sender email, sender password, and recipient email. - This allows users to customize email settings without modifying the script.
3. Email Notification
- The
send_email
function sends email notifications when a product becomes available. - It utilizes the Gmail SMTP server for email delivery and provides feedback on the success or failure of the email sending process.
4. Main Workflow
- The
main
function orchestrates the overall product availability checking and notification process. - It reads product details and email configuration from JSON files, iterates through products, checks availability, sends notifications, and updates the product status.
How to Use
-
Product Configuration:
- Create a
products.json
file with details of the products to monitor, including the product URL and stock class.
- Create a
-
Email Configuration:
- Create an
email-config.json
file with the sender's email, sender's password, and recipient's email.
- Create an
-
Run the Script:
- Execute the script to start monitoring the specified products for availability changes.
- The script can be scheduled to run periodically to provide timely notifications.
Release Notes
-
Enhancements:
- This release brings a significant overhaul with enhanced features for product availability tracking and email notification.
-
Known Issues:
- No known issues in this release.
-
Future Plans:
- Future releases may include additional features such as multiple product support, improved error handling, and enhanced notification options.
Feedback and Contributions
We welcome user feedback and contributions to enhance the functionality and reliability of the Product Availability Tracker. Please feel free to open issues or submit pull requests on the GitHub repository.
Thank you for choosing the Product Availability Tracker!
v1.0.0 - Initial Release
New Features:
- Implemented a Python script to check the stock availability of Raspberry Pi 5 on a specified seller's website.
- Added functionality to send a notification email using Gmail when the product is in stock.
- Configured the script to run periodically, checking for stock availability every 5 minutes.
Prerequisites:
- Ensure Python (version 3.x recommended) is installed.
- Install required Python packages (
requests
,bs4
- BeautifulSoup,smtplib
). - Have a Gmail account for sending notification emails.
Setup Instructions:
- Install dependencies with
pip install requests beautifulsoup4
. - Create two JSON files (
email-config.json
andrecipient-mail-data.json
) in the same directory as the script, providing necessary configuration details. - Execute the script using
python script_name.py
.
Important Notes:
- Comply with the terms of service of the seller's website when using this script.
- Use the script responsibly to avoid excessive requests to the seller's website.
- Exercise caution when handling email credentials in the script; consider secure methods.
Customization:
- Feel free to customize the script or improve it based on specific needs.
- Adjust the frequency of stock checks or modify the email notification content as desired.
Versioning:
- This is the initial release marked as v1.0.0.
- Future updates may include additional features, bug fixes, or improvements based on user feedback.
Thank you for using the Raspberry Pi 5 Stock Availability Notifier! Your feedback is valuable for future enhancements.