nothingholy/REPORT.md

## REPORT.md

      
    Raw
  

              REPORT.md
            
          
    Laboratory work II

Данная лабораторная работа посвещена изучению систем контроля версий на примере Git.
$ open https://git-scm.com
Tasks


 1. Создать публичный репозиторий с названием lab02 и с лиценцией MIT
 2. Сгенирировать токен для доступа к сервису GitHub с правами repo
 3. Ознакомиться со ссылками учебного материала
 4. Выполнить инструкцию учебного материала
 5. Составить отчет и отправить ссылку личным сообщением в Slack

Tutorial

Установка переменных
$ export GITHUB_USERNAME=<имя_пользователя>
$ export GITHUB_EMAIL=<адрес_почтового_ящика>
$ export GITHUB_TOKEN=<сгенирированный_токен>
$ alias edit=<nano|vi|vim|subl>
Подготовка рабочего места
$ cd ${GITHUB_USERNAME}/workspace
$ source scripts/activate #активация скрипта
Устанавливаем глобальные параметры
$ mkdir ~/.config #создаем папку с конфигом
$ cat > ~/.config/hub <<EOF #создаем файл hub и записываем в него 
github.com:
- user: ${GITHUB_USERNAME}
  oauth_token: ${GITHUB_TOKEN}
  protocol: https
EOF
$ git config --global hub.protocol https #Устанавливаем параметр конфига гит
Работа с git
$ mkdir projects/lab02 && cd projects/lab02
$ git init #создаем пустой репозиторий
Инициализирован пустой репозиторий Git в /home/nothingholy/nothingholy/workspace/projects/lab02/.git/
$ git config --global user.name ${GITHUB_USERNAME} # Установка параметра конфига username для git
$ git config --global user.email ${GITHUB_EMAIL} # Установка параметра конфига email для git
# check your git global settings
$ git config -e --global #вывод конфига
$ git remote add origin https://github.com/${GITHUB_USERNAME}/lab02.git # добавление ссылки на репозиторий гитхаба
$ git pull origin master #переносим изменения с гитхаба
$ touch README.md #создаем README.md
$ git status #узнаем статус репозитория
На ветке master
Неотслеживаемые файлы:
  (используйте «git add <файл>…», чтобы добавить в то, что будет включено в коммит)

        README.md

ничего не добавлено в коммит, но есть неотслеживаемые файлы (используйте «git add», чтобы отслеживать их)
$ git add README.md #добавляем файл
$ git commit -m"added README.md" #закомитить изменения 
$ git push origin master
Username for 'https://github.com': nothingholy
Password for 'https://nothingholy@github.com': 
Перечисление объектов: 4, готово.
Подсчет объектов: 100% (4/4), готово.
При сжатии изменений используется до 4 потоков
Сжатие объектов: 100% (2/2), готово.
Запись объектов: 100% (3/3), 288 bytes | 288.00 KiB/s, готово.
Всего 3 (изменения 0), повторно использовано 0 (изменения 0)
To https://github.com/nothingholy/lab02.git
   69a3c45..3cfa6c7  master -> master

Добавить на сервисе GitHub в репозитории lab02 файл .gitignore
со следующем содержимом:
*build*/
*install*/
*.swp
.idea/
Перенос изменений с гитхаба
$ git pull origin master
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Распаковка объектов: 100% (3/3), готово.
Из https://github.com/nothingholy/lab02
 * branch            master     -> FETCH_HEAD
   3cfa6c7..8cefc53  master     -> origin/master
Обновление 3cfa6c7..8cefc53
Fast-forward
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 .gitignore
$ git log #просмотр коммитов
commit 8cefc53d298ae4700f481cb3a929396f10e4d0c1 (HEAD -> master, origin/master)
Author: nothingholy <43923996+nothingholy@users.noreply.github.com>
Date:   Mon Mar 18 17:57:46 2019 +0300

    Create .gitignore

commit 3cfa6c7b8d7a6e9f29bee90df99b8c384e471bc2
Author: nothingholy <pershaevnikita@yandex.ru>
Date:   Mon Mar 18 05:56:38 2019 +0300

    added README.md

commit 69a3c455f3871fc42089fa34583356d7d35f99c6
Author: nothingholy <43923996+nothingholy@users.noreply.github.com>
Date:   Mon Mar 18 17:43:22 2019 +0300

    Initial commit

