in-memory-docker-database

KO | EN

gitlite — search

#react #ai #typescript #go #linux #docker #windows #cli #awesome-list #pytorch #security #ios #mcp #openai

in-memory-docker-database

(★ 10)

In memory databases for your tests!

in-memory-docker-database 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# In Memory Docker Database

In the Java world the most popular approach to test with in memory databases is using H2 or HSQLDB. These databases work well and can emulate some database syntax and features, but like most emulations, this is superficial, imperfect and doesn't cover important database features.

In Memory Docker Database is a Java library that allow you to easily launch a docker container with a real database instance (like postgres, mysql and so on). This database will be running [in memory][1] and the process to do that is lightweight and quick, what is really useful for test purposes.

## Overview

![Alt text](https://cacoo.com/diagrams/KJIYGq2xh7iCL33h-D6350.png)

## Setup

#### Pull the database images
```sh
sudo docker pull postgres
```

#### Enable Docker remote REST API:
```sh
$ echo "DOCKER_OPTS='-H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock'" > /etc/default/docker
$ service docker restart
```
[Read here more about it!][2]

#### Maven dependencies:

```xml
<repositories>
	<repository>
    	<id>in-memory-docker-database-mvn-repo</id>
        <url>https://raw.github.com/rafaelpsouza/in-memory-docker-database/mvn-repo/</url>
        <snapshots>
        	<enabled>true</enabled>
          	<updatePolicy>always</updatePolicy>
        </snapshots>
    </repository>
</repositories>
```

```xml
<dependency>
    <groupId>br.eng.rafaelsouza</groupId>
    <artifactId>in-memory-docker-database</artifactId>
    <version>1.0-SNAPSHOT</version>
	<scope>test</scope>
</dependency>
```

## How to use

Basically you need to add two annotations in your tests:

```java
@RunWith(DockerDatabaseRunner.class)
@DockerDatabaseConfig(type = DatabaseType.POSTGRES, port = 5432)
public class BlogRepositoryTest {
```

* **@RunWith(DockerDatabaseRunner.class)**: The test runner that will enable test listeners (start database before start tests and stop afterwards)
* **@DockerDatabaseConfig(type = DatabaseType.POSTGRES, port = 5432)**: The database configuration. **type** is the database that you want to launch (only Postgres 9.4 is supported at this monent). **port** the port that the database you listen for connections.

You can also see the example projects here:
[examples][3]

### How to contribute

Fell free to open issues and pull requests or send me an [e-mail][4] if you want to code it.

[1]: http://www.martinfowler.com/bliki/InMemoryTestDatabase.html
[2]: http://infoslack.com/devops/exploring-docker-remote-api/
[3]: https://github.com/rafaelpsouza/in-memory-docker-database/tree/master/examples/
[4]: mailto:rafael.bnc@gmail.com

in-memory-docker-database

in-memory-docker-database 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

in-memory-docker-database

in-memory-docker-database 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README