This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

pycsdl2 is a low-overhead, compiled SDL2 binding for CPython. It aims to provide the familiar C API of SDL2, while offering several Pythonic features such as automatic memory management, bounds checking and exceptions.

Documentation

Documentation is hosted online at https://pycsdl2.readthedocs.org/.

The Python API is documented with Sphinx in the docs/ directory. If you have GNU Make and Sphinx installed, run the following in the docs/ directory to generate the HTML documentation in docs/_build/html/:

make html

On Windows, make.bat can be used instead of GNU Make. Run the following in the docs/ directory to generate the HTML documentation in docs/_build/html/:

.\make.bat html

The documentation can be generated in other formats as well. See the output of make help or .\make.bat help for more details.

Building

Building the source code requires the CPython header files to be installed. This may require the installation of a development package such as python3-dev in Debian. The headers are installed by default in the official Python distributions for Windows and Mac OS X.

On Windows and Mac OS X, pycsdl2 will be statically linked against the bundled SDL2 source code. As such,

On other platforms such as Linux, the system must have a C compiler installed and the SDL2 library and header files installed. This may require the installation of a development package such as libsdl2-dev on Debian. Furthermore, a working installation of sdl2-config or pkg-config must be present in the executable search paths. pycsdl2 will be dynamically linked to the SDL2 library on these platforms.

Once your system satisfies the above requirements, run the following in the root of the source directory:

python3 setup.py build

If the build is successful, pycsdl2 can be installed with:

python3 setup.py install

The above build behavior can be controlled with the environment variable PYCSDL2_LIB:

  • setting it to auto will use the default behavior. setup.py will build and link against the bundled SDL2 source code on Windows and Mac OS X, and link against the system SDL2 library on other platforms.
  • setting it to bundled will force setup.py to build and link against the bundled SDL2 source code.
  • setting it to system will force setup.py to link against the system’s SDL2 library. sdl2-config will be used to retrieve the required compile and link flags, and if it fails, pkg-config will be used instead.
  • setting it to sdl2-config or pkg-config will force setup.py to link against the system’s SDL2 library, and to only use sdl2-config or pkg-config respectively to retrieve the required compile and link flags.

Unit tests

Unit tests are implemented using the unittest standard library module. Once the pycsdl2 has been built with python3 setup.py build, you can run all tests by running the following in the root of the source directory:

python3 -mtest

You can also run an individual test suite by running the corresponding file in the test/ directory:

python3 test/testfoo.py

Understanding the source code

The source code is documented with Doxygen. If you have a working installation, simply run the following in the root of the source directory:

doxygen

The HTML documentation will be written to the apidocs/html directory.

License

Unless otherwise stated, pycsdl2 source code is licensed under the zlib license.

pycsdl2 source code contains an unmodified copy of the Simple DirectMedia Layer (SDL) version 2.0.0 source code. The source code is licensed under the zlib license.

Release History

Release History

2.0.0.0.dev5

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.0.0.dev4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.0.0.dev3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.0.0.dev2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.0.0.dev1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.0.0.dev0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pycsdl2-2.0.0.0.dev5-cp34-cp34m-macosx_10_6_intel.whl (1.2 MB) Copy SHA256 Checksum SHA256 3.4 Wheel Oct 25, 2015
pycsdl2-2.0.0.0.dev5-cp34-none-win32.whl (627.2 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Oct 25, 2015
pycsdl2-2.0.0.0.dev5-cp34-none-win_amd64.whl (685.4 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Oct 25, 2015
pycsdl2-2.0.0.0.dev5-cp35-cp35m-macosx_10_6_intel.whl (1.2 MB) Copy SHA256 Checksum SHA256 3.5 Wheel Oct 25, 2015
pycsdl2-2.0.0.0.dev5.tar.gz (3.8 MB) Copy SHA256 Checksum SHA256 Source Oct 25, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting