Issue

`BasicIssue`

Bases: BaseModel

Contains fields for all Issues.

ATTRIBUTE	DESCRIPTION
`aliases`	List of names used by the Issue, collected in a string. TYPE: `str \| None`
`associated_images`	List of different images associated with the Issue. TYPE: `list[AssociatedImage]`
`api_url`	Url to the resource in the Comicvine API. TYPE: `HttpUrl`
`cover_date`	Date on the cover of the Issue. TYPE: `date \| None`
`date_added`	Date and time when the Issue was added. TYPE: `datetime`
`date_last_updated`	Date and time when the Issue was last updated. TYPE: `datetime`
`description`	Long description of the Issue. TYPE: `str \| None`
`id`	Identifier used by Comicvine. TYPE: `int`
`image`	Different sized images, posters and thumbnails for the Issue. TYPE: `Images`
`name`	Name/Title of the Issue. TYPE: `str \| None`
`number`	The Issue number. TYPE: `str \| None`
`site_url`	Url to the resource in Comicvine. TYPE: `HttpUrl`
`store_date`	Date the Issue went on sale on stores. TYPE: `date \| None`
`summary`	Short description of the Issue. TYPE: `str \| None`
`volume`	The volume the Issue is in. TYPE: `GenericEntry`

`Issue`

Bases: BasicIssue

Extends BasicIssue by including all the list references of an issue.

ATTRIBUTE	DESCRIPTION
`characters`	List of characters in the Issue. TYPE: `list[GenericEntry]`
`concepts`	List of concepts in the Issue. TYPE: `list[GenericEntry]`
`creators`	List of creators in the Issue. TYPE: `list[GenericCreator]`
`deaths`	List of characters who died in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_characters`	List of characters who first appear in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_concepts`	List of concepts which first appear in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_locations`	List of locations which first appear in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_objects`	List of objects which first appear in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_story_arcs`	List of story arcs which first appear in the Issue. TYPE: `list[GenericEntry]`
`first_appearance_teams`	List of teams who first appear in the Issue. TYPE: `list[GenericEntry]`
`locations`	List of locations in the Issue. TYPE: `list[GenericEntry]`
`objects`	List of objects in the Issue. TYPE: `list[GenericEntry]`
`story_arcs`	List of story arcs in the Issue. TYPE: `list[GenericEntry]`
`teams`	List of teams in the Issue. TYPE: `list[GenericEntry]`
`teams_disbanded`	List of teams who disbanded in the Issue. TYPE: `list[GenericEntry]`

Functions

`handle_blank_list`

Convert a blank or None value to an empty list.

PARAMETER	DESCRIPTION
`value`	The value to check. TYPE: `str \| list \| None`

RETURNS	DESCRIPTION
`list`	An empty list if the value is None or an empty string, otherwise the original list.

Source code in simyan/schemas/issue.py

Python
@field_validator(
    "first_appearance_characters",
    "first_appearance_concepts",
    "first_appearance_locations",
    "first_appearance_objects",
    "first_appearance_story_arcs",
    "first_appearance_teams",
    mode="before",
)
def handle_blank_list(cls, value: str | list | None) -> list:
    """Convert a blank or None value to an empty list.

    Args:
        value: The value to check.

    Returns:
        An empty list if the value is None or an empty string, otherwise the original list.
    """
    if isinstance(value, str):
        return []
    return value or []