https://github.com/peopledoc/populous

populate your database with god-like powers
https://github.com/peopledoc/populous

approved-public ghec-mig-migrated peopledoc-opensource

Last synced: 17 days ago
JSON representation

populate your database with god-like powers

• Host: GitHub
• URL: https://github.com/peopledoc/populous
• Owner: peopledoc
• License: mit
• Created: 2015-12-22T18:48:17.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2022-02-03T10:39:18.000Z (almost 3 years ago)
• Last Synced: 2024-10-30T00:10:52.050Z (2 months ago)
• Topics: approved-public, ghec-mig-migrated, peopledoc-opensource
• Language: Python
• Size: 218 KB
• Stars: 8
• Watchers: 18
• Forks: 2
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
Populous - *populate your database with god-like powers*

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

Populous is a tool for fast and rich data generation. From a description

of your schema say how many objects you want, what they should look

like, and populous will create them for you!

Current state

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

The project is in a very early stage and proof-of-concept state. Please

be patient, but don't hesitate to share your thoughts and desires with

us in the issues.

Documentation

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

**Sorry, but the documentation is not ready yet :( .**

However, if you are very eager to try it, here is what you can do:

-  Install populous: ``pip install populous``

-  Have a PostgreSQL database at hand

-  Find some blueprints (YAML files describing what you want to

   generate) or create some. This is the tricky part, but you can find

   some examples in the ``demo/blueprints/`` directory.

-  Launch populous with those blueprints:

   ``populous run postgres demo/blueprints/*.yml`` (you can pass your

   postgres instance either via ``PG*`` environment variables or via

   arguments)

-  Gaze at your freshly generated data via ``psql`` or any other tool!

Troubleshooting

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

OSX compilation problems

~~~~~~~~~~~~~~~~~~~~~~~~

There's currently no pre-compiled package for the

``peloton_bloomfilters`` library, which is a current requirement for

populous. To correctly install it in your environment, you're going to:

-  install ``gcc`` (via homebrew, for example),

-  install the package using the following flags

   ``ARCHFLAGS="-arch x86_64" CC=/usr/bin/gcc``.

For example, to install locally:

::

    ARCHFLAGS="-arch x86_64" CC=/usr/bin/gcc pip install peloton_bloomfilters

Or if you want to run the test suite via tox:

::

    ARCHFLAGS="-arch x86_64" CC=/usr/bin/gcc tox