dataforger 0.1.1__py3-none-any.whl

dataforger/data.json

@@ -0,0 +1,78 @@
+{
+  "first_names": [
+    "Alex",
+    "Avery",
+    "Casey",
+    "Drew",
+    "Jordan",
+    "Morgan",
+    "Quinn",
+    "Riley",
+    "Sam",
+    "Taylor"
+  ],
+  "last_names": [
+    "Anderson",
+    "Bennett",
+    "Chen",
+    "Diaz",
+    "Garcia",
+    "Kim",
+    "Morgan",
+    "Patel",
+    "Smith",
+    "Wilson"
+  ],
+  "streets": [
+    "Cedar",
+    "Highland",
+    "Lake",
+    "Maple",
+    "Oak",
+    "Park",
+    "Pine",
+    "River"
+  ],
+  "street_types": [
+    "Ave",
+    "Blvd",
+    "Lane",
+    "Road",
+    "Street"
+  ],
+  "companies": [
+    "Acme",
+    "Bluebird",
+    "Cedar",
+    "Evergreen",
+    "Northstar",
+    "Pioneer",
+    "Silverline",
+    "Summit"
+  ],
+  "company_suffixes": [
+    "Group",
+    "Labs",
+    "Partners",
+    "Solutions",
+    "Studio"
+  ],
+  "email_domains": [
+    "example.com",
+    "example.net",
+    "example.org",
+    "example.ai",
+    "dummy.com",
+    "dummy.net",
+    "dummy.org",
+    "dummy.ai",
+    "fakedata.com",
+    "fakedata.net",
+    "fakedata.org",
+    "fakedata.ai",
+    "dummydata.com",
+    "dummydata.net",
+    "dummydata.org",
+    "dummydata.ai"
+  ]
+}

dataforger-0.1.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: dataforger
+Version: 0.1.1
+Summary: Generate fake data from Python or the command line.
+License: MIT License
+        
+        Copyright (c) 2026 Karmanshi Shrivastava
+        
+        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.
+        
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dataforger
+
+Generate realistic fake data from Python or the command line, and save it as
+CSV or JSON. Dataforger uses only the Python standard library and has no
+third-party runtime dependencies.
+
+Built-in names, streets, companies, and email domains are stored in
+`src/dataforger/data.json`. Country names and their associated cities are
+stored in `src/dataforger/countries.json`; when generating a record with both
+country and city fields, the city is selected from that country's list.
+
+## Install
+
+Requires Python 3.10 or later.
+
+From a checkout of this repository:
+
+```console
+python -m pip install .
+```
+
+After publishing the package to PyPI:
+
+```console
+python -m pip install dataforger
+```
+
+## Publishing to PyPI
+
+The GitHub Actions workflow runs the tests on Python 3.10 through 3.13 and
+builds wheel and source distributions on pushes and pull requests. To publish,
+configure a PyPI trusted publisher for this GitHub repository, using workflow
+`.github/workflows/publish.yml` and the GitHub environment `pypi`. Then create
+and publish a GitHub Release; the workflow publishes its tested distributions
+to PyPI using trusted publishing.
+
+## Command line
+
+Run `dataforger` without field options for an interactive prompt. Or specify
+all options directly:
+
+```console
+dataforger --rows 100 --field name:name --field email:email --field age:age --format csv --output users.csv --seed 42
+```
+
+The `--field` option can be repeated. Supported field types are `name`,
+`first_name`, `last_name`, `email`, `phone`, `address`, `city`, `country`,
+`company`, `uuid`, `date`, `age`, `integer`, `float`, and `boolean`. If
+`--field` is omitted, the command prompts for the row count, format, output
+path, and fields. When using command-line field options, the defaults are 10
+rows, JSON format, and `data.json`.
+
+## Python API
+
+```python
+from dataforger import generate_data, write_data
+
+records = generate_data(
+    {"name": "name", "email": "email", "age": "age"},
+    rows=100,
+    seed=42,
+)
+
+write_data(records, "users.json", "json")
+write_data(records, "users.csv", "csv")
+```
+
+`generate_data` returns a list of dictionaries. Pass the resulting records,
+an output path, and either `"csv"` or `"json"` to `write_data`.

dataforger-0.1.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+dataforger/__init__.py,sha256=WhbHQ-4RxsyRPpm1sMv0Tk-Ujd4X9D0oMhgsfhjWU7g,125
+dataforger/cli.py,sha256=wPL4L2WmzVKBzq6YR-INqtMfHP9Rfr5bZhyJjDtd-oY,3461
+dataforger/core.py,sha256=IZ30RZZ_FrI5rTctchkpp3kZMM1YlPHlKpqjkXmbelE,7363
+dataforger/countries.json,sha256=3-M8PnN1U0c5UndXR9crsgX8MfJ_Her5ozBdWiXXO8o,1452600
+dataforger/data.json,sha256=Zl0tHT6YTmxtI8ZltudendEo_WdOsy8MfXFO22vwdXY,1089
+dataforger-0.1.1.dist-info/licenses/LICENSE,sha256=I-Bi2ubGJVRom4qBJe3M0xquz0aqbe5q21PpcZ2pgqU,1078
+dataforger-0.1.1.dist-info/METADATA,sha256=DQ3HXIur39Fg1ruXxCtNDkCGIzpp9741usGiEBf2jU4,3977
+dataforger-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+dataforger-0.1.1.dist-info/entry_points.txt,sha256=hTz4qdENIShH6O17XGLvNkAZVpbvfJ4zy1UMTcbD8BE,51
+dataforger-0.1.1.dist-info/top_level.txt,sha256=RwD0Eh48r78jIamgk4iso1zH2Avfn6MWfB99ndQrUk0,11
+dataforger-0.1.1.dist-info/RECORD,,

dataforger-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dataforger-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dataforger = dataforger.cli:main

dataforger-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karmanshi Shrivastava
+
+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.

dataforger-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+dataforger