Gerrit/git-review/tr

git-review, Git / bir değişiklik göndermek veya mevcut olanı getirmek için kullanılan bir komut satırı aracıdır.

Wikimedia Gerrit için git-review sürüm 1.27 veya üstü gerektiğini unutmayın.

Akış projesi OpenStack tarafından yönetiliyor. İlgisiz Facebook projesi ile karıştırılmamalıdır.

Kurulum

 * Ayrıca bakınız: Gerrit eğitimi

Git'i yükledikten (1, 2), gerrit kullanıcı hesabı oluşturduktan, bir ssh anahtarı (3, 4) oluşturduktan ve |proje deposu klonladıktan sonra (veya örnek), Gerrit depolarıyla çalışmak için bir araç olan git-review'i kurmaya hazırsınız, böylece bazı komutları hatırlamak zorunda kalmazsınız. İşletim sisteminiz için aşağıdaki talimatları izleyin ve daha sonra yapılandırmayı yapmayı unutmayın!

Debian/Ubuntu/Mint
Paylaşılan bir ana bilgisayardaki Debian veya ilgili dağıtımların (ör. Ubuntu, Mint) kullanıcıları genellikle kök erişimine sahip değildir. Barındırma hizmetinden sizin için git-review yüklemesini sağlayamazsanız, yerel olarak kurmayı deneyebilirsiniz. Aşağıdaki uygun bölüme gidin

Kök erişimine sahip olmak
Şunu yapabilirsiniz:

veya

easy_install kurulumunuz yoksa, deneyin

komutunuz yoksa, ancak yüklü  varsa, bunu kullanabilirsiniz; özel OS X talimatları için aşağıya bakın.

Ubuntu 20.04'e sahipseniz, deneyin

Sonra çalıştırın:

Gerrit ile çalışmak için klonlanmış kopyanızda. Muhtemelen sizden taahhüt kullanıcı adınızı isteyecektir. Sonra otomatik olarak commit-msg kancayı kuracaktır.

Kök erişimi olmadan
Paylaşılan bir ana bilgisayardaysanız ve sisteminizde git-review yoksa, bunu yerel olarak kullanıcı dizininize kurabilirsiniz.

Bu ilk yerel kurulumunuzsa veya bunu daha önce yapmadıysanız, PATH'inizi yerel ikili dosyaları içerecek şekilde genişletin. Bunu yapmanın iki yolu var. Daha muhafazakar yol

sistemin önce tüm ikili dizinlere bakmasını ve başka bir yerde bir komut bulunmaması durumunda yalnızca yerel ikili dizine bakmasını sağlar. Ana dizininize yerel olarak yüklenmiş yazılımın sistem programlarını geçersiz kılmasını istiyorsanız, sıralamanın tersini yapmanız gerekir.

Muhtemelen bunu daha önce yaptınız. Otomatik olarak çalışmasını sağlamak için oturum açma sıranıza her iki komutu da eklemek isteyebilirsiniz.

PATH değişkeninizi değiştirmek istemiyorsanız, değiştirmenize gerek yoktur. Bu durumda,  komutunu kullanamazsınız, bunun yerine   kullanmayı unutmamalısınız.

Son olarak şunu çalıştırın:

veya

sırasıyla, Gerrit ile çalışmak üzere ayarlamak için klonlanmış kopyanızda. Muhtemelen sizden taahhüt kullanıcı adınızı isteyecektir. Ardından commit-msg kancasını otomatik olarak kuracaktır.

Fedora≤21/CentOS
Git-review kullanırken  görüyorsanız,   yüklemeniz gerekecek

Yum'un git-review paketi bulamadığını görebilirsiniz. Bu durumda EPEL deposunu etkinleştirebilir ve tekrar deneyebilirsiniz.

OpenSUSE
kurun (YaST), sonra



OpenSUSE 13.1'den itibaren git-review ana depoya dahil edilmiştir, böylece kullanabilirsiniz

