Fix pyrobosim_ros docs build and move build script to docs folder

[sea-bass]

I noticed that the pyrobosim_ros.ros_interface module was not being picked up by docs build because of missing ROS interface modules that need to be mocked out, so this PR should address that.

It also moves the generate_docs.bash script from the setup folder to the docs folder, as this makes more sense.

Finally, it updates ReadTheDocs to using Ubuntu 24.04 and Python 3.12, just to get ahead of any more surprises.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
__init__.py	0	0	100%
core
__init__.py	9	0	100%
dynamics.py	47	1	97%	140
gazebo.py	136	8	94%	55, 124, 230, 244–248
hallway.py	94	8	91%	200, 242–245, 269–271
locations.py	131	18	86%	69, 71, 88, 104, 117–118, 120–121, 138, 196, 211, 236, 246, 302–303, 305–306, 335
objects.py	69	4	94%	78, 106, 137, 197
robot.py	464	69	85%	263–264, 276, 279, 283–284, 289–290, 336, 359–360, 401–403, 407–411, 436, 439, 443–445, 472, 474, 516–517, 519–520, 537–539, 555–557, 624–626, 651–653, 704–706, 775–777, 829–831, 854, 860, 863, 865, 867, 870–872, 882, 890, 896, 902, 908, 920, 962, 980, 983, 988
room.py	48	1	97%	113
world.py	804	189	76%	153–154, 190–191, 195, 269–270, 272–273, 303–304, 366, 380–381, 383–384, 399–401, 421–425, 427–429, 431–432, 435, 437–440, 444–448, 451–453, 456–467, 483–484, 502–504, 518, 520, 523–524, 529–531, 570, 572, 575–576, 581–583, 593–595, 630, 632, 635–636, 641–643, 666, 668, 671–672, 677–679, 725–726, 729, 750, 780–781, 792, 795, 803, 819–823, 825–827, 830–831, 834–837, 839, 842, 844–846, 848–850, 852, 867, 874, 885–889, 924–925, 929–930, 948–949, 955–956, 958–959, 961, 963–964, 966, 968–969, 979–980, 983, 985, 999, 1001, 1008, 1055, 1086–1087, 1110–1111, 1115–1116, 1135–1136, 1140–1141, 1164, 1166–1167, 1203, 1220–1221, 1245, 1310, 1317, 1335–1338, 1350–1353, 1367, 1381, 1425–1426, 1478, 1558–1559, 1625, 1635
yaml_utils.py	108	6	94%	61, 65, 167–168, 187–188
gui
__init__.py	2	0	100%
main.py	236	54	77%	22–24, 45, 77–80, 221–229, 241–249, 256–259, 261, 264–270, 274, 279–280, 284–285, 296, 336–337, 346–347, 351–352, 363–366
world_canvas.py	296	56	81%	46–47, 49–53, 56, 167–170, 174–175, 180–181, 188, 190, 247–249, 255, 272–274, 321, 378–379, 406–407, 409, 411–413, 416–419, 421, 425–431, 434, 437–438, 454, 473, 516, 540, 570, 590, 607
manipulation
__init__.py	1	0	100%
grasping.py	236	61	74%	102, 110–112, 114–122, 124, 132, 462, 464–466, 470–472, 566–568, 571–575, 583, 586–588, 593–594, 600–604, 607–614, 617–619, 628, 630, 632–638
navigation
__init__.py	11	1	90%	37
a_star.py	77	11	85%	83–88, 90–92, 180, 189
execution.py	90	7	92%	73–75, 80–82, 119
occupancy_grid.py	139	14	89%	44–47, 49–53, 56, 192, 226, 234, 238
prm.py	56	4	92%	60–61, 140, 149
rrt.py	161	0	100%
visualization.py	32	6	81%	88–93
world_graph.py	58	4	93%	117, 120, 130, 139
planning
__init__.py	0	0	100%
actions.py	112	0	100%
planning/pddlstream
__init__.py	7	1	85%	13
default_mappings.py	9	0	100%
planner.py	40	8	80%	119–126
primitives.py	61	4	93%	68, 82, 94, 232
utils.py	99	8	91%	66, 93, 105, 115–116, 207–208, 211
utils
__init__.py	0	0	100%
general.py	33	4	87%	23, 45, 51–52
knowledge.py	154	22	85%	86, 117, 156–161, 163–164, 167–168, 170–173, 189, 204, 208, 250, 266, 329
motion.py	70	3	95%	93–94, 96
polygon.py	111	0	100%
pose.py	89	0	100%
search_graph.py	93	3	96%	240–242
trajectory.py	67	2	97%	130, 165
TOTAL	4250	577	86%

Tests	Skipped	Failures	Errors	Time
195	0 💤	0 ❌	0 🔥	3m 29s ⏱️