git-hub — Online w chmurze

PROGRAM:

IMIĘ

git-hub — interfejs wiersza poleceń Git do GitHuba

SYNOPSY

git hub [opcje globalne] [opcje] [argumenty]

OPIS

odrzutowiec piasta to prosty interfejs wiersza poleceń do githuba, umożliwiający najbardziej przydatne zadania GitHuba
(takie jak tworzenie i wyświetlanie żądań ściągnięcia lub problemów), do których można uzyskać dostęp bezpośrednio poprzez git
wiersz poleceń.

Aby użyć tego polecenia, prawdopodobnie będziesz musiał dokonać wstępnej konfiguracji
autoryzacja z GitHuba. Aby to zrobić, możesz użyć ustawienie Komenda. Zobacz
KONFIGURACJA sekcję zawierającą więcej opcji konfiguracyjnych.

GLOBAL OPCJE

-H, --help
Pokaż tę pomoc i wyjdź.

--wersja
Pokaż numer wersji programu i wyjdź.

-v, --gadatliwy
Bądź bardziej gadatliwy (można określić wiele razy, aby uzyskać większą gadatliwość)

-tak, --cichy
Bądź mniej gadatliwy (można określić wiele razy, aby uzyskać mniej gadatliwości)

POLECENIA

ustawienie To polecenie wykonuje wstępną konfigurację połączenia z GitHub. W zasadzie pyta
GitHub w celu uzyskania tokenu autoryzacyjnego i przechowuje go w zmiennej konfiguracyjnej
hub.oauthtoken do wykorzystania w przyszłości, dzięki czemu nie będziesz musiał za każdym razem wpisywać hasła (lub
zapisz go w konfiguracji). Nazwa użytkownika jest również przechowywana do wykorzystania w przyszłości w pliku
hub.nazwa użytkownika zmienny. Jeśli określono podstawowy adres URL, jest on przechowywany w hub.baseurl
też.

-u NAZWA UŻYTKOWNIKA, --nazwa_użytkownika=NAZWA UŻYTKOWNIKA
Nazwa użytkownika GitHuba (nazwa logowania) będzie przechowywana w zmiennej konfiguracyjnej
hub.nazwa użytkownika. Jeśli podany jest adres e-mail, nazwa użytkownika pasująca do tego adresu e-mail
będzie przeszukiwany i używany, jeśli zostanie znaleziony (aby to zadziałało, e-mail
musi być częścią profilu publicznego).

-p HASŁO, --hasło=HASŁO
Hasło do GitHuba (nie będzie przechowywane).

