Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dsietz/test-data-generation
Test Data Generation
https://github.com/dsietz/test-data-generation
algorithm archconf data data-privacy generate json machine-learning markov-decision-processes nfjs privacy profile rust-lang testing
Last synced: 12 days ago
JSON representation
Test Data Generation
- Host: GitHub
- URL: https://github.com/dsietz/test-data-generation
- Owner: dsietz
- License: apache-2.0
- Created: 2016-08-25T16:32:24.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2021-12-18T21:18:39.000Z (almost 3 years ago)
- Last Synced: 2024-10-13T13:29:54.211Z (26 days ago)
- Topics: algorithm, archconf, data, data-privacy, generate, json, machine-learning, markov-decision-processes, nfjs, privacy, profile, rust-lang, testing
- Language: Rust
- Homepage:
- Size: 2.83 MB
- Stars: 36
- Watchers: 8
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
## Test Data Generation
[](https://opensource.org/licenses/Apache-2.0)
[](https://coveralls.io/github/dsietz/test-data-generation?branch=master)
[](https://docs.rs/test-data-generation)
Linux: [](https://github.com/dsietz/test-data-generation/actions/workflows/master.yaml)
Windows: [](https://ci.appveyor.com/project/dsietz/test-data-generation/branch/master)
## [Fast test data generation!](#head1234)
### Description
For software development teams who need realistic test data for testing their software, this Test Data Generation library is a light-weight module that implements Markov decision process machine learning to quickly and easily profile sample data, create an algorithm, and produce representative test data without the need for persistent data sources, data cleaning, or remote services. Unlike other solutions, this open source solution can be integrated into your test source code, or wrapped into a web service or stand-alone utility.
**PROBLEM**
In order to make test data represent production, (a.k.a. realistic) you need to perform one of the following:
+ load data from a production environment into the non-production environment, which requires ETL (e.g.: masking, obfuscation, etc.)
+ stand up a pre-loaded "profile" database that is randomly sampled, which requires preparing sample data from either another test data source
or production environment (option #1 above)
**SOLUTION**
Incorporate this library in your software's testing source code by loading an algorithm from a previously analyzed data sample and generating
test data during your tests runtime.
---
### Table of Contents
- [Test Data Generation](#test-data-generation)
- [Fast test data generation!](#fast-test-data-generation)
- [Description](#description)
- [Table of Contents](#table-of-contents)
- [What's New](#whats-new)
- [About](#about)
- [Usage](#usage)
- [Profile](#profile)
- [Data Sample Parser](#data-sample-parser)
- [Examples](#examples)
- [How to Contribute](#how-to-contribute)
- [License](#license)
## What's New
Here's what's new ...
**0.3.4**
+ [Upgrade crates and improve performance](https://github.com/dsietz/test-data-generation/pull/100)
## About
`test data generation` uses [Markov decision process](https://en.wikipedia.org/wiki/Markov_decision_process) machine learning to create algorithms that enable test data generation on the fly without the overhead
of test data databases, security data provisioning (e.g.: masking, obfuscation), or standing up remote services.
The algorithm is built on the bases of:
1. character patterns
2. frequency of patterns
3. character locations
4. beginning and ending characters
5. length of entity (string, date, number)
## Usage
There are multiple ways to use the Test Data Generation library. It all depends on your intent.
### Profile
The easiest way is to use a Profile. The `profile` module provides functionality to create a profile on a data sample (Strings).
Once a profile has been made, data can be generated by calling the _pre_generate()_ and _generate()_ functions, in that order.
```rust
extern crate test_data_generation;
use test_data_generation::profile::profile::Profile;
fn main() {
// analyze the dataset
let mut data_profile = Profile::new();
// analyze the dataset
data_profile.analyze("Smith, John");
data_profile.analyze("Doe, John");
data_profile.analyze("Dale, Danny");
data_profile.analyze("Rickets, Ronney");
// confirm 4 data samples were analyzed
assert_eq!(data_profile.patterns.len(), 4);
// prepare the generator
data_profile.pre_generate();
// generate some data
println!("The generated name is {:?}", data_profile.generate());
// save the profile (algorithm) for later
assert_eq!(data_profile.save(&String::from("./tests/samples/sample-00-profile")).unwrap(), true);
// later... create a new profile from the saved archive file
let mut new_profile = Profile::from_file(&String::from("./tests/samples/sample-00-profile"));
new_profile.pre_generate();
// generate some data
println!("The generated name is {:?}", new_profile.generate());
}
```
### Data Sample Parser
If you are using CSV files of data samples, then you may wish to use a Data Sample Parser.
The `data_sample_parser` module provides functionality to read sample data, parse and analyze it, so that test data can be generated based on profiles.
```rust
extern crate test_data_generation;
use test_data_generation::data_sample_parser::DataSampleParser;
fn main() {
let mut dsp = DataSampleParser::new();
dsp.analyze_csv_file(&String::from("./tests/samples/sample-01.csv"), None).unwrap();
println!("My new name is {} {}", dsp.generate_record()[0], dsp.generate_record()[1]);
// My new name is Abbon Aady
}
```
You can also save the Data Sample Parser (the algorithm) as an archive file (json) ...
```rust
extern crate test_data_generation;
use test_data_generation::data_sample_parser::DataSampleParser;
fn main() {
let mut dsp = DataSampleParser::new();
dsp.analyze_csv_file(&String::from("./tests/samples/sample-01.csv"), None).unwrap();
assert_eq!(dsp.save(&String::from("./tests/samples/sample-01-dsp")).unwrap(), true);
}
```
and use it at a later time.
```rust
extern crate test_data_generation;
use test_data_generation::data_sample_parser::DataSampleParser;
fn main() {
let mut dsp = DataSampleParser::from_file(&String::from("./tests/samples/sample-01-dsp"));
println!("Sample data is {:?}", dsp.generate_record()[0]);
}
```
You can also generate a new csv file based on the data sample provided.
```rust
extern crate test_data_generation;
use test_data_generation::data_sample_parser::DataSampleParser;
fn main() {
let mut dsp = DataSampleParser::new();
dsp.analyze_csv_file(&String::from("./tests/samples/sample-01.csv"), None).unwrap();
dsp.generate_csv(100, &String::from("./tests/samples/generated-01.csv"), None).unwrap();
}
```
## Examples
This library comes with the following examples. To run the examples.
+ [Demo 1](https://github.com/dsietz/test-data-generation/blob/master/examples/01_demo.rs) : Demonstrates the basic feature of the library to generate dates and people's names from the built-in demo data sets.
> `cargo run --example 01_demo`
+ [Demo 2](https://github.com/dsietz/test-data-generation/blob/master/examples/02_demo.rs) : Demonstrates the basic feature of the library to generate dates and people's names from a CSV file.
> `cargo run --example 02_demo`
+ [Demo 3](https://github.com/dsietz/test-data-generation/blob/master/examples/03_demo.rs) : Demonstrates the ability to continuously add new analyzed data to an existing profile.
> `cargo run --example 03_demo`
## How to Contribute
Details on how to contribute can be found in the [CONTRIBUTING](./CONTRIBUTING.md) file.
## License
test-data-generation is primarily distributed under the terms of the Apache License (Version 2.0).
See [LICENSE-APACHE "Apache License](./LICENSE-APACHE) for details.