Metadata-Version: 1.2
Name: terminal-quest
Version: 1.2.1
Summary: Cute little puzzle for teaching basic command line usage
Home-page: https://github.com/neuromics/terminal_quest
Author: Adam Labadorf
Author-email: labadorf@bu.edu
License: MIT
Description-Content-Type: UNKNOWN
Description: # Introduction
        
        `terminal-quest` is a [gamified](https://en.wikipedia.org/wiki/Gamification) introduction to basic command line navigation and file manipulation skills. It is implemented in the python programming language but requires no programming other than entering commands on a command line. 
        
        `terminal-quest` is a series of puzzles that can be solved with only the commands **cd**, **ls**, **man**, **cat**, **head**, **tail**, **grep**, file globbing (`*` character), and output redirection (`>` character).
        
        ![terminal_quest.png](terminal_quest.png)
        
        ## Installation and Use ##
        
        ### pypi ###
        
        You can install `terminal-quest` using `pip`:
        
        ```
        pip install terminal-quest
        ```
        
        ### Anaconda ###
        
        An alternative way to install `terminal-quest` is by using [anaconda](https://anaconda.org). After installing anaconda, open a terminal and run:
        
        ```
        conda create -n terminal-quest -c bubhub python=3.5 terminal-quest
        ```
        
        This will create a new conda environment called *terminal-quest* and install this software and the needed dependencies into it. To create your own terminal quest, run:
        
        ```
        source activate terminal-quest
        terminal_quest
        ```
        
        Note that the executable is `terminal_quest` not `terminal-quest`! The second command will display a festive and colorful splash message while it creates your own personal quest and provides some instructions and hints on how to start. **NB:** the anaconda method only currently works on linux systems.
        
        ### Manual Installation ###
        
        If you do not have access to anaconda, you may also install this package manually. You can either clone this repo to your local machine with:
        
        ```
        git clone https://bitbucket.org/bubioinformaticshub/terminal_quest.git
        ```
        
        or simply download the most recent stable version from [the downloads page](https://bitbucket.org/bubioinformaticshub/terminal_quest/downloads/?tab=tags).
        
        Once downloaded (and expanded, if downloaded as an archive), open a terminal and run from within the source directory:
        
        ```
        python setup.py install
        terminal_quest
        ```
        
        ### Dependencies ###
        
        This package uses the following non-standard python packages:
        
        * [future](https://pypi.python.org/pypi/future)
        * [fabulous](https://pypi.python.org/pypi/fabulous)
        * [pillow](https://python-pillow.org/)
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Python: >=2.6, >=3
