localdex 0.1.8__tar.gz → 0.1.19__tar.gz

{localdex-0.1.8 → localdex-0.1.19}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: localdex
-Version: 0.1.8
+Version: 0.1.19
 Summary: A local Pokemon data repository/Pokedex with fast offline access
-Home-page: https://github.com/yourusername/localdex
-Author: LocalDex Team
 Author-email: LocalDex Team <localdex@example.com>
 License: MIT
 Project-URL: Homepage, https://github.com/colefoster/localdex
@@ -48,9 +46,8 @@ Requires-Dist: black>=22.0.0; extra == "dev"
 Requires-Dist: isort>=5.0.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: flake8>=5.0.0; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: requires-python
+Requires-Dist: pillow>=9.0.0; extra == "dev"
+Requires-Dist: selenium>=4.0.0; extra == "dev"
 
 # LocalDex
 
@@ -70,6 +67,7 @@ A fast, offline-first Python library for Pokemon data access. LocalDex provides
 - **Type Hints**: Full type support for better development experience
 - **Multiple Generations**: Support for all Pokemon generations
 - **Competitive Data**: Includes battle sets and competitive information
+- **Random Battle Sets**: Download and access Pokemon Showdown's random battle data
 
 ## Installation
 
@@ -144,7 +142,19 @@ all_moves = dex.get_all_moves()
 electric_moves = [m for m in all_moves if m.type.lower() == "electric"]
 print(f"Electric moves count: {len(electric_moves)}")
 print(f"First 5 Electric moves: {[m.name for m in electric_moves[:5]]}")
-```
+
+# Random Battle Sets (requires internet for initial download)
+# Get random battle sets for a Pokemon
+venusaur_sets = dex.get_random_battle_sets("venusaur", generation=9)
+if venusaur_sets:
+    print(f"Venusaur Gen 9 Level: {venusaur_sets.get('level')}")
+    for set_data in venusaur_sets.get('sets', []):
+        print(f"  Role: {set_data.get('role')}")
+        print(f"  Moves: {', '.join(set_data.get('movepool', []))}")
+
+# Search Pokemon by move in random battles
+giga_drain_users = dex.search_random_battle_pokemon_by_move("Giga Drain", generation=9)
+print(f"Pokemon with Giga Drain in Gen 9: {giga_drain_users[:5]}")
 
 ## API Reference
 
@@ -166,6 +176,15 @@ The main class for accessing Pokemon data.
 - `get_all_abilities() -> List[Ability]`: Get all abilities
 - `get_all_items() -> List[Item]`: Get all items
 
+#### Random Battle Sets Methods
+
+- `get_random_battle_sets(pokemon_name: str, generation: int = 9) -> Optional[Dict]`: Get random battle sets for a Pokemon
+- `get_all_random_battle_sets(generation: int = 9) -> Dict`: Get all random battle sets for a generation
+- `search_random_battle_pokemon_by_move(move_name: str, generation: int = 9) -> List[str]`: Search Pokemon by move in random battles
+- `search_random_battle_pokemon_by_ability(ability_name: str, generation: int = 9) -> List[str]`: Search Pokemon by ability in random battles
+- `get_available_random_battle_generations() -> List[int]`: Get available generations for random battles
+- `get_random_battle_formats(generation: int) -> List[str]`: Get available formats for a generation
+
 #### Search Filters
 
 ```python
@@ -243,6 +262,89 @@ LocalDex organizes data into logical sets that can be installed independently:
 - **Items** (`items`): Item data and effects
 - **Abilities** (`abilities`): Detailed ability information
 
