Начало работы с Git для разработки

В этом и следующем разделах подробно описано, как настроить git для работы с исходным кодом NumPy. Если git у вас уже настроен, перейдите к Процессу разработки.

Основные настройки Git

• установка-git.

• Знакомство с Git:

  git config --global user.email you@yourdomain.example.com
  git config --global user.name "Your Name Comes Here"
  

Создание собственной копии (fork) NumPy

Это нужно сделать только один раз. Инструкции здесь очень похожи на инструкции на http://help.github.com/forking/ — для получения подробной информации обратитесь к этой странице. Мы повторяем некоторые из них здесь, чтобы указать особенности проекта NumPy и предложить некоторые стандартные имена.

Настройка и конфигурация учетной записи на github

Если у вас нет учетной записи на github, перейдите на страницу github и создайте её.

Затем вам нужно настроить свою учетную запись для получения прав на запись — см. раздел Generating SSH keys справки по помощи github.

Создайте свою копию NumPy с помощью fork

1. Войдите в свою учетную запись на github.
2. Перейдите на главную страницу проекта NumPy на github NumPy.

3. Нажмите кнопку fork:

   

   Через некоторое время вы окажетесь на главной странице вашей собственной скопированной копии NumPy.

Настройка вашей копии

Сначала следуйте инструкциям для Создание собственной копии (fork) NumPy.

Обзор

git clone https://github.com/your-user-name/numpy.git
cd numpy
git remote add upstream https://github.com/numpy/numpy.git

Подробно

Клонирование вашей копии

1. Клонируйте свою копию на локальный компьютер с помощью git clone https://github.com/your-user-name/numpy.git

2. Исследование. Перейдите в каталог вашего нового репозитория: cd numpy. Затем git branch -a, чтобы увидеть все ветки. Вы получите что-то вроде:

   * master
   remotes/origin/master
   

   Это означает, что вы сейчас находитесь на ветке master, и у вас также есть подключение remote к origin/master. Какой удалённый репозиторий это remote/origin? Попробуйте git remote -v, чтобы увидеть URL-адреса удалённых репозиториев. Они будут указывать на ваш fork на github.

   Теперь вам нужно подключиться к исходному репозиторию NumPy github, чтобы вы могли объединить изменения из основной ветки.

Связывание вашего репозитория с исходным репозиторием

cd numpy
git remote add upstream https://github.com/numpy/numpy.git

upstream — это просто произвольное имя, которое мы используем для обозначения основного репозитория NumPy на NumPy github.

Для вашей же удовлетворенности, покажите себе, что у вас теперь есть новый «удаленный» репозиторий с git remote -v show, что даст вам что-то вроде:

upstream     https://github.com/numpy/numpy.git (fetch)
upstream     https://github.com/numpy/numpy.git (push)
origin       https://github.com/your-user-name/numpy.git (fetch)
origin       https://github.com/your-user-name/numpy.git (push)

Чтобы оставаться в синхронизации с изменениями в NumPy, вы хотите настроить свой репозиторий так, чтобы он подтягивал изменения из upstream по умолчанию. Это можно сделать с помощью:

git config branch.master.remote upstream
git config branch.master.merge refs/heads/master

Также вы можете легко получить доступ ко всем запросам на добавление изменений в репозиторий NumPy:

git config --add remote.upstream.fetch '+refs/pull/*/head:refs/remotes/upstream/pr/*'

Ваш конфигурационный файл теперь должен выглядеть примерно так (из $ cat .git/config):

[core]
        repositoryformatversion = 0
        filemode = true
        bare = false
        logallrefupdates = true
        ignorecase = true
        precomposeunicode = false
[remote "origin"]
        url = https://github.com/your-user-name/numpy.git
        fetch = +refs/heads/*:refs/remotes/origin/*
[remote "upstream"]
        url = https://github.com/numpy/numpy.git
        fetch = +refs/heads/*:refs/remotes/upstream/*
        fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*
[branch "master"]
        remote = upstream
        merge = refs/heads/master