python_bivt

Хаб-репозиторий курса (просто и по делу)

В этом репозитории — правила и ссылки, а также задания для лабораторных.
Задания ищите тут: ./src/lab01/README.md, ./src/lab02/README.md, ...

---

Что такое Git и система контроля версий (в двух словах)

• Git — инструмент для хранения истории кода (кто/что/когда изменил).
• Позволяет возвращаться к прошлым версиям, работать вместе и делать ветки для экспериментов.
• Репозиторий — это папка с историей (.git), которую можно хранить на GitHub и на своём компьютере.

Что нужно сделать?

Для сдачи лабораторных работ Вам понадобится git-репозиторий. Чтобы его создать - необходимо создать аккаунт на github.com и добавить ssh-ключ.

Как создать SSH-ключ (один раз)

SSH-ключ нужен, чтобы каждый раз не вводить логин/пароль при работе с GitHub.
Процесс делится на 3 шага:

1. Сгенерировать ключ — команда ssh-keygen создаёт пару файлов (закрытый и открытый ключи).
2. Найти ключ — перейти в папку .ssh и вывести содержимое открытого ключа (id_rsa.pub).
3. Добавить ключ в GitHub — скопировать ключ и вставить в настройках GitHub.

macOS / Linux Открываем терминал и вводим нужные команды

ssh-keygen -t rsa
# Нажмите Enter 3-4 раза
cat ~/.ssh/id_rsa.pub

Windows (PowerShell)

В поисковой строке находим приложение cmd.exe

Введите команду

ssh-keygen -t rsa

Несколько раз нажмите Enter

Перейдите в папку с ключами и выведите содержимое, используя следующие команды:

cd .ssh
type id_rsa.pub

Обязательно убедитесь, что находитесь в нужной директории

Вывели ключ

Добавляем ключ на GitHub

GitHub → Settings → SSH and GPG keys → New SSH key → вставьте содержимое id_rsa.pub → Save.

Копируем содержимое ключа

Переходим в аккаунт

Заходим в настройки

Добавляем новый ключ

Вставляем содержимое id_rsa.pub

Жмем Add SSH key

Что дальше? Создаем репозиторий.

GitHub → Repository Repository → New

New Repository→ python_labs → Public → Create.

Как склонировать репозиторий на компьютер

1. На странице репозитория — кнопка Code → вкладка SSH → скопируйте URL.

2. В терминале:

cd Desktop
git clone git@github.com:<owner>/<repo>.git
cd <repo>

Эти команды работают как на Windows так и на macOS, покажу на примере macOS:

Находясь в корневой директории (попасть в нее можно командой cd или cd ..), выполняем команду cd Desktop и проверяем, что мы оказались на рабочем столе

Затем выполняем команду git clone и в качeстве аргумента вставляем ssh-url, который мы скопировали на шаге 1.

После успешного выполнения команды открываем репозиторий в Visual Studio Code

Индикаторы справа от названия директорий и файлов сигнализируют о том, что в репозиторий были внесены изменения и пора их опубликовать.

Открываем терминал. Можно как в VS Code, так и в том терминале что мы работали. Чтобы открыть терминал в VS Code используйте сочетание клавиш ctrl + ~(ё)

Базовые команды Git

Команда / шорткат	Что делает	Пример использования
git config --global user.name "Имя"	Указать имя автора коммитов (один раз на ПК)	git config --global user.name "Иван Иванов"
git config --global user.email "почта"	Указать email автора (лучше GitHub noreply при желании)	git config --global user.email ivan@users.noreply.github.com
git config --global --list	Проверить текущие глобальные настройки	—
git status	Показать текущее состояние репозитория	—
git add <файл/папка>	Добавить изменения в индекс (подготовить к коммиту)	git add src/main.py / git add .
git commit -m "сообщение"	Зафиксировать изменения локально	git commit -m "solve task 1"
git push	Отправить коммиты на удалённый репозиторий (GitHub)	git push origin main
git pull	Забрать изменения с удалённого репозитория	git pull (или git pull --rebase)
git branch	Показать список веток (локальных)	git branch
git branch -d <ветка>	Удалить слитую локальную ветку	git branch -d lab01
git checkout -b <ветка>	Создать и перейти в новую ветку	git checkout -b lab01
git checkout <ветка>	Перейти в существующую ветку	git checkout main
git log --oneline --graph --decorate	Короткий журнал коммитов с визуализацией веток	—

Примечания:

• Перед первым push может понадобиться задать апстрим: git push -u origin <ветка>.
• Команда git add . добавляет всё изменённое — будьте осторожны; можно точечно git add file.py.
• Если работаете на общем компьютере — вместо --global используйте настройки без него (только для текущего репо):
  git config user.name "Имя" / git config user.email "почта".

Добавляем изменения

Фиксируем изменения

Публикуем изменения

Возможные сложности

Вероятно, при первой попытке зафиксировать изменения командой git commit git попросит Вас как-то идентифицировать себя, чтобы было видно кто заливает изменения. Используйте команду git config --global user.name "Имя", куда введете своё имя или почту, чтобы git Вас узнавал.

Где смотреть задания

• Для каждой лабораторной есть папка: ./src/lab01, ./src/lab02, ...
• Внутри — README.md с заданием и мини-теорией.