Skip to content

Latest commit

 

History

History
72 lines (51 loc) · 2.78 KB

README.md

File metadata and controls

72 lines (51 loc) · 2.78 KB

Humble Data Workshop

Humble Data Workshop

ℹ️ If you would like to know more about this workshop, please apply here.


Load the environment using pip-tools

# Activate environment
workon beginners-data-workshop

# Update packages from requirements.txt
# If this is the first time, then pip install pip-tools
pip-sync

# Install new package & update requirements.txt
pip install new-package-name
pip freeze  # to check version number

# Copy paste package & version to requirements.in
pip-compile
pip-sync

Attendee Setup

  1. Visit [https://bit.ly/humble-python-setup] to install Python onto your machine.
  2. The notebooks in this project should work great with Anaconda out of the box. If you want to create your own virtual environment for this workshop, your mentor will guide you through the simplest setup.

Note: The Development Setup outlined below will work for you, but is more complex than what you need to follow this workshop. This setup is designed to make it easy to upgrade Python dependencies (e.g. pandas, Seaborn), and run automated checks to highlight if any code in the notebooks is broken (we call this a "test suite").

Development Setup

This project uses pyenv, pyenv-virtualenvwrapper and Poetry. Please see here for a step-by-step installation guide.

# Install Python
pyenv install $(cat .python-version)
pyenv shell $(cat .python-version)
python -m pip install --upgrade pip
python -m pip install virtualenvwrapper
pyenv virtualenvwrapper

# Setup the virtualenv
mkvirtualenv -p python$(cat .python-version) $(cat .venv)
python -V
python -m pip install --upgrade pip

# Install dependencies with Poetry
poetry self update
poetry install --no-root --remove-untracked

# Create Jupyter Kernel
python -m ipykernel install --user --name beginners-data-workshop --display-name "Python (beginners-data-workshop)"

# Install Jupyter Extensions static files
jupyter contrib nbextension install --user
# More info: https://jupyter-contrib-nbextensions.readthedocs.io/en/latest/install.html

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.