Help with some of the functions / example code?

[evanmang]

First off THANK YOU. I've been able to do SO MUCH with this tool already that would have never been possible with Applescript and the methods I was previously using.

My python is mediocre at best, and I'm having trouble with some of the functions that take multiple parameters.

For example, i'm able to run create_memory_location and it creates a memory location at the current timeline with the default settings, but I can't figure out the syntax of how I would pass the other parameters (name, start_time) to the function. I recognize that this is likely due to my ignorance as to how these data structures work in python in general, but a simple example of how that would look would help me (and hopefully others) a ton!

[iluvcapra]

Hi Evan-

Thanks for checking out the library!

A lot of python code has inline documentation, and a lot of more modern python code has type annotations for things like function parameters. If you look at the create_memory_location definition:

https://github.com/iluvcapra/py-ptsl/blob/master/ptsl/engine.py#L359

start_time and end_time are Optional[str], which means you have to pass these as strings (you just pass a time in the current ruler format, like "1:00:00:00").

[evanmang]

Thanks for the reply! I saw the documentation in the engine.py file, but it seems like i'm just misunderstanding the correct syntax to pass those parameters.

for example:

engine.create_memory_location(start_time="01:00:00:00", memory_number=100, name="test")
Does give me a new memory location with memory location number 100, but with a default name, and at the current timecode position.