Files
sql-utilities/tests/Strata.SqlTools.Markdown.Tests/PostgreSql/SqlStatementGeneratorTests.cs
T
Thom LambandClaude Opus 4.7 423108a7dc
SonarQube Analysis / sonarqube (pull_request) Successful in 4m22s
chore(sonar)!: mark Markdown generator classes as 'public static class' (S1118)
After the CA1822 cascade in #15 left every method on the eight
Markdown generator classes static, the classes themselves were
instantiable shells that consumers couldn't usefully `new`. This
commit flips the `class` modifier to `static class` on all eight:

- `Markdown.SqlServer.QueryBreakdownGenerator`
- `Markdown.SqlServer.SqlStatementGenerator`
- `Markdown.LinqToSql.QueryBreakdownGenerator`
- `Markdown.LinqToSql.SqlStatementGenerator`
- `Markdown.PostgreSql.QueryBreakdownGenerator`
- `Markdown.PostgreSql.SqlStatementGenerator`
- `Markdown.Snowflake.QueryBreakdownGenerator`
- `Markdown.Snowflake.SqlStatementGenerator`

Test fixtures drop the now-meaningless `_generator = new …()` field
and `[SetUp]` (kept the existing Setup body where unrelated state was
also initialized — `QueryMarkdownGenerationTests` and
`LinqToSql.QueryBreakdownGeneratorTests`).

BREAKING CHANGE: External NuGet consumers can no longer write
`new Markdown.Snowflake.SqlStatementGenerator()` (or any of the other
seven classes above) — the type is now a static container and may only
be referenced by name, e.g.
`Markdown.Snowflake.SqlStatementGenerator.GenerateSequenceDiagram(…)`.
The call syntax for the static methods is unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 15:08:48 -05:00

172 lines
5.7 KiB
C#

using Strata.SqlTools.Breakdowns.PostgreSql;
using Strata.SqlTools.Markdown.PostgreSql;
namespace Strata.SqlTools.Markdown.Tests.PostgreSql;
[TestFixture]
public class SqlStatementGeneratorTests
{
[Test]
public void GenerateSequenceDiagram_PostgreSqlQuery_GeneratesValidDiagram()
{
// Arrange
var query = QueryBreakdown.Parse(@"
SELECT user_id, user_name, email
FROM users
WHERE status = 'ACTIVE'
");
// Act
var result = SqlStatementGenerator.GenerateSequenceDiagram(query, "User Query Flow");
// Assert
Assert.That(result, Does.Contain("```mermaid"));
Assert.That(result, Does.Contain("sequenceDiagram"));
Assert.That(result, Does.Contain("### User Query Flow"));
Assert.That(result, Does.Contain("```"));
}
[Test]
public void GenerateSequenceDiagram_WithPostgreSqlCTE_ShowsMainStatement()
{
// Arrange
var query = QueryBreakdown.Parse(@"
WITH active_customers AS (
SELECT customer_id, customer_name
FROM customers
WHERE status = 'ACTIVE'
)
SELECT c.customer_id, c.customer_name, COUNT(o.order_id) AS order_count
FROM active_customers c
LEFT JOIN orders o ON c.customer_id = o.customer_id
GROUP BY c.customer_id, c.customer_name
");
// Act
var result = SqlStatementGenerator.GenerateSequenceDiagram(query);
// Assert
Assert.That(result, Does.Contain("Execute Main Statement"));
Assert.That(result, Does.Contain("activate DB"));
Assert.That(result, Does.Contain("deactivate DB"));
}
[Test]
public void GenerateSequenceDiagram_ComplexPostgreSqlQuery_GeneratesSequenceDiagram()
{
// Arrange
var query = QueryBreakdown.Parse(@"
SELECT region, product, SUM(sales) AS total_sales
FROM sales_data
WHERE sale_date >= $1
GROUP BY region, product
HAVING SUM(sales) > 1000
ORDER BY total_sales DESC
");
// Act
var result = SqlStatementGenerator.GenerateSequenceDiagram(query, "Sales Analysis");
// Assert
Assert.That(result, Does.Contain("### Sales Analysis"));
Assert.That(result, Does.Contain("sequenceDiagram"));
Assert.That(result, Does.Contain("Execute Main Statement"));
Assert.That(result, Does.Contain("activate DB"));
Assert.That(result, Does.Contain("Return Results"));
}
[Test]
public void GenerateEntityRelationshipDiagram_PostgreSqlTables_GeneratesERDiagram()
{
// Arrange - PostgreSQL typically uses lowercase table names
var tables = new[] { "customers", "orders", "order_items", "products" };
// Act
var result = SqlStatementGenerator.GenerateEntityRelationshipDiagram(tables, "E-Commerce Schema");
// Assert
Assert.That(result, Does.Contain("```mermaid"));
Assert.That(result, Does.Contain("erDiagram"));
Assert.That(result, Does.Contain("### E-Commerce Schema"));
Assert.That(result, Does.Contain("customers"));
Assert.That(result, Does.Contain("orders"));
Assert.That(result, Does.Contain("order_items"));
Assert.That(result, Does.Contain("products"));
}
[Test]
public void GenerateEntityRelationshipDiagram_WithDoubleQuotedNames_HandlesQuotedIdentifiers()
{
// Arrange - PostgreSQL case-sensitive identifiers
var tables = new[] { "\"Customers\"", "\"Orders\"", "\"OrderItems\"" };
// Act
var result = SqlStatementGenerator.GenerateEntityRelationshipDiagram(tables);
// Assert
Assert.That(result, Does.Contain("erDiagram"));
Assert.That(result, Does.Contain("```"));
}
[Test]
public void GenerateEntityRelationshipDiagram_WithSchemaQualifiedNames_HandlesSchemaDotTable()
{
// Arrange - PostgreSQL schema.table qualified names
var tables = new[] { "public.users", "sales.orders", "inventory.products" };
// Act
var result = SqlStatementGenerator.GenerateEntityRelationshipDiagram(tables);
// Assert
Assert.That(result, Does.Contain("erDiagram"));
Assert.That(result, Does.Contain("```"));
}
[Test]
public void GenerateEntityRelationshipDiagram_SingleTable_GeneratesDiagram()
{
// Arrange
var tables = new[] { "users" };
// Act
var result = SqlStatementGenerator.GenerateEntityRelationshipDiagram(tables);
// Assert
Assert.That(result, Does.Contain("erDiagram"));
Assert.That(result, Does.Contain("users"));
}
[Test]
public void GenerateSequenceDiagram_NullTitle_GeneratesWithoutTitle()
{
// Arrange
var query = new QueryBreakdown("order_id", "orders");
// Act
var result = SqlStatementGenerator.GenerateSequenceDiagram(query, null);
// Assert
Assert.That(result, Does.Not.Contain("###"));
Assert.That(result, Does.Contain("sequenceDiagram"));
}
[Test]
public void GenerateSequenceDiagram_WithPositionalParameters_HandlesParametrizedQuery()
{
// Arrange - PostgreSQL positional parameters $1, $2
var query = QueryBreakdown.Parse(@"
SELECT product_id, product_name, price
FROM products
WHERE category_id = $1 AND price > $2
ORDER BY price DESC
");
// Act
var result = SqlStatementGenerator.GenerateSequenceDiagram(query);
// Assert
Assert.That(result, Does.Contain("sequenceDiagram"));
Assert.That(result, Does.Contain("Execute Main Statement"));
}
}