@Hkyle
That is a nice idea. It is related to #151
It not trivial to implement, if we want to get it done right.
Definitely worth doing.

I am having a second thought now.
To achieve this, you can simply call the setup inside a test, if the setup is test-specific.
so instead of:

create or replace package my_test is
  --%suite

  procedure build_user(a_param varchar2);

  --%test
  --%beforetest( build_user(123) )
  procedure do_the_test;
end;
/

create or replace package body my_test is
  procedure build_user(a_param varchar2) is
  begin
    --do some stuff here
    null;
  end;

  procedure do_the_test is
  begin
    --Assert
    ut.expect(get_user()).to_equal('123');
  end;
end;
/

You could have:

create or replace package my_test is
  --%suite

  --%test
  procedure do_the_test;
end;
/

create or replace package body my_test is
  procedure build_user(a_param varchar2) is
  begin
    --do some stuff here
    null;
  end;

  procedure do_the_test is
  begin
    --Arrange
    build_user(123);
    --Assert
    ut.expect(get_user()).to_equal('123');
  end;

end;
/

@Hkyle
The main benefit of having beforetest/aftertest invoked from the framework than from within test procedure is that it will be executed outside of the test and that it will get executed even if the test throws an exception.
Though adding parameters procedures in annotations is something I have in mind it requires significant amount of work. We will probably get there at some point, just not now.

Since at least in version 3.1.13 it is possible to pass parameters to procedures called in before... and after.. annotations, the problem described by @kyleholgate is solved, isn't it?

But I have a follow-up question:
Currently it is only possible to pass a single parameter because the , is interpreted as a splitter between methods, not between parameters.

--%beforetest(do_something('value1', 'value2')) will result in Call params for beforetest are not valid: USER.SUITE.DO_SOMETHING('VALUE1

Also note the capitalization of the passed value. This could sometimes lead to confusion 😅

Is there any way to pass more than one value?