Skip to content

Commit

Permalink
Fix docs
Browse files Browse the repository at this point in the history
  • Loading branch information
aivora-beamng committed Oct 7, 2024
1 parent 1898743 commit e813b91
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 25 deletions.
14 changes: 13 additions & 1 deletion CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,19 @@ Changelog

Version 1.30
============
TODO
- Added a new API for attaching and detaching `couplers`.
- Added a flag to disable `RoadsSensor <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#roads-sensor>`__ debug visualization.
- Fixed `BeamNGpy.scenario.restart <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.Scenario.restart>`__ breaking some keyboard shortcuts after calling it.
- The `BeamNGpy <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.BeamNGpy>`__ and `Vehicle <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.Vehicle>`__ objects are threadsafe now.
- Fixed the `set_part_config <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.Vehicle.set_part_config>`__ function losing the connection to the `Vehicle <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.Vehicle>`__ object
- Fixed `Lidar <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#lidar>`__ with ``is_streaming=True``.
- New tool for recording/replaying BeamNGpy protocol runs - `Tech Capture Player <https://documentation.beamng.com/beamng_tech/beamngpy/tools/capture_player/>`__.
- New debugging tool for BeamNGpy communication - Wireshark plugin:

- decodes all messages exchanged between BeamNGpy and BeamNG
- included with instructions in the `debug <https://github.com/BeamNG/BeamNGpy/tree/v1.30/debug>`__ folder of the BeamNGpy repository
- The ``determine_userpath`` function is skipped on Linux
- Renamed the ``crash_lua_on_error`` argument of `BeamNGpy <https://beamngpy.readthedocs.io/en/latest/beamngpy.html#beamngpy.BeamNGpy>`__ to ``debug``, as the argument also changes other behavior (it starts recording the Tech Captures).

Version 1.29
============
Expand Down
43 changes: 19 additions & 24 deletions src/beamngpy/beamng/beamng.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,9 @@
from time import sleep
from typing import TYPE_CHECKING, Any, List

from beamngpy.api.beamng import (
CameraApi,
ControlApi,
DebugApi,
EnvironmentApi,
ScenarioApi,
SettingsApi,
SystemApi,
TrafficApi,
UiApi,
VehiclesApi,
)
from beamngpy.api.beamng import (CameraApi, ControlApi, DebugApi,
EnvironmentApi, ScenarioApi, SettingsApi,
SystemApi, TrafficApi, UiApi, VehiclesApi)
from beamngpy.beamng import filesystem
from beamngpy.connection import Connection
from beamngpy.logging import LOGGER_ID, BNGError, create_warning
Expand Down Expand Up @@ -60,11 +51,13 @@ class BeamNGpy:
quit_on_close: Whether the simulator should be closed when :func:`close()` is called.
Defaults to True.
debug: If True, then sets BeamNG.tech communication to debug mode. That means:
1. BeamNG will not respond to BeamNGpy requests when a Lua error
happens and prints the stacktrace instead.
2. The `techCapture.*.log` files are created automatically in the userfolder,
they log every protocol call and can be replayed using the `tech/capturePlayer`
Lua extension.
1. BeamNG will not respond to BeamNGpy requests when a Lua error
happens and prints the stacktrace instead.
2. The ``techCapture.*.log`` files are created automatically in the userfolder,
they log every protocol call and can be replayed using the ``tech/capturePlayer``
Lua extension.
This option is applicable only when the process is launched by this instance
of BeamNGpy, as it sets a launch argument of the process. Defaults to False.
Expand Down Expand Up @@ -156,13 +149,15 @@ def open(
launch: Whether to launch a new process or connect to a running one on the configured host/port.
Defaults to True.
debug: If True, then sets BeamNG.tech communication to debug mode. That means:
1. BeamNG will not respond to BeamNGpy requests when a Lua error
happens and prints the stacktrace instead.
2. The `techCapture.*.log` files are created automatically in the userfolder,
they log every protocol call and can be replayed using the `tech/capturePlayer`
Lua extension.
This option is applicable only when the process is launched by this instance
of BeamNGpy, as it sets a launch argument of the process. Defaults to False.
1. BeamNG will not respond to BeamNGpy requests when a Lua error
happens and prints the stacktrace instead.
2. The ``techCapture.*.log`` files are created automatically in the userfolder,
they log every protocol call and can be replayed using the ``tech/capturePlayer``
Lua extension.
This option is applicable only when the process is launched by this instance
of BeamNGpy, as it sets a launch argument of the process. Defaults to False.
listen_ip: The IP address that the BeamNG process will be listening on. Only relevant when ``launch`` is True.
Set to ``*`` if you want BeamNG to listen on ALL network interfaces.
"""
Expand Down

0 comments on commit e813b91

Please sign in to comment.