This is the home page for the (UNNAMED, but possibly "Sort-Search"?)
distribution. I will try to get it completed and published shortly
after my school term ends some time in uhhhh March!
(I'll probably also have r/perl and/or module-authors review my choice of
name….)
It will be hosted by the generous GitHub... here is the URL:
If you prefer, you can also clone/view Codeberg or repo.or.cz.
You can clone from my server too btw!
git clone https://git.rapidcow.org/pub/lib/perl5/Sort-Search.git p5-Sort-Search
# OR over ssh:
git clone guest@git.rapidcow.org:pub/lib/perl5/Sort-Search.git p5-Sort-SearchSort::Search should run on most Perls (I put Perl 5.6 because that's the default minimum version of module-starter, but I haven't really tested that far… I have checked that that I only use core modules according to corepack, either way. :x)
If Want is installed, it would be called to determine the exact number of values requested in list context. The behavior shouldn't change, but it may avoid having to copy array elements for the third argument (though this may be redundant if your Perl is built with COW, I haven't benchmarked anything either so…)
To submit any bugs you found (this early though???), rt.cpan.org won't work as I haven't uploaded the package to CPAN. So use the GitHub bug tracker: https://github.com/rapidcow/p5-Sort-Search/issues.
If you can and are willing to write up a fix, the GitHub way to do it is to submit a Pull Request: https://github.com/rapidcow/p5-Sort-Search/pulls
You can also send patches since I know how to apply them, but the issue is I don't have a real mailing list, so other people will not be able to join the discussion. If your mail provider doesn't let you change the author name and email as they appear on the "From" header, please also let me know what alternatives you would prefer.
You can also use git-request-pull if you made your changes in a Git repository that is not on GitHub; be noted that git-pull will include the URL of your repository, so if that's not something you want other people to see, you should tell me about it too.
From the current revision of SECURITY.md:
This is the Security Policy for the CPAN distribution
Sort-Search, based on the CPAN Security Group's Guidelines for Adding a Security Policy to Perl Distributions (version 1.4.2).Report to:
- GitHub security advisories: https://github.com/rapidcow/p5-Sort-Search/security/advisories; or
- To me (the author) directly: security@rapidcow.org
I have written some over here
but it's too long and unstructured for people to actually make use of it.
I'll write up a new one near the end of this month (and year) (okay
please just wait until I get back to school i really don't wanna do it now
TvT) but until then that would be the best I got.
There will also be a separate Cookbook/Tutorial POD for a more example-driven approach to these functions. The documentation itself will be more focused on usage. I may take inspiration from features that the existing binary search libraries lack, such as this issue.
There is also a more narrative approach that is basically the design note, though it is more or less for myself and will not be included in the distribution. There is an initial section, and there will be subsequent sections that cover the less theoretical and more practical cases you may encounter.