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.