https://github.com/tiagopog/gropen
gropen - git remote open
https://github.com/tiagopog/gropen
bitbucket cli developer-tools git github gitlab python
Last synced: 11 months ago
JSON representation
gropen - git remote open
- Host: GitHub
- URL: https://github.com/tiagopog/gropen
- Owner: tiagopog
- License: mit
- Created: 2021-02-28T17:16:51.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-09-08T11:50:16.000Z (almost 5 years ago)
- Last Synced: 2025-05-22T02:08:56.365Z (about 1 year ago)
- Topics: bitbucket, cli, developer-tools, git, github, gitlab, python
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gropen
[](https://codeclimate.com/github/tiagopog/gropen/maintainability)
`gropen` (Git Remote Open) is a simple command line application for opening
local files and directories in remote git repositories.
## Supported repos
- [x] Bitbucket
- [x] GitHub
- [ ] GitLab
## Supported editors
- [ ] Sublime
- [x] Vim ([gropen.vim](https://github.com/tiagopog/gropen.vim))
- [x] VS Code ([gropen.vscode](https://github.com/tiagopog/gropen-vscode))
## Supported systems
- [x] Linux
- [x] macOS
- [x] Windows
# Installation
```
pip install gropen
```
**NOTE:** `gropen` requires Python 3.6 or greater installed on your local environment.
# Usage
Here are some example of what `gropen` can open on your project's remote repo.
Open current directory:
```
gropen .
```
Open another directory:
```
gropen gropen/
```
Open a file:
```
gropen gropen/gropen.py
```
Open a file pointing out the lines of code to be highlighted:
```
gropen gropen/gropen.py:42
gropen gropen/gropen.py:16,32
```
Open file from an outter directory:
```
cd ~/Dev
gropen python/gropen/gropen/gropen.py:20,30
```
Open file from an inner directory:
```
cd ~/Dev/python/gropen/gropen
gropen gropen.py:20,30
```
# TODO
- [x] Add support for GitHub repositories;
- [x] Add support for Bitbucket repositories;
- [x] Add support for GitLab repositories;
- [x] Open current directory;
- [x] Open arbitrary directory and files;
- [x] Open in a line or range of lines in the file;
- [ ] Open files in a specific commit;
- [x] Handle relative and absolute paths;
- [x] Support flag for only displaying the URL instead of opening it in the browser;
- [x] Create Vim plugin;
- [x] Create VS Code plugin;
- [ ] Create Sublime plugin.
# Contributing
Bug reports and pull requests are welcome on GitHub at [https://github.com/tiagopog/gropen/](https://github.com/tiagopog/gropen/).
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the
[Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.
# License
This package is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).