https://github.com/uber/sublime-phabricator
Open files in Phabricator via Sublime Text
https://github.com/uber/sublime-phabricator
Last synced: 5 months ago
JSON representation
Open files in Phabricator via Sublime Text
- Host: GitHub
- URL: https://github.com/uber/sublime-phabricator
- Owner: uber
- License: mit
- Created: 2014-02-08T03:25:05.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2020-05-05T17:10:54.000Z (over 5 years ago)
- Last Synced: 2024-05-09T07:59:00.127Z (over 1 year ago)
- Language: Python
- Size: 350 KB
- Stars: 33
- Watchers: 2,765
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
# sublime-phabricator
Open files in [Phabricator][] via [Sublime Text][]
This was built to remove the inconvenience of switching to CLI and losing the context of line numbers. It is strongly inspired by [GitHubinator][].
[Phabricator]: http://phabricator.org/
[Sublime Text]: http://sublimetext.com/
[GitHubinator]: https://github.com/ehamiter/ST2-GitHubinator
## Getting Started
### Installation
This package is available under `phabricator` inside of [Package Control][], a [Sublime Text][] plugin that allows for easy management of other plugins.
[Sublime Text]: http://www.sublimetext.com/
[Package Control]: http://wbond.net/sublime_packages/package_control
If you prefer the manual route, you can install the script via the following command in the Sublime Text terminal (``ctrl+` ``) which utilizes `git clone`.
```python
import os; path=sublime.packages_path(); (os.makedirs(path) if not os.path.exists(path) else None); window.run_command('exec', {'cmd': ['git', 'clone', 'https://github.com/twolfson/sublime-phabricator', 'phabricator'], 'working_dir': path})
```
Packages can be uninstalled via "Package Control: Remove Package" via the command pallete, `ctrl+shift+p` on Windows/Linux, `command+shift+p` on Mac.
### Configuration
Set your preferences by going to `Preferences -> Package Settings -> Phabricator -> Settings - User`. Be sure to set `arc_path` to the absolute path to `arc` in your system.
Set `branch` to the branch in the repo you want to view files on.
If you would like the plugin to just use the `arc.land.onto.default` value from the arc config for the current project,
you can leave the branch key unset and instead set `branch_use_arc_land_onto_default` to `True`.
If neither the `branch` or the `branch_use_arc_land_onto_default` keys are set, the branch you are currently on is used.
For example, your configuration on Mac OS X may be:
```json
{
"arc_path": "/usr/local/bin/arc",
"branch": "master"
}
```
## Documentation
We provide a single command via the command pallete.
### Phabricator: Open
Open the current file inside of Phabricator. The first selected area will be highlighted in the open window.
This command can be accessed as `phabricator_open` via `run_command`.
## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.
## License
Copyright (c) 2014 Uber
Licensed under the MIT license.