dzharkov / assignments-2017-1

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Домашние задания по Java

Этот репозиторий содержит домашние задания курса Java для студентов 5го курса Академического Университета.

Процесс сдачи

  1. Вы работаете над заданием в собственном форке этого репозитория.
  2. По окончанию работы вы посылаете Pull Request с изменениями в этот репозиторий.
  • Формат названия пулл-реквеста: ДЗ <номер задания>, <фамилия и имя сдающего>, подгруппа <номер подгруппы>
  1. Pull Request автоматически собирается и тестируется на Semaphore.
  • Решение не проверяется и не засчитывается пока есть хотя бы один падающий тест
  1. После того, как все тесты на Semaphore будут пройдены, вы оставляете комментарий в пулл-реквесте о том, что решение можно проверять.
  2. Преподаватель проверяет ваше решение и, возможно, оставляет замечения, которые вам необходимо исправить, а также оповещает вас об окончании проверки комментарием в пулл-реквесте.
  3. После исправления всех замечаний вы оставляете комментарий в пулл-реквесте; далее либо повторяется пункт 5, либо, при отсутствии замечаний, решение засчитывается и выставляется оценка.
  • Решение не засчитывается если есть хотя бы одно неисправленное замечание

Сроки сдачи

  • Решение проходящее все тесты на Semaphore: до дедлайна, см. README в соответствующей ветке
  • Решение со всеми исправленными замечаниями: 1 неделя после дедлайна

Что оценивается

Как сдавать домашние задания (в первый раз)

  1. Сделайте форк этого репозитория. В дальнейшем вы будете работать с ним.
  2. Склонируйте форк к себе на компьютер
$ git clone <your-fork-url>
  1. Выберите задание над которым вы собираетесь работать:
$ git checkout <your-assignment-branch>
  1. Сделайте задание. Обыкновенно от вас будет требоваться реализовать определенный интерфейс и, возможно, написать несколько тестов для него. Подробнее смотрите в README.mkdn в ветке задания.
  2. Сохраните изменения и отправьте их на сервер:
$ git commit -m <your-message>
$ git push

Если вы посылаете ветку в первый раз, необходимо явно указать, что отправление идёт в ваш репозиторий:

$ git push -u origin <your-assignment-branch>
  1. Сделайте Pull Request в этот репозиторий. Проверьте, чтобы ветка в репозитории в которую вы делаете реквест совпадала с веткой задания над которым вы работали. О том, как сделать реквест написано здесь.
  2. При наличии падающих тестов или замечаний с нашей стороны повторите шаги 4 и 5, новый реквест делать не надо.

Как сдавать домашние задания (в последующие разы)

  1. У вас уже должен быть форк и клон форка на комьютере. Если нет, то воспользуйтесь инструкцией выше.
  2. Проверьте, что git настроен на синхронизацию с этим репозиторием:
$ git remote -v

Если вывод этой команды содержит upstream https://github.com/java-course-au/assignments-2016-1, то перейдите на шаг 4. 3. Настройте git на синхронизацию с этим репозиторием:

$ git remote add upstream https://github.com/java-course-au/assignments-2016-1
  1. Обновите свой форк:
$ git fetch upstream
  1. Выполните шаги 3-7 из инструкции выше.

Рекомендации по работе с проектом

  1. Для удобной работы с проектом установите себе на компьютер Maven (например sudo apt-get install maven)
  2. Проект можно открыть в IDE (например так)
  3. Тесты можно запускать, как из IDE, так и из консоли с помощью команды mvn test в директории проекта.
  4. Статистика покрытия тестами генерируется автоматически при запуске mvn test; ее можно посмотреть в браузере открыв файл target/site/jacoco/index.html в директории проекта

About