localdex 0.1.8__py3-none-any.whl → 0.1.19__py3-none-any.whl

{localdex-0.1.8.dist-info → localdex-0.1.19.dist-info}/METADATA

@@ -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.dist-info → localdex-0.1.19.dist-info}/RECORD

@@ -1,9 +1,11 @@
-localdex/__init__.py,sha256=rAVSDHi5KVKNiMaKgZZ04_Kl7j2KPCZuWO7OuDU6id8,748
+localdex/__init__.py,sha256=hrXzDvHAGSDUNhnajIGpxEbeMrO1sy9AiAuqs15muTs,544
 localdex/cli.py,sha256=WqBCyA0akAFJNrYa8jCA3zoZgYEptDYDMGfAGkvKyZc,19317
-localdex/core.py,sha256=9sLLrT60mMtPYVg5ybRRteIFnw3nkj4-XMLhlfLC2jo,20891
+localdex/core.py,sha256=I8LwvKxtmEgdYtdEBVQLLp3JwafM8FhmvMrMpgxXkvA,28792
 localdex/data_loader.py,sha256=hi9aSTto5Ti-OBGOgrQ-XwD5hmivsUwS1uC4rulhwQI,11366
 localdex/download_data.py,sha256=ibAHDxL60sV4LVN9isCmf8vvd_aI9IQbyjJpU0FHGUo,18869
 localdex/exceptions.py,sha256=Z02-8Kci6jFDk2nnGdVSHZJMDDWE9vuwuASs4VM3To8,2777
+localdex/random_battles.py,sha256=xRGQ6v-g9NG1-4jcQJWHOfskNUv-tFXspCXPRdctdmQ,9213
+localdex/sprite_downloader.py,sha256=q4ropKb6vCZmAHbetIXLOzcdbk50oa53Vv_WiiXbOk8,41379
 localdex/data/abilities/adaptability.json,sha256=FGEEZmL80YVcIXHV-h287Wu-UJycM1QEJxiOHK2I4mY,289
 localdex/data/abilities/aerilate.json,sha256=KRZOVH2KGdEQ_3UktFoXoagUOaC8jIPZ6Ti-YGzW44s,301
 localdex/data/abilities/aftermath.json,sha256=Awv_8jquu3pM4CemD5ylS1v83ABrqGtrgMEkL-1ldBk,285
@@ -4790,8 +4792,8 @@ localdex/models/ability.py,sha256=AQzv3XUHHl4sustMJjPDDjJOjXu2GMLTfcM3-tqQ_1w,30
 localdex/models/item.py,sha256=zXao8F-jBPUGq_YLeGeYeK_dZVI7aZMXtWOPwR3qusY,4677
 localdex/models/move.py,sha256=hfgcWI4ziz5MMvc9ddmkotxzYYdrSUqZZQ72IU5tucs,7629
 localdex/models/pokemon.py,sha256=v5zkxY1NGGR-MczFCZe9fHt6u_BAqAjMiQZlpcLXVGc,5408
-localdex-0.1.8.dist-info/METADATA,sha256=cgxNvLj3bLSU7lQY488Z1QcuvHfJhGzrx790kt4oTQY,8332
-localdex-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-localdex-0.1.8.dist-info/entry_points.txt,sha256=n5GxSeQo-MRuvrT2wVk7hOzEFFsWf6tkBjkzmGIYJe4,47
-localdex-0.1.8.dist-info/top_level.txt,sha256=vtupDMH-IaxVCoEZrmE0QzdTwhaKzngVJbTA1NkR_MY,9
-localdex-0.1.8.dist-info/RECORD,,
+localdex-0.1.19.dist-info/METADATA,sha256=LfwrdPZ8k5DZAg7in5j7CSnMFOre8rivO1koAlar1qA,14087
+localdex-0.1.19.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+localdex-0.1.19.dist-info/entry_points.txt,sha256=n5GxSeQo-MRuvrT2wVk7hOzEFFsWf6tkBjkzmGIYJe4,47
+localdex-0.1.19.dist-info/top_level.txt,sha256=vtupDMH-IaxVCoEZrmE0QzdTwhaKzngVJbTA1NkR_MY,9
+localdex-0.1.19.dist-info/RECORD,,