Portando código
Esta skill é usada para portar código de uma linguagem para outra.
Entrada
- Linguagem alvo
- Arquivos fonte ou código a ser portado
Processo
Comece criando um esboço das funcionalidades principais presentes no código atual. Anote quaisquer:
- Casos de borda que o código ou testes unitários consideram
- Bibliotecas utilizadas e equivalentes recomendados na linguagem alvo.
Use a ferramenta de entrada ou perguntas estruturadas para percorrer cada biblioteca utilizada e verificar com o usuário qual equivalente usar.
Opções adicionais a apresentar:
- Funcionalidade de stub (esboço)
- Implementar do zero
Em seguida, porte quaisquer testes unitários. Use isso como base para verificar o código portado.
Finalmente, porte o código usando o esboço preparado anteriormente. Itere sobre isso usando os testes unitários para informar correções.
Diretrizes gerais
- Use padrões comuns para a linguagem alvo.
- Use convenções de nomenclatura comuns para a linguagem alvo.
- O código portado deve espelhar o código original para que seja fácil para o usuário encontrar funcionalidades equivalentes.
- Mantenha logs e comentários presentes no código original.
- Anote quaisquer novos casos de borda.
- Anote quaisquer alterações na estrutura do código para ajudar o usuário a se orientar.
Critérios de sucesso
- Testes unitários passam, se presentes.
- Linting passa, se presente.
- Todas as funcionalidades principais estão implementadas.
- Todos os casos de borda identificados foram considerados.
- Todas as bibliotecas necessárias estão instaladas e prontas para uso.
Exemplos
Exemplo de código original
/**
* Calcuta o preço final do produto incluindo quaisquer descontos e com imposto.
*
* Lança um erro em caso de desconto inválido.
*/
export function calculatePrice(basePrice: number, discount: number | null, taxRate: number): number {
let discountAmount = 0;
if (discount) {
if (discount >= 1) {
// Se os descontos estiverem mal configurados, podem resultar em um
// preço negativo. Pare antes de mostrar ao usuário um preço inválido.
throw new Error('Invalid discount');
}
discountAmount = basePrice * discount;
}
const taxAmount = (basePrice - discountAmount) * taxRate;
return (basePrice - discountAmount) + taxAmount;
}
Exemplo de esboço
Funcionalidades principais:
- A função
calculatePriceaceita um preço base, percentual de desconto e uma taxa de imposto e calcula o preço final do produto.- Casos de borda:
- Desconto pode ser nulo
- Se o desconto for maior ou igual a 1, lançar uma exceção para evitar preços inválidos.
- Casos de borda:
Exemplo de código portado
def calculate_price(base_price: float, discount: Optional[float], tax_rate: float) -> float:
"""
Calcuta o preço final do produto incluindo quaisquer descontos e com imposto.
Lança uma exceção em caso de desconto inválido.
"""
discount_amount = 0
if discount is not None:
if discount >= 1:
# Se os descontos estiverem mal configurados, podem resultar em um
# preço negativo. Pare antes de mostrar ao usuário um preço inválido.
raise Exception('Invalid discount')
discount_amount = base_price * discount
tax_amount = (base_price - discount_amount) * tax_rate
return (base_price - discount_amount) + tax_amount
Exemplo de resposta
Portei o código para Python.
calculatePriceagora écalculate_price