python unable to unpack returned values from Octave function

Question

I have a function called doFFT.m in Octave, defined as:

function [Rx1,Rx2,fbins]=doFFT(file)

this function runs as expected returning 3 row vectors.

In Python, I have oct2py imported,

from oct2py import octave

and I call this Octave function via:

RX1,RX2,fbins=octave.doFFT(file)

I get an error that says "ValueError: not enough values to unpack (expected 3, got 1)"

As a test I redefined the function in Octave to only return 1 value, and instead called it in Python as :

RX1=octave.doFFT(file)

and this worked fine.

So, the issue seems to be with having Python understand the return format from Octave. I've tried calling the function as

[RX1, RX2, fbins]=octave.doFFT(file)
(RX1, RX2, fbins)=octave.doFFT(file)

for example, but still get either the same error.

How do I format the function call or the output from Octave, so that Python "understands" that there are 3 items being returned?

Answer 1

the oct2py python bridge requires that the expected number of returned values to be explicitly expressed in the function call, for eg.

RX1,RX2,fbins=octave.doFFT(samples, nout=3)

specifies that the function returns 3 values (or numpy arrays in this case).
When a function doesn't return anything, it must be called indicating that it returns 0 arguments, ie:

octave.foobar(in_arg, nout=0).

Thank you to @Tasos Papastlyianou for linking the oct2py's documentation in his comment.