frc-dozer/dozer

Dozer

Dozer is a framework for robots built with WPILib to help write fluent, readable code.

Build:

Features

• A task scheduler that allows you to write your robot logic as coroutines
• Wrapping of common motors, controllers, and sensors for easy inialization and management

Getting Started

👷

Download a Release

Or add us as a dependency on Maven (coming soon)

🚧

Discord

Join us on Discord!

Prerequisites

You'll need a copy of the latest build of WPILib from FRC, either as an Eclipse plugin or as a Maven artifact

Installing

Eclipse Plugins

Add our built jar archive to USER_HOME\wpilib\user\java\lib(C:\Users\USERNAME on Windows). This jar file will be available to all existing and future projects that are built with WPILib in Eclipse, and will be packaged automatically into the deploy task. Make sure to also add it to your IDE's classpath

Maven Artefact

(Support coming soon)

Built With

• WPILib - The Robot Library this project is based on.
• Maven - Dependency Management
• Zoominfo's Java Generators - A sadly abandoned implementation of lazy generators in java, used to handle coroutines.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

• Saints Robotics - Initial work - Saints Robotics
• Robototes - Robototes

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Special thanks to all of our mentors in helping us make this project a reality ❤️

dozer's Issues

TaskRobot should have inheritable fields for OI, Flags and Motors?

Should it?

Can't actually access the motors created in Motors.java

The hashmap needs accessors and to be protected not private

Tasks leak the threads they use after they're killed

After a task is disabled, a reference to the task and associated thread still remain, which leaves halted threads all around willy nilly. Though this doesn't seem to affect performance or behavior in a meaningful way when a robot is not operated for a very long time, this bug should still be patched.