На данный момент, как вы сохраняете свой код, чтобы он был легко доступен вам в будущем? Вы делаете резервную копию своего кода? Можете ли вы легко поделиться своим кодом с другими разработчиками? У вас есть файл с именем «v1», «v2», «v3» внутри папок, внутри папок? Ваш готовый файл кода называется «Final», «Final, Final», «Latest Final»? Это чрезвычайно напряженный способ работы. Тот, в котором вы постоянно беспокоитесь о том, как вы сохраните свой следующий фрагмент кода, и ловите себя на том, что говорите: «Я почищу свою систему для следующего проекта». Такой способ работы затрудняет отслеживание вашего кода, изменений в файлах и повторение ваших шагов, если вам это нужно.

Когда вы обнаружите, что не можете ответить на вопросы выше или разочаровываетесь в мыслях о файловой структуре вашего кода, пришло время подумать о внедрении Системы контроля версий (VCS). В двух словах, VCS — это часть программного обеспечения, отвечающая за управление изменениями в файле. В этой статье мы обсудим, как использовать Git и GitHub в качестве нашего решения для контроля версий и как использовать их для совместной работы при работе в команде. Мы также узнаем, как установить Git, создать репозиторий GitHub или репозиторий и локально отредактировать исходный код, чтобы затем вы могли отправить его в свой репозиторий GitHub. Я бы порекомендовал вам сначала полностью прочитать эту статью, а затем следовать приведенным ниже шагам.

Начнем с понимания основ системы контроля версий (VCS).

Что такое система контроля версий?

Система контроля версий (VCS) — это программный инструмент, используемый для отслеживания изменений в ваших файлах и папках. В наших целях он используется для отслеживания файлов кода во время разработки. Система контроля версий позволяет отслеживать изменения, внесенные в файл, и при необходимости возвращаться к предыдущей версии. Это отличный способ следить за ходом проекта, особенно при работе в команде. Это также отличный способ иметь под рукой предыдущую версию вашего кода на случай, если вы полностью уничтожите свой текущий рабочий код, и вы это сделаете!

Типы систем контроля версий

Существует три типа систем контроля версий:

Локальная система контроля версий. В локальной системе контроля версий контроль версий происходит на вашем локальном компьютере, например, на компьютере, на котором вы сейчас работаете. Поэтому, если ваш локальный компьютер сломается, вы потеряете файл кода. Кроме того, если что-то пойдет не так с файлом кода, находящимся под контролем версий, если он каким-то образом будет поврежден, все версии, созданные после этой начальной версии, будут потеряны. Это происходит потому, что база данных версий создается с использованием предыдущего файла. Наконец, локальная система контроля версий не позволяет вам сотрудничать с другими разработчиками. По сути, ваша VCS находится в автономном режиме, поэтому другие члены команды не могут получить к ней доступ, если вы этого захотите.

Централизованная система контроля версий. В централизованной системе контроля версий члены вашей команды могут совместно работать над файлом кода, поскольку хранилище файлов хранится на центральном сервере. Члены группы могут получить доступ к копиям файла кода на своем локальном компьютере и вносить необходимые обновления. Недостатком этого решения является то, что в случае сбоя центрального сервера файл кода может быть потерян. Это связано с тем, что основной репозиторий файлов и история хранятся на центральном сервере, а не на локальном компьютере пользователя.

Распределенная система управления версиями —распределенная система управления версиями работает почти так же, как централизованная система управления версиями, но с некоторыми важными отличиями. Распределенная система управления версиями является распределенной, так как существует более одного сервера, на котором хранится файловый репозиторий. Другими словами, если один сервер выходит из строя, есть другой сервер, который можно использовать в качестве резервного. Кроме того, каждый соавтор, работающий над файлом кода, имеет доступ к истории его версий и может просматривать историю его прошлых изменений. Распределенная система контроля версий гарантирует, что каждый пользователь имеет доступ к копии всего репозитория файлов. Предлагаемый уровень избыточности делает распределенную систему управления версиями отличным решением для разработчиков, позволяющим хранить свой код, отслеживать изменения и делиться им с другими разработчиками.

Теперь вы понимаете основы того, что такое VCS, и различные типы, давайте взглянем на два самых популярных, Git и GitHub.

Гит

