Getting Set Up¶
The Panel library is a complex project which provides a wide range of data interfaces and an extensible set of plotting backends, which means the development and testing process involves a wide set of libraries.
The Panel source code is stored in a Git source control repository. The first step to working on Panel is to install Git on to your system. There are different ways to do this depending on whether, you are using Windows, OSX, or Linux.
Developing Panel requires a wide range of packages that are not
easily and quickly available using pip. To make this more manageable,
core developers rely heavily on the conda package manager for the
free Anaconda Python distribution. However,
conda can also
install non-Python package dependencies, which helps streamline Panel
development greatly. It is strongly recommended that anyone
developing Panel also use
conda, and the remainder of the
instructions will assume that
conda is available.
The source code for the Panel project is hosted on GitHub. To clone the source repository, issue the following command:
git clone https://github.com/pyviz/panel.git
This will create a
panel directory at your file system
panel directory is referred to as the source
checkout for the remainder of this document.
Since Panel interfaces with a large range of different libraries the full test suite requires a wide range of dependencies. To make it easier to install and run different parts of the test suite across different platforms Panel uses a library called pyctdev to make things more consistent and general. To start with cd into the panel directory and then set up conda using the following commands:
cd panel conda install -c pyviz "pyctdev>0.5.0" doit ecosystem_setup
Once pyctdev is available and you are in the cloned panel repository you can set up an environment with:
doit env_create -c pyviz/label/dev -c conda-forge --name=panel_dev --python=3.7
Specify the desired Python version, currently Panel officially supports Python 2.7, 3.5, 3.6 and 3.7. Once the environment has been created you can activate it with:
conda activate panel_dev
To perform an editable install of Panel, including all the dependencies required to run the full unit test suite, run the following:
doit develop_install -c pyviz/label/dev -c conda-forge -c bokeh -o build -o tests -o recommended
The above command installs Panel’s dependencies using conda, then performs a pip editable install of Panel.