pgsql-parser-testing-fixtures

Generate Jest test suites from SQL fixtures for pgsql-parser.

232|33|Updated Jun 17, 2020
One-click install
npx skills add https://github.com/constructive-io/pgsql-parser --skill pgsql-parser-testing-fixtures
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pgsql-parser-testing-fixtures
Source: https://github.com/constructive-io/pgsql-parser/tree/main/.agents/skills/testing-fixtures
Command: npx skills add https://github.com/constructive-io/pgsql-parser --skill pgsql-parser-testing-fixtures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual overhead of maintaining consistent, regression-safe test suites for the pgsql-parser monorepo's PostgreSQL parsing, deparsing, and AST transformation tools, ensuring SQL parsing fidelity across code changes without repetitive test writing.

Core Features & Use Cases

  • Automated Fixture Pipeline: Generates executable Jest test suites automatically from raw SQL fixture files for the deparser, PL/pgSQL deparser, and transform packages.
  • Round-Trip Fidelity Validation: Verifies that parsed ASTs can be deparsed back to identical SQL and re-parsed to match the original AST, catching parsing and code generation regressions.
  • Use Case: When contributing a new SQL parsing feature to pgsql-parser, use this Skill to add a test fixture, regenerate the test suite, and confirm your changes do not break existing parsing behavior.

Quick Start

Use the pgsql-parser testing fixtures skill to add a new SQL test case to the kitchen-sink fixtures, regenerate the full test suite, and run all deparser tests to confirm no regressions are introduced.

Frequently Asked Questions about pgsql-parser-testing-fixtures

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

FAQPage Schema
How do I automate PostgreSQL parser regression testing from SQL fixtures?▼

Automate PostgreSQL parser regression testing by generating executable Jest test suites directly from raw SQL fixtures, validating that parsed ASTs deparse back to identical SQL and re-parse to match the original AST.

What is round-trip SQL parsing fidelity validation and when do I need it?▼

Round-trip SQL parsing fidelity validation verifies that a parsed AST can be deparsed back to identical SQL and re-parsed to match the original AST, catching parsing regressions when contributing to PostgreSQL parser development.

How do I add a new SQL test case to pgsql-parser without writing tests manually?▼

Add a new SQL test case to the kitchen-sink fixtures, regenerate the full test suite automatically, and run all deparser tests to confirm no regressions are introduced without manual test writing.

Does this PostgreSQL testing pipeline support PL/pgSQL deparser and AST transform packages?▼

Yes, the PostgreSQL testing pipeline supports the deparser, PL/pgSQL deparser, and AST transform packages, applying standardized fixture-based testing across the pgsql-parser monorepo.

Why do my PostgreSQL AST manipulation changes break existing parsing behavior?▼

PostgreSQL AST manipulation changes break existing parsing behavior when code generation regressions occur, which automated round-trip fidelity validation catches by verifying deparsed SQL matches the original parse.

What's the best way to maintain consistent test suites for PostgreSQL parsing tools?▼

Maintain consistent test suites for PostgreSQL parsing tools by using a standardized fixture-based testing pipeline that automatically generates executable Jest tests from raw SQL fixtures, eliminating manual test maintenance overhead.