Metadata-Version: 2.1
Name: pygamelib
Version: 1.2.3
Summary: A small game development framework for teaching programming.
Home-page: https://www.pygamelib.org
Author: Arnaud Dupuis
Author-email: 8bitscoding@gmail.com
License: UNKNOWN
Project-URL: Documentation, https://pygamelib.readthedocs.io/en/latest/index.html
Project-URL: Guides & Tutorials, https://astro.hyrul.es/guides/pygamelib/
Project-URL: Source, https://github.com/arnauddupuis/pygamelib
Project-URL: Tracker, https://github.com/arnauddupuis/pygamelib/issues
Project-URL: Wiki, https://github.com/arnauddupuis/pygamelib/wiki
Project-URL: Tech blog, https://8bitscoding.io/
Project-URL: Release Notes, https://8bitscoding.io/2020/08/30/pygamelib-v1-2-0-release-notes/
Description: ![Linux: Ok](https://img.shields.io/badge/Linux-Ok-green.svg "Linux: Ok")
        ![Windows: Ok](https://img.shields.io/badge/Windows-Ok-green.svg "Windows: Ok")
        ![Mac OS: Ok](https://img.shields.io/badge/Mac%20OS-Ok-green.svg "Mac OS: Ok")
        [![GPLv3 license](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.txt)
        [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
        [![Documentation Status](https://readthedocs.org/projects/pygamelib/badge/?version=latest)](https://pygamelib.readthedocs.io/en/latest/?badge=latest)
        [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2849/badge)](https://bestpractices.coreinfrastructure.org/projects/2849)
        [![CircleCI](https://circleci.com/gh/arnauddupuis/pygamelib.svg?style=svg)](https://circleci.com/gh/arnauddupuis/pygamelib)
        [![codecov](https://codecov.io/gh/arnauddupuis/pygamelib/branch/master/graph/badge.svg)](https://codecov.io/gh/arnauddupuis/pygamelib)
        
        
        # pygamelib
        A (not so) small library for terminal based game development.
        
        ## Preemptive warning
        
        Between version 1.1.1 and 1.2.0 the library was renamed from hac-game-lib to pygamelib and reworked to its core. So even though all the objects remains API compatible across versions, there is a bit of renaming to do in the imports.
        
        ## Introduction
        
        Historically, this library is used as a base to teach coding to kids from 6 to 15.
        It aims at giving an environment to new and learning developers (including kids) that let them focus on the algorithm instead of the lousy display or precise management.
        
        It started as a very simple library with very little capabilities, but over time it became something more. To the point that it is now possible to make very decent games with it.
        So this is **obviously** still extremely simple compared to other game framework and it still does not aim at being anything serious for real game developers.
        However, it can now be used by aspiring game developers for an introduction to 2D games development.
        
        There is a [Youtube channel](https://www.youtube.com/channel/UCT_SxIlKaD6MM7JlQKelpgw) that contains tutorials.
        
        ![suparex.py screenshot](https://raw.githubusercontent.com/arnauddupuis/pygamelib/master/images/Screenshot_Suparex.png "suparex.py")
        
        Here is a quick view of what can currently be achieved with that library (base_game haven't been updated for a long time):
        
        ![base_game.py animation](https://raw.githubusercontent.com/arnauddupuis/pygamelib/master/images/base_game.gif "base_game.py")
        
        The base game makes use of:
        * The main "game engine" (pygamelib.engine.Game)
        * Many different types of structures (from pygamelib.board_items): Wall (well the walls...), Treasure (gems and money bag), GenericStructure (trees) and GenericActionnableStructure (hearts and portals)
        * Game()'s menu capabilities.
        * Player and NPC (from pygamelib.board_items)
        * Inventory (from pygamelib.engine.Inventory)
        * Player and Inventory stats
        * RandomActuator (NPCs in level 2) and PathActuator (NPCs in level 1) (from pygamelib.actuators.SimpleActuators)
        
        For more up to date examples, have a look at:
         * [examples/suparex/](examples/suparex/) a platform game with procedural level generation
         * [examples/tutorials/03-game-design/](examples/tutorials/03-game-design/) for a more "dungeon-y" turn by turn experience.
        
        Here is a poorly done gif of Suparex:
        ![Suparex animation](https://raw.githubusercontent.com/arnauddupuis/pygamelib/master/images/suparex-720.gif "suparex.py")
        
        ## Strong points
        
        Hopefully you'll find the pygamelib to have a lot of strong points:
         * It is **simple**. It requires very limited Python knowledge to start coding games.
         * Yet **powerful** offering more advanced programmers a *lot* of possibilities.
         * The possibilities **scale up with the students** offering basic feature and default values "good enough" for beginners and lots of tunning opportunities for the advanced coders.
         * Lots of stuff are available **by default**. Any idea how long it would take a beginner to display only a part of a board? 1 second with the pygamelib, probably slightly more if they had to do it by hand ;)
         * It is **Terminal based**. This means no graphics card dependencies, cross platform, and a framework that stimulate imagination and creativity.
        
        ## Installation (recommended)
        
        The easiest way to install a stable version is to use [pypi](https://pypi.org/project/pygamelib/):
        
        ```bash
        pip3 install pygamelib
        ```
        
        It will pull all dependencies 
        
        ## Installation from sources and requirements
        
        ### Python
        
        The pygamelib only supports Python 3.6+. It will **not** run with Python 2.
        We use [pipenv](https://github.com/pypa/pipenv) to manage dependencies.
        
        Run Pipenv to install the requirements:
        
        ```bash
        pip3 install pipenv
        pipenv install
        ```
        
        If you want the development dependencies you need to run:
        ```bash
        pip3 install pipenv
        pipenv install --dev
        ```
        
        ### Runing tests 
        
        To run the unit tests use the following command:
        
        ```bash
        python -m unittest discover -s tests
        ```
        
        ### Terminal color and emojis
        
        It is not really a hard requirement but colored emojis are really bringing the games created to life.  
        We then recommend to have a color emojis font installed like Noto Color Emojis (on most Linux distributions you can install it from the package manager, search for "noto-color-emoji").
        
        If your terminal application is not displaying color emojis, please have a look at this [file](https://gist.github.com/IgnoredAmbience/7c99b6cf9a8b73c9312a71d1209d9bbb) and follow the instructions.
        
        ### Running examples
        
        To run the examples using [pipenv](https://github.com/pypa/pipenv):
        
        ```bash
        pipenv shell
        (pygamelib) cd examples/suparex
        (pygamelib) python3 suparex.py
        ```
        
        ## Limitations
        
        There is tons of limitations but for the most important ones: 
        * Only one player is supported.
        * There is little protections against messing up with the internal. This is *on purpose*, I want the kids to learn to use the API not mess up with the internals of every single class.
        * It's pure Python (it's slow).
        
Keywords: game,development,beginner,console,terminal
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
