test: privatehd icin live e2e testlerini ve test dokumantasyonunu ekle

README.md

@@ -227,6 +227,105 @@ Bu script:
 
 Kurulum daha önce tamamsa script aynı işlemleri baştan yapmaz; sadece eksikleri tamamlar.
 
+## Testler
+
+`wscraper` içinde canlı sistemlere karşı çalışan `pytest` tabanlı e2e testleri vardır. Bunlar varsayılan olarak kapalıdır; yalnızca açıkça etkinleştirildiğinde çalışırlar.
+
+Test dosyaları:
+
+- `tests/e2e/test_happyfappy_live.py`
+- `tests/e2e/test_privatehd_live.py`
+- `tests/e2e/_helpers.py`
+
+### Testleri Etkinleştirme
+
+Tüm live testler için:
+
+```bash
+export WSCRAPER_E2E=1
+```
+
+Bu değişken yoksa veya `1` değilse, e2e testleri `skip` olur.
+
+### HappyFappy Live Testleri
+
+Mevcut test kapsamı:
+
+- `get-bookmarks`
+- `download-torrent-files`
+
+Kullanılan env değişkenleri:
+
+- `WSCRAPER_COOKIE_FILE`
+- `WSCRAPER_TEST_TORRENT_URL`
+
+Örnek:
+
+```bash
+export WSCRAPER_E2E=1
+export WSCRAPER_COOKIE_FILE=/absolute/path/to/happyfappy-cookies.txt
+export WSCRAPER_TEST_TORRENT_URL="https://www.happyfappy.net/torrents.php?id=110178"
+pytest tests/e2e/test_happyfappy_live.py -m e2e -s
+```
+
+### PrivateHD Live Testleri
+
+PrivateHD için eklenen test kapsamı:
+
+- `get-bookmarks`
+- `download-torrent-files`
+- `remove-bookmark`
+
+Kullanılan env değişkenleri:
+
+- `WSCRAPER_PRIVATEHD_COOKIE_FILE`
+- `WSCRAPER_PRIVATEHD_WISHLIST_URL`
+- `WSCRAPER_PRIVATEHD_TEST_TORRENT_URL`
+- `WSCRAPER_PRIVATEHD_TEST_DOWNLOAD_URL`
+- `WSCRAPER_PRIVATEHD_TEST_REMOVE_URL`
+- `WSCRAPER_PRIVATEHD_TEST_REMOVE_TOKEN`
+
+Fallback kuralı:
+
+- `WSCRAPER_PRIVATEHD_COOKIE_FILE` yoksa `WSCRAPER_COOKIE_FILE` kullanılır
+
+Örnek:
+
+```bash
+export WSCRAPER_E2E=1
+export WSCRAPER_PRIVATEHD_COOKIE_FILE=/absolute/path/to/privatehd-cookies.txt
+export WSCRAPER_PRIVATEHD_WISHLIST_URL="https://privatehd.to/profile/blackdockers/wishlist"
+export WSCRAPER_PRIVATEHD_TEST_TORRENT_URL="https://privatehd.to/torrent/12345-example"
+export WSCRAPER_PRIVATEHD_TEST_DOWNLOAD_URL="https://privatehd.to/download/torrent/12345.example.torrent"
+pytest tests/e2e/test_privatehd_live.py -m e2e -s
+```
+
+### remove-bookmark Testi Hakkında
+
+`PrivateHD remove-bookmark` testi gerçek wishlist kaydını sildiği için özellikle dikkatli kullanılmalıdır.
+
+Bu test:
+
+- yalnızca `WSCRAPER_PRIVATEHD_TEST_REMOVE_URL` ve `WSCRAPER_PRIVATEHD_TEST_REMOVE_TOKEN` verilirse çalışır
+- aksi halde güvenli şekilde `skip` olur
+
+Örnek:
+
+```bash
+export WSCRAPER_E2E=1
+export WSCRAPER_PRIVATEHD_COOKIE_FILE=/absolute/path/to/privatehd-cookies.txt
+export WSCRAPER_PRIVATEHD_WISHLIST_URL="https://privatehd.to/profile/blackdockers/wishlist"
+export WSCRAPER_PRIVATEHD_TEST_REMOVE_URL="https://privatehd.to/torrent/12345-example"
+export WSCRAPER_PRIVATEHD_TEST_REMOVE_TOKEN="467471"
+pytest tests/e2e/test_privatehd_live.py -m e2e -s -k remove
+```
+
+### Notlar
+
+- Bu testler gerçek tracker hesaplarına ve geçerli cookie'lere ihtiyaç duyar
+- `remove-bookmark` testi mutasyon yapar; test datası bilinçli seçilmelidir
+- `tests/e2e/_helpers.py`, tüm tracker live testlerinde ortak CLI çalıştırma ve loglama yardımcılarını içerir
+
 ## Dizin Yapısı
 
 ```text