AGENTS.md

Project

Python bot automating appointment requests (French immigration/visa). Multi-threaded HTTP workers + MongoDB tracking + RabbitMQ queuing. FastAPI wrapper (api/) provides HTTP/WebSocket control plane.

Install

pip install -r requirements.txt     # main bot
pip install pymongo                  # NOT in requirements.txt but required by db/mongo_manager.py
pip install -r api_requirements.txt  # FastAPI wrapper only

Run Commands

python scheduler.py              # production cron (Mon–Sat 10:30 Europe/Paris)
python scheduler_test.py         # test variant (Mon–Sun)
python request_sender_test.py    # manual run — edit hardcoded `file_list` at bottom first
python scheduler_link_validator.py

uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload  # FastAPI server

No Tests / No Lint / No Typecheck

*_test.py files are standalone scripts, not pytest tests. Run them with python, not pytest. There is no test framework, no linter, no formatter, no CI configured.

Key Quirks

utiles.py (intentional typo) — time utility module. Imported as from utiles import is_time_between. Do not rename.
requirements.txt incomplete — pymongo missing; must be installed separately.
venv/ is committed — do not delete.
.env file required for FastAPI server: API_KEY, API_HOST, API_PORT, LOG_LEVEL, ALLOWED_ORIGINS, DEFAULT_THREAD_NUMBER, DEFAULT_STOP_HOUR, DEFAULT_STOP_MINS.
MongoDB env vars — MONGO_USERNAME and MONGO_PASSWORD must be set; db/mongo_manager.py raises ValueError if missing. Hardcoded host: mongo2.lpaconsulting.fr.
RabbitMQ credentials hardcoded in queue_message/CookiesPublisher.py. Host: appointment.lpaconsulting.fr:5672.
curl_cffi used for HTTP (not requests/httpx) to bypass TLS fingerprinting / bot detection.
Module-level side effects — importing request_sender.py calls init_logger() at import time (no __main__ guard).

External Service Dependencies

Bot will fail without network access to:

MongoDB at mongo2.lpaconsulting.fr (needs env vars)
RabbitMQ at appointment.lpaconsulting.fr:5672
Proxy servers defined in workers/proxies_constants.py and workers/proxy_constants.py

Structure

api/              FastAPI control plane (start/stop, log streaming)
captcha/          CAPTCHA solver wrapper
db/               MongoDB singleton (MONGO_STORE_MANAGER)
mail/             IMAP helpers
models/           Data POJOs (ContactPojo, LinkPojo, etc.)
proxy_manager/    Proxy list management
queue_message/    RabbitMQ publisher/consumer (pika)
utils/            Misc helpers (logging, cookies, JS data)
workers/          Core HTTP workers (sender, link validator, cookie generator)
excel_reader.py   Reads .xlsx contact lists via openpyxl
utiles.py         Time utility (note spelling)
scheduler.py      Production APScheduler entry point

2.9 KiB Raw Blame History Unescape Escape