Skip to content

Latest commit

 

History

History
184 lines (132 loc) · 8.28 KB

README.md

File metadata and controls

184 lines (132 loc) · 8.28 KB

generatedata.com

Build Status

This is the repo for the downloadable version of generatedata.com. The script is basically an engine to generate any sort of random data in any format. It currently comes with 30 or so Data Types (types of data it generates), plus 8 Export Types (formats for the data), but it can be extended in any way you want. Check out the developer documentation for that. If you need to generate random data programmatically rather than manually via the UI, you can use the REST API.

Generally the trunk is pretty stable, but it's not guaranteed. If you're downloading the script, get the most recent tag: https://github.com/benkeen/generatedata/releases

Requirements

  • PHP 5.3 or any later version of PHP 5.
  • MySQL 4.1.3 or later

How to Install / Documentation

For installation instructions, user and developer documentation, check out: http://benkeen.github.io/generatedata/

Installation is really, really simple. I deliberately wrote the script to be as self-contained as possible and not require additional PHP/Server configuration when setting it up. That said, it does require PHP 5.3.0 or later. See the documentation for more info.

Pre-packaged solutions

Docker

Vagrant

There's also a pre-packaged Vagrant solution found here, courtesy of Daragh Courtney.

Test Coverage

Test coverage is pretty weak right now! I'm in the midst of adding phpunit tests and integrating it with Travis, but it's going to be a little hairy for a while just yet.

To-Do

Please see the issues tagges as feature requests for a list of things that are still left to complete on this project. Help is always welcome!

License

This script is freely available under the GPL 3 license. See license.txt in the root folder. Please note that all contributors agree that all code is released under this license.

Contributors

In addition to the many fine folk who submit bug reports, a big thanks to the following for their help extending the script: https://github.com/benkeen/generatedata/graphs/contributors

Changelog

3.4.0 - Nov 16, 2019

3.3.1 - July 18, 2019

3.3.0 - July 1, 2019

  • misc bug fixes

3.2.8 - Sep 12, 2017

  • misc bug fixes

3.2.7 - Jul 29, 2017

  • "Computed" Data Type added.
  • misc bug fixes

3.2.6 - Apr 17, 2017

3.2.5 - Apr 16, 2016

3.2.4 - Dec 6, 2015

  • patch release for per-user settings.

3.2.3 - Nov 15, 2015

3.2.2 - Nov 12, 2015

  • The plugins (Data Types, Export Types, Countries) seen in the interface may not be configured on a per-user level.
  • Installation script updated to allow customization of plugin selection.

3.2.1 - May 25, 2015

  • Configuration history option added to store the last 200 (this is configurable) versions of a data set. In case of data loss, you can now revert to an older version very simply.
  • Assorted bug fixes, including some improvements to the installation script.

3.2.0 - Jan 29, 2015

  • Adds a new REST API as an alternative way to generate data. See the API Documentation for more information.

3.1.4 - Sept 6, 2014

3.1.3 - July 20, 2014

3.1.2 - July 12, 2014

3.1.1 - Jan 31, 2014

3.1.0 - Dec 19, 2013

  • Bug fix for accidental short-tags that were introduced in earlier code

3.0.9 - Dec 11, 2013

3.0.8 - Oct 28, 2013

3.0.7 - Sept 7, 2013

3.0.6 - Aug 1, 2013

3.0.5 - July 13, 2013

3.0.4 - July 2nd, 2013

3.0.3 - June 23, 2013

3.0.2 - June 12, 2013

3.0.1 - June 1st, 2013

3.0.0 - May 21st, 2013

  • Initial release

Ben Keen @vancouverben