-b adres URL, --baseurl=URL
Podstawowy adres URL GitHuba używany do uzyskiwania dostępu do interfejsu API. Ustaw tę opcję, jeśli korzystasz z interfejsu API GitHub
w innej lokalizacji niż domyślna (zwykle serwery korporacyjne używają
https://host/api/v3).

--światowy
Przechowuj ustawienia w konfiguracji globalnej (zobacz opcję --global w odrzutowiec
config(1) dla szczegółów).

--system
Przechowuj ustawienia w konfiguracji systemu (patrz opcja --system w odrzutowiec
config(1) dla szczegółów).

klonować REPO [DEST]
To polecenie służy do klonowania REPO, repozytorium GitHub, do pliku DEST katalog
(domyślnie jest to nazwa klonowanego projektu). Jeśli określono repozytorium
in / forma, REPO będzie używany jako upstream i osobisty fork
zostanie sprawdzone. Jeśli żaden nie zostanie znaleziony, zostanie utworzony nowy fork. W obu przypadkach
fork zostanie sklonowany zamiast repozytorium nadrzędnego.

Gdyby tylko jest określony jako REPO, następnie konfiguracja hub.nazwa użytkownika służy
as , a repozytorium nadrzędne jest sprawdzane w GitHub w celu ustalenia rzeczywistego
repozytorium nadrzędne.

Repozytorium nadrzędne jest również dodawane jako zdalne pod nazwą pod prąd (chyba że
--trójkątny jest używany i w takim przypadku zostanie wywołany pilot widelec domyślnie) i
hub.upstream zmienna konfiguracyjna jest ustawiona (patrz KONFIGURACJA), chyba że tylko
zostało użyte i powstałe repozytorium nie jest tak naprawdę forkiem, w takim przypadku
nie jest możliwe automatyczne określenie repozytorium nadrzędnego.

-r NAZWA, --remote=NAZWA
Zastosowanie IMIĘ jako nazwę zdalnego repozytorium nadrzędnego zamiast domyślnej
(„widelec”, jeśli --trójkątny jest używany, w przeciwnym razie „upstream”).

-T, --trójkątny
Użyj Gita trójkątny workflow konfiguracja. Ta opcja klonuje z
repozytorium nadrzędne/upstream zamiast klonować rozwidlenie i dodaje rozwidlenie jako
zdalne repozytorium. Następnie ustawia zdalny.pushdefault Opcja Gita i
hub.forkremote git-hub do forka.

Efektem tego jest domyślne użycie repozytorium nadrzędnego, gdy ty
ciągnij, ale do pchania używaj widelca, co zazwyczaj jest tym, czego chcesz
podczas korzystania z żądań ściągnięcia GitHub.

Aby skorzystać z tej opcji, wymagana jest wersja Git 1.8.3 lub nowsza (oraz wersja 1.8.4 lub nowsza
jest zalecane ze względu na pewne problemy w wersji 1.8.3 z tym związane).

Ta opcja może w przyszłości stać się opcją domyślną. Aby było to ustawienie domyślne
możesz ustawić tę opcję piasta.trójkątna. Zobaczyć KONFIGURACJA .

GIT CLONE OPCJE
Dowolny standard odrzutowiec klonować opcję można przekazać. Nie wszyscy mogą to zrobić
ma to jednak sens podczas klonowania repozytorium GitHub do użycia z tym narzędziem.

problem To polecenie służy do zarządzania problemami z GitHubem za pomocą zestawu poleceń podrzędnych. Nie jest
podpolecenie jest określone, podstęp Jest używane.

podstęp Pokaż listę otwartych problemów.

-C, --Zamknięte
Zamiast tego pokaż zamknięte problemy.

-DO, --stworzone przeze mnie
Pokaż tylko problemy utworzone przeze mnie

-DO, --Przydzielony do mnie
Pokaż tylko sprawy przypisane do mnie

pokazać KWESTIA [WYDANIE ...]
Pokaż problemy zidentyfikowane przez KWESTIA.

nowa Utwórz nowy problem.

-m MSG, --wiadomość=wiadomość
Tytuł wydania (i opis). Pierwsza linia jest używana jako problem
tytuł i dowolny tekst po pustej linii jest używany jako opcjonalna treść.
Jeśli ta opcja nie jest używana, zostanie wybrana opcja domyślna GIT_EDYTOR jest otwarty do pisania
jeden.

-l ETYKIETA, --etykieta=ETYKIETA
Dołączać LABEL do problemu (można określić wielokrotnie, aby ustawić
wiele etykiet).

-a UŻYTKOWNIK, --przypisz=UŻYTKOWNIK
Przypisz użytkownika do problemu. USER musi być prawidłową nazwą logowania GitHub.

-M ID, --milestone=identyfikator
Przypisz kamień milowy identyfikowany przez numer identyfikacyjny do problemu.

aktualizacja KWESTIA
Podobny do nowa ale zaktualizuj istniejący problem zidentyfikowany przez KWESTIA.

Wygodny skrót do zamknięcia sprawy zapewnia opcja zamknięte podkomenda.

-m MSG, --wiadomość=wiadomość
Nowy tytuł numeru (i opis). Pierwsza linia jest używana jako
tytuł wydania i dowolny tekst po pustej linii jest używany jako opcjonalny
ciała.

-mi, --edytuj wiadomość
Otwórz domyślne GIT_EDYTOR aby edytować bieżący tytuł (i
opis problemu.

-o, --otwarty
Otwórz ponownie problem.

-C, --zamknąć
Zamknij sprawę.

-l ETYKIETA, --etykieta=ETYKIETA
Jeśli określono jedną lub więcej etykiet, zastąpią one bieżącą
wydawać etykiety. W przeciwnym razie etykiety pozostają niezmienione. Jeśli jeden z
etykiety są puste, etykiety zostaną wyczyszczone (abyś mógł użyć -l'' do
usuń etykiety problemu.

-a UŻYTKOWNIK, --przypisz=UŻYTKOWNIK
Przypisz użytkownika do problemu. USER musi być prawidłową nazwą logowania GitHub.

-M ID, --milestone=identyfikator
Przypisz kamień milowy identyfikowany przez numer identyfikacyjny do problemu.

komentarz KWESTIA
Dodaj nowy komentarz do istniejącego problemu zidentyfikowanego przez KWESTIA.

-m MSG, --wiadomość=wiadomość
Komentarz do dodania do problemu. Jeśli ta opcja nie zostanie użyta, plik
domyślnym GIT_EDYTOR jest otwarty, aby napisać komentarz.

zamknięte KWESTIA
Alias ​​dla aktualizacja --zamknąć. (+ komentarz if --wiadomość or --edytuj wiadomość is
określony). Zamyka problem zidentyfikowany przez KWESTIA.

-m MSG, --wiadomość=wiadomość
Dodaj komentarz do problemu przed jego zamknięciem.

-mi, --edytuj wiadomość
Otwórz domyślne GIT_EDYTOR aby napisać komentarz, który zostanie dodany do
temat przed jego zamknięciem.

Ciągnąć To polecenie służy do zarządzania żądaniami ściągnięcia w serwisie GitHub. Od żądań ściągnięcia w GitHub
są również problemy, większość podpoleceń jest powtarzana z problem polecenie dla
wygoda. Tylko podstęp i nowa polecenia są naprawdę różne i dołączać i
przebazować są dodane.

podstęp Pokaż listę otwartych żądań ściągnięcia.

--Zamknięte
Zamiast tego pokaż zamknięte żądania ściągnięcia.

pokazać CIĄGNĄĆ [CIĄGNĄĆ ...]
Alias ​​dla problem pokazać.

checkout CIĄGNĄĆ ...
Sprawdź zdalną gałąź (głowę) żądania ściągnięcia. Najpierw to polecenie
pobiera głowa odwołanie z żądania ściągnięcia, a następnie wywołuje standard
odrzutowiec checkout polecenie i każdy dodatkowy argument zostanie przekazany do odrzutowiec checkout
tak jak jest, po odwołaniu, które właśnie zostało pobrane. Pamiętaj, że to tworzy
domyślnie odłączona kasa, użyj -b jeśli chcesz utworzyć nowy oddział
na podstawie żądania ściągnięcia. Proszę spojrzeć odrzutowiec checkout pomóc, aby uzyskać więcej
detale.

nowa [GŁOWA]
Utwórz nowe żądanie ściągnięcia. Jeśli GŁOWA zostanie określony, zostanie użyty jako
oddział (lub git ref), w którym zaimplementowano zmiany. W przeciwnym razie
używana jest bieżąca gałąź. Jeśli gałąź używana jako głowa nie zostanie dociśnięta do twojej
wideł, pchnięcie zostanie wykonane automatycznie przed utworzeniem pociągnięcia
prośba.

Repozytorium, z którego ma zostać wysłane żądanie ściągnięcia, jest pobierane z pliku hub.forkrepo
konfiguracja, która jest domyślna hub.nazwa użytkownika/ projekt udostępnij>.

-m MSG, --wiadomość=wiadomość
Tytuł żądania ściągnięcia (i opis). Pierwsza linia jest używana jako
Tytuł żądania ściągnięcia i dowolny tekst po pustej linii jest używany jako
opcjonalny korpus. Jeśli ta opcja nie jest używana, zostanie wybrana opcja domyślna GIT_EDYTOR is
otwierany. Jeżeli gałąź HEAD ma odpowiedni opis (patrz odrzutowiec oddział
--Edytuj opis), ten opis będzie używany jako domyślny
komunikat w edytorze, a jeśli nie, pojawi się komunikat ostatniego zatwierdzenia
być używany zamiast.

-b BAZA, --podstawa=BAZA
Oddział (lub git ref), do którego chcesz pobrać zmiany. Domyślnie
oddział śledzący (oddział. .łączyć zmienna konfiguracyjna).
lub konfiguracja hub.pullbase jeśli nie śledzisz odległego oddziału. Jeśli
żaden nie jest obecny, domyślnie jest tak mistrz. Repozytorium, które będzie używane jako plik
podstawa jest pobierana z hub.upstream konfiguracja.

-c NAZWA, --create-branch=NAZWA
Utwórz nową zdalną gałąź z (o nazwie IMIĘ) jako prawdziwy szef
żądanie ściągnięcia zamiast używać nazwy HEAD przekazanej jako GŁOWA, To
jest przydatny do utworzenia żądania ściągnięcia poprawki, do której się zobowiązałeś
swojego zwykłego HEAD bez tworzenia najpierw gałęzi.

-F, --pchnięcie siłą
Wymuś operacje wypychania. Używaj ostrożnie!

dołączać KWESTIA [GŁOWA]
Konwertuj problem zidentyfikowany przez KWESTIA do żądania ściągnięcia, dołączając zatwierdzenia
do tego. Może to być gałąź (lub git ref), w której zaimplementowano zmiany
opcjonalnie określone za pomocą GŁOWA (w przeciwnym razie używana jest bieżąca gałąź). Ten
podpolecenie jest bardzo podobne do polecenia nowa podpoleceniem, zapoznaj się z nim
więcej szczegółów.

Pamiętaj, że zatwierdzenia możesz dołączać tylko do problemów, jeśli masz dostęp do zatwierdzeń
do repozytorium lub jeśli jesteś przypisany do problemu.

-m MSG, --wiadomość=wiadomość
Dodaj komentarz do problemu/nowego żądania ściągnięcia.

-mi, --edytuj wiadomość
Otwórz domyślne GIT_EDYTOR aby napisać komentarz, który zostanie dodany do
wydanie/nowe żądanie ściągnięcia. Domyślna wiadomość jest pobierana z pliku
--wiadomość opcję, jeśli jest obecna, w przeciwnym razie opis gałęzi lub
pierwszy komunikat zatwierdzenia jest używany tak samo jak w przypadku nowa podkomenda.

-b BAZA, --podstawa=BAZA
Gałąź podstawowa, do której wysyłane jest żądanie ściągnięcia. Jeśli ta opcja nie jest
jest obecny, wówczas gałąź podstawowa jest pobierana z konfiguracji
hub.pullbase (Lub tylko mistrz jeśli tej konfiguracji nie ma
albo). Repozytorium używane jako baza jest pobierane z pliku
hub.upstream konfiguracja.

-c NAZWA, --create-branch=NAZWA
Utwórz nową zdalną gałąź z (o nazwie IMIĘ) jako prawdziwy szef
żądanie ściągnięcia zamiast używać nazwy HEAD przekazanej jako GŁOWA, To
jest przydatny do utworzenia żądania ściągnięcia poprawki, do której się zobowiązałeś
swojego zwykłego HEAD bez tworzenia najpierw gałęzi.

-F, --pchnięcie siłą
Wymuś operacje wypychania. Używaj ostrożnie!

przebazować CIĄGNĄĆ
Zamknij żądanie ściągnięcia zidentyfikowane przez CIĄGNĄĆ poprzez zmianę podstawy gałęzi podstawowej
(określony w żądaniu ściągnięcia) zamiast łączyć się jako GitHub Łączyć Przycisk™
zrobiłaby.

Jeśli operacja się powiedzie, zostanie opublikowany komentarz informujący o nowym
Zatwierdzenie HEAD gałęzi, której baza została zmieniona, i żądanie ściągnięcia zostanie wykonane
zamknięty.

Typ adresu URL używanego do pobierania i wypychania można określić za pomocą
typ huba.pullurl zmienna konfiguracyjna (zob KONFIGURACJA po więcej szczegółów).
Twoja kopia robocza powinna pozostać taka sama, idealnie, jeśli wszystko poszło dobrze.

Operacje wykonywane przez tę komendę są mniej więcej następujące:

1. skrytka git

2. pobierz git głowica pociągowa

3. git checkout -b tmp FETCH_HEAD

4. git pull --rebase podstawa ściągająca

5.git push podstawa ściągająca

6. przejdź do kasy staruszek

7. gałąź git -D tmp

8. git stash pop

If hub.forcerebase jest ustawiony na „true” (domyślnie), --siła zostanie przekazany do
rebase (nie mylić z tą opcją polecenia --pchnięcie siłą , które będą
wymusić wypchnięcie), w przeciwnym razie (jeśli jest „fałsz”) wykonywana jest zwykła zmiana bazy.
Kiedy wymuszona jest zmiana bazy, wszystkie zatwierdzenia w żądaniu ściągnięcia są takie
ponownie zatwierdzono, więc metadane Committer i CommitterDate są aktualizowane w pliku
zatwierdzeń, pokazując osobę, która wykonała zmianę bazy i czas
rebase zamiast oryginalnych wartości, zapewniając w ten sposób bardziej przydatne informacje.
Jako efekt uboczny zmienią się skróty zatwierdzeń.

Jeśli zostaną znalezione konflikty, polecenie zostanie przerwane, podobnie jak w przypadku odrzutowiec
przebazować zrobiłaby. Użytkownik też powinien --anulować ponowne bazowanie, --pominąć dotychczasowy
konflikt, popełnij lub rozwiąż konflikt i --kontyntynuj. Podczas korzystania z jednego z
te działania, należy pominąć CIĄGNĄĆ argumenty.

-m MSG, --wiadomość=wiadomość
Użyj tej wiadomości jako komentarza zamiast domyślnej. Określ
pusta wiadomość (-M''), aby całkowicie pominąć komentarz.

-mi, --edytuj wiadomość
Otwórz domyślne GIT_EDYTOR aby napisać komentarz.

--pchnięcie siłą
Wymuś operacje wypychania. Używaj ostrożnie!

-P, --pauza
Wstrzymaj rebase tuż przed wypchnięciem wyników i problemem jest
połączone. Aby wznowić zmianę bazy żądania ściągnięcia (wypchnij zmiany
upstream i zamknij problem), po prostu użyj metody --kontyntynuj działanie. Ten
jest szczególnie przydatny do testowania.

-ty, --stash-include-untracked
Przechodzi --include-nieśledzone opcja przechowywania. Jeśli używane, wszystkie nieśledzone
pliki są również przechowywane, a następnie czyszczone za pomocą git clean, pozostawiając
katalog roboczy w bardzo czystym stanie, co pozwala uniknąć konfliktów
podczas sprawdzania żądania ściągnięcia w celu zmiany bazy.

-za, --ukryj wszystko
Przechodzi --wszystko opcja przechowywania. Jest jak --stash-include-untracked
ale ignorowane pliki są przechowywane i czyszczone oprócz
nieśledzone pliki, co całkowicie eliminuje możliwość
konflikty podczas sprawdzania żądania ściągnięcia w celu zmiany bazy.

-D, --usuń gałąź
Usuń gałąź żądania ściągnięcia, jeśli zmiana bazy zakończyła się pomyślnie. To jest
podobnie do naciśnięcia przycisku „Usuń oddział” (TM) w interfejsie internetowym
po połączeniu.

Akcje:

--kontyntynuj
Kontynuuj trwającą bazę.

--anulować
Przerwanie trwającej ponownej bazy.

--pominąć Pomiń bieżącą łatkę w trwającej zmianie bazy i kontynuuj.

aktualizacja CIĄGNĄĆ
Alias ​​dla problem aktualizacja.

komentarz CIĄGNĄĆ
Alias ​​dla problem komentarz.

zamknięte CIĄGNĄĆ
Alias ​​dla problem zamknięte.

KONFIGURACJA

Ten program korzysta z narzędzi konfiguracyjnych git, z których pobiera swoją konfigurację. To są
użyte klucze konfiguracyjne git:

hub.nazwa użytkownika
Twoja nazwa użytkownika GitHub. [domyślny: aktualne OS nazwa użytkownika]

hub.oauthtoken wymagany
Jest to token autoryzacyjny uzyskany poprzez ustawienie Komenda. Nawet gdy jest to wymagane,
nie powinieneś ustawiać tej zmiennej ręcznie. Użyj ustawienie zamiast tego polecenie.

hub.upstream wymagany
Błogosławione repozytorium używane do pobierania problemów i wysyłania żądań ściągnięcia. The
format jest /. Opcja ta może być ustawiona automatycznie przez klonować
polecenie i tak naprawdę nie jest przez nie wymagane ustawienie dowództwo.

hub.forkrepo
Twój błogosławiony widelec repozytorium. Format jest /. Służy do ustawiania głowicy
dla Twoich żądań ściągnięcia. [domyślny: /(pod prąd część)]

hub.forkremote
Zdalna nazwa dostępu do Twojego forka. Służy do pchania gałęzi przed utworzeniem ciągnięcia
wniosek. [domyślny: pochodzenie]

hub.pullbase
Domyślna gałąź zdalna (lub odwołanie do git), do której chcesz, kiedy chcesz pobrać swoje zmiany
tworzenie żądania ściągnięcia. [domyślny: mistrz]

hub.urltype
Typ adresu URL, który ma być używany, gdy potrzebny jest adres URL z interfejsu API GitHub (na przykład, gdy „pull
używana jest rebase”). W chwili pisania tego tekstu mogło tak być ssh_url or klon_url dla
HTTP). Więcej szczegółów i opcji znajdziesz w dokumentacji API GitHuba[1]. [domyślny:
ssh_url]

hub.baseurl
Podstawowy adres URL GitHuba używany do uzyskiwania dostępu do interfejsu API. Ustaw tę opcję, gdy włączony jest interfejs API GitHub
inna lokalizacja niż domyślna (zwykle serwery korporacyjne używają
https://host/api/v3). Będzie to dołączane do wszystkich wywołań API GitHub i tak musi być
być pełnym adresem URL, a nie czymś w rodzaju „www.example.com/api/v3/”.

hub.forcerebase
Jeśli jest ustawione na „true”, --siła zostanie przekazany do rebase. Jeśli jest ustawione na „false” a
przeprowadzana jest regularna ponowna baza. Zobacz Ciągnąć przebazować polecenie dla szczegółów. [domyślny:
prawdziwy]

piasta.trójkątna
Sprawia, że --trójkątny dla klonować jeśli ustawione na „true” (wartość logiczna). Widzieć klonować
dokumentacja, aby uzyskać szczegółowe informacje.

[1] https://developer.github.com/v3/pulls/#get-a-single-pull-request

Korzystaj z git-hub online, korzystając z usług onworks.net