Metadata-Version: 2.1
Name: tgp
Version: 0.0.1
Summary: A platform for building terminal games
Home-page: https://github.com/cli-games/launcher
Author: Kieran Wood
Author-email: kieran@canadiancoding.ca
License: UNKNOWN
Description: **THERE IS NO CODE YET. I'm just namesquatting while planning so I don't have to rename everything later. Check back next week for first implementation.**
        
        
        
        
        
        
        
        # Terminal Game Platform
        
        A simple platform to handle some of the annoying implementation details of creating a terminal based game.
        
        
        
        ## Quick-start
        
        
        
        ### Installation
        
        #### From source
        
        1. Clone this repo: ([https://github.com/terminal-game-platform/launcher](https://github.com/terminal-game-platform/launcher))
        2. Run ```pip install .``` or ```sudo pip3 install .```in the root directory
        
        
        
        ## Development-Contribution guide
        
        
        
        ### Installing development dependencies
        
        There are a few dependencies you will need to use this package fully, they are specified in the extras require parameter in setup.py but you can install them manually:
        
        ```
        nox   	# Used to run automated processes
        pytest 	# Used to run the test code in the tests directory
        mkdocs	# Used to create HTML versions of the markdown docs in the docs directory
        ```
        
        Just go through and run ```pip install <name>``` or ```sudo pip3 install <name>```. These dependencies will help you to automate documentation creation, testing, and build + distribution (through PyPi) automation.
        
        
        
        ### Folder Structure
        
        *A Brief explanation of how the project is set up for people trying to get into developing for it*
        
        
        
        #### /tgp
        
        *Contains all the first party modules used in tgp*
        
        
        
        #### /docs
        
        *Contains markdown source files to be used with [mkdocs](https://www.mkdocs.org/) to create html/pdf documentation.* 
        
        
        
        #### /tests
        
        *Contains tests to be run before release* 
        
        #### Root Directory
        
        **setup.py**: Contains all the configuration for installing the package via pip.
        
        
        
        **LICENSE**: This file contains the licensing information about the project.
        
        
        
        **CHANGELOG.md**: Used to create a changelog of features you add, bugs you fix etc. as you release.
        
        
        
        **mkdocs.yml**: Used to specify how to build documentation from the source markdown files.
        
        
        
        **noxfile.py**: Used to configure various automated processes using [nox](https://nox.readthedocs.io/en/stable/), these include;
        
        - Building release distributions
        - Releasing distributions on PyPi
        - Running test suite agains a number of python versions (3.5-current)
        
        If anything to do with deployment or releases is failing, this is likely the suspect.
        
        
        
        There are 4 main sessions built into the noxfile and they can be run using ```nox -s <session name>``` i.e. ```nox -s test```:
        
        - build: Creates a source distribution, builds the markdown docs to html, and creates a universal wheel distribution for PyPi.
        - release: First runs the build session, then asks you to confirm all the pre-release steps have been completed, then runs *twine* to upload to PyPi
        - test: Runs the tests specified in /tests using pytest, and runs it on python versions 3.5-3.8 (assuming they are installed)
        - docs: Serves the docs on a local http server so you can validate they have the content you want without having to fully build them.
        
        
        
        **.gitignore**: A preconfigured gitignore file (info on .gitignore files can be found here: https://www.atlassian.com/git/tutorials/saving-changes/gitignore)
        
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 1 - Planning
Description-Content-Type: text/markdown
Provides-Extra: dev
