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:

1. A directory adjacent to arcanist/ itself.
2. Anywhere in the normal PHP include_path.
3. 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 and composer update --lock.