This application allows users to check if a given stock is considered halal (permissible) according to Islamic principles. It uses a web scraper to fetch a list of halal stocks and provides a terminal user interface (TUI) for easy interaction.
- Web scraping of halal stocks from a reliable source
- Terminal user interface for easy stock checking
- Asynchronous stock fetching with progress bar
- Simple and intuitive user interaction
- Clone this repository:
git clone https://github.com/shajeen/halal-stock-checker.git
cd halal-stock-checker
- Install the required dependencies:
pip install -r requirements.txt
Run the application using:
python tui_checker.py
Once the application starts:
- Wait for the initial stock fetching to complete.
- Enter a stock name in the input field.
- Click the "Check Stock" button or press Enter.
- The result will be displayed in the result area.
tui_checker.py
: Main application file containing the TUI implementation[3].halal_stock.py
: Module for scraping halal stocks from the web[1].requirements.txt
: List of Python dependencies[2].
- requests: For making HTTP requests
- beautifulsoup4: For parsing HTML content
- textual: For creating the terminal user interface
- tqdm: For displaying progress
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.