Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/carlthome/ipytoolbox

A collection of IPython magics and other utilities
https://github.com/carlthome/ipytoolbox

ipython jupyter matplotlib numpy

Last synced: 29 days ago
JSON representation

A collection of IPython magics and other utilities

Awesome Lists containing this project

README

        

# ipytoolbox

A collection of IPython magic commands and other utilities.

## Features

### `%autocuda`
- A line magic to automatically select the local CUDA device(s) with the most free memory.

image

### `%%animate`

- A cell magic to automatically capture `plt.plot(); plt.show()` calls and display them as an animation once the cell has finished executing.

[Example notebook](./notebooks/demo.ipynb)

## Install

First make sure Python is installed, then run:

```sh
pip install ipytoolbox
```

Then you can use it in IPython or Jupyter Notebooks by

```ipython
%load_ext ipytoolbox
```

## Develop

First clone the repo and set it as working directory. Then install the package in development mode (preferably within its own virtual environment):

```sh
pip install -e ".[tests]"
```

If you have `direnv` installed, you can run `direnv allow` to automatically create and activate a Python virtual environment when you enter the directory.

### Test

```sh
pytest
```

### Lint

```sh
pre-commit run --all-files
```

Or `pre-commit install` to run automatically on `git commit`.

### Publish

```sh
gh release create
```