Documented the AmiiboFilter, AmiiboSeriesFilter, AmiiboTypeFilter, GameCharacterFilter, and the GameSeriesFilter types in the library target.

This commit is contained in:
2025-09-09 09:49:43 +02:00
parent 36fd2c29ea
commit f7ae2f65f2
5 changed files with 35 additions and 5 deletions
+27 -1
View File
@@ -10,21 +10,47 @@
//
//===----------------------------------------------------------------------===
/// A type that contains values to fine-tune a response when requesting amiibo items.
public struct AmiiboFilter {
// MARK: Properties
/// A game character to return, if any.
public let gameCharacter: String?
/// A game series to return, if any.
public let gameSeries: String?
/// An amiibo identifier to return, if any.
public let identifier: String?
/// An amiibo name to return, if any.
public let name: String?
/// An amiibo series to return, if any.
public let series: String?
/// A flag indicating whether to include games in the response, if any.
public let showGames: Bool?
/// A flag indicating whether to include amiibo usages in games in the response, if any.
public let showUsage: Bool?
/// An amiibo type to return, if any.
public let type: String?
// MARK: Initialisers
// MARK: Initializers
/// Initializes this filter.
/// - Parameters:
/// - identifier: An amiibo identifier to return, if any.
/// - name: An amiibo name to return, if any.
/// - type: An amiibo type to return, if any.
/// - series: An amiibo series to return, if any.
/// - gameCharacter: A game character to return, if any.
/// - gameSeries: A game series to return, if any.
/// - showGames: A flag indicating whether to include games in the response, if any.
/// - showUsage: A flag indicating whether to include amiibo usages in games in the response, if any.
public init(
identifier: String? = nil,
name: String? = nil,
@@ -10,6 +10,7 @@
//
//===----------------------------------------------------------------------===
/// A type that contains values to fine-tune a response when requesting amiibo series.
public struct AmiiboSeriesFilter: KeyNameFilter {
// MARK: Properties
@@ -17,7 +18,7 @@ public struct AmiiboSeriesFilter: KeyNameFilter {
public let key: String?
public let name: String?
// MARK: Initialisers
// MARK: Initializers
public init() {
self.key = nil
@@ -10,6 +10,7 @@
//
//===----------------------------------------------------------------------===
/// A type that contains values to fine-tune a response when requesting amiibo types.
public struct AmiiboTypeFilter: KeyNameFilter {
// MARK: Properties
@@ -17,7 +18,7 @@ public struct AmiiboTypeFilter: KeyNameFilter {
public let key: String?
public let name: String?
// MARK: Initialisers
// MARK: Initializers
public init() {
self.key = nil
@@ -10,6 +10,7 @@
//
//===----------------------------------------------------------------------===
/// A type that contains values to fine-tune a response when requesting game characters.
public struct GameCharacterFilter: KeyNameFilter {
// MARK: Properties
@@ -17,7 +18,7 @@ public struct GameCharacterFilter: KeyNameFilter {
public let key: String?
public let name: String?
// MARK: Initialisers
// MARK: Initializers
public init() {
self.key = nil
@@ -10,6 +10,7 @@
//
//===----------------------------------------------------------------------===
/// A type that contains values to fine-tune a response when requesting game series.
public struct GameSeriesFilter: KeyNameFilter {
// MARK: Properties
@@ -17,7 +18,7 @@ public struct GameSeriesFilter: KeyNameFilter {
public let key: String?
public let name: String?
// MARK: Initialisers
// MARK: Initializers
public init() {
self.key = nil