tcod

A high-performance Python port of libtcod. Includes the libtcodpy module for backwards compatibility with older projects.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

289

Maintenance

Last Commit

9d ago

Contributors

21

Package

Dependencies

3

License

Simplified BSD License

Categories

Readme

.. contents:: :backlinks: top

========

Status

|VersionsBadge| |ImplementationBadge| |LicenseBadge|

|PyPI| |RTD| |Appveyor| |Travis| |Codecov| |Codacy|

|Requires| |Pyup|

=======

About

This is a Python cffi port of libtcod.

This library is hosted on GitHub <https://github.com/libtcod/python-tcod>_.

Any issues you have with this module can be reported at the GitHub issue tracker <https://github.com/libtcod/python-tcod/issues>_.

=======

Usage

This module was designed to be backward compatible with the original libtcodpy module distributed with libtcod. If you had code that runs on libtcodpy then you can use this library as a drop-in replacement. This installs a libtcodpy module so you'll only need to delete the libtcodpy/ folder that's usually bundled in an older libtcodpy project.

Guides and Tutorials for libtcodpy should work with the tcod module.

The latest documentation can be found here: https://python-tcod.readthedocs.io/en/latest/

==============

Installation

Detailed installation instructions are here: https://python-tcod.readthedocs.io/en/latest/installation.html

For the most part it's just::

pip3 install tcod

==============

Requirements

  • Python 3.6+
  • Windows, Linux, or MacOS X 10.9+.
  • On Linux, requires libsdl2 (2.0.5+).

===========

Changelog

You can find the most recent changelog here <https://github.com/libtcod/python-tcod/blob/develop/CHANGELOG.rst>_.

=========

License

python-tcod is distributed under the Simplified 2-clause FreeBSD license <https://github.com/HexDecimal/python-tdl/blob/master/LICENSE.txt>_.

.. _LICENSE.txt: https://github.com/libtcod/python-tcod/blob/master/LICENSE.txt

.. _python-tdl: https://github.com/libtcod/python-tcod/

.. _cffi: https://cffi.readthedocs.io/en/latest/

.. _numpy: https://docs.scipy.org/doc/numpy/user/index.html

.. _libtcod: https://github.com/libtcod/libtcod

.. _pip: https://pip.pypa.io/en/stable/installing/

.. |VersionsBadge| image:: https://img.shields.io/pypi/pyversions/tcod.svg?maxAge=2592000 :target: https://pypi.python.org/pypi/tcod

.. |ImplementationBadge| image:: https://img.shields.io/pypi/implementation/tcod.svg?maxAge=2592000 :target: https://pypi.python.org/pypi/tcod

.. |LicenseBadge| image:: https://img.shields.io/pypi/l/tcod.svg?maxAge=2592000 :target: https://github.com/HexDecimal/tcod/blob/master/LICENSE.txt

.. |PyPI| image:: https://img.shields.io/pypi/v/tcod.svg?maxAge=10800 :target: https://pypi.python.org/pypi/tcod

.. |RTD| image:: https://readthedocs.org/projects/python-tcod/badge/?version=latest :target: http://python-tcod.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

.. |Appveyor| image:: https://ci.appveyor.com/api/projects/status/bb04bpankj0h1cpa/branch/master?svg=true :target: https://ci.appveyor.com/project/HexDecimal/python-tdl/branch/master

.. |Travis| image:: https://travis-ci.org/libtcod/python-tcod.svg?branch=master :target: https://travis-ci.org/libtcod/python-tcod

.. |Codecov| image:: https://codecov.io/gh/libtcod/python-tcod/branch/master/graph/badge.svg :target: https://codecov.io/gh/libtcod/python-tcod

.. |Issues| image:: https://img.shields.io/github/issues/libtcod/python-tcod.svg?maxAge=3600 :target: https://github.com/libtcod/python-tcod/issues

.. |Codacy| image:: https://api.codacy.com/project/badge/Grade/b9df9aff87fb4968a0508a72aeb74a72 :target: https://www.codacy.com/app/4b796c65-github/python-tcod?utm_source=github.com&utm_medium=referral&utm_content=libtcod/python-tcod&utm_campaign=Badge_Grade

.. |Requires| image:: https://requires.io/github/libtcod/python-tcod/requirements.svg?branch=master :target: https://requires.io/github/libtcod/python-tcod/requirements/?branch=master :alt: Requirements Status

.. |Pyup| image:: https://pyup.io/repos/github/libtcod/python-tcod/shield.svg :target: https://pyup.io/repos/github/libtcod/python-tcod/ :alt: Updates

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100