pinterest/arcanist-owners

Name: arcanist-owners

Owner: Pinterest

Description: An Arcanist extension for displaying file ownership information

Created: 2016-02-29 19:30:08.0

Updated: 2017-06-27 14:37:41.0

Pushed: 2017-04-07 16:02:44.0

Homepage: null

Size: 10

Language: PHP

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Arcanist Owners

Build Status

This is an Arcanist extension that displays file ownership information. It is implemented as an arc owners command:

owners [path ...]
    Supports: git, hg
    Display ownership information for a list of files.

    Without paths, the files changed in your local working copy will
    be used.
c owners README.md
nist Extensions (jparise)
ADME.md

This is similar to the built-in arc cover command, but instead of inferring likely owners based on “blame” statistics, arc owners uses the ownership definitions specified in Phabricator's Owners application.

It's possible that arc cover could evolve to the point where arc owners becomes redundant. T2443 tracks progress in that direction.

Installation

In short, you'll need to add this repository to your local machine and tell Arcanist to load the extension. You either can do this globally or on a per-project basis.

Global Installation

Arcanist can load modules from an absolute path, but because it also searches for modules one level up from itself on the filesystem, it's convenient to clone this repository at the same level as arcanist and libphutil.

t clone https://github.com/pinterest/arcanist-owners.git

nist
nist-owners
hutil

Then, tell Arcanist to load the module by editing ~/.arcconfig (or /etc/arcconfig):


oad": ["arcanist-owners"]

Project Installation

You can also load arcanist-owners on a per-project basis. In that case, using a git submodule is probably the most convenient approach.

t submodule add https://github.com/pinterest/arcanist-owners.git .arcanist-owners
t submodule update --init

Then, enable the module in your project-level .arcconfig file:


oad": [".arcanist-owners"]


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.