gitsome
0.8.0
GitHub 및 GitHub Enterprise의 공식 통합입니다.
gitsome ?표준 Git 명령줄은 Git 기반 저장소를 관리하는 훌륭한 도구이지만 다음의 사용법을 기억하기 어려울 수 있습니다.
Git 명령줄은 GitHub와 통합되지 않으므로 명령줄과 브라우저 간에 전환해야 합니다.
gitsome - 자동 완성 기능을 갖춘 강력한 Git/GitHub CLI gitsome 다음에 중점을 두어 표준 git/shell 인터페이스를 강화하는 것을 목표로 합니다.
모든 GitHub 워크플로가 터미널에서 제대로 작동하는 것은 아닙니다. gitsome 그런 사람들을 표적으로 삼으려고 시도합니다.
gitsome 모든 쉘에서 작동하는 29개의 GitHub 통합 명령이 포함되어 있습니다.
$ gh <command> [param] [options]
Git-Extras 및 허브 명령과 함께 gh 명령을 실행하여 더 많은 GitHub 통합을 잠금 해제하세요!
선택적 셸을 실행할 수 있습니다.
$ gitsome
다음에 대한 자동 완성 및 대화형 도움말을 활성화합니다.
gitsome 다음을 자동 완성합니다.
추가 자동 완성을 활성화하려면 Bash 완성 활성화 섹션을 확인하세요.
gitsome Fish 스타일 자동 제안을 지원합니다. 제안을 완성하려면 right arrow 키를 사용하세요.
gitsome Python REPL을 지원하는 xonsh 에 의해 구동됩니다.
셸 명령과 함께 Python 명령을 실행합니다.
추가 xonsh 기능은 xonsh tutorial 에서 찾을 수 있습니다.
gitsome 사용자가 입력한 명령을 추적하고 ~/.xonsh_history.json 에 저장합니다. 위쪽 및 아래쪽 화살표 키를 사용하여 명령 기록을 순환합니다.
~/.gitsomeconfig 파일을 업데이트하여 강조 표시에 사용되는 ANSI 색상을 제어할 수 있습니다.
색상 옵션은 다음과 같습니다:
'black', 'red', 'green', 'yellow',
'blue', 'magenta', 'cyan', 'white'
색상이 없으면 값을 None 으로 설정합니다. 일부 터미널에서는 white 밝은 회색으로 나타날 수 있습니다.
gitsome Mac, Linux, Unix, Windows 및 Docker에서 사용할 수 있습니다.
모든 GitHub 워크플로가 터미널에서 제대로 작동하는 것은 아닙니다.
gitsome그런 사람들을 표적으로 삼으려고 시도합니다.
gitsome 이제 막 시작되었습니다. 자유롭게 기여해 주세요!
gh configuregh create-commentgh create-issuegh create-repogh emailsgh emojisgh feedgh followersgh followinggh gitignore-templategh gitignore-templatesgh issuegh issuesgh licensegh licensesgh megh notificationsgh octogh pull-requestgh pull-requestsgh rate-limitgh repogh reposgh search-issuesgh search-reposgh starredgh trendinggh usergh viewgh configure 명령 실행gitsome 외부에서 gh 탭 완성 활성화PIL 또는 Pillow 설치용법:
$ gh <command> [param] [options]
configure Configure gitsome.
create-comment Create a comment on the given issue.
create-issue Create an issue.
create-repo Create a repo.
emails List all the user's registered emails.
emojis List all GitHub supported emojis.
feed List all activity for the given user or repo.
followers List all followers and the total follower count.
following List all followed users and the total followed count.
gitignore-template Output the gitignore template for the given language.
gitignore-templates Output all supported gitignore templates.
issue Output detailed information about the given issue.
issues List all issues matching the filter.
license Output the license template for the given license.
licenses Output all supported license templates.
me List information about the logged in user.
notifications List all notifications.
octo Output an Easter egg or the given message from Octocat.
pull-request Output detailed information about the given pull request.
pull-requests List all pull requests.
rate-limit Output the rate limit. Not available for Enterprise.
repo Output detailed information about the given filter.
repos List all repos matching the given filter.
search-issues Search for all issues matching the given query.
search-repos Search for all repos matching the given query.
starred Output starred repos.
trending List trending repos for the given language.
user List information about the given user.
view View the given index in the terminal or a browser.
모든 GitHub 통합 명령, 매개변수, 옵션 및 예제에 대한 자세한 내용은 COMMANDS.md의 GitHub 통합 명령 참조를 참조하세요.
빠른 참조를 보려면 다음 섹션을 확인하세요.
gitsome 구성 GitHub와 제대로 통합하려면 먼저 gitsome 구성해야 합니다.
$ gh configure
GitHub Enterprise 사용자의 경우 -e/--enterprise 플래그를 사용하여 실행하세요.
$ gh configure -e
$ gh feed
선택적으로 -p/--pager 사용하는 호출기를 통해 활동 피드 또는 다른 사용자의 활동 피드를 봅니다. 호출기 옵션은 많은 명령에 사용할 수 있습니다.
$ gh feed donnemartin -p
$ gh feed donnemartin/gitsome -p
$ gh notifications
저장소에 대한 모든 풀 요청을 확인하세요.
$ gh pull-requests
귀하가 언급된 모든 미해결 문제를 확인하세요.
$ gh issues --issue_state open --issue_filter mentioned
상태(열림, 닫힘)에 관계없이 나에게 할당된 문제만 필터링하여 모든 문제를 봅니다.
$ gh issues --issue_state all --issue_filter assigned
필터 및 상태 한정자에 대한 자세한 내용을 보려면 COMMANDS.md의 gh issues 참조를 방문하세요.
$ gh starred "repo filter"
+1이 가장 많은 문제를 검색합니다.
$ gh search-issues "is:open is:issue sort:reactions-+1-desc" -p
댓글이 가장 많은 이슈 검색:
$ gh search-issues "is:open is:issue sort:comments-desc" -p
"도움말 구함" 태그로 문제 검색:
$ gh search-issues "is:open is:issue label:"help wanted"" -p
사용자 이름에 @donnemartin 태그가 붙은 문제 검색:
$ gh search-issues "is:issue donnemartin is:open" -p
모든 공개 비공개 이슈를 검색하세요.
$ gh search-issues "is:open is:issue is:private" -p
쿼리 한정자에 대한 자세한 내용을 보려면 검색 문제 참조를 방문하세요.
2015년 이후에 생성되었으며 별표가 1000개 이상인 모든 Python 저장소를 검색합니다.
$ gh search-repos "created:>=2015-01-01 stars:>=1000 language:python" --sort stars -p
쿼리 한정자에 대한 자세한 내용은 검색 저장소 참조를 참조하세요.
인기 저장소 보기:
$ gh trending [language] [-w/--weekly] [-m/--monthly] [-d/--devs] [-b/--browser]
인기 개발자 보기(개발자는 현재 브라우저에서만 지원됩니다):
$ gh trending [language] --devs --browser
view 명령터미널에 맞게 HTML 형식으로 또는 선택적으로 브라우저에서 이전에 나열된 알림, 풀 요청, 문제, 저장소, 사용자 등을 봅니다.
$ gh view [#] [-b/--browser]
issue 명령문제 보기:
$ gh issue donnemartin/saws/1
pull-request 명령풀 요청 보기:
$ gh pull-request donnemartin/awesome-aws/2
.gitignore 설정 사용 가능한 모든 .gitignore 템플릿을 나열합니다.
$ gh gitignore-templates
.gitignore 설정:
$ gh gitignore-template Python > .gitignore
LICENSE 설정 사용 가능한 모든 LICENSE 템플릿을 나열합니다.
$ gh licenses
또는 LICENSE 설정:
$ gh license MIT > LICENSE
Octocat을 호출하여 주어진 메시지나 부활절 달걀을 말하세요.
$ gh octo [say]
$ gh user octocat
gh user [YOUR_USER_ID] 명령이나 다음 단축키를 사용하여 프로필을 확인하세요.
$ gh me
댓글 작성:
$ gh create-comment donnemartin/gitsome/1 -t "hello world"
이슈 생성:
$ gh create-issue donnemartin/gitsome -t "title" -b "body"
저장소를 생성합니다:
$ gh create-repo gitsome
많은 gh 명령은 가능한 경우 호출기에 결과를 표시하는 -p/--pager 옵션을 지원합니다.
용법:
$ gh <command> [param] [options] -p
$ gh <command> [param] [options] --pager
많은 gh 명령은 터미널 대신 기본 브라우저에 결과를 표시하는 -b/--browser 옵션을 지원합니다.
용법:
$ gh <command> [param] [options] -b
$ gh <command> [param] [options] --browser
모든 GitHub 통합 명령, 매개변수, 옵션 및 예제의 자세한 목록은 COMMANDS.md를 참조하세요.
이러한 명령을 기억하는 데 문제가 있습니까? 각 명령을 안내하는 대화형 도움말이 포함된 편리한 자동 완성 기능을 확인해 보세요.
gitsome Git-Extras와 같은 다른 유틸리티와 결합할 수 있습니다.
gitsome PyPI에서 호스팅됩니다. 다음 명령은 gitsome 설치합니다.
$ pip3 install gitsome
아직 PyPI에 푸시되지 않은 변경 사항을 포함할 수 있는 GitHub 소스에서 최신 gitsome 설치할 수도 있습니다.
$ pip3 install git+https://github.com/donnemartin/gitsome.git
virtualenv 에 설치하지 않는 경우 sudo 로 실행해야 할 수도 있습니다.
$ sudo pip3 install gitsome
pip3 설정에 따라 -H flag 사용하여 pip3 실행할 수도 있습니다.
$ sudo -H pip3 install gitsome
대부분의 Linux 사용자의 경우 python3-pip 패키지를 사용하여 시스템에 pip3 설치할 수 있습니다.
예를 들어 Ubuntu 사용자는 다음을 실행할 수 있습니다.
$ sudo apt-get install python3-pip
자세한 내용은 이 티켓을 참조하세요.
종속성 또는 권한과 관련된 잠재적인 문제를 방지하기 위해 virtualenv 에 Python 패키지를 설치할 수 있습니다.
Windows 사용자이거나 virtualenv 에 대한 자세한 내용을 알고 싶다면 이 가이드를 확인하세요.
virtualenv 및 virtualenvwrapper 설치합니다.
$ pip3 install virtualenv
$ pip3 install virtualenvwrapper
$ export WORKON_HOME=~/.virtualenvs
$ source /usr/local/bin/virtualenvwrapper.sh
gitsome virtualenv 생성하고 gitsome 설치합니다.
$ mkvirtualenv gitsome
$ pip3 install gitsome
pip 설치가 작동하지 않으면 기본적으로 Python 2를 실행 중일 수 있습니다. 실행 중인 Python 버전을 확인하세요.
$ python --version
위 호출의 결과가 Python 2인 경우 Python 3의 경로를 찾으세요.
$ which python3 # Python 3 path for mkvirtualenv's --python option
필요한 경우 Python 3을 설치합니다. mkvirtualenv 호출할 때 Python 버전을 설정하십시오.
$ mkvirtualenv --python [Python 3 path from above] gitsome
$ pip3 install gitsome
나중에 gitsome virtualenv 다시 활성화하려면 다음을 실행하세요.
$ workon gitsome
gitsome virtualenv 비활성화하려면 다음을 실행하세요.
$ deactivate
Python 및 pip3 로컬로 설치하지 않으려면 Docker 컨테이너에서 gitsome을 실행할 수 있습니다. Docker를 설치하려면 공식 Docker 설명서를 확인하세요.
docker가 설치되면 gitsome을 실행할 수 있습니다.
$ docker run -ti --rm mariolet/gitsome
Docker 볼륨을 사용하여 gitsome이 작업 디렉터리인 로컬 .gitsomeconfig 및 .gitconfig에 액세스하도록 할 수 있습니다.
$ docker run -ti --rm -v $(pwd):/src/
-v ${HOME}/.gitsomeconfig:/root/.gitsomeconfig
-v ${HOME}/.gitconfig:/root/.gitconfig
mariolet/gitsome
이 명령을 자주 실행하는 경우 별칭을 정의하고 싶을 것입니다.
$ alias gitsome="docker run -ti --rm -v $(pwd):/src/
-v ${HOME}/.gitsomeconfig:/root/.gitsomeconfig
-v ${HOME}/.gitconfig:/root/.gitconfig
mariolet/gitsome"
소스에서 Docker 이미지를 빌드하려면 다음 안내를 따르세요.
$ git clone https://github.com/donnemartin/gitsome.git
$ cd gitsome
$ docker build -t gitsome .
gitsome 쉘 시작하기 설치가 완료되면 대화형 도움말을 사용하여 선택적 gitsome 자동 완성기를 실행하세요.
$ gitsome
선택적 gitsome 쉘을 실행하면 자동 완성, 대화형 도움말, 피쉬 스타일 제안, Python REPL 등이 제공됩니다.
gh 명령 실행GitHub 통합 명령을 실행합니다.
$ gh <command> [param] [options]
참고: gh 명령을 실행하기 위해 gitsome 쉘을 실행할 필요는 없습니다. gitsome 설치한 후 모든 쉘에서 gh 명령을 실행할 수 있습니다.
gh configure 명령 실행 GitHub와 올바르게 통합하려면 gitsome 올바르게 구성해야 합니다.
$ gh configure
-e/--enterprise 플래그를 사용하여 실행합니다.
$ gh configure -e
gh 구성 섹션에서 자세한 내용을 확인하세요.
기본적으로 gitsome bash 완료를 활성화하기 위해 다음 위치를 확인합니다.
Bash 완성을 더 추가하려면 ~/.xonshrc 파일을 bash 완성 위치로 업데이트하세요.
~/.xonshrc 없으면 작성하십시오.
$ touch ~/.xonshrc
예를 들어 /usr/local/etc/my_bash_completion.d/completion.bash 에서 추가 완성이 발견되면 ~/.xonshrc 에 다음 줄을 추가합니다.
$BASH_COMPLETIONS.append('/usr/local/etc/my_bash_completion.d/completion.bash')
변경 사항을 적용하려면 gitsome 다시 시작해야 합니다.
gitsome 외부에서 gh 탭 완성 활성화 gitsome Shell Completer 외부에서 gh 명령을 실행할 수 있습니다. 이 워크플로우에 대해 gh 탭 완성을 활성화하려면 gh_complete.sh 파일을 로컬로 복사하십시오.
현재 세션 내에서 gh 명령을 완료할 수 있음을 bash에 알립니다.
$ source /path/to/gh_complete.sh
모든 터미널 세션에 대해 탭 완성을 활성화하려면 bashrc 파일에 다음을 추가하십시오.
source /path/to/gh_complete.sh
bashrc 다시 로드하세요.
$ source ~/.bashrc
팁: . 는 source 의 짧은 형식이므로 대신 실행할 수 있습니다.
$ . ~/.bashrc
zsh 에는 bash 완성과 호환되는 모듈이 포함되어 있습니다.
위와 같이 gh_complete.sh 파일을 다운로드하고 .zshrc 에 다음을 추가합니다.
autoload bashcompinit
bashcompinit
source /path/to/gh_complete.sh
zshrc 다시 로드하세요.
$ source ~/.zshrc
PIL 또는 Pillow 설치 gh me 및 gh user 명령에 대한 아바타를 표시하려면 선택적 PIL 또는 Pillow 종속성을 설치해야 합니다.
Windows* 및 Mac:
$ pip3 install Pillow
*아바타에 대한 제한 사항은 Windows 지원 섹션을 참조하세요.
Ubuntu 사용자는 askubuntu에서 다음 지침을 확인하세요.
gitsome 이 티켓에서 설명한 대로 현재 Python 2.x를 지원하지 않는 xonsh 에 의해 구동됩니다.
gitsome cmd 및 cmder 사용하여 Windows 10에서 테스트되었습니다.
표준 Windows 명령 프롬프트를 사용할 수 있지만 cmder 또는 conemu를 사용하는 것이 더 나은 환경을 제공할 것입니다.
img2txt Windows에서 ansi 아바타를 지원하지 않기 때문에 gh user 및 gh me 명령에는 항상 -t/--text_avatar 플래그가 활성화됩니다.
Windows에서는 .gitsomeconfig 파일을 %userprofile% 에서 찾을 수 있습니다. 예를 들어:
C:Usersdmartin.gitsomeconfig
gitsome 에 기여하고 싶다면 다음 명령을 실행하세요:
$ git clone https://github.com/donnemartin/gitsome.git
$ cd gitsome
$ pip3 install -e .
$ pip3 install -r requirements-dev.txt
$ gitsome
$ gh <command> [param] [options]
pip3 설치하는 동안 Python 3.4+가 필요하다는 오류가 발생하는 경우 pip 명령이 이전 버전의 Python용으로 구성되었기 때문일 수 있습니다. 이 문제를 해결하려면 pip3 설치하는 것이 좋습니다.
$ sudo apt-get install python3-pip
자세한 내용은 이 티켓을 참조하세요.
지속적인 통합 세부정보는 Travis CI에서 확인할 수 있습니다.
활성 Python 환경에서 단위 테스트를 실행합니다.
$ python tests/run_tests.py
여러 Python 환경에서 tox를 사용하여 단위 테스트를 실행합니다.
$ tox
소스 코드 문서는 곧 Readthedocs.org에서 제공될 예정입니다. 소스 독스트링을 확인하세요.
문서를 작성하려면 다음을 실행하세요.
$ scripts/update_docs.sh
기여를 환영합니다!
다음 방법에 대한 자세한 내용은 기여 지침을 검토하세요.
문제, 질문 또는 의견에 대해 논의하려면 언제든지 저에게 연락하십시오.
내 연락처 정보는 내 GitHub 페이지에서 확인할 수 있습니다.
저는 오픈 소스 라이선스에 따라 이 저장소의 코드와 리소스를 귀하에게 제공하고 있습니다. 이것은 내 개인 저장소이기 때문에 귀하가 내 코드와 리소스에 대해 받는 라이선스는 내 고용주(Facebook)가 아닌 나에게서 오는 것입니다.
Copyright 2016 Donne Martin
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