Git — это инструмент управления версиями из командной строки. Если вы новичок в командной строке, ознакомьтесь с предыдущей статьей, посвященной основам. Он был разработан в 2005 году Линусом Торвальдсом, создателем Linux. Git работает, отслеживая изменения в конкретном файле, в нашем случае файле с кодом. Git стал широко использоваться разработчиками всех языков программирования, поскольку он дает им возможность одновременно работать над небольшими фрагментами более крупного проекта. Кроме того, если требования проекта изменятся, разработчики могут легко вернуться к предыдущей версии своего кода.

При работе с Git файлы проекта или исходный код хранятся в репозитории, который часто называют «репозиторием». Репо может быть размещено онлайн или на локальном сервере.

Как обсуждалось ранее, размещение файлов на онлайн-сервере — самый безопасный способ работы. Существует несколько онлайн-хостингов, где вы можете разместить свои репозитории. Некоторые из самых популярных включают BitBucket, GitLab и GitHub. В этой статье мы обсудим GitHub.

Гитхаб

GitHub — это онлайн-платформа для разработки, которую вы можете использовать для размещения и обслуживания своих репозиториев кода. Есть несколько преимуществ использования GitHub, в том числе:

  • Отслеживание изменений в файле с помощью git
  • Слияние кода из разных версий файлов
  • Вернитесь к более старой версии вашего кода
  • Проверьте эффект от нового изменения кода, не нарушая исходный файл кода.
  • Легко делитесь файлами кода, назначайте задачи и сотрудничайте с другими разработчиками.
  • Действует как онлайн-резервная копия для ваших проектов кода

Важно отметить, что GitHub, а также GitLab и BitBucket используют Git для своих операций контроля версий. Другими словами, вам нужен Git для работы с GitHub.

Давайте установим Git.

Установка Git на вашу машину

В MacOS

Самый простой способ установить Git на ваш Mac — использовать инструмент командной строки Xcode. Откройте терминал и выполните следующую команду:

git — версия

Если на вашем компьютере установлен Git, приглашение вернет версию, которая у вас есть. Если Git не установлен, вам будет предложено установить его.

В Windows

Чтобы установить Git в Windows, загрузите его с оригинального веб-сайта Git. Перейдите на страницу загрузки здесь, щелкните соответствующую сборку системы и загрузите исполняемый файл Git для Windows. После загрузки запустите файл и нажмите Далее, пока установка не будет завершена.

В Linux

Если вы используете Ubuntu, вы можете использовать apt с помощью следующей команды:

sudo apt установить git-все

Если вы используете Fedora, вы можете использовать dnf с командой ниже:

sudo dnf установить git-все

Создание учетной записи GitHub

Если у вас есть учетная запись Github, вы можете пропустить этот раздел. Если у вас нет учетной записи, перейдите на github.com и создайте ее прямо сейчас. Нажмите Зарегистрироваться, введите свои данные и подтвердите адрес электронной почты.

Затем нам нужно подключить программное обеспечение Git, установленное на вашем локальном компьютере, к вашей учетной записи GitHub. Это позволит вам переместить или отправить код с вашего компьютера в вашу учетную запись GitHub.

Как связать Git и GitHub

Перейдите в командную строку или терминал и введите следующую команду:

git config — — global user.name «Ваше имя здесь»

git config — — глобальный user.email «[email protected]»

Обязательно замените «Ваше имя здесь» на ваше настоящее имя, а «[email protected]» — на адрес электронной почты, который вы использовали для создания учетной записи GitHub.

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

ssh-keygen -t ed25519 -C «[email protected]»

Эта строка кода сгенерирует ключ, который вам будет предложено сохранить в локальный файл, нажмите enter, это примет местоположение по умолчанию. Запомните, где вы сохранили этот файл. В расположении файла откройте id_ed25519.pub с помощью текстового редактора (не текстового процессора) и скопируйте сгенерированный ключ, он вам скоро понадобится.

Затем появится приглашение, в котором вас попросят ввести парольную фразу GitHub (пароль для входа).

Для получения документации GitHub по этому процессу нажмите здесь.

Теперь перейдите на Github и нажмите на профиль в правом верхнем углу экрана.

Нажмите «Настройки», а затем SSH и ключи GPG. Нажмите Новые ключи SSH. Дайте ключу название, а затем введите ключ, сохраненный в файле.

Наконец, нажмите Добавить ключ SSH, и все готово.

