playgroundtools 1.0.1

A command-line interface for managing playground projects.

playgroundtools

A command-line interface for managing playground projects.

Overview

This package is intended to provide a quick and easy way to set up Python "projects," each containing their own files, folders, virtual environment, and installed packages. This also includes the ability to run these projects (called "playgrounds") and delete them through use of the CLI. The exact configuration for the creation and execution of these playgrounds are found here, in the package's configuration file.

Commands

new: Creates a playground.

$ playground new [-h] [-i LIB [LIB ...]] -n NAME type

For example, to create an api project:

# We can specify a list of optional packages to install via pip by using the `-i` option
$ playground new api -n my_api -i requests

run: Runs a playground.

$ playground run [-h] name

For example:

$ playground run console_app

delete: Deletes a playground.

$ playground delete -h name

For example:

$ playground delete jupyter_tests

Configuration and Settings

Settings for a playground can be configured via its settings.json file. The available options are:

• python: a path that points to the Python installation used to run the playground.
• module: the module to run (by invocation of -m {module})
• args: the arguments to pass to the module (-m {module} {args ...})

To configure the installation of playgroundtools, edit the config.json file. An easier way to do so will be coming in a future update. The available options are:

• folders: a list of folders that should be placed inside the playground upon creation.
• files: maps file names to lists containing the contents of the file by line.
• lib: the packages to be installed upon creation of the playground.
• module: the module to run when the playground is executed via -m {module}.
• args: the arguments to pass to the module upon execution (-m {module} {args ...}).