Создание директорий и файлов с кодом
$ mkdir sources
$ mkdir include
$ mkdir examples
$ cat > sources/print.cpp <<EOF
#include <print.hpp>

void print(const std::string& text, std::ostream& out)
{
  out << text;
}

void print(const std::string& text, std::ofstream& out)
{
  out << text;
}
EOF
Создание файла с кодом
$ cat > include/print.hpp <<EOF
#include <fstream>
#include <iostream>
#include <string>

void print(const std::string& text, std::ofstream& out);
void print(const std::string& text, std::ostream& out = std::cout);
EOF
Создание файла с кодом
$ cat > examples/example1.cpp <<EOF
#include <print.hpp>

int main(int argc, char** argv)
{
  print("hello");
}
EOF
Создание файла с кодом
$ cat > examples/example2.cpp <<EOF
#include <print.hpp>

#include <fstream>

int main(int argc, char** argv)
{
  std::ofstream file("log.txt");
  print(std::string("hello"), file);
}
EOF
Редактируем README.md
$ edit README.md
Состояние репозитория и отправка изменений
$ git status
$ git add .
$ git commit -m"added sources"
$ git push origin master
Report

$ cd ~/workspace/labs/
$ export LAB_NUMBER=02
$ git clone https://github.com/tp-labs/lab${LAB_NUMBER}.git tasks/lab${LAB_NUMBER}
$ mkdir reports/lab${LAB_NUMBER}
$ cp tasks/lab${LAB_NUMBER}/README.md reports/lab${LAB_NUMBER}/REPORT.md
$ cd reports/lab${LAB_NUMBER}
$ edit REPORT.md
$ gistup -m "lab${LAB_NUMBER}"
Homework

Part I


Создайте пустой репозиторий на сервисе github.com (или gitlab.com, или bitbucket.com).
Выполните инструкцию по созданию первого коммита на странице репозитория, созданного на предыдещем шаге.
Создайте файл hello_world.cpp в локальной копии репозитория (который должен был появиться на шаге 2). Реализуйте программу Hello world на языке C++ используя плохой стиль кода. Например, после заголовочных файлов вставьте строку using namespace std;.
Добавьте этот файл в локальную копию репозитория.
Закоммитьте изменения с осмысленным сообщением.
Изменитьте исходный код так, чтобы программа через стандартный поток ввода запрашивалось имя пользователя. А в стандартный поток вывода печаталось сообщение Hello world from @name, где @name имя пользователя.
Закоммитьте новую версию программы. Почему не надо добавлять файл повторно git add?
Запуште изменения в удалёный репозиторий.
Проверьте, что история коммитов доступна в удалёный репозитории.

Part II

Note: Работать продолжайте с теми же репоззиториями, что и в первой части задания.

В локальной копии репозитория создайте локальную ветку patch1.
Внесите изменения в ветке patch1 по исправлению кода и избавления от using namespace std;.
commit, push локальную ветку в удалённый репозиторий.
Проверьте, что ветка patch1 доступна в удалёный репозитории.
Создайте pull-request patch1 -> master.
В локальной копии в ветке patch1 добавьте в исходный код комментарии.
commit, push.
Проверьте, что новые изменения есть в созданном на шаге 5 pull-request
В удалённый репозитории выполните  слияние PR patch1 -> master и удалите ветку patch1 в удаленном репозитории.
Локально выполните pull.
С помощью команды git log просмотрите историю в локальной версии ветки master.
Удалите локальную ветку patch1.

Part III

Note: Работать продолжайте с теми же репоззиториями, что и в первой части задания.

Создайте новую локальную ветку patch2.
Измените code style с помощью утилиты clang-format. Например, используя опцию -style=Mozilla.
commit, push, создайте pull-request patch2 -> master.
В ветке master в удаленном репозитории измените комментарии, например, расставьте знаки препинания, переведите комментарии на другой язык.
Убедитесь, что в pull-request появились конфликтны.
Для этого локально выполните pull + rebase (точную последовательность команд, следует узнать самостоятельно). Исправьте конфликты.
Сделайте force push в ветку patch2
Убедитель, что в pull-request пропали конфликтны.
Вмержите pull-request patch2 -> master.

Links


hub
GitHub
Bitbucket
Gitlab
LearnGitBranching

Copyright (c) 2015-2019 The ISC Authors