crush

crush is a library to control placement in a hierarchy

• Home page : http://http://libcrush.org/main/python-crush

• Documentation : http://crush.readthedocs.org/

• PyPi : https://pypi.python.org/pypi/crush

GNU/Linux Installation

• pip install crush

Other Installation

When using pip versions lower than 8.1 or other operating systems, compilation is necessary and packages must be installed first.

• apt-get install -y gcc g++ python-pip python-all-dev libpython3-all-dev cmake libboost-all-dev libatomic-ops-dev

• dnf / yum / zypper install -y gcc gcc-c++ python-pip python-devel python3-devel cmake make boost-devel libatomic_ops-devel

• pip install crush

Hacking

• Get the code:

  git clone http://libcrush.org/main/python-crush.git
  cd python-crush

• Set up the development environment:

  deactivate || true ; source bootstrap

• Run the tests:

  deactivate || true ; bash run-tests.sh

• Sync the libcrush submodule:

  git submodule update --remote libcrush

• Run a single test:

  tox -e py27 -- -s -k test_one tests/test_crush.py

• Check the documentation:

  python setup.py build_sphinx
  firefox build/html/index.html

• Update requirements

  rm -fr virtualenv virtualenv virtualenv source virtualenv/bin/activate # update some module in requirements.txt tox # if that works pip install -r requirements.txt pip freeze -r requirements.txt > new-requirements.txt .tox/py3/bin/pip freeze -r requirements-dev.txt > new-requirements-dev.txt diff <(.tox/py27/bin/pip freeze -r requirements-dev.txt) new-requirements-dev.txt # all lines after the first “were added by pip freeze” are indirect dependencies remove pkg-resources==0.0.0 https://bugs.launchpad.net/ubuntu/+source/python-pip/+bug/1635463

Release management

• Prepare a new version

• git checkout master ; git pull

• version=1.0.0 ; perl -pi -e “s/^version.*/version = $version/” setup.cfg ; for i in 1 2 ; do python setup.py sdist ; amend=$(git log -1 –oneline | grep –quiet “version $version” && echo –amend) ; git commit $amend -m “version $version” ChangeLog setup.cfg ; git tag -a -f -m “version $version” $version ; done

• Publish a new version

• docker build –tag manylinux manylinux

• docker run –rm -v $(pwd):/io manylinux /io/manylinux/build-wheels.sh OR docker run –rm -v $(pwd):/io manylinux env PYBINS=/opt/python/cp27-cp27mu/bin /io/manylinux/build-wheels.sh

• sudo chown -R $(id -u) wheelhouse/

• twine upload –sign wheelhouse/crush

• rm -fr dist

• python setup.py sdist

• twine upload –sign dist/*.tar.gz

• git push ; git push –tags

• pypi maintenance

• trim old versions at https://pypi.python.org/pypi/crush