+## Random Battle Sets
+
+LocalDex can download and access Pokemon Showdown's random battle sets from different generations. This feature requires an internet connection for the initial download, but then works offline.
+
+### Features
+
+- **Multiple Generations**: Support for Gen 8 and Gen 9 random battles
+- **Multiple Formats**: Standard sets, factory sets, doubles sets, and more
+- **Search Capabilities**: Find Pokemon by moves or abilities in their random battle sets
+- **Caching**: Downloaded data is cached for offline use
+- **Optional**: Can be disabled to save memory and avoid downloads
+
+### Usage
+
+```python
+from localdex import LocalDex
+
+# Initialize with random battles enabled (default)
+dex = LocalDex(enable_random_battles=True)
+
+# Get random battle sets for a specific Pokemon
+venusaur_sets = dex.get_random_battle_sets("venusaur", generation=9)
+if venusaur_sets:
+    print(f"Level: {venusaur_sets['level']}")
+    for set_data in venusaur_sets['sets']:
+        print(f"Role: {set_data['role']}")
+        print(f"Moves: {', '.join(set_data['movepool'])}")
+        print(f"Abilities: {', '.join(set_data['abilities'])}")
+        print(f"Tera Types: {', '.join(set_data['teraTypes'])}")
+
+# Search for Pokemon with specific moves
+giga_drain_users = dex.search_random_battle_pokemon_by_move("Giga Drain", generation=9)
+print(f"Pokemon with Giga Drain: {giga_drain_users}")
+
+# Search for Pokemon with specific abilities
+chlorophyll_users = dex.search_random_battle_pokemon_by_ability("Chlorophyll", generation=9)
+print(f"Pokemon with Chlorophyll: {chlorophyll_users}")
+
+# Get all random battle sets for a generation
+all_gen9_sets = dex.get_all_random_battle_sets(generation=9)
+print(f"Total Pokemon in Gen 9: {len(all_gen9_sets)}")
+
+# Get available generations and formats
+generations = dex.get_available_random_battle_generations()
+formats = dex.get_random_battle_formats(9)
+print(f"Available generations: {generations}")
+print(f"Gen 9 formats: {formats}")
+
+# Disable random battles to save memory
+dex_lightweight = LocalDex(enable_random_battles=False)
+```
+
+### Data Structure
+
+#### Generation 9 Sets
+```json
+{
+  "venusaur": {
+    "level": 84,
+    "sets": [
+      {
+        "role": "Bulky Support",
+        "movepool": ["Giga Drain", "Leech Seed", "Sleep Powder"],
+        "abilities": ["Chlorophyll", "Overgrow"],
+        "teraTypes": ["Steel", "Water"]
+      }
+    ]
+  }
+}
+```
+
+#### Generation 8 Data
+```json
+{
+  "venusaur": {
+    "level": 84,
+    "moves": ["gigadrain", "leechseed", "sleeppowder"],
+    "doublesMoves": ["earthpower", "energyball", "leechseed"],
+    "doublesLevel": 80
+  }
+}
+```
+
 ## CLI Usage
 
 LocalDex includes a command-line interface for quick data access:
