https://github.com/codemonstur/filldb

Command line tool to fill an arbitrary mariadb schema with test data
https://github.com/codemonstur/filldb

Last synced: 21 days ago
JSON representation

Command line tool to fill an arbitrary mariadb schema with test data

• Host: GitHub
• URL: https://github.com/codemonstur/filldb
• Owner: codemonstur
• License: mit
• Created: 2019-10-16T09:27:39.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-02-11T15:08:41.000Z (almost 2 years ago)
• Last Synced: 2024-02-11T16:26:49.445Z (almost 2 years ago)
• Language: Java
• Homepage:
• Size: 2.1 MB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

[![GitHub Release](https://img.shields.io/github/release/codemonstur/filldb.svg)](https://github.com/codemonstur/filldb/releases) 

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.codemonstur/bobjooqcodegen/badge.svg)](http://mvnrepository.com/artifact/com.github.codemonstur/benthemanager)

[![MIT Licence](https://badges.frapsoft.com/os/mit/mit.svg?v=103)](https://opensource.org/licenses/mit-license.php)

## A tool for filling a Relational database

I looked around and couldn't find a decent database filling tool.

So I wrote one.

This tool only works with MariaDB.

Extending it to support other databases should not be hard, but I have no need at the moment.

Anyone that would like to implement it can help.

Meant to be used from the command line.

### Status

Only one real problem left:

Dealing with primary keys that span multiple columns (may or may not fail with the current code)

There is a command line switch that allows you to ignore errors so that the insert won't fail completely.

### Current features

- Schema agnostic, point it to a DB and it will figure things out from there

- Supports text, varchar, bigint, int and bit columns

- Can generate test data of various field types:

  street, city, state, country, email, name, first/middle/last name, hex, 

  phone number, timestamp, 

- Can download various lorum ipsums from generators online

- Can download various cartoons from webcomics

### Future features

There are some listed in `src/docs/ideas.md`.

More ideas are welcome.

As are bugs, comments and anything else really.

### Installation

1. Check out the code `git clone https://github.com/codemonstur/filldb.git`

2. Run `make install`

3. You can now run the code with `java -jar target/filldb.jar`

4. \[Optional] Copy the code to `/usr/local/bin`

5. \[Optional] Create an alias `alias filldb='java -jar /usr/local/bin/filldb.jar'`

The code requires Java 11.