txt: ## dist_github-azawawi-File-Which.md
  # File::Which
  
  [![Actions
  Status](https://github.com/azawawi/raku-file-which/workflows/test/badge.svg)](https://github.com/azawawi/raku-file-which/actions)
  
  This is a Raku Object-oriented port of [File::Which (CPAN)](https://metacpan.org/pod/File::Which).
  
  File::Which finds the full or relative paths to an executable program on the
  system. This is normally the function of which utility which is typically
  implemented as either a program or a built in shell command. On some unfortunate
  platforms, such as Microsoft Windows it is not provided as part of the core
  operating system.
  
  This module provides a consistent API to this functionality regardless of the
  underlying platform.
  
  ```
  use File::Which :whence;
  
  # All raku executables in PATH
  say which('raku', :all);
  
  # First executable in PATH
  say which('raku');
  
  # Same as which('raku')
  say whence('raku');
  
  ```
  
  ## Installation
  
  To install it using zef (a module management tool bundled with Rakudo Star):
  
  ```
  $ zef install File::Which
  
  ```
  
  ## Testing
  
  * To run tests:
  
  ```
  $ prove --ext .rakutest -ve "raku -I."
  
  ```
  
  * To run all tests including author tests (Please make sure
    [Test::Meta](https://github.com/jonathanstowe/Test-META) is installed):
  
  ```
  $ zef install Test::META
  $ AUTHOR_TESTING=1 prove --ext .rakutest -ve "raku -I."
  
  ```
  
  ## Author
  
  Raku port:
  
  * Ahmad M. Zawawi, azawawi on #raku, <https://github.com/azawawi/>
  * Nick Logan, ugexe on #raku, <https://github.com/ugexe>
  * Steve Dondley, sdondley on #raku, <https://github.com/sdondley>
  
  A bit of tests:
  
  * Altai-man, sena\_kun on libera, <https://github.com/Altai-man/>
  
  Perl 5 version:
  
  * Author: Per Einar Ellefsen [pereinar@cpan.org](mailto:pereinar@cpan.org)
  * Maintainers:
    * Adam Kennedy [adamk@cpan.org](mailto:adamk@cpan.org)
    * Graham Ollis [plicease@cpan.org](mailto:plicease@cpan.org)
  
  ## License
  
  MIT License
  