Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

An all-in-one toolkit package to easy my Python work in my PhD.

Project description

PyhDToolkit: An all-in-one toolkit package for Python work in my PhD.

This repository is a package gathering a number of Python utilities for my work.

Installation

This code is compatible with Python 3.6+. If for some reason you have a need for it, you can simply install it in your virtual enrivonment with:

pip install pyhdtoolkit

If you intend to make some hotfix changes to the site-package, you can use pip's --editable flag and get the last released version (from master) with:

pip install --editable git+https://github.com/fsoubelet/PyhDToolkit.git@master#egg=pyhdtoolkit

If you intend on making actual changes, then you should clone this repository through VCS, and install it into a virtual environment. With git, this would be:

git clone https://github.com/fsoubelet/PyhDToolkit.git
cd PyhDToolkit
make

Testing

Tests are currently a work in progress, but testing builds are ensured after each commit through Travis-CI.

You can run tests locally with:

make tests

Standards, Tools and VCS

This repository respects the reStructuredText docstring format, uses Black as a code formatter with a default enforced line length of 120 characters, and Pylint as a linter. You can format the code with:

make format 

You can lint the code with (which will format the code first):

make lint

VCS is done through git and follows the Gitflow workflow. As a consequence, make sure to always install from master.

Miscellaneous

Feel free to explore the Makefile. You will get an idea of what functionality is available to you by running:

make help

Environment

This repository currently comes with an environment.yml file to reproduce a fully compatible conda environment. You can install this environment and add it to your ipython kernel by running:

make condaenv

Container

A Dockerfile is included if you want to build a container image from source. You can do so, building with the name simenv (and tag latest), with the command:

make docker-build

Alternatively, you can directly pull a pre-built image from Dockerhub with:

make docker-pull

You can then run your container in interactive mode, and use the already activated conda environment for your work. It is highly advised to run with --init for zombie processes protection, see Tini for details. Assuming you pulled the provided image from Dockerhub, the command is then (remove the --rm flag if you wish to preserve it after running):

docker run -it --rm --init fsoubelet/simenv

If you want to do some exploration through a jupyter interface then you need to tell your container to install it first, as it is not bundled in the image, then add the custom environment kernelspec. The following command will take care of all this:

docker run -it --rm --init -p 8888:8888 fsoubelet/simenv /bin/bash -c "/opt/conda/bin/conda install -c conda-forge jupyterlab -y --quiet > /dev/null && mkdir /opt/notebooks && /opt/conda/envs/PHD/bin/ipython kernel install --user --name=PHD && /opt/conda/bin/jupyter lab --notebook-dir=/opt/notebooks --ip='*' --port=8888 --no-browser --allow-root"

You can then copy the provided token and head to localhost:8888 on your local machine. There, you will have access to a kernel named PHD with all the goodies of this repository (and more).

Beware though, none of your changes / work will be saved in the image, and re-launching it gets you a clean state everytime. To save a file from the container (say a plot, or saved data), you can use the docker cp command (while the container is active).

A generic use case is: docker cp <ContainerID>:/path/to/container/file /path/to/local/copy and an example would be : docker cp fsoubelet/simenv:/some_plot_output.jpg .

License

Copyright © 2019-2020 Felix Soubelet. MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyhdtoolkit, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size pyhdtoolkit-0.3.0-py3-none-any.whl (52.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pyhdtoolkit-0.3.0.tar.gz (44.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page