« Projects

PySoy

  • Q: I'd like to participate. How do I begin?

    • 0

      Use Mercurial to grab a copy of our source code and join our IRC channel on Freenode. We need help with the backend (libsoy, using Genie), frontend (PySoy, using C), Documentation, and API feedback from beta-testing game developers.

      http://www.pysoy.org/wiki/Download#Mercurial


         — Arc Riley (arc) · 7 years ago
    • [X]
      • Tip:

        Talk about diverse kinds of contributions. Include URLs if relevant (we'll automatically linkify them).

      • Examples:

        Here's how to download and patch our codes…

        Read about our death-defying mailing list and momentous IRC channel at http://lobstermag.net.

  • Q: Other than writing code, how can I contribute?

    • 0
      Documentation and Testing

      While we pride ourselves on documentation, there's a lot of room for improvement. You can help by trying to learn PySoy and fixing documentation where you found it unclear or incomplete. At the same time you may find rough edges or things that don't work as you'd intuitively expect, those are areas for API improvement.

      Of course, as we're in beta and active development, finding new and creative ways to make the engine crash is always helpful! New users are often the best at finding these obscure bugs as they work with the engine in ways we wouldn't.


         — Arc Riley (arc) · 7 years ago
    • [X]
      • Tip:

        Discuss documentation, testing, webmastering, and/or publicity.

        Include URLs if relevant (we'll automatically linkify them).

      • Example:

        We need people to download version 0.4.5 and make sure the frobulator still frobulates correctly.

  • Q: What's a good bug for a newcomer to tackle?

    • 0
      New math functions

      Throughout PySoy there's objects with incomplete or missing math functions. Vectors, Textures, Sounds, etc could all use basic (or improved) math functions.

      For an example of good math support, take a look at soy.atoms.Color which allows you to do intuitive things like:
      red = soy.atoms.Color('red')
      blue = soy.atoms.Color('blue')
      purple = red + blue

      Likewise, you should be able to generate a new texture by adding two existing textures together or divide a velocity vector in half.


         — Arc Riley (arc) · 7 years ago
    • [X]
      • Tip:

        Many projects have good small tasks that can teach newcomers how the project works. Now's your chance to share one of them!

        Include URLs if relevant (we'll automatically linkify them).

      • Example:

        Someone could improve the photo upload dialog box so that it lets you resize the photo before sending it to the web.

  • Q: What is a bug or issue with PySoy that you've been putting off, neglecting, or just plain avoiding?

    • 0
      OSX support

      There's a bug in gtkglext that prevents OpenGL rendering or event processing on OSX when GDK is run on a thread other than the primary thread.

      More details on this here: https://bugzilla.gnome.org/show_bug.cgi?id=606378

      PySoy currently lets Python run in the main thread and runs rendering and event handling in background threads. Some work is needed either in gdk/gtkglext or in PySoy to cause the main thread to handle display and/or event handling.


         — Arc Riley (arc) · 7 years ago
    • [X]
      • Examples:

        I don't know how to get started with internationalizing my app.

        Bug 392 about printing was filed five years ago, and I don't even know if printing still works.

        I want help from a C coder writing a Maildir patch for Alpine.

      • Note:

        If this issue was formally filed on the web, be sure to include the URL.

What else do you want to talk about?

About PySoy

(logo)

3d cloud gaming engine for Python 3

from the profile of Arc Riley (arc)

The code is mostly written in Genie, Orc, and C.

People who want to help (3)

The following people are interested in helping. Send them an email! (tips)

You can use this page to track who has been contacted if you log in. There will be a checkbox next to their name. When you check it, the page will publish today's date and your username.

Volunteer opportunities, etc.

No volunteer opportunities in PySoy indexed here yet. Add a bug tracker.

There is 1 person who can mentor in PySoy.

No one on OpenHatch has signed up as a mentor for Genie, Orc, and C. Can you? Add the tag.

You can embed the "I want to help" button on your website. (More about this.)