great-generator 0.1.0__tar.gz

great_generator-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+dist/
+build/
+*.egg-info/
+_publish_clone/
+.ipynb_checkpoints/
+.coverage
+coverage.xml
+htmlcov/

great_generator-0.1.0/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented here.
+
+This project follows semantic versioning once public releases begin.
+
+## Unreleased
+
+No unreleased changes yet.
+
+## 0.1.0 - 2026-06-19
+
+Initial public PyPI release.
+
+### Added
+
+- Great Generator package identity: publish as `great-generator` and import as `great_generator`.
+- Backward-compatible `enterprise_synth` import alias for pre-release users of the earlier repo name.
+- Faker-backed realistic value generation for pandas outputs.
+- Spark-native deterministic realistic value generation for Spark outputs.
+- `realism` mode for domain, relational, and schema generation APIs.
+- Realistic customer, patient, resident, user, merchant, product, provider, organization, company, phone, email, address, city, state, and postal-code fields where applicable.
+- Curated domain reference values for banking, ecommerce, healthcare, insurance, telecom, manufacturing, logistics, energy, hospitality, SaaS, public sector, media, and automotive-style data.
+- Ecommerce domain pack with customers, products, orders, order items, payments, shipments, and returns.
+- Banking domain pack with customers, accounts, transactions, cards, merchants, fraud events, and CDC-style customer changes.
+- Healthcare domain pack with patients, providers, facilities, encounters, claims, prescriptions, and lab results.
+- Telecom domain pack with customers, plans, devices, subscriptions, usage events, invoices, and support tickets.
+- Logistics domain pack with shippers, warehouses, carriers, products, shipments, shipment events, and inventory movements.
+- SaaS domain pack with organizations, users, plans, subscriptions, features, usage events, invoices, and support tickets.
+- Insurance domain pack with customers, agents, policies, claims, premium payments, risk assessments, and reinsurance contracts.
+- Automotive domain pack with customers, dealers, vehicles, sales, service appointments, warranty claims, and telematics events.
+- Energy domain pack with customers, sites, meters, rate plans, usage readings, outages, and bills.
+- Manufacturing domain pack with suppliers, plants, products, work orders, production runs, quality inspections, and inventory movements.
+- Media domain pack with users, content titles, subscriptions, viewing events, ad campaigns, ad impressions, and game sessions.
+- Public sector domain pack with residents, agencies, programs, applications, cases, payments, and service requests.
+- Hospitality domain pack with customers, properties, rooms, reservations, stays, payments, and reviews.
+- Shared industry-domain generator for compact domain packs with valid relationships and domain-looking values.
+- Schema-driven Spark fallback for newer domain packs, preserving primary-key and foreign-key consistency.
+- Deterministic generation with seeds.
+- Pandas generation engine.
+- Optional Spark generation engine.
+- CSV, JSON, Parquet, and Delta export helpers.
+- Cloud-friendly Spark path handling for local paths, DBFS, S3, ADLS, and GCS-style URIs.
+- Spark export controls for writer options, partitioning, repartitioning, and coalescing.
+- CDC generation for banking customer changes.
+- Opt-in anomaly injection for nulls, duplicates, orphan keys, late records, out-of-order records, outliers, negative amounts, invalid statuses, and skew.
+- Schema-first generation from compact schema strings, pandas DataFrames, PySpark StructTypes, and PySpark DataFrames.
+- Custom relational schema generation with user-provided tables, row counts, primary keys, foreign keys, pandas/Spark output, and optional exports.
+- Realistic-value examples, documentation pages, a GitHub Wiki, and a lightweight pandas benchmark script.
+- Tests for realistic value quality, placeholder compatibility, seed reproducibility, and relationship safety.
+- Tests for domain generation, relationship integrity, exports, CDC, anomalies, seed reproducibility, schema generation, and optional Spark behavior.
+
+### Notes
+
+- Spark and Delta dependencies are optional extras.
+- JSON-native nested payload generation is planned for a future release.

great_generator-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,26 @@
+# Code of Conduct
+
+This project is meant to be a practical, welcoming place for people building synthetic data tools for demos, tests, education, benchmarking, and research.
+
+## Expected behavior
+
+- Be respectful and constructive.
+- Assume good intent, but accept correction gracefully.
+- Keep discussions focused on the work.
+- Make space for beginners, students, practitioners, and domain experts.
+- Prefer specific technical feedback over personal criticism.
+
+## Unacceptable behavior
+
+- Harassment, threats, insults, or discriminatory language.
+- Posting private information without permission.
+- Repeatedly derailing technical discussions.
+- Using issues, pull requests, or discussions to attack people rather than improve the project.
+
+## Enforcement
+
+Project maintainers may remove comments, close threads, decline contributions, or restrict participation when behavior harms the project or its contributors.
+
+If you need to report a conduct issue, email:
+
+**ravikiran.pagidi@gmail.com**

great_generator-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Contributing
+
+Thanks for helping make `great-generator` more useful.
+
+## Local setup
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Development workflow
+
+1. Create a focused branch.
+2. Add or update tests with every behavior change.
+3. Run:
+
+```bash
+ruff check .
+black --check .
+pytest
+python -m build
+python -m twine check dist/*
+```
+
+4. Keep domain packs realistic, deterministic, and dependency-light.
+5. Prefer small public APIs with excellent examples over clever internals.
+
+## Good contributions
+
+- New domain packs with documented relationships and behaviors
+- Additional realistic reference values for existing domains
+- Additional anomaly types that are opt-in and testable
+- Spark generation improvements that preserve deterministic behavior
+- Exporters, schema utilities, and documentation examples
+- Bug fixes with regression tests
+
+## Adding a domain pack
+
+A good domain pack should include:
+
+1. table schemas with primary keys and foreign keys
+2. deterministic pandas generation
+3. Spark support through either a domain-specific generator or schema-driven fallback
+4. realistic distributions, skew, and time behavior
+5. tests for tables, columns, relationships, and seed reproducibility
+6. README or docs examples showing why the domain is useful
+
+## Adding realistic values
+
+Add reusable business values to `great_generator/core/reference_values.py` when they can help more than one domain or user-provided schema. Keep lists realistic, dependency-light, and safe for public demos. Add tests that prove realistic mode is not returning placeholder-only values.
+
+## Suggested starter issues
+
+- Add realistic values for telecom plans and device models
+- Add ecommerce dashboard demo notebook
+- Add Spark benchmark script for cluster runs
+- Improve API reference docs with more examples
+- Add Great Expectations integration example
+- Add Microsoft Fabric demo using generated Parquet data
+- Add more healthcare provider and facility reference values
+- Add tests for realistic optional-null distribution
+
+## Releases
+
+Release work should follow [docs/PYPI_RELEASE.md](docs/PYPI_RELEASE.md).
+
+## Community and security
+
+- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+- Security policy: [SECURITY.md](SECURITY.md)
+
+## Design principles
+
+- Referential integrity by default
+- Anomalies only when explicitly requested
+- Seeds should make experiments reproducible
+- Optional Spark/Delta dependencies must remain optional
+- A newcomer should succeed in under a minute

great_generator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ravi Kiran Pagidi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.