A Flask web application that helps manage and process PetScan lists for Wikipedia articles.

• Python 3.x
• pip (Python package installer)
• Wikipedia account with bot password

1. Clone this repository:

   git clone https://github.com/MrIbrahem/petscan_list.git
   cd petscan_list

2. Create a virtual environment (recommended):

   python -m venv venv
   source venv/bin/activate  # On Linux/Mac
   # or
   .\venv\Scripts\activate  # On Windows

3. Install the required dependencies:

   pip install -r requirements.txt

1. Create a bot password for your Wikipedia account:

   • Go to Special:BotPasswords on Wikipedia (https://ar.wikipedia.org/wiki/Special:BotPasswords)
   • Create a new bot password with necessary permissions

2. Set up your credentials:

   • Create a .env file in the project root with the following content:

     WIKIPEDIA_BOT_USERNAME=YOUR_USERNAME
     WIKIPEDIA_BOT_PASSWORD=YOUR_BOT_PASSWORD

   Replace YOUR_USERNAME with your Wikipedia username and YOUR_BOT_PASSWORD with your bot password.

   Alternatively, you can set environment variables directly:

   set WIKIPEDIA_BOT_USERNAME=YOUR_USERNAME
   set WIKIPEDIA_BOT_PASSWORD=YOUR_BOT_PASSWORD

You can run this application in two different ways:

Start the Flask development server:

python app.py

Then open your web browser and navigate to:

http://localhost:5000

The web interface allows you to:

• Process individual Wikipedia articles
• View results directly in your browser
• Interactive usage with immediate feedback

Run the bot script to automatically process multiple pages:

python bot.py

The bot mode:

• Automatically searches for pages with "petscan list" template
• Processes all found pages in batch
• Works specifically with Arabic Wikipedia
• Runs continuously without manual intervention

• app.py - Main Flask web application file
• bot.py - Automated bot script for batch processing
• PetScanList/ - Core functionality modules
• templates/ - HTML templates
• static/ - Static files (JavaScript, CSS)
• confs/ - Configuration files including Wikipedia credentials

• runall.sh - Script to run all components
• update.sh - Script for updates

1. Navigate to the homepage at http://localhost:5000
2. Enter the Wikipedia article title
3. The application will process the PetScan list and display the results

1. Make sure your credentials are properly configured
2. Run python bot.py
3. The bot will automatically:
   • Find pages with "petscan list" template
   • Process each page
   • Show progress in the terminal

The application runs in debug mode by default when running locally, which provides detailed error messages and automatic reloading when code changes are made.

These parameters are optional:

• |_result_=table: to display the result in wikitable.
• |_line_format_=: Table to modify the value format, example:

  |_line_format_ = # {{user:Mr. Ibrahem/link|$1}}

• |output_limit = 3000: Maximum number of results to display.