aioenkanetworkcard 0.0.5

Wrapper module for enkanetwork.py for creating character cards.

Русская версия | Example | Discord

EnkaNetworkCard

Wrapper for EnkaNetwork.py to create character cards in Python.

Full Documentation:

En: Documentation EN

Navigation

• Installation
• Dependencies
• Launch
• Running Async
• Fix bug with async
• Get a character showcase
• Description of arguments
• Languages Supported
• Sample Results

Installation:

pip install enkanetworkcard

Or you can copy the given repository.

Dependencies:

Dependencies that must be installed for the library to work:

• Pillow
• requests
• io
• math
• threading
• datetime
• random
• enkanetwork
• logging

Launch:

from enkanetworkcard import encbanner

ENC = encbanner.EnkaGenshinGeneration() 

result = ENC.start(uids = 724281429)

print(result)

Running Async:

from enkanetworkcard import aioenkbanner
import asyncio

async def card():
    ENC = aioenkbanner.EnkaGenshinGeneration()
    return await ENC.start(uids = 724281429)

result = asyncio.run(card()) 

print(result)

Thank you for this example and advice: Gaurav Mandal

Fix bug with async:

Windows users may experience an error: RuntimeError: Event loop is closed if this occurs, then you must set the variable FIX_ASYNCIO_WIN = True

Example

from enkanetworkcard import encbanner

ENC = encbanner.EnkaGenshinGeneration() 
ENC.FIX_ASYNCIO_WIN = True

Get a character showcase:

profile - A useful feature for bot developers. Get information about the characters from the showcase, for their further use.

Example

from enkanetworkcard import encbanner

ENC = encbanner.EnkaGenshinGeneration()
resultProfile = ENC.profile(uid = 724281429, image = False)
result = ENC.start(uids = 724281429, name = resultProfile["charactersArg"])

print(result)

Function: profile returns: characters, charactersArg, img

• characters - Information about each character.
• charactersArg - List of character names to quickly pass to start()
• img - Showcase generated image.

Description of arguments:

Main class: EnkaGenshinGeneration Contains the following arguments lang,img,charterImg,name,adapt,randomImg,hide,dowload,namecard,splash

Class argument description::

• lang - Takes one value to define the language. Supported languages are listed below in the documentation. The default is Russian.
• Values: str
• Example str: EnkaGenshinGeneration(lang = "en")

---

• img - If you want to use your image on the card, then pass this argument.
• Values str: Image link or the path to the file.
• Values PIL.ImageFile: Image opened with Image.open()
• Values list: Image link, the path to the file or PIL.ImageFile
• Example str the path to the file: EnkaGenshinGeneration(img = "img.png")
• Example str image link: EnkaGenshinGeneration(img = "https//...image.png")
• Example PIL.ImageFile: EnkaGenshinGeneration(img = Image.open("img.png"))
• Example list: EnkaGenshinGeneration(img = [Image.open("img.png"), "img.png", "https//...image.png"]) - list only works with the argument: randomImg.

---

• charterImg - Give each character a custom image.
• Values dict: Can take all values from the img argument except list.
• Example dict: EnkaGenshinGeneration(charterImg = {"Klee": Image.open("img.png"), "Albedo": "img.png", "Xiao": "https//...image.png"})

---

• name - Needed if you want to get certain characters.
• Values: str
• Example str one character: EnkaGenshinGeneration(name = "Klee")
• Example str two or more characters: EnkaGenshinGeneration(name = "Klee, Albedo, ...")

---

• adapt - Adapt background to custom image.
• Values: bool
• Example bool: EnkaGenshinGeneration(img = "img.png", adapt = True)

---

• randomImg - Random selection of custom images from the list.
• Values: bool
• Example bool: EnkaGenshinGeneration(img = [Image.open("img.png"), "img.png"], randomImg = True) - If img is not a list, then randomImg is ignored.

---

• hide - Hide the UID on the character card.
• Values: bool
• Example bool: EnkaGenshinGeneration(hide = True)

---

• dowload - Will return ready images for further work with them. (If not specified, then the finished results will be saved in the directory of the executable file in the folder and return None: EnkaImg)
• Values: bool
• Example bool: EnkaGenshinGeneration(dowload = True)

---

• namecard - Replaces the background of the player card image with character images. (Used only for the second template.)
• Values: bool
• Example bool: EnkaGenshinGeneration(namecard = True)

---

• splash - Displays splashes of characters in costumes
• Values: bool
• Example bool: EnkaGenshinGeneration(splash= True)

---

The main function of the class: start takes template, uids, name argument

Function argument description::

• uids - Game UID in the game Genshin Impact.
• Values: int, str
• Example int: EnkaGenshinGeneration().start(uids = 757562748)
• Example str one UID: EnkaGenshinGeneration().start(uids = "757562748")
• Example str two or more UID: EnkaGenshinGeneration().start(uids = "757562748,544523587,874385763")

---

• template - Changes the character card template.
• Values: int
• Example int: EnkaGenshinGeneration().start(uids = "757562748", template = 2)

---

• name - Needed if you want to get certain characters.
• Values: str
• Example str one character: EnkaGenshinGeneration(uids = "757562748", name = "Klee")
• Example str two or more characters: EnkaGenshinGeneration.start(uids = "757562748", name = "Klee, Albedo, ...")

---

Additional class function: profile takes uid, image argument

• uid - Game UID in the game Genshin Impact.
• Values: int
• Example int: EnkaGenshinGeneration().profile(uids = 757562748)

---

• image - Generate a showcase image. (Default True)
• Values: bool
• Example bool: EnkaGenshinGeneration().profile(uid = 757562748б, image = False)

Languages Supported

Languege	Code	Languege	Code
English	en	русский	ru
Tiếng Việt	vi	ไทย	th
português	pt	한국어	kr
日本語	jp	中文	zh
中文	zh	Indonesian	id
français	fr	español	es
deutsch	de	Taiwan	cht
Chinese	chs

Sample Results:

The result of a custom images and adaptation (template= 1).

Usual result (template= 1).

The result of a custom images and adaptation (template= 2).

Usual result (template= 2).