refactor: Restructure downloaders with clear separation

This commit implements a complete reorganization of the downloader system
with a clear distinction between anime streaming sites and video hosting services.

## Structure Changes

**New Organization:**
- `app/downloaders/anime_sites/` - Anime streaming sites (catalogs + metadata)
- `app/downloaders/video_players/` - Video hosting services (file downloads)

**Base Classes:**
- `BaseAnimeSite` - For anime providers (search, episodes, metadata)
- `BaseVideoPlayer` - For video players (download link extraction)

**Migrated Downloaders:**
Anime Sites (4):
- AnimeSama, NekoSama, AnimeUltime, Vostfree

Video Players (8):
- Doodstream, Sibnet, VidMoly, SendVid, Lpayer, 1fichier, Uptobox, Rapidfile

## Key Improvements

1. **Clear Separation**: Distinct base classes for different use cases
2. **Preserved Functionality**: All existing features maintained
   - VidMoly: M3U8 support, Playwright, multi-domains, target_filename param
   - SendVid: target_filename parameter support
   - All others: No behavioral changes

3. **Better Organization**:
   - Anime sites: search_anime(), get_episodes(), get_anime_metadata()
   - Video players: get_download_link(url, target_filename=None)

4. **Fixed Imports**: Updated cross-imports in AnimeSama
   - from ..video_players.vidmoly import
   - from ..video_players.sendvid import
   - from ..video_players.sibnet import
   - from ..video_players.lpayer import

5. **Updated Tests**: All test imports use new structure
6. **Updated Providers**: Added 4 missing file hosts to providers.py

## Backward Compatibility

 Main API unchanged: get_downloader() works identically
 All 23 tests passing
 Frontend fully functional
 No breaking changes for users

## Documentation

- RESTRUCTURATION_SUMMARY.md - Technical details
- FIX_IMPORT_ERROR.md - Import error resolution
- IMPORT_VERIFICATION_REPORT.md - Complete import verification
- FRONTEND_VERIFICATION_FINAL.md - Frontend validation

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
This commit is contained in:
root
2026-01-24 22:13:20 +00:00
parent 1fe7392063
commit 3afad41d46
25 changed files with 1001 additions and 83 deletions
+13 -13
View File
@@ -18,7 +18,7 @@ class TestBaseDownloader:
def test_base_downloader_can_handle_not_implemented(self):
"""Test that can_handle raises NotImplementedError"""
from app.downloaders.uptobox import UptoboxDownloader
from app.downloaders.video_players.uptobox import UptoboxDownloader
downloader = UptoboxDownloader()
# Test with unsupported URL
@@ -26,7 +26,7 @@ class TestBaseDownloader:
def test_base_downloader_get_download_link_not_implemented(self):
"""Test that get_download_link works in concrete implementation"""
from app.downloaders.sendvid import SendVidDownloader
from app.downloaders.video_players.sendvid import SendVidDownloader
downloader = SendVidDownloader()
# Test that concrete implementation can be called
@@ -197,7 +197,7 @@ class TestDownloaderCanHandle:
def test_unfichier_can_handle(self):
"""Test UnfichierDownloader.can_handle"""
from app.downloaders.unfichier import UnFichierDownloader
from app.downloaders.video_players.unfichier import UnFichierDownloader
downloader = UnFichierDownloader()
assert downloader.can_handle("https://1fichier.com/?abc123") is True
@@ -208,7 +208,7 @@ class TestDownloaderCanHandle:
def test_doodstream_can_handle(self):
"""Test DoodStreamDownloader.can_handle"""
from app.downloaders.doodstream import DoodStreamDownloader
from app.downloaders.video_players.doodstream import DoodStreamDownloader
downloader = DoodStreamDownloader()
assert downloader.can_handle("https://doodstream.com/d/abc123") is True
@@ -218,7 +218,7 @@ class TestDownloaderCanHandle:
def test_rapidfile_can_handle(self):
"""Test RapidFileDownloader.can_handle"""
from app.downloaders.rapidfile import RapidFileDownloader
from app.downloaders.video_players.rapidfile import RapidFileDownloader
downloader = RapidFileDownloader()
assert downloader.can_handle("https://rapidfile.net/abc123") is True
@@ -227,7 +227,7 @@ class TestDownloaderCanHandle:
def test_uptobox_can_handle(self):
"""Test UptoboxDownloader.can_handle"""
from app.downloaders.uptobox import UptoboxDownloader
from app.downloaders.video_players.uptobox import UptoboxDownloader
downloader = UptoboxDownloader()
assert downloader.can_handle("https://uptobox.com/abc123") is True
@@ -236,7 +236,7 @@ class TestDownloaderCanHandle:
def test_vidmoly_can_handle(self):
"""Test VidMolyDownloader.can_handle"""
from app.downloaders.vidmoly import VidMolyDownloader
from app.downloaders.video_players.vidmoly import VidMolyDownloader
downloader = VidMolyDownloader()
assert downloader.can_handle("https://vidmoly.to/abc123") is True
@@ -247,7 +247,7 @@ class TestDownloaderCanHandle:
def test_sendvid_can_handle(self):
"""Test SendVidDownloader.can_handle"""
from app.downloaders.sendvid import SendVidDownloader
from app.downloaders.video_players.sendvid import SendVidDownloader
downloader = SendVidDownloader()
assert downloader.can_handle("https://sendvid.com/abc123") is True
@@ -260,7 +260,7 @@ class TestAnimeDownloaders:
@pytest.mark.asyncio
async def test_anime_sama_search(self):
"""Test AnimeSamaDownloader.search_anime"""
from app.downloaders.animesama import AnimeSamaDownloader
from app.downloaders.anime_sites.animesama import AnimeSamaDownloader
downloader = AnimeSamaDownloader()
with patch.object(downloader, '_fetch_page') as mock_fetch:
@@ -286,7 +286,7 @@ class TestAnimeDownloaders:
@pytest.mark.asyncio
async def test_neko_sama_can_handle(self):
"""Test NekoSamaDownloader.can_handle"""
from app.downloaders.nekosama import NekoSamaDownloader
from app.downloaders.anime_sites.nekosama import NekoSamaDownloader
downloader = NekoSamaDownloader()
assert downloader.can_handle("https://neko-sama.fr/test") is True
@@ -297,7 +297,7 @@ class TestAnimeDownloaders:
@pytest.mark.asyncio
async def test_anime_ultime_can_handle(self):
"""Test AnimeUltimeDownloader.can_handle"""
from app.downloaders.animeultime import AnimeUltimeDownloader
from app.downloaders.anime_sites.animeultime import AnimeUltimeDownloader
downloader = AnimeUltimeDownloader()
assert downloader.can_handle("https://anime-ultime.net/test") is True
@@ -306,7 +306,7 @@ class TestAnimeDownloaders:
@pytest.mark.asyncio
async def test_vostfree_can_handle(self):
"""Test VostfreeDownloader.can_handle"""
from app.downloaders.vostfree import VostfreeDownloader
from app.downloaders.anime_sites.vostfree import VostfreeDownloader
downloader = VostfreeDownloader()
assert downloader.can_handle("https://vostfree.tv/test") is True
@@ -320,7 +320,7 @@ class TestDownloaderUrlExtraction:
@pytest.mark.asyncio
async def test_get_download_link_mock(self):
"""Test get_download_link with mocked response"""
from app.downloaders.unfichier import UnFichierDownloader
from app.downloaders.video_players.unfichier import UnFichierDownloader
downloader = UnFichierDownloader()
with patch.object(downloader, '_fetch_page') as mock_fetch: