flarc
is a libphutil library that contains various Arcanist extensions used at Freelancer.com, mostly relating to linting and testing integrations.
To use flarc
, you must clone the repository into a location that Arcanist knows how to load it. Arcanist adjusts the PHP include path in arcanist_adjust_php_include_path
so that libphutil libraries can be loaded from any of the following locations:
- A directory adjacent to
arcanist/
itself. - Anywhere in the normal PHP
include_path
. - Inside
arcanist/externals/includes/
.
To use flarc
in your project, add flarc/src
to the load
path in the project's .arcconfig
:
{
"load": ["flarc/src"]
}
To pin the version of flarc
used in fl-gaf
, update the FLARC_VERSION
in rGaf/support/flarc/src/common/FlarcVersionChecker.php
.
flarc
is built and used as a docker image in CI.
It was built daily in this CI job.
It's probably a good idea to trigger this job manually once you've made changes to flarc
.
For more information on adding or updating linters, see lint/README.md.
To create a new version of flarc
:
- Update
composer.json
to the new version. - Run
arc liberate
andcomposer update --lock
.