Please document "sources" subroutine interface

polettix / App-Easer

Simplify writing (hierarchical) CLI applications in Perl

https://github.polettix.it/App-Easer

Other

9 stars 0 forks source link

Closed djerius closed 1 month ago

djerius commented 1 year ago

Hi,

The API for a custom locator subroutine isn't defined. Given a locator of

[ \&locator, @opts ]

it seems to be

sub locator( $app, \@opts, \@args );

where @args is an undocumented argument to collect, which receives it from run, which receives it as the list of arguments to parse.

None of the provided source_* routines make use of @args; is its presence in their signature a deprecated pattern?

djerius commented 1 year ago

None of the provided source_* routines make use of @args; is its presence in their signature a deprecated pattern?

I missed that source_CmdLine does use it.

polettix commented 2 months ago

Yep... that needs some documentation, I'd like to coalesce this with #13 if possible...

polettix commented 2 months ago

Should be fixed by 8e22238fefe7f8c90ec7d604d508b58b0092191f

polettix commented 1 month ago