Skip to content

Commit

Permalink
Add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
danieldirks committed Jun 6, 2023
1 parent b716447 commit 315092d
Showing 1 changed file with 39 additions and 0 deletions.
39 changes: 39 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# devdb

Fire up a local testing database from a dump in no time.

[![MIT License](https://img.shields.io/github/license/danieldirks/devdb.svg)](LICENSE)


## Features

* Easy setup of local dev databases without the hassle.
* Loads a dump on startup, so you don't have to worry how to get your data in.
* Supports MySQL, MariaDB and PostgreSQL.
* Uses docker to start temporary databases without cluttering up your device.
* Lets you export to share, customize and set up on other machines.


## Setup

Make sure docker is installed and run `curl -sSf https://raw.githubusercontent.com/danieldirks/devdb/main/devdb > ~/.local/bin/devdb`.

To update or uninstall, simply remove the file and load it again.


## Usage

1. `devdb dump.sql`
2. wait
3. connect

It tries its best to figure out the database management system for you by searching for one of the supported databases at the beginning of the dump file. In some cases you may still need to specify it manually: `devdb --base mysql dump.sql`.

You can customize things like user and password and can export `devdb`s. More can be found by running `devdb help`.

Save time and have fun!


## License

The project is licensed under the [MIT License](LICENSE).

0 comments on commit 315092d

Please sign in to comment.