TMDb

TMDb - O banco de dados de filmes

Um pacote Swift para o Movie Database (TMDb) https://www.themoviedb.org

Requisitos

• Rápido 6.0+
• SO
  • macOS 13+
  • iOS 16+
  • watchOS 9+
  • tvOS 16+
  • visãoOS 1+
  • Windows
  • Linux

Instalação

Gerenciador de pacotes Swift

Adicione o pacote TMDb como uma dependência ao seu arquivo Package.swift e adicione-o como uma dependência ao seu destino.

 // 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 " ] )
  ]
)

Projeto Xcode

Adicione o pacote TMDb às dependências do pacote do seu projeto.

Configurar

Obtenha uma chave de API

Crie uma chave de API no site do Movie Database https://www.themoviedb.org/documentation/api.

Início rápido

 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 ) 

Documentação

Documentação e exemplos de uso podem ser encontrados em https://adamayoung.github.io/TMDb/documentation/tmdb/

Desenvolvimento

Pré-requisitos

Xcode 16.0+ Swift 6.0+ Homebrew

Cerveja caseira

Instale o homebrew e as seguintes fórmulas

• Swiftlint
• formato rápido
• markdownlint

brew install swiftlint swiftformat markdownlint

Antes de enviar um PR

Testes unitários e de integração

O Swift Testing é usado como estrutura de teste. XCTest não é mais usado.

Certifique-se de que todo o novo código seja coberto por testes de unidade. Se quaisquer novos métodos forem adicionados aos serviços que fazem chamadas para terminais da API TMDb, certifique-se de que haja testes de integração cobrindo-os.

Estilo de codificação

O estilo de codificação é aplicado por swift-format .

Use o seguinte comando para limpar a base de código:

make lint

Para formatar a base de código, use:

make format

Documentação DocC

Certifique-se de que todas as classes public , estruturas, propriedades e métodos sejam comentados

A documentação DocC pode ser construída e hospedada localmente por

make preview-docs

Veja DocC | Documentação do desenvolvedor Apple para obter mais detalhes.

Verificações de IC

Antes de enviar um PR, certifique-se de que todas as verificações de CI serão aprovadas:

make ci

As verificações de CI são compostas pelas seguintes tarefas:

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

Para executar testes de integração, as seguintes variáveis ​​de ambiente precisam ser definidas.

• TMDB_API_KEY - Sua chave API TMDb
• TMDB_USERNAME - Seu nome de usuário TMDb
• TMDB_PASSWORD – Sua senha do TMDB

Se essas variáveis ​​de ambiente não estiverem definidas, os testes de integração serão ignorados quando não forem usados make .

A execução de testes de unidade no Linux requer que o Docker esteja em execução.

Referências

• https://www.themoviedb.org
• https://developer.themoviedb.org

Licença

Esta biblioteca está licenciada sob a Licença Apache 2.0. Consulte LICENÇA para obter detalhes.