Module: social_media

This module provides objects used to retrieve social media network information from a copy of the Wait Wait Don't Tell Me! Stats database.

Social Media Networks

class wwdtm.social_media.SocialMediaNetworks(connect_dict=None, database_connection=None)

Social media network information retrieval class.

Contains methods used to retrieve available social media networks.

Parameters:
  • connect_dict (dict[str, Any]) -- A dictionary containing database connection settings as required by MySQL Connector/Python

  • database_connection (MySQLConnection | PooledMySQLConnection) -- MySQL database connection object

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites instead.

Added in version 3.3.0.

retrieve_all()

Retrieves all social media networks, sorted by ID.

Returns:

A list of dictionaries containing social media site IDs, names, slug strings and icon names

Return type:

list[dict[int, str]]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_all() instead.

Added in version 3.3.0.

retrieve_all_as_dict()

Retrieves all social media sites as a dictionary.

Returns:

A dictionary of social media site IDs as keys, each containing name and slug key/values, ordered by social media site ID

Return type:

dict[int, dict[str, str]]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_all_as_dict() instead.

Added in version 3.3.0.

retrieve_all_ids()

Retrieves all social media site IDs, sorted by ID.

Returns:

A list of social media site IDs as integers

Return type:

list[int]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_all_ids() instead.

Added in version 3.3.0.

retrieve_all_network_names()

Retrieves all social media sites.

Returns:

A list of social media sites, ordered by social media site ID

Return type:

list[str]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_all_site_names() instead.

Added in version 3.3.0.

retrieve_all_network_slugs()

Retrieves all social media site slug strings.

Returns:

A list of social media site slug strings, ordered by social media site ID

Return type:

list[str]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_all_site_slugs() instead.

Added in version 3.3.0.

retrieve_by_id(network_id)

Retrieves social media site information by site ID.

Parameters:

network_id (int) -- Social media site ID

Returns:

A dictionary containing social media site ID, name, slug string and icon name

Return type:

dict[int, str]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_by_id() instead.

Added in version 3.3.0.

retrieve_by_slug(network_slug)

Retrieves social media site information by slug string.

Parameters:

network_slug (str) -- Social media network slug string

Returns:

A dictionary containing social media site ID, name, slug string and icon name

Return type:

dict[int, str]

Deprecated since version 3.4.0: Use wwdtm.external_site.ExternalSites.retrieve_by_slug() instead.

Added in version 3.3.0.