port-tests

Automates conversion of botocore sync tests to aiobotocore async tests with pytest validation and commits successful changes.

1.4k|208|Updated May 31, 2015
One-click install
npx skills add https://github.com/aio-libs/aiobotocore --skill port-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: port-tests
Source: https://github.com/aio-libs/aiobotocore/tree/main/plugins/aiobotocore-bot/skills/port-tests
Command: npx skills add https://github.com/aio-libs/aiobotocore --skill port-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, pytest, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of porting botocore tests to aiobotocore, reducing manual effort and ensuring consistency across test suites.

Core Features & Use Cases

  • Test Porting: Converts sync test files from botocore to their async counterparts in aiobotocore.
  • Validation: Validates each ported test with pytest -x and commits only successful changes.
  • Backfill Mode: Backfills missing tests from existing mirrored files to narrow coverage gaps.
  • Dry Run: Provides a dry run option to review changes before committing.

Quick Start

Run the port-tests skill with the --from and --to flags to port tests from one version to another.

Frequently Asked Questions about port-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert botocore sync tests to aiobotocore async tests?

You can port botocore sync tests by running the port-tests automation, which converts sync test files to their async counterparts and validates them with pytest. It automatically commits only successful changes.

What is the best way to backfill missing aiobotocore tests from botocore?

To backfill missing aiobotocore tests, use the backfill mode to extract missing tests from existing mirrored botocore files. This narrows coverage gaps without manually writing new test cases.

Do I need git and pytest to automate aiobotocore test porting?

Yes, you need git, pytest, and python installed to automate aiobotocore test porting. The skill uses pytest to validate ported tests and git to commit successful changes automatically.

Can I review botocore to aiobotocore test changes before committing them?

Yes, you can review test porting changes before committing by using the dry run option. This allows you to preview converted aiobotocore tests without applying any git commits.

How does pytest validation work when porting tests to aiobotocore?

Pytest validation runs using the -x flag to execute ported aiobotocore tests and stop on the first failure. The automation only commits changes when pytest execution succeeds without errors.