72 lines
1.7 KiB
ReStructuredText
72 lines
1.7 KiB
ReStructuredText
.. _lib_api:
|
|
|
|
Api
|
|
****
|
|
|
|
Seeding
|
|
========
|
|
|
|
.. autoclass:: compLib.Api.Seeding
|
|
:members:
|
|
|
|
Double Elimination
|
|
===================
|
|
|
|
.. autoclass:: compLib.Api.DoubleElim
|
|
:members:
|
|
|
|
Position
|
|
========
|
|
|
|
.. autoclass:: compLib.Api.Position
|
|
:members:
|
|
|
|
|
|
Examples
|
|
========
|
|
|
|
Calling Seeding API
|
|
---------------------
|
|
|
|
.. code-block:: python
|
|
|
|
from compLib.Api import Seeding
|
|
|
|
park, code = Seeding.get_park()
|
|
if code == 403:
|
|
print(f"I am not in the correct zone to make that request!")
|
|
else:
|
|
park = park["id"]
|
|
print(f"I should move to parking position: {park}")
|
|
|
|
if park == 0:
|
|
print(f"I can't move to this position yet :(")
|
|
elif park == 1:
|
|
print(f"Moving to position 1!")
|
|
# drive to parking position using Motors module...
|
|
print(f"Now hopefully at position 1")
|
|
# drive back using Motors module...
|
|
elif park == 2:
|
|
# do something similar to park == 1..
|
|
elif park == 3:
|
|
# do something similar to park == 1..
|
|
|
|
success = Seeding.pay_park()
|
|
# check which code the api returned
|
|
if success == 204:
|
|
print(f"We scored some points!")
|
|
else:
|
|
print(f"We failed :(")
|
|
|
|
Calling Double Elimination API
|
|
----------------------------------
|
|
|
|
.. code-block:: python
|
|
|
|
from compLib.Api import DoubleElim
|
|
|
|
position, status = DoubleElim.get_position()
|
|
print(f"Position of my robot is: x={position.x}, y={position.y} and rotation is: {position.degrees}, the server responded with status code: {status}")
|
|
|
|
goal, status = DoubleElim.get_goal()
|
|
print(f"Goal is at: x={goal.x}, y={goal.y}, the server responded with status code: {status}")
|