Начало работы с кодовыми инкрементами

Автотесты

Инкремент 1

Задание по треку «Сервис сокращения URL»

• Эндпоинт с методом POST и путём /. Сервер принимает в теле запроса строку URL как text/plain и возвращает ответ с кодом 201 и сокращённым URL как text/plain.
  Пример запроса к серверу:
  Скопировать кодTEXT

  POST / HTTP/1.1
  Host: localhost:8080
  Content-Type: text/plain
  
  https://practicum.yandex.ru/ 
  Пример ответа от сервера:
  Скопировать кодTEXT

  HTTP/1.1 201 Created
  Content-Type: text/plain
  Content-Length: 30
  
  http://localhost:8080/EwHXdJfB 
• Эндпоинт с методом GET и путём /{id}, где id — идентификатор сокращённого URL (например, /EwHXdJfB). В случае успешной обработки запроса сервер возвращает ответ с кодом 307 и оригинальным URL в HTTP-заголовке Location.
  Пример запроса к серверу:
  Скопировать кодTEXT

  GET /EwHXdJfB HTTP/1.1
  Host: localhost:8080
  Content-Type: text/plain 
  Пример ответа от сервера:
  Скопировать кодTEXT

  HTTP/1.1 307 Temporary Redirect
  Location: https://practicum.yandex.ru/ 

Задание по треку «Сервис сбора метрик и алертинга»

• Принимать и хранить произвольные метрики двух типов:
  • Тип gauge, float64 — новое значение должно замещать предыдущее.
  • Тип counter, int64 — новое значение должно добавляться к предыдущему, если какое-то значение уже было известно серверу.
• Принимать метрики по протоколу HTTP методом POST.
• Принимать данные в формате http://<АДРЕС_СЕРВЕРА>/update/<ТИП_МЕТРИКИ>/<ИМЯ_МЕТРИКИ>/<ЗНАЧЕНИЕ_МЕТРИКИ>, Content-Type: text/plain.
• При успешном приёме возвращать http.StatusOK.
• При попытке передать запрос без имени метрики возвращать http.StatusNotFound.
• При попытке передать запрос с некорректным типом метрики или значением возвращать http.StatusBadRequest.

POST /update/counter/someMetric/527 HTTP/1.1
Host: localhost:8080
Content-Length: 0
Content-Type: text/plain 

HTTP/1.1 200 OK
Date: Tue, 21 Feb 2023 02:51:35 GMT
Content-Length: 11
Content-Type: text/plain; charset=utf-8 

Как работать на GitHub

1. Перейдите по ссылке к шаблону репозитория:
   для трека «Сервис сокращения URL»,
   для трека «Сервис сбора метрик и алертинга».
2. Нажмите зелёную кнопку Use this template.
3. Дайте имя вашему репозиторию. При выборе названия воспользуйтесь рекомендациями с официального сайта Go.
4. Склонируйте созданный репозиторий командой git clone.
5. В корне репозитория выполните команду go mod init <name>, где <name> — адрес вашего репозитория без префикса https://, для создания модуля.
6. Перед началом выполнения инкремента создайте новую ветку. Вы можете использовать команду git checkout -b iter1, где iter1 — название ветки. Эта команда создаст новую ветку в вашем репозитории и переключит репозиторий на неё. Каждый инкремент следует выполнять в отдельной ветке.
7. Выполните задание по инкременту и проверьте командой go test отсутствие ошибок компиляции. На этом этапе локальные тесты отсутствуют, но в одном из заданий первого спринта вам предстоит их реализовать.
8. Запушьте код в репозиторий на GitHub — командами git add ., git commit -m 'текст коммита' и git push.
9. Создайте Pull Request (PR) для ветки этого инкремента. В дальнейшем создавайте отдельный PR для каждого нового инкремента.
10. Дождитесь, пока завершится проверка кода автотестами. Автотесты запускаются при открытии PR и на каждый новый коммит в текущей ветке.

11. Перед сдачей последнего инкремента на ревью убедитесь, что тесты за текущий и предыдущие инкременты успешно пройдены. Это минимальное требование для принятия работы ментором.
12. Если ваш ментор запросил изменения в работе, то после внесения правок загрузите ссылку на PR повторно — в соответствующем уроке на платформе. Только таким способом ментор сможет взять вашу работу на повторное ревью.
13. После принятия работы ментором смёржите PR в основную ветку вашего проекта — main. Таким образом в main будет находиться только код, одобренный ментором, а в новом PR для проверки — код, имплементированный в рамках сдаваемого спринта.

Приватные и публичные репозитории