2020 Notes

Here are things to know about 2020 that are different from prior years. If you find things that are different that aren’t in this list, please submit a bug report.

Note

Most importantly, the API documentation has NOT been upgraded for 2020 yet. However, our goal is that most API should be identical/close to the 2019 API. If you find something that is different, please file a bug report!

Why is everything so different this year?

From 2015-2020, RobotPy maintained a pure python version of WPILib and bindings around third party vendor libraries. However, maintaining RobotPy is a lot of work, and as WPILib and third party vendors add even more features it was becoming slowly impossible to keep up.

In 2020, we switched to using mostly automatically generated wrappers around C++ libraries. Ideally, once completed, this will significantly lower the amount of work needed to update/maintain RobotPy in the future. Unfortunately in the short term, there’s a lot of work needed to get there (however – we’re most of the way there as of this writing!).

See this github issue for a longer discussion about this.

2020 has been a bit bumpy, but with your help hopefully we can smooth out the rough spots and make 2021 a seamless transition!

Upgrading from prior years

You should uninstall the following packages manually:

py -3 -m pip uninstall robotpy-hal-sim robotpy-hal-base

Windows-specific notes

  • The Visual Studio 2019 redistributable package is required to be installed.
  • CTRE and REV do not support simulation in 32-bit programs, so you must have a 64-bit Python installed.

OSX-specific notes

CTRE and REV do not support simulation on OSX, so these packages do not work at this time. You can work around this by checking for an import error:

try:
    import ctre
except ImportError:
    ctre = None

...

if ctre is not None:
    ..

A mock solution could be provided for simulation. If you’re interested in developing something, contact us!

Class inheritance

When inheriting from RobotPy provided objects, and you provide your own __init__ function, you must call the base class’ __init__ function. If you don’t have your own __init__ function, there is no need to add one, Python will do the right thing automatically.

Here are some examples using the command framework objects, but this applies to any RobotPy object that you might inherit from:

from wpilib.command import Command

class GoodCommand(Command):

    # no custom __init__, nothing extra required

    def foo(self):
        pass

class AlsoGoodCommand(Command):

    def __init__(self):

        # Call this first!!
        Command.__init__(self)

        # custom stuff here
        self.my_cool_thing = 1

class BadCommand(Command):
    def __init__(self):
        self.my_cool_thing = 1

        # BAD!! you forgot to call Command.__init__, which will result
        # in a difficult to diagnose crash!

class MaybeBadCommand(Command):
    def __init__(self):
        # This is not recommended, as it may fail in some cases
        # of multiple inheritance. See below
        super().__init__()
        self.my_cool_thing = 1

The pybind11 documentation recommends against using super().__init__():

Note that a direct __init__ constructor should be called, and super() should not be used. For simple cases of linear inheritance, super() may work, but once you begin mixing Python and C++ multiple inheritance, things will fall apart due to differences between Python’s MRO and C++’s mechanisms.

Where is physics and tests?

We are working on the 2020 implementation, and then once completed will focus on adding support for these.

Some community members have expressed interest in fixing support for testing/physics, but the work still has not been completed.