Skip to content

Latest commit

 

History

History
49 lines (30 loc) · 1.73 KB

DEVELOP.rst

File metadata and controls

49 lines (30 loc) · 1.73 KB
Raw

How to develop on Astrodb

Installing the package on your system will not permit you to change it, this is why you will have to use virtual environment and install it from the repository sources.

You will use virtualenv to install the package with pip in Editable installs mode (in fact a Develop egg).

  1. Create a directory and make it a virtual environment:

    mkdir AstroDev
cd AstroDev
virtualenv --no-site-packages --setuptools .

  2. Then install the editable package sources:

    bin/pip install -e git+https://github.com/EricDepagne/Astrodb#egg=Astrodb

  3. Finally activate the virtual environment:

    source bin/activate

You should probably change the repository url if you don't have permissions to push on it.

You will find the package sources in AstroDev/src/astrodb/, your virtualenv install use it directly so every changes on the source takes effect instantly.

When you have activated the virtual environment you can check that is rightly installed use the commandline script:

astrodb

This should answer you something.

How to release

  1. Be sure that you don't commit anything that break your package;

  2. Update your release version in astrodb/__init__.py, remember you can't push a version that has allready been released;

  3. Then commit and push your changes;

  4. Go to the root directory of your package where there is a setup.py file;

  5. Build the new package:

    python setup.py sdist

  6. When it's done release it to PyPi:

    python setup.py sdist upload

  7. It's done!