jajaaa2/Swift-Testing-Agent-Skill

O que Swift-Testing-Agent-Skill faz?

🧪 Forneça orientação especializada em testes Swift com melhores práticas para XCTest, testes assíncronos, execução paralela e integração perfeita com Agent Skills.

Visão Geral

Esta skill capacita agentes de IA a oferecerem consultoria e suporte para testes em projetos Swift, utilizando XCTest e frameworks modernos. Ela é ideal para desenvolvedores que buscam qualidade de código, eficiência em testes e adoção de melhores práticas.

Recursos

• XCTest: Criação e execução de casos de teste, suites e fixtures.
• Testes Assíncronos: Suporte a async/await, expectativas e XCTestExpectation.
• Execução Paralela: Configuração de testes concorrentes para agilizar o feedback.
• Integração com Agent Skills: Uso de habilidades do agente para automação de CI/CD, análise de cobertura e geração de relatórios.

Plataformas Suportadas

• macOS (Xcode 15+)
• Linux (Swift 5.9+, via Swift Package Manager)

Como Usar

Inclua esta skill no seu prompt do agente para receber orientação contextualizada. Exemplo:

Use Swift-Testing-Agent-Skill para revisar este código e sugerir testes otimizados:

func fetchUserData() async throws -> User {
    let url = URL(string: "https://api.exemplo.com/user")!
    let (data, _) = try await URLSession.shared.data(from: url)
    return try JSONDecoder().decode(User.self, from: data)
}

Melhores Práticas

• Isolamento: Cada teste deve ser independente.
• Mocking: Use protocol e injeção de dependência para simular serviços.
• Nomenclatura: Nomes claros como testFetchUserData_whenSuccess_returnsUser().
• Cobertura: Priorize lógica de negócio e casos extremos.

Exemplo de Teste

import XCTest

final class UserServiceTests: XCTestCase {
    func testFetchUserData_success() async throws {
        let mockService = MockUserService()
        let user = try await mockService.fetchUserData()
        XCTAssertEqual(user.name, "João")
    }
}

Integração com CI/CD

Configure workflows para executar testes automaticamente. Exemplo para GitHub Actions:

name: Test Swift
on: [push]
jobs:
  test:
    runs-on: macOS-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: swift build
      - name: Test
        run: swift test --parallel

Contribuição

Sugestões e pull requests são bem-vindos! Veja o arquivo CONTRIBUTING.md para detalhes.

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.