endfield-cards 1.0.0__tar.gz

endfield_cards-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MR-LORD-REX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

endfield_cards-1.0.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: endfield-cards
+Version: 1.0.0
+Summary: A library for creating beautiful cards for Endfield.
+Author-email: sora <sahikast07@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 MR-LORD-REX
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pydantic>=2.5
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: endfield-py>=1.0.7
+Requires-Dist: pillow>=12.2.0
+Requires-Dist: numpy>=2.4.5
+Dynamic: license-file
+
+# Endfield Cards
+
+[![PyPI version](https://img.shields.io/pypi/v/endfield-cards)](https://pypi.org/project/endfield-cards/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.txt)
+
+A powerful Python library for generating beautiful character and profile cards for **Endfield**. This library provides an easy-to-use interface to create stunning visual cards with character stats, weapons, relics, and profile information.
+
+## Features
+
+**Beautiful Card Templates** - Multiple professional templates for character showcase and profile cards
+
+**Complete Character Information** - Display stats, skills, weapons, relics, and more
+
+**Profile Cards** - Generate comprehensive profile cards with operator showcase
+
+**Async Support** - Full async/await support for efficient operations
+
+**Caching** - Smart asset caching for improved performance
+
+**Easy Integration** - Simple API for quick integration into your projects
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install endfield-cards
+```
+
+### From Source
+
+```bash
+git clone https://github.com/MR-LORD-REX/endfield-cards.git
+cd endfield-cards
+pip install -e .
+```
+
+## Dependencies
+
+This library depends on:
+
+- **[endfield-py](https://github.com/MR-LORD-REX/endfield)** - Core Endfield game data client
+- **[enka.network](https://enka.network)** - Player data and asset provider
+
+
+## Quick Start
+
+### Basic Usage
+
+```python
+import asyncio
+from ef_cards import EFCard
+
+async def main():
+    uid = 4225399080  # Your Endfield UID
+    
+    # Using async context manager (recommended)
+    async with EFCard() as ef_card:
+        # Get a single character card
+        char_card = await ef_card.get_character_card(uid, char_index=0)
+        char_card.save("character_card.png")
+        
+        # Get all characters cards
+        all_cards = await ef_card.get_all_characters_card(uid)
+        
+        # Get profile card with showcase
+        profile = await ef_card.get_profile_card(uid)
+        profile.card.save("profile_card.png")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### Without Context Manager
+
+```python
+import asyncio
+from ef_cards import EFCard
+
+async def main():
+    ef_card = EFCard()
+    try:
+        char_card = await ef_card.get_character_card(4225399080, char_index=0)
+        char_card.save("character_card.png")
+    finally:
+        await ef_card.close()  # Don't forget to close!
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Available Methods
+
+### Character Card
+
+```python
+# Get a single character card
+card = await ef_card.get_character_card(
+    uid: int,
+    char_index: int = 0,
+    user_img: Image.Image | None = None,
+    template: int = 1
+) -> Image.Image
+```
+
+### All Characters Cards
+
+```python
+# Get cards for all characters in a profile
+cards = await ef_card.get_all_characters_card(
+    uid: int,
+    user_imgs: list[Image.Image] | None = None,
+    template: int = 1
+) -> list[Image.Image]
+```
+
+### Profile Card
+
+```python
+# Get a complete profile card with showcase
+profile = await ef_card.get_profile_card(
+    uid: int,
+    template: int = 1
+) -> ProfileCard_1
+```
+
+## Card Information
+
+### Character Card Template 1 (1920x800)
+
+Displays comprehensive character information including:
+
+- **Main Frame** - Character artwork and basic stats
+- **Weapon Panel** - Current weapon with stats
+- **Relic Panel** - Equipped relics and bonuses
+- **Skill Panel** - Character skills and cooldowns
+- **Stats Panel** - Detailed character statistics
+
+### Profile Card Template 1 (1080x1467)
+
+Includes:
+
+- **Player Profile** - UID, Authority Level, Exploration Level
+- **Awakening Day** - Days since account creation
+- **Operator Showcase** - 4 featured characters
+- **Statistics** - Total operators, weapons, and files collected
+- **Regional Development** - Development levels by region
+
+## Example Output
+
+### Character Card
+![Character Card Example](https://github.com/MR-LORD-REX/endfield-cards/blob/main/src/examples/cards/char_card1.png)
+
+### Profile Card
+![Profile Card Example](https://github.com/MR-LORD-REX/endfield-cards/blob/main/src/examples/cards/profile_card1.png)
+
+## Data Sources
+
+- **Game Data**: [endfield-py](https://github.com/MR-LORD-REX/endfield) - Endfield game data wrapper developed by me
+- **Assets & Player Data**: [enka.network](https://enka.network) - Community-driven asset and player data provider
+
+## Configuration
+
+### Debug Mode
+
+Enable debug logging to troubleshoot issues:
+
+```python
+async with EFCard(debug=True) as ef_card:
+    # Your code here
+    pass
+```
+
+### Custom Endfield Client
+
+Use your own Endfield client instance:
+
+```python
+from endfield import Endfield
+
+ef = Endfield()
+async with EFCard(ef=ef) as ef_card:
+    # Your code here
+    pass
+```
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.
+
+## Disclaimer
+
+This project is not affiliated with or endorsed by the developers of Endfield. All assets and game data are sourced from public APIs and are used for educational purposes only.
+
+## Acknowledgments
+
+- **endfield-py** - Library developed by me for accessing Endfield game data
+- **enka.network** - For providing player data and asset caching
+
+## Support
+
+If you encounter any issues or have questions:
+
+1. Check the [examples](src/examples/) directory for usage patterns
+2. Enable debug mode to see detailed logs
+3. Open an issue on [GitHub](https://github.com/MR-LORD-REX/endfield-cards/issues)
+4. Contact me on [Telegram](https://t.me/The_Prime_Mover)
+
+## Related Projects
+
+- [endfield-py](https://github.com/MR-LORD-REX/endfield) - Core Endfield game data client
+
+---
+
+**Note**: Make sure you have a valid Endfield UID to use this library. You can find your UID in-game .

endfield_cards-1.0.0/README.md

@@ -0,0 +1,221 @@
+# Endfield Cards
+
+[![PyPI version](https://img.shields.io/pypi/v/endfield-cards)](https://pypi.org/project/endfield-cards/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.txt)
+
+A powerful Python library for generating beautiful character and profile cards for **Endfield**. This library provides an easy-to-use interface to create stunning visual cards with character stats, weapons, relics, and profile information.
+
+## Features
+
+**Beautiful Card Templates** - Multiple professional templates for character showcase and profile cards
+
+**Complete Character Information** - Display stats, skills, weapons, relics, and more
+
+**Profile Cards** - Generate comprehensive profile cards with operator showcase
+
+**Async Support** - Full async/await support for efficient operations
+
+**Caching** - Smart asset caching for improved performance
+
+**Easy Integration** - Simple API for quick integration into your projects
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install endfield-cards
+```
+
+### From Source
+
+```bash
+git clone https://github.com/MR-LORD-REX/endfield-cards.git
+cd endfield-cards
+pip install -e .
+```
+
+## Dependencies
+
+This library depends on:
+
+- **[endfield-py](https://github.com/MR-LORD-REX/endfield)** - Core Endfield game data client
+- **[enka.network](https://enka.network)** - Player data and asset provider
+
+
+## Quick Start
+
+### Basic Usage
+
+```python
+import asyncio
+from ef_cards import EFCard
+
+async def main():
+    uid = 4225399080  # Your Endfield UID
+    
+    # Using async context manager (recommended)
+    async with EFCard() as ef_card:
+        # Get a single character card
+        char_card = await ef_card.get_character_card(uid, char_index=0)
+        char_card.save("character_card.png")
+        
+        # Get all characters cards
+        all_cards = await ef_card.get_all_characters_card(uid)
+        
+        # Get profile card with showcase
+        profile = await ef_card.get_profile_card(uid)
+        profile.card.save("profile_card.png")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### Without Context Manager
+
+```python
+import asyncio
+from ef_cards import EFCard
+
+async def main():
+    ef_card = EFCard()
+    try:
+        char_card = await ef_card.get_character_card(4225399080, char_index=0)
+        char_card.save("character_card.png")
+    finally:
+        await ef_card.close()  # Don't forget to close!
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Available Methods
+
+### Character Card
+
+```python
+# Get a single character card
+card = await ef_card.get_character_card(
+    uid: int,
+    char_index: int = 0,
+    user_img: Image.Image | None = None,
+    template: int = 1
+) -> Image.Image
+```
+
+### All Characters Cards
+
+```python
+# Get cards for all characters in a profile
+cards = await ef_card.get_all_characters_card(
+    uid: int,
+    user_imgs: list[Image.Image] | None = None,
+    template: int = 1
+) -> list[Image.Image]
+```
+
+### Profile Card
+
+```python
+# Get a complete profile card with showcase
+profile = await ef_card.get_profile_card(
+    uid: int,
+    template: int = 1
+) -> ProfileCard_1
+```
+
+## Card Information
+
+### Character Card Template 1 (1920x800)
+
+Displays comprehensive character information including:
+
+- **Main Frame** - Character artwork and basic stats
+- **Weapon Panel** - Current weapon with stats
+- **Relic Panel** - Equipped relics and bonuses
+- **Skill Panel** - Character skills and cooldowns
+- **Stats Panel** - Detailed character statistics
+
+### Profile Card Template 1 (1080x1467)
+
+Includes:
+
+- **Player Profile** - UID, Authority Level, Exploration Level
+- **Awakening Day** - Days since account creation
+- **Operator Showcase** - 4 featured characters
+- **Statistics** - Total operators, weapons, and files collected
+- **Regional Development** - Development levels by region
+
+## Example Output
+
+### Character Card
+![Character Card Example](https://github.com/MR-LORD-REX/endfield-cards/blob/main/src/examples/cards/char_card1.png)
+
+### Profile Card
+![Profile Card Example](https://github.com/MR-LORD-REX/endfield-cards/blob/main/src/examples/cards/profile_card1.png)
+
+## Data Sources
+
+- **Game Data**: [endfield-py](https://github.com/MR-LORD-REX/endfield) - Endfield game data wrapper developed by me
+- **Assets & Player Data**: [enka.network](https://enka.network) - Community-driven asset and player data provider
+
+## Configuration
+
+### Debug Mode
+
+Enable debug logging to troubleshoot issues:
+
+```python
+async with EFCard(debug=True) as ef_card:
+    # Your code here
+    pass
+```
+
+### Custom Endfield Client
+
+Use your own Endfield client instance:
+
+```python
+from endfield import Endfield
+
+ef = Endfield()
+async with EFCard(ef=ef) as ef_card:
+    # Your code here
+    pass
+```
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.
+
+## Disclaimer
+
+This project is not affiliated with or endorsed by the developers of Endfield. All assets and game data are sourced from public APIs and are used for educational purposes only.
+
+## Acknowledgments
+
+- **endfield-py** - Library developed by me for accessing Endfield game data
+- **enka.network** - For providing player data and asset caching
+
+## Support
+
+If you encounter any issues or have questions:
+
+1. Check the [examples](src/examples/) directory for usage patterns
+2. Enable debug mode to see detailed logs
+3. Open an issue on [GitHub](https://github.com/MR-LORD-REX/endfield-cards/issues)
+4. Contact me on [Telegram](https://t.me/The_Prime_Mover)
+
+## Related Projects
+
+- [endfield-py](https://github.com/MR-LORD-REX/endfield) - Core Endfield game data client
+
+---
+
+**Note**: Make sure you have a valid Endfield UID to use this library. You can find your UID in-game .

endfield_cards-1.0.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires=["setuptools>=61.0"]
+build-backend="setuptools.build_meta"
+
+[project]
+name="endfield-cards"
+version="1.0.0"
+description="A library for creating beautiful cards for Endfield."
+authors=[
+    { name="sora", email="sahikast07@gmail.com" }
+]
+readme="README.md"
+license={file="LICENSE.txt"}
+dependencies=[
+    "pydantic>=2.5",
+    "aiohttp>=3.9",
+    "endfield-py>=1.0.7",
+    "pillow>=12.2.0",
+    "numpy>=2.4.5"
+]
+[tool.setuptools.packages.find]
+where=["src"]
+
+[tool.setuptools.package-data]
+ef_cards = [
+    "assets/**/*",
+    "assets/char1/**/*",
+    "assets/char1/main/**/*",
+    "assets/char1/relics/**/*",
+    "assets/char1/skills/**/*",
+    "assets/char1/stats/**/*",
+    "assets/char1/weapon/**/*",
+    "assets/common/**/*",
+    "assets/elements/**/*",
+    "assets/fonts/**/*",
+    "assets/phases/**/*",
+    "assets/prof/**/*",
+    "assets/profile1/**/*",
+    "assets/props/**/*",
+    "assets/weap_types/**/*"
+]

endfield_cards-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

endfield_cards-1.0.0/src/endfield_cards/__init__.py

@@ -0,0 +1,3 @@
+from .client import EFCard
+
+__all__ = ["EFCard"]