Kararsız
Eğer nixpkgs'in dengesiz dalını çalıştırıyorsanız, git-review bir paket olarak mevcuttur. Şununla kurun:

nix-env -i python2.7-git-review

Eski nixpkgs dalları
Python ve pip'i kurun:

nix-env -i -A pythonPackages.pip ~/.local/bin yolunuzu ekleyin:

export PATH=$PATH:~/.local/bin echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc

git-review kurun:

pip install git-review --user pip install --upgrade setuptools pip install --upgrade distribute

Pip Python paket yükleyicisini kullanarak yükleme
Not:  dalınız yoksa, ancak yüklü   varsa, git-review'in en son sürümünü python paket yükleyicisini kullanarak da yükleyebilirsiniz. Tam komut dağıtımınıza bağlıdır, ya da:

veya



yüklendikten sonra şunları kullanabilirsiniz:



FreeBSD
git-review'i doğrudan bağlantı noktaları üzerinden kurabilirsiniz.

Windows
git-review işlevinin çalışması için Python gereklidir ve kurulumu için pip kullanılır:


 * Python'u yükleyin veya Python 2 veya Python 3'ün en güncel sürümüne yükseltin.
 * Önemli: Python'u yolunda boşluk olan herhangi bir dizine kurmayın, çünkü bir pip hatası ( adresine bakın), varsayılanı kullanın, ör.
 * Python kurulumu sırasında manüel olarak Add python.exe to Path seçeneği seçin
 * Aksi takdirde, python betikleri dizininizi manüel olarak sistem yoluna ekleyin (Ayarlar, Kontrol paneli, Sistem, Gelişmiş sistem ayarları, Ortam değişkenleri, Kullanıcı değişkenleri, Yol; ör. ). Yoldaki farklı dizinler noktalı virgülle ";" yalnızca yol listesine herhangi bir boşluk eklemeyin.
 * Python 3.4'te pip zaten kurulu. Yalnızca daha eski bir sürüme sahipseniz, buradaki talimatları izleyerek pip kurun.
 * Git Bash'i Yönetici olarak çalıştırın (bu seçenek için simgeye sağ tıklayın) ve aşağıdaki komutla git-review'i kurun:
 * pip install git-review
 * Aşağıdakilere benzer sorunlarla karşılaşırsanız:
 * Retrying (Retry(total=4, connect=None, read=None, redirect=None)) after connection broken by 'ConnectTimeoutError(, 'Connection to pypi.python.org timed out. (connect timeout=15)')': /simple/git-review/
 * şunu çalıştırmayı deneyin:
 * pip install git-review --proxy=www-proxy-lon.uk.oracle.com:80
 * kullanılacak tam proxy http://wpad/wpad.dat dosyasından çıkarılabilir.


 * kullanmak için, halihazırda (muhtemelen gizli)  yapılandırma dosyası içeren bir git klon dizininde olmanız gerekir (git-remote için bir depo kurma sayfasına bakın)

Yöntem 1 (Homebrew)
OS X 10.11 El Capitan ve sonraki sürümlerde çalışır (High Sierra 10.13.5'te doğrulanmıştır):
 * 1) Homebrew'i kurun
 * 2)   ile git-review kurun

Yöntem 2 (Python “pip” Paket Yükleyicisi)
Mac OS X, Python 2.7 ile birlikte gelir (şimdilik), ancak Git ve git-review tarafından desteklenen kurulum programları değil.
 * 1) Terminal'i açın ve test Git paketlerini indirmek için rahat olduğunuz bir dizine geçin ("İndirilenler" gibi)
 * 2) OS X Installer for Git'i indirin ve yükleyin (yalnızca OS X 10.8 ve öncesi için OS X 10.9, Git önceden yüklenmiş olarak gelir)
 * 3) Pip'i kurun (Not: OS X'in bazı eski sürümlerine zaten dahil edilmiştir):
 * 4) Pip/setuptools'u güncelleyin (yalnızca OS X 10.7 ve öncesi için)
 * 5) git-review yükleyin. "El Capitan" sürümünden itibaren OS X, dosya sistemindeki konumları   dahil olmak üzere korur, böylece tipik yükleme yöntemi sudo kullanılarak başarısız olur. Bunun yerine git-review ile yerel olarak ana klasörünüze şu şekilde yükleyin:
 * 1) PATH kabuk değişkeninizi,   olması gereken git-review konumunu içerecek şekilde güncelleyin

