{"id":14977418,"url":"https://github.com/tryexceptpass/capsule","last_synced_at":"2025-10-28T03:32:10.569Z","repository":{"id":62560840,"uuid":"45228478","full_name":"tryexceptpass/capsule","owner":"tryexceptpass","description":"Python module for creating development environments as Docker containers, similar to virtualenv.","archived":false,"fork":false,"pushed_at":"2016-05-30T00:35:30.000Z","size":13,"stargazers_count":17,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-01T11:24:13.697Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tryexceptpass.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-30T04:08:37.000Z","updated_at":"2021-09-26T02:51:25.000Z","dependencies_parsed_at":"2022-11-03T14:45:34.393Z","dependency_job_id":null,"html_url":"https://github.com/tryexceptpass/capsule","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryexceptpass%2Fcapsule","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryexceptpass%2Fcapsule/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryexceptpass%2Fcapsule/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryexceptpass%2Fcapsule/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tryexceptpass","download_url":"https://codeload.github.com/tryexceptpass/capsule/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238590596,"owners_count":19497350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T13:55:37.266Z","updated_at":"2025-10-28T03:32:10.264Z","avatar_url":"https://github.com/tryexceptpass.png","language":"Python","readme":"This package is meant to help manage development environments using docker, while providing an interface similar  to that of python's `virtualenvwrapper` module.\n\n**Note:** This code is in alpha stage. You're free to try it out and provide feedback, but keep in mind it will undergo heavy changes before it's production ready.\n\n[![Stories in Ready](https://badge.waffle.io/tryexceptpass/capsule.png?label=ready\u0026title=Ready)](https://waffle.io/tryexceptpass/capsule)\n\n## Features\n* Simple cli to create, switch to and delete environments that allow you to fiddle to your heart's content without breaking anything else. \n* Currently this is based on a clean Ubuntu install (`ubuntu:latest` docker [image](https://hub.docker.com/_/ubuntu/)) with basic python 2.7 configured.\n* Save your environment to a tarfile in case you want to take it with you anywhere.\n* Export the python history of anything you tried while using the python interpreter within your environment into an iPythonNotebook file that can be used with any Jupyter server (like the `jupyter/notebook` docker [image](https://hub.docker.com/r/jupyter/notebook/)).\n\n## Install\n1. Setup and install [docker](http://docs.docker.com/linux/started/) or [docker-machine](https://www.docker.com/docker-toolbox) on your computer.\n2. `git clone` this repo.\n3. `python setup.py install`\n\n## Usage\nThe setup script installs a `capsule` shell command that provides the interface described below. Any environment you create is essentially a new docker container and will therefore maintain state next time you work on it. The `save` and `load` commands essentially export / import the environment to a tarfile.\n\nThe environment is an Ubuntu install with python 2.7 by default (I'll provide a python 3 option soon) and is configured to keep track of your python history when using the interpreter. This allows us to automatically export any experiments you run within the python interpreter to an iPythonNotebook through the `pyhistory` command.\n\n```\nManage capsule environments.\n\nUsage:\n  capsule make \u003cname\u003e [options]\n  capsule workon \u003cname\u003e [options]\n  capsule remove \u003cname\u003e [options]\n  capsule list [options]\n  capsule save \u003cname\u003e [options]\n  capsule load \u003cfilename\u003e \u003cname\u003e\n  capsule pyhistory \u003cname\u003e\n\nOptions:\n  --baseimage\n\n  --debug       Print debug messages.\n  -h --help     Show this screen.\n  --version     Show version.\n```\n\nNote: please be patient the first time you run it, as it will take a little bit while we run a docker build to download and create the first container.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryexceptpass%2Fcapsule","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftryexceptpass%2Fcapsule","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryexceptpass%2Fcapsule/lists"}