Metadata-Version: 2.1
Name: ephemeral-postgres
Version: 0.2.0
Summary: Start an ephemeral postgres instance for easy testing
Home-page: https://github.com/jthacker/ephemeral_postgres
Author: jthacker
Author-email: thacker.jon@gmail.com
License: UNKNOWN
Download-URL: https://github.com/jthacker/ephemeral_postgres/archive/v0.2.0.tar.gz
Description: # ephemeral-postgres
        
        [![Build Status](https://travis-ci.org/jthacker/ephemeral_postgres.svg?branch=master)](https://travis-ci.org/jthacker/ephemeral_postgres)
        
        ephemeral-postgres is a python package for easily setting up, testing, and
        finally tearing down postgres instances. It can be easily integrated in most
        test suites but has been primarily used with pytest.
        
        
        ## Installation
        ```bash
        pip install ephemeral-postgres
        ```
        
        ## Example
        ```python
        import ephemeral_postgres
        import psycopg2
        
        with ephemeral_postgres.postgres() as uri:
            con = psycopg2.connect(uri)
            cur = con.cursor()
            cur.execute('select * from pg_database')
            for row in cur.fetchall():
                print(row)
        ```
        
        Alternatively, if you would like to run an external Postgres server, you can
        override ephemeral_postgres from starting a new instance by setting the
        environment variable `EPHEMERAL_POSTGRES_URI` accordingly. For example:
        ```bash
        export EPHEMERAL_POSTGRES_URI="postgresql://postgres:postgres@localhost:5432/postgres"
        python "import ephemeral_postgres; print(ephemeral_postgres.postgres()[0])"
        ```
        
        ## Developing
        ```bash
        pip install -e .[test]
        
        # run unit tests
        pytest
        ```
        
        
        
Keywords: postgres,postgresql,testing,docker
Platform: UNKNOWN
Description-Content-Type: text/markdown
Provides-Extra: test