$ 1 hatası alırsanız, önceden yüklenmiş Python'u (/Library/Python/) nük yapmayı, Python'u homebrew ile yüklemeyi ve kurulum araçlarını ve git-review'i yeniden yüklemeyi deneyebilirsiniz.

Görünüşte başarılı bir kurulumdan sonra  alırsanız, mevcut kurulumun üzerine yeniden yüklemeyin, ancak git-review'i kaldırın ve yeniden yapın

git-review ayarlama
git-review varsayılan uzak olarak "origin" ile kullanacak şekilde yapılandırmak için Gerrit eğitimdeki talimatları izleyin. Bu, "gerrit" ve "origin" adlı uzak arasındaki karışıklığı ve çakışmaları önler.

Bir depoyu klonladıktan sonra git-review kullanmak için onu ayarlamanız gerekir. Bu, bir taahhüdü ilk kez göndermeye çalıştığınızda otomatik olarak gerçekleşir, ancak bunu klonlamadan hemen sonra yapmak genellikle daha iyidir. Bu, kullandığınız kabuk kullanıcı adından farklıysa git kullanıcı adınızı isteyebilir.

Internally, this does the following:
 * checks whether accessing the remote repository works
 * if it doesn't, asks for a username and tries again
 * creates a remote called 'gerrit' that points to gerrit
 * installs the commit-msg hook

git-review ile değişiklik gönderme
Submitting changes with git review does not involve a lot of commands: git checkout -b mycoolfeature change files git commit -a git review

Bir değişiklik gönderdiğinizde ne olur
When you submit a change, git review does the following things:
 * it looks up which branch to push to (production or whatever) in the .gitreview file. If it can't find this information, it pushes to master
 * it figures out what "topic" to put on the revision (you can set the topic manually with )
 * if you're resubmitting a downloaded change, it will reuse the topic of the original change
 * if your commit summary contains a bug number like, the topic will be
 * otherwise, the topic will be the name of your local branch
 * it rebases your change against the HEAD of the branch you're pushing to (use  to skip this)
 * if you are submitting more than one change at once, or submitting a change that's based on another unmerged change, it will ask you whether you really meant to do that (use  to skip this)
 * it pushes the change for review

Downloading a change with git-review
When downloading a change from gerrit to review it or amend it, git-review offers an alternative to copy-pasting a magic incantation from the Gerrit web UI. All you need is the sequence number of the change in Gerrit, which you can find in the URL:. git review -d 2033 This will download the change, put it in a branch called  (if the change has no tag, the sequence number will be used instead), and switch to that branch.

After that, you can amend the downloaded change to improve it.

Troubleshooting
For problems and how to solve them, see Gerrit/Troubleshooting.

Troubleshooting for Windows
If this fails, you have a couple of options. The first is the use scp (secure copy) from within your local repository's directory, for each repository, before committing edits to it:

scp -P 29418 USERNAME@gerrit.wikimedia.org:hooks/commit-msg .git/hooks/commit-msg

The second is to try patching  to make git-review work properly: If using Python 2.x and git-review 1.17 or earlier, use  instead of.

Another error encountered on Windows is: ...   (top_dir, git_dir) = git_directories ValueError: too many values to unpack (expected 2)

One solution to this is to change the return line of  to use splitlines rather than its normal split function. Split looks for any whitespace and will produce this error when the path to your source code directory contains a space. Splitlines looks for newline characters and will not produce this same error.