https://github.com/michaelhelmick/django-balancer

A set of tools for using Django's multi-db feature.
https://github.com/michaelhelmick/django-balancer

database django python replication

Last synced: 12 days ago
JSON representation

A set of tools for using Django's multi-db feature.

• Host: GitHub
• URL: https://github.com/michaelhelmick/django-balancer
• Owner: michaelhelmick
• License: bsd-3-clause
• Created: 2010-10-15T20:28:31.000Z (about 14 years ago)
• Default Branch: develop
• Last Pushed: 2017-05-11T20:04:33.000Z (over 7 years ago)
• Last Synced: 2024-10-16T01:55:37.030Z (28 days ago)
• Topics: database, django, python, replication
• Language: Python
• Homepage:
• Size: 53.7 KB
• Stars: 110
• Watchers: 3
• Forks: 5
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
Django-Balancer

===============

.. image:: https://img.shields.io/pypi/v/django-balancer.svg?style=flat-square

  :target: https://pypi.python.org/pypi/django-balancer 

.. image:: https://img.shields.io/pypi/dw/django-balancer.svg?style=flat-square

  :target: https://pypi.python.org/pypi/django-balancer 

 

.. image:: https://img.shields.io/travis/michaelhelmick/django-balancer.svg?style=flat-square

  :target: https://travis-ci.org/michaelhelmick/django-balancer 

.. image:: https://img.shields.io/coveralls/michaelhelmick/django-balancer/master.svg?style=flat-square

  :target: https://coveralls.io/r/michaelhelmick/django-balancer?branch=master 

A set of tools for using Django's multi-db feature to balance database requests

between multiple replicated databases.  It currently provides some basic

routers for using weighted random selection or round robin selection with a

pool of databases, following a master/slave layout where the slaves are

read-only copies of master, and pinning reads to master for a user after that

user completes a write.

Since everything is implemented using base classes and mixins, this also serves

as a construction kit for creating your own more complex routers.  Feel free to

contribute routers, and I'll be happy to incorporate them into the project.

Install

-------

Install django-balancer via `pip `_

.. code-block:: bash

    $ pip install django-balancer

or, with `easy_install `_

.. code-block:: bash

    $ easy_install django-balancer

But, hey... `that's up to you `_.

Documentation

-------------

https://django-balancer.readthedocs.org/en/latest/