Вы можете дышать, вы связали свой автономный Git со своим онлайн-профилем GitHub. Чтобы убедиться, что все работает должным образом, перейдите в командную строку или терминал и введите следующую команду:

$ ssh -T [email protected]

Вы должны получить сообщение, в котором говорится:

Привет, имя пользователя! Вы успешно прошли аутентификацию, но Github не предоставляет доступ к оболочке.

Это пример скриншота, на котором весь процесс выглядит от начала до конца.

Если после этого вы еще не совсем устали, мы обсудим, как работать с файлами на вашем компьютере, а затем воспользуемся Git для их синхронизации с вашим профилем на GitHub.

Создание репозиториев на GitHub

Первым шагом к работе с GitHub является создание репозитория. В правом верхнем углу страницы GitHub нажмите кнопку +, а затем выберите Новый репозиторий.

Заполните имя репозитория, вы можете сделать его частным или общедоступным. Установив для него значение private, вы указываете, кому вы хотите предоставить доступ к вашему репозиторию. Если он установлен как общедоступный, любой может получить доступ к репозиторию и вашему коду. Также добавьте файл readme и лицензию. Вы можете использовать лицензию MIT. Когда вы закончите, нажмите Создать репозиторий.

В приведенном ниже примере я создал новый репозиторий под названием demo_repo. Если вы будете следовать этому примеру, у вас на экране должно появиться что-то вроде этого.

Работа с файлами с помощью команд Git

Теперь, когда мы создали репозиторий онлайн, мы можем загрузить его на наш локальный компьютер с помощью команды git clone. Для этого перейдите на свою страницу GitHub, щелкните раскрывающийся список «Код», а затем клонируйте SSH. Скопируйте URL-ссылку, как показано на изображении ниже.

Чтобы сохранить репозиторий на своем компьютере, перейдите в папку по вашему выбору (я назвал ее gitProject) и введите следующую команду:

клонировать git insert_your_github_link

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

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

Теперь давайте добавим файл в наш репозиторий. С помощью редактора кода создайте файл Python, main.py, а затем добавьте код, как показано ниже:

Внутри вашей командной строки или терминала вы можете проверить статус изменений файла с помощью команды git status, эта команда используется для проверки того, какой файл отслеживает Git. Убедитесь, что вы работаете с файлом, в котором был клонирован репозиторий, и введите следующую команду.

статус git

Как видно на скриншоте выше, Git не отслеживает новый файл, который мы создали в папке main.py. Чтобы убедиться, что git отслеживает файл, вы используете команду git add.

git добавить имя_файла

Теперь любые изменения, внесенные в файл, будут отслеживаться.

Команда git commit используется для сохранения в файл кода. Хорошей практикой является регулярное коммитирование вашего кода. Хотя Git отслеживает файл кода с помощью команды git add, он не сохраняет изменения до тех пор, пока не будет использована команда git commit.

Поток команд показан ниже.

git commit -m ‘Описание последних изменений’

-m означает сообщение. Git позволяет добавлять сообщение или описание к каждому сделанному вами коммиту. Это отлично помогает другим разработчикам понять, о чем вы думали или пытались сделать во время коммита.

Теперь давайте немного отредактируем файл и зафиксируем изменение. Чтобы убедиться, что git отслеживает файл, давайте отредактируем main.py. Я добавил комментарий в строке 3 ниже.

Затем мы снова запускаем команду git commit, чтобы сохранить изменения.

Как видно, коммит был сделан в основной ветке.

Теперь, когда у нас есть файл кода и мы закончили работу с ним, мы можем загрузить последнюю версию файла на GitHub с помощью команды git push:

git push

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

Краткое содержание

Если вы дочитали до конца эту статью, поздравляем, а теперь сделайте перерыв! Он охватывает многое, и есть вероятность, что вам придется прочитать его снова и несколько раз повторить инструкции. Но вы многому научились. Использование Git и онлайн-системы контроля версий — это то, что должен знать каждый компетентный разработчик. И теперь вы знаете:

  • что такое контроль версий
  • как работать с Git и GitHub
  • используйте команды git, такие как git status, git add, git commit и git push

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

Наконец, если вам нужно бесплатное руководство по настройке Python, нажмите здесь.

Я надеюсь, что вы нашли эту статью полезной.

Тони.