frappe-integration-test-generator_skill

Overview

This skill generates integration tests for multi-DocType workflows in Frappe, focusing on end-to-end business processes and state transitions. It produces ready-to-run test scaffolding, sample helper methods, and assertions to verify data integrity and lifecycle changes across related documents. Use it to speed up coverage for complex workflows and reduce manual test authoring.

How this skill works

The skill inspects a described workflow or sample DocTypes and produces FrappeTestCase-based test classes that create, submit, transform, and cancel documents in sequence. It includes helper factory methods for creating test fixtures, asserts for expected states and amounts, and examples for verifying transitions and validation errors. Outputs are organized as Python test methods that can be adapted into your app's tests folder.

When to use it

• Validating complete end-to-end business workflows that span multiple DocTypes.
• Verifying state transitions (draft → submitted → cancelled) and lifecycle rules.
• Testing multi-document interactions like Sales Order → Invoice → Payment Entry.
• Automating regression checks for complex business logic after code changes.
• Creating baseline integration tests when onboarding new features or modules.

Best practices

• Isolate test data using helper methods that insert minimal required fields and clean up after run.
• Use assertions for both state (docstatus/status) and numeric invariants (outstanding amount, totals).
• Keep tests deterministic: set explicit dates, item codes, and currencies to avoid environment variability.
• Test negative flows too: expect ValidationError for forbidden edits or invalid transitions.
• Group related assertions in one end-to-end test and keep smaller focused tests for single transitions.

Example use cases

• Generate a full sales cycle test: create Customer → Sales Order → Sales Invoice → Payment Entry and assert 'Paid' status.
• Create state transition tests for invoices to exercise draft, submit, and cancel behavior and forbidden edits.
• Produce tests that exercise multi-DocType business rules, e.g., stock reservation across Sales Order and Stock Entry.
• Scaffold tests for custom workflows introduced by a new app to ensure regression safety.
• Create parameterized tests for the same workflow under different customer groups, price lists, or taxes.