Getting started with pandas dev

This is a repo to bootstrap you to get going with pandas development

This helps setting up development environment quickly.

History: built for onboarding at Pycon 2018 Canada sprint

Dependency

This requires you to have Docker installed. We relie on Docker to keep our environment homogenous between developers.

Getting started

1. Setting up your pandas source folder

Create a fork of the pandas repo following this instructions

Then you can start pulling it into your repo.

git clone https://github.com/<your user name>/pandas.git
git remote add upstream [email protected]:pandas-dev/pandas.git

See adding upstream and merge for understanding the upstream setup.

2. Building the docker image

make build
make run
# This will put you into the shell of the image.

Once you are in the docker image, run:

$ conda activate pandas-dev
$ python scripts/validate_docstrings.py pandas.DataFrame.mean

Note that if the above doesnt run, with the error:

ImportError: C extension: No module named 'pandas._libs.tslibs.conversion' not built. If you want to import pandas from the source directory, you may need to run 'python setup.py build_ext --inplace --force' to build the C extensions first.

You will need to run:

python setup.py build_ext --inplace -j 4 && python -m pip install -e .

Some development notes

Docs contributing guideline

• Contributing guideline
• reST introduction