Metadata-Version: 2.4
Name: lauterbach-trace32-pystart
Version: 0.6.0
Summary: start Lauterbach TRACE32
Home-page: https://www.lauterbach.com
Author: Lauterbach GmbH
Author-email: support@lauterbach.com
Maintainer: Lauterbach GmbH
Maintainer-email: support@lauterbach.com
License: MIT
Project-URL: Documentation, https://lauterbach-trace32-pystart.readthedocs.io
Project-URL: Repository, https://gitlab.com/lauterbach/pystart
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Debuggers
Classifier: Intended Audience :: Developers
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# lauterbach-trace32-pystart
Since 2020, Python programs can control TRACE32 via the lauterbach-trace32-rcl module (pyrcl). Up to now, TRACE32 must be started using a config file, which requires familiarization with the TRACE32 configuration file syntax or the use of the configuration tool t32start.exe. Now Lauterbach offers a new
lauterbach-trace32-pystart module (pystart) which allows the configuration and start of TRACE32 directly from Python.

For feedback and questions, please contact support@lauterbach.com (include "pystart" in the subject).

## Example
```python
import lauterbach.trace32.pystart as pystart

pystart.defaults.system_path = r"C:\T32"

powerview = pystart.PowerView(pystart.USBConnection(), "t32marm")
powerview.title = f"TRACE32 PowerView for ARM 0"
powerview.id = "T32_arm0"

powerview.start()
powerview.wait()
```

## Release Notes
### v0.6.0
* add parameter setting for `connection_script`.
* Make `Connection` optional for `connection_script` not being ignored.
* add generic argument setting for starting TRACE32.

### v0.5.0
* add `connection_script` setting
* fix InteractiveConnection
* start windows 32bit executable only if `force_32bit_executable==True`, don't search for it, if 64bit executable is not available

### v0.4.0
* fix broken compatibility to python <3.9
* allow `PowerView` to be used as ContextManager

### v0.3.0
* add settings `REMOTEHOSTALLOW` and `REMOTEHOSTDENY` for some T32Interfaces

### v0.2.1
* use builtin `TimeoutError` instead of `TimeoutExpiredError`
* use builtin `RuntimeError` instead of `AlreadyRunningError`
* add `ViewerConnection`
* add `InteractiveConnection`
* put temporary config file also in T32TMP path
* throw on premature termination of PowerView process
* add `device_path` option to `USBConnection` and `USBProxyConnection`

### v0.2.0
* use binaries from `PATH` if no system_path is specified
* gently stop Trace32 on Windows OS
* added timeout for `PowerView.stop()`
* wait necessary time in `PowerView.start()` instead of waiting for a predefined amount of time
* added exeptions `TimeoutExpiredError` and `AlreadyRunningError`
* limit startup script parameter to be of type `Iterable[str]`
* send `stdout` and `stderr` output of PowerView instance to a logger

### v0.1.7
* fix datatype of `library_file` parameters in some Connection classes to allow `pathlib.Path`'s.
* add `TCPConnection` for Lauterbach X-Series debugger.
* rename `EthernetConnection` to `UDPConnection`

### v0.1.6
* initial release
