The Movie Database (TMDb) 用の Swift パッケージ https://www.themoviedb.org
TMDb パッケージを依存関係としてPackage.swift
ファイルに追加し、それを依存関係としてターゲットに追加します。
// swift-tools-version:5.9
import PackageDescription
let package = Package (
name : " MyProject " ,
dependencies : [
. package ( url : " https://github.com/adamayoung/TMDb.git " , from : " 13.0.0 " )
] ,
targets : [
. target ( name : " MyProject " , dependencies : [ " TMDb " ] )
]
)
TMDb パッケージをプロジェクトのパッケージ依存関係に追加します。
The Movie Database Web サイト https://www.themoviedb.org/documentation/api から API キーを作成します。
let tmdbClient = TMDbClient ( apiKey : " <your-tmdb-api-key> " )
let moviesToDiscover = try await tmdbClient . discover . movies ( ) . results
let fightClub = try await tmdbClient . movies . details ( forMovie : 550 )
ドキュメントと使用例は、https://adamayoung.github.io/TMDb/documentation/tmdb/ にあります。
Xcode 16.0+ Swift 6.0+ 自作
homebrew と次の式をインストールします
brew install swiftlint swiftformat markdownlint
テストフレームワークとしてSwift Testingを使用します。 XCTest は使用されなくなりました。
すべての新しいコードが単体テストでカバーされていることを確認します。 TMDb API エンドポイントを呼び出すサービスに新しいメソッドが追加される場合は、これらをカバーする統合テストがあることを確認してください。
コーディングスタイルはswift-format
によって強制されます。
次のコマンドを使用してコードベースをリントします。
make lint
コードベースをフォーマットするには、以下を使用します。
make format
すべてのpublic
クラス、構造体、プロパティ、メソッドがコメント化されていることを確認します。
DocC ドキュメントは、次の方法でローカルに構築してホストできます。
make preview-docs
DocC | を参照してください。詳細については、Apple 開発者向けドキュメントを参照してください。
PR を送信する前に、すべての CI チェックに合格することを確認してください。
make ci
CI チェックは次のタスクで構成されます。
make lint
make lint-markddown
make test
make test-ios
make test-watchos
make test-tvos
make test-visionos
make test-linux
make integration-test
make build-release
make build-docs
統合テストを実行するには、次の環境変数を設定する必要があります。
TMDB_API_KEY
- TMDb API キーTMDB_USERNAME
- TMDb ユーザー名TMDB_PASSWORD
- TMDB パスワードこれらの環境変数が設定されていない場合、 make
使用しない場合、統合テストはスキップされます。
Linux で単体テストを実行するには、Docker が実行されている必要があります。
このライブラリは、Apache License 2.0 に基づいてライセンスされています。詳細については、「ライセンス」を参照してください。