@@ -277,4 +379,60 @@ LocalDex uses data from:
 - [Pokemon Showdown](https://github.com/smogon/pokemon-showdown)
 - [PokeAPI](https://pokeapi.co/) (for initial data collection)
 
+## Sprite Downloading and Usage
+
+LocalDex can download and manage Pokémon and item sprites directly from Pokémon Showdown. This feature allows you to access local sprite images for use in your applications. The sprite extraction process uses parallel processing for significantly improved performance.
+
+### Downloading Sprites
+
+```python
+from localdex import LocalDex
+
+# Initialize with default parallel processing (8 workers)
+dex = LocalDex()
+
+# Download and extract all Pokémon and item sprites (requires internet for first run)
+dex.download_all_sprites()
+
+# Or customize the number of worker threads for parallel processing
+dex_fast = LocalDex(sprite_max_workers=16)  # More workers for faster processing
+dex_lightweight = LocalDex(sprite_max_workers=4)  # Fewer workers for lower resource usage
+```
+
+### Accessing Sprite Paths
+
+```python
+# Get the local file path to a Pokémon sprite
+sprite_path = dex.get_pokemon_sprite_path("Pikachu")
+print(sprite_path)  # e.g., /path/to/data/sprites/pokemon/pikachu.png
+
+# Get the local file path to an item sprite
+item_sprite_path = dex.get_item_sprite_path("Leftovers")
+print(item_sprite_path)  # e.g., /path/to/data/sprites/items/leftovers.png
+```
+
+### Listing Available Sprites
+
+```python
+# List all available Pokémon sprites
+pokemon_sprites = dex.list_available_sprites("pokemon")
+print(pokemon_sprites)
+
+# List all available item sprites
+item_sprites = dex.list_available_sprites("items")
+print(item_sprites)
+```
+
+### Accessing Sprite Metadata
+
+```python
+# Get metadata for all Pokémon sprites
+pokemon_meta = dex.get_sprite_metadata("pokemon")
+print(pokemon_meta["Pikachu"])
+
+# Get metadata for all item sprites
+item_meta = dex.get_sprite_metadata("items")
+print(item_meta["Leftovers"])
+```
+
 

{localdex-0.1.8 → localdex-0.1.19}/README.md

@@ -16,6 +16,7 @@ A fast, offline-first Python library for Pokemon data access. LocalDex provides
 - **Type Hints**: Full type support for better development experience
 - **Multiple Generations**: Support for all Pokemon generations
 - **Competitive Data**: Includes battle sets and competitive information
+- **Random Battle Sets**: Download and access Pokemon Showdown's random battle data
 
 ## Installation
 
@@ -90,7 +91,19 @@ all_moves = dex.get_all_moves()
 electric_moves = [m for m in all_moves if m.type.lower() == "electric"]
 print(f"Electric moves count: {len(electric_moves)}")
 print(f"First 5 Electric moves: {[m.name for m in electric_moves[:5]]}")
-```
+
+# Random Battle Sets (requires internet for initial download)
+# Get random battle sets for a Pokemon
+venusaur_sets = dex.get_random_battle_sets("venusaur", generation=9)
+if venusaur_sets:
+    print(f"Venusaur Gen 9 Level: {venusaur_sets.get('level')}")
+    for set_data in venusaur_sets.get('sets', []):
+        print(f"  Role: {set_data.get('role')}")
+        print(f"  Moves: {', '.join(set_data.get('movepool', []))}")
+
+# Search Pokemon by move in random battles
+giga_drain_users = dex.search_random_battle_pokemon_by_move("Giga Drain", generation=9)
+print(f"Pokemon with Giga Drain in Gen 9: {giga_drain_users[:5]}")
 
 ## API Reference
 
@@ -112,6 +125,15 @@ The main class for accessing Pokemon data.
 - `get_all_abilities() -> List[Ability]`: Get all abilities
 - `get_all_items() -> List[Item]`: Get all items
 
+#### Random Battle Sets Methods
+
+- `get_random_battle_sets(pokemon_name: str, generation: int = 9) -> Optional[Dict]`: Get random battle sets for a Pokemon
+- `get_all_random_battle_sets(generation: int = 9) -> Dict`: Get all random battle sets for a generation
+- `search_random_battle_pokemon_by_move(move_name: str, generation: int = 9) -> List[str]`: Search Pokemon by move in random battles
+- `search_random_battle_pokemon_by_ability(ability_name: str, generation: int = 9) -> List[str]`: Search Pokemon by ability in random battles
+- `get_available_random_battle_generations() -> List[int]`: Get available generations for random battles
+- `get_random_battle_formats(generation: int) -> List[str]`: Get available formats for a generation
+
 #### Search Filters
 
 ```python
@@ -189,6 +211,89 @@ LocalDex organizes data into logical sets that can be installed independently:
 - **Items** (`items`): Item data and effects
 - **Abilities** (`abilities`): Detailed ability information
 
+## Random Battle Sets
+
+LocalDex can download and access Pokemon Showdown's random battle sets from different generations. This feature requires an internet connection for the initial download, but then works offline.
+
+### Features
+
+- **Multiple Generations**: Support for Gen 8 and Gen 9 random battles
+- **Multiple Formats**: Standard sets, factory sets, doubles sets, and more
+- **Search Capabilities**: Find Pokemon by moves or abilities in their random battle sets
+- **Caching**: Downloaded data is cached for offline use
+- **Optional**: Can be disabled to save memory and avoid downloads
+
+### Usage
+
+```python
+from localdex import LocalDex
+
+# Initialize with random battles enabled (default)
+dex = LocalDex(enable_random_battles=True)
+
+# Get random battle sets for a specific Pokemon
+venusaur_sets = dex.get_random_battle_sets("venusaur", generation=9)
+if venusaur_sets:
+    print(f"Level: {venusaur_sets['level']}")
+    for set_data in venusaur_sets['sets']:
+        print(f"Role: {set_data['role']}")
+        print(f"Moves: {', '.join(set_data['movepool'])}")
+        print(f"Abilities: {', '.join(set_data['abilities'])}")
+        print(f"Tera Types: {', '.join(set_data['teraTypes'])}")
+
+# Search for Pokemon with specific moves
+giga_drain_users = dex.search_random_battle_pokemon_by_move("Giga Drain", generation=9)
+print(f"Pokemon with Giga Drain: {giga_drain_users}")
+
+# Search for Pokemon with specific abilities
+chlorophyll_users = dex.search_random_battle_pokemon_by_ability("Chlorophyll", generation=9)
+print(f"Pokemon with Chlorophyll: {chlorophyll_users}")
+
+# Get all random battle sets for a generation
+all_gen9_sets = dex.get_all_random_battle_sets(generation=9)
+print(f"Total Pokemon in Gen 9: {len(all_gen9_sets)}")
+
+# Get available generations and formats
+generations = dex.get_available_random_battle_generations()
+formats = dex.get_random_battle_formats(9)
+print(f"Available generations: {generations}")
+print(f"Gen 9 formats: {formats}")
+
+# Disable random battles to save memory
+dex_lightweight = LocalDex(enable_random_battles=False)
+```
+
+### Data Structure
+
+#### Generation 9 Sets
+```json
+{
+  "venusaur": {
+    "level": 84,
+    "sets": [
+      {
+        "role": "Bulky Support",
+        "movepool": ["Giga Drain", "Leech Seed", "Sleep Powder"],
+        "abilities": ["Chlorophyll", "Overgrow"],
+        "teraTypes": ["Steel", "Water"]
+      }
+    ]
+  }
+}
+```
+
+#### Generation 8 Data
+```json
+{
+  "venusaur": {
+    "level": 84,
+    "moves": ["gigadrain", "leechseed", "sleeppowder"],
+    "doublesMoves": ["earthpower", "energyball", "leechseed"],
+    "doublesLevel": 80
+  }
+}
+```
+
 ## CLI Usage
 
 LocalDex includes a command-line interface for quick data access:
@@ -223,4 +328,60 @@ LocalDex uses data from:
 - [Pokemon Showdown](https://github.com/smogon/pokemon-showdown)
 - [PokeAPI](https://pokeapi.co/) (for initial data collection)
 
+## Sprite Downloading and Usage
+
+LocalDex can download and manage Pokémon and item sprites directly from Pokémon Showdown. This feature allows you to access local sprite images for use in your applications. The sprite extraction process uses parallel processing for significantly improved performance.
+
+### Downloading Sprites
+
+```python
+from localdex import LocalDex
+
+# Initialize with default parallel processing (8 workers)
+dex = LocalDex()
+
+# Download and extract all Pokémon and item sprites (requires internet for first run)
+dex.download_all_sprites()
+
+# Or customize the number of worker threads for parallel processing
+dex_fast = LocalDex(sprite_max_workers=16)  # More workers for faster processing
+dex_lightweight = LocalDex(sprite_max_workers=4)  # Fewer workers for lower resource usage
+```
+
+### Accessing Sprite Paths
+
+```python
+# Get the local file path to a Pokémon sprite
+sprite_path = dex.get_pokemon_sprite_path("Pikachu")
+print(sprite_path)  # e.g., /path/to/data/sprites/pokemon/pikachu.png
+
+# Get the local file path to an item sprite
+item_sprite_path = dex.get_item_sprite_path("Leftovers")
+print(item_sprite_path)  # e.g., /path/to/data/sprites/items/leftovers.png
+```
+
+### Listing Available Sprites
+
+```python
+# List all available Pokémon sprites
+pokemon_sprites = dex.list_available_sprites("pokemon")
+print(pokemon_sprites)
+
+# List all available item sprites
+item_sprites = dex.list_available_sprites("items")
+print(item_sprites)
+```
+
+### Accessing Sprite Metadata
+
+```python
+# Get metadata for all Pokémon sprites
+pokemon_meta = dex.get_sprite_metadata("pokemon")
+print(pokemon_meta["Pikachu"])
+
+# Get metadata for all item sprites
+item_meta = dex.get_sprite_metadata("items")
+print(item_meta["Leftovers"])
+```
+
 

{localdex-0.1.8 → localdex-0.1.19}/localdex/__init__.py

@@ -1,18 +1,9 @@
-"""
-LocalDex - A fast, offline-first Python library for Pokemon data access.
-
-This package provides comprehensive Pokemon information without requiring
-network requests, making it perfect for applications that need reliable,
-fast access to Pokemon data.
-"""
-
-__version__ = "0.1.0"
-__author__ = "LocalDex Team"
-__email__ = "localdex@example.com"
 
 from .core import LocalDex
 from .models import Pokemon, Move, Ability, Item, BaseStats
 from .exceptions import PokemonNotFoundError, MoveNotFoundError, AbilityNotFoundError, ItemNotFoundError
+from .random_battles import RandomBattleSets
+from .sprite_downloader import SpriteDownloader
 
 __all__ = [
     "LocalDex",
@@ -25,4 +16,6 @@ __all__ = [
     "MoveNotFoundError", 
     "AbilityNotFoundError",
     "ItemNotFoundError",
+    "RandomBattleSets",
+    "SpriteDownloader",
 ] 

{localdex-0.1.8 → localdex-0.1.19}/localdex/core.py

@@ -18,6 +18,8 @@ from .exceptions import (
     ItemNotFoundError, DataLoadError, SearchError
 )
 from .data_loader import DataLoader
+from .random_battles import RandomBattleSets
+from .sprite_downloader import SpriteDownloader
 
 
 class LocalDex:
@@ -29,7 +31,7 @@ class LocalDex:
     performance and comprehensive search capabilities.
     """
     
-    def __init__(self, data_path: Optional[str] = None, data_dir: Optional[str] = None, enable_caching: bool = True):
+    def __init__(self, data_path: Optional[str] = None, data_dir: Optional[str] = None, enable_caching: bool = True, enable_random_battles: bool = True, enable_sprite_downloader: bool = True, sprite_max_workers: int = 8):
         """
         Initialize the LocalDex.
         
@@ -37,6 +39,9 @@ class LocalDex:
             data_path: Optional path to data directory. If None, uses package data.
             data_dir: Alias for data_path for backward compatibility.
             enable_caching: Whether to enable caching for better performance.
+            enable_random_battles: Whether to enable random battle sets functionality.
+            enable_sprite_downloader: Whether to enable sprite downloader functionality.
+            sprite_max_workers: Maximum number of worker threads for parallel sprite processing.
         """
         # Use data_dir if provided, otherwise use data_path
         final_data_path = data_dir if data_dir is not None else data_path
@@ -44,6 +49,12 @@ class LocalDex:
         self.data_dir = final_data_path  # Store for backward compatibility
         self.enable_caching = enable_caching
         
+        # Sprite downloader integration
+        self.sprite_downloader = SpriteDownloader(final_data_path, max_workers=sprite_max_workers) if enable_sprite_downloader else None
+        
+        # Initialize random battle sets
+        self.random_battles = RandomBattleSets() if enable_random_battles else None
+        
         # Initialize caches
         self._pokemon_cache: Dict[str, Pokemon] = {}
         self._pokemon_id_cache: Dict[int, Pokemon] = {}
@@ -556,4 +567,178 @@ class LocalDex:
             "moves": len(self._move_cache),
             "abilities": len(self._ability_cache),
             "items": len(self._item_cache)
-        } 
+        }
+    
+    # Random Battle Sets Methods
+    
+    def get_random_battle_sets(self, pokemon_name: str, generation: int = 9, force_refresh: bool = False) -> Optional[Dict[str, Any]]:
+        """
+        Get random battle sets for a specific Pokemon.
+        
+        Args:
+            pokemon_name: Name of the Pokemon (case-insensitive)
+            generation: Generation to get sets from (8 or 9)
+            force_refresh: If True, re-download data
+            
+        Returns:
+            Pokemon's random battle sets or None if not found
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        if generation == 9:
+            return self.random_battles.get_pokemon_gen9_sets(pokemon_name, force_refresh)
+        elif generation == 8:
+            return self.random_battles.get_pokemon_gen8_data(pokemon_name, force_refresh)
+        else:
+            raise ValueError(f"Generation {generation} is not supported. Use 8 or 9.")
+    
+    def get_all_random_battle_sets(self, generation: int = 9, force_refresh: bool = False) -> Dict[str, Any]:
+        """
+        Get all random battle sets for a generation.
+        
+        Args:
+            generation: Generation to get sets from (8 or 9)
+            force_refresh: If True, re-download data
+            
+        Returns:
+            Dictionary containing all random battle sets for the generation
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        if generation == 9:
+            return self.random_battles.get_gen9_sets(force_refresh)
+        elif generation == 8:
+            return self.random_battles.get_gen8_data(force_refresh)
+        else:
+            raise ValueError(f"Generation {generation} is not supported. Use 8 or 9.")
+    
+    def search_random_battle_pokemon_by_move(self, move_name: str, generation: int = 9, force_refresh: bool = False) -> List[str]:
+        """
+        Search for Pokemon that have a specific move in their random battle sets.
+        
+        Args:
+            move_name: Name of the move to search for (case-insensitive)
+            generation: Generation to search in (8 or 9)
+            force_refresh: If True, re-download data
+            
+        Returns:
+            List of Pokemon names that have the move
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        return self.random_battles.search_pokemon_by_move(move_name, generation, force_refresh)
+    
+    def search_random_battle_pokemon_by_ability(self, ability_name: str, generation: int = 9, force_refresh: bool = False) -> List[str]:
+        """
+        Search for Pokemon that have a specific ability in their random battle sets.
+        
+        Args:
+            ability_name: Name of the ability to search for (case-insensitive)
+            generation: Generation to search in (8 or 9)
+            force_refresh: If True, re-download data
+            
+        Returns:
+            List of Pokemon names that have the ability
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        return self.random_battles.search_pokemon_by_ability(ability_name, generation, force_refresh)
+    
+    def get_available_random_battle_generations(self) -> List[int]:
+        """
+        Get list of available generations for random battles.
+        
+        Returns:
+            List of generation numbers
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        return self.random_battles.get_available_generations()
+    
+    def get_random_battle_formats(self, generation: int) -> List[str]:
+        """
+        Get available formats for a specific generation.
+        
+        Args:
+            generation: Generation number
+            
+        Returns:
+            List of available format names
+            
+        Raises:
+            ValueError: If random battles are not enabled
+        """
+        if self.random_battles is None:
+            raise ValueError("Random battle sets are not enabled. Set enable_random_battles=True when initializing LocalDex.")
+        
+        return self.random_battles.get_generation_formats(generation)
+    
+    def clear_random_battle_cache(self) -> None:
+        """Clear random battle cache."""
+        if self.random_battles is not None:
+            self.random_battles.clear_cache()
+    
+    def cleanup_random_battle_downloads(self) -> None:
+        """Remove downloaded Pokemon Showdown repository."""
+        if self.random_battles is not None:
+            self.random_battles.cleanup_downloads()
+    
+    def download_all_sprites(self):
+        """
+        Download and extract all sprites (Pokemon and items).
+        """
+        if not self.sprite_downloader:
+            raise RuntimeError("SpriteDownloader is not enabled.")
+        return self.sprite_downloader.download_all_sprites()
+
+    def get_pokemon_sprite_path(self, pokemon_name: str):
+        """
+        Get the path to a Pokemon sprite image.
+        """
+        if not self.sprite_downloader:
+            raise RuntimeError("SpriteDownloader is not enabled.")
+        return self.sprite_downloader.get_pokemon_sprite_path(pokemon_name)
+
+    def get_item_sprite_path(self, item_name: str):
+        """
+        Get the path to an item sprite image.
+        """
+        if not self.sprite_downloader:
+            raise RuntimeError("SpriteDownloader is not enabled.")
+        return self.sprite_downloader.get_item_sprite_path(item_name)
+
+    def get_sprite_metadata(self, sprite_type: str = "pokemon"):
+        """
+        Get sprite metadata for either 'pokemon' or 'items'.
+        """
+        if not self.sprite_downloader:
+            raise RuntimeError("SpriteDownloader is not enabled.")
+        return self.sprite_downloader.get_sprite_metadata(sprite_type)
+
+    def list_available_sprites(self, sprite_type: str = "pokemon"):
+        """
+        List all available sprites of a given type ('pokemon' or 'items').
+        """
+        if not self.sprite_downloader:
+            raise RuntimeError("SpriteDownloader is not enabled.")
+        return self.sprite_downloader.list_available_sprites(sprite_type)