/generatedata

Random data generator in JS, PHP and MySQL.

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

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.

Generally the trunk is pretty stable, but it's never guaranteed. If you're downloading the code, I'd suggest getting the most recent tag: https://github.com/benkeen/generatedata/releases

Requirements

  • PHP 5.3 or later
  • 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.

Installation via Vagrant

There's a prepackaged installation available via vagrant found here, courtesy of Daragh Courtney. If you're not familiar with Vagrant, basically it's a package that includes not just the generatedata script, but the entire development environment along with it: PHP, MySQL and Apache. Super handy.

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] (https://github.com/benkeen/generatedata/issues?labels=Feature+Request%21&page=1&state=open) 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 folks who submit bug reports, a big thanks to the following for their help extending the script:

Changelog

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