Git и GitHub для аналитиков

Шаг 1. Установите Git и укажите свою личность (один раз).

1. Установите Git из git-scm.com/downloads (все значения по умолчанию в порядке).
2. По желанию установите Интерфейс командной строки GitHub от cli.github.com. Это значительно упрощает создание репозиториев и вход в систему.
3. Откройте терминал (Гит Баш в Окна, Терминал на Мак) и сообщите Git, кто вы. Это имя и адрес электронной почты отмечаются при каждом сохранении:

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

Если вы установили интерфейс командной строки GitHub, войдите в GitHub один раз с помощью gh auth login и следуйте подсказкам. Это то, что позволяет вам нажимать, не вставляя пароль каждый раз.

Шаг 2. Ежедневный цикл (это 90% Git)

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

Каждый раз, когда вы заканчиваете часть работы, вы делаете одно и то же трехтактное движение: этап, сохранение, отправка. В терминале, открытом внутри папки вашего проекта:

git status                 # see what changed (read this first, always)
git add .                  # stage every changed file for the next save
git commit -m "Add churn analysis notebook"   # save, with a short note
git push                   # send it up to GitHub

Вот и весь суточный ритм. status показывает вам, что будет сохранено, add выбирает файлы, commit сохраняет снимок с сообщением и push загружает его. Делайте это часто, используя четкие сообщения. Думайте о каждом коммите как о помеченной точке сохранения, к которой вы можете вернуться.

Шаг 3. Запустите новый проект и разместите его на Гитхаб.

У вас есть папка с вашей работой, и вы хотите, чтобы она была на Гитхаб. Из этой папки:

git init -b main           # start tracking this folder, on a branch called main
git add .                  # stage everything
git commit -m "First commit"   # your first save point

Теперь создайте для него онлайн-дом. Самый простой способ — с помощью Интерфейс командной строки GitHub — сделать это в одну строку и одновременно нажать:

gh repo create my-project --public --source=. --remote=origin --push

Нет CLI? Создайте пустой репозиторий на github.com/новый (не добавляйте README, оставьте его пустым). Затем скопируйте две команды, которые GitHub показывает вам в разделе «Отправить существующий репозиторий». Они выглядят так:

git remote add origin https://github.com/yourname/my-project.git
git push -u origin main

Шаг 4. Опубликуйте его как действующий веб-сайт (страницы GitHub).

Если в вашем проекте есть index.html, GitHub может бесплатно разместить его как настоящую общедоступную веб-страницу. На странице репо: Настройки → Страницы → Источник: Развернуть из ветки → Ветка: основная/(корневая) → Сохранить.

Подождите одну-две минуты до первой сборки, затем посетите:

https://yourname.github.io/my-project/

Шаг 5. Чего НЕ следует совершать

Прежде чем читать список, подумайте о папке своего проекта. Какой файл из него вам было бы больше всего неловко случайно опубликовать в Интернете? Этот файл является причиной существования этого шага.

Git предназначен для вашего кода и небольших файлов, а не для гигантских наборов данных. GitHub отклоняет файлы размером более 100 МБ, а использование CSV-файла размером 2 ГБ или файла базы данных в любом случае является ошибкой. Вы исключаете файлы, перечисляя их в .gitignore файл в корне вашего проекта:

# .gitignore
*.db            # SQLite databases
*.csv           # large raw data
data/raw/       # a whole folder of source files
node_modules/   # dependencies

Эмпирическое правило: делайте то, что необходимо перестроить проект (код, небольшой пример файла, README), а не сами тяжелые данные. Любой может повторно загрузить или восстановить большие файлы.