Skip to main content

A psycopg2 PostgreSQL wrapper for data science

Project description

jumbo logo

📑 Welcome to Jumbo!

Jumbo is a wrapper of the amazing psycopg2 - the most popular PostgreSQL database adapter for the Python programming language.

Jumbo has been designed specifically for adoption in environments where thorough widespread knowledge of SQL protocols might be lacking and a streamlined approach to database interactions might be needed. Jumbo offers an intuitive and quickly deployable interface to successfully implement a database-centred data analysis pipeline at all levels of your team or organisation.

Jumbo is intuitive yet customisable - first-time users can easily interact with the database without worrying about handling transactions under the hood. At the same time, experienced PostgreSQL architects can still unleash the full power of psycopg2 and exploit its more advanced functionalities.

🚀 Quick Start

  1. 📚 Install jumbo like any other python package, using pip to download it from PyPI:

        $ pip install jumbo
    
  2. 🐘 Create a jumbo.env file in the root directory of your project with the following structure:

        DATABASE_HOST = <my_database_host_address>
        DATABASE_USERNAME = <my_database_user_name>
        DATABASE_PASSWORD = <my_database_user_password>
        DATABASE_PORT = <my_database_port>
        DATABASE_NAME = <my_database_name>
    
  3. 🐍 Test your installation running the following minimal script:

         import jumbo
    
         # Initialize database connection
         database = jumbo.database.Database()
    
         # Open a connection pool.
         with database.open() as pool:
    
            # Get an individual connection from the pool.
            with pool.connect():
    
               pass
    

📚 Documentation

To learn more about the package head over to the official documentation!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jumbo-1.0.2.tar.gz (14.6 kB view hashes)

Uploaded Source

Built Distribution

jumbo-1.0.2-py3-none-any.whl (27.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page