Init commit

materials/instructions_for_testing_rus.md

@@ -0,0 +1,67 @@
+# Инструкция по запуску тестов.
+
+Помимо тестов на корректные выходные данные система автотестирования будет проверять вашу программу и ее исходный код по
+следующим пунктам:
+
+* **Стилевые тесты.** Чтобы проверить, насколько красота вашего кода соответствует стандартам, вы можете протестировать
+  ваш код с помощью утилиты _clang-format_. В папке ```materials/linters``` лежит файл ```.clang-format```, который
+  содержит необходимые настройки для стилевого теста. Данный конфигурационный файл распространяет свое действие на все
+  файлы, которые лежат с ним в директории или в директориях ниже. Поэтому, чтобы данные настройки применились к вашим
+  файлам с исходным кодом, скопируйте ```.clang-format``` в папку ```src```. \
+  \
+  Чтобы запустить проверку на стиль, выполните следующую команду: \
+  ```clang-format -n src/sourcefile_name.c``` \
+  \
+  Чтобы скачать _clang-format_, введите в терминал одну из следующих команд: \
+  ```brew install clang-format``` \
+  или, если у вас есть root-права (для Ubuntu / Linux Mint / Debian) \
+  ```sudo apt install clang-format```
+
+  Необходимая версия clang-format: \
+  **Mac** 14.0.5 \
+  **Linux** 13.0.1
+
+  Google Style: https://google.github.io/styleguide/cppguide.html
+
+
+* **Тест на корректную работу с памятью.** При написании C-программ очень важно следить за утечками памяти. Для этого в
+  Unix-подобных операционных системах довольно часто используют утилиту _valgrind_. Однако, на OS X имеются проблемы с
+  поддержкой _valgrind_, поэтому вместо нее можно использовать утилиту _leaks_. Вдаваться в механизм работы этих утилит
+  мы сейчас не будем — если интересно, можете почитать в гугле.
+
+  **_LEAKS_**
+
+  Чтобы запустить ваш исполняемый файл с помощью этой утилиты, наберите в терминале: \
+  ```leaks -atExit -- ./main.out | grep LEAK:```
+
+  Обратите внимание на команду ```| grep LEAK:```. Мы используем ее для короткого вывода, чтобы видеть только линии с
+  утечками, если они есть. Если вы хотите увидеть весь вывод, просто удалите эту команду.
+
+  При запуске исполняемого файла с помощью _leaks_ может появиться сообщение об ошибке:
+  > dyld: could not load inserted library ‘/usr/local/lib/libLeaksAtExit.dylib’ because image not found
+
+  Ошибка возникает из-за того, что _leaks_ не может найти библиотеку _libLeaksAtExit.dylib_. \
+  В этом случае вам необходимо ввести следующие команды:
+  ```sh
+  cd /usr/local/lib  
+  sudo ln -s /Applications/Xcode.app/Contents/Developer/usr/lib/libLeaksAtExit.dylib
+  ```
+
+  _Дополнительно:_ \
+  Используйте флаг ```-exclude``` утилиты _leaks_ для того, чтобы отфильтровать утечки в функциях, где известно об
+  утечках памяти. Этот флаг позволяет уменьшить количество посторонней информации, сообщаемой _leaks_.
+
+  **_VALGRIND_**
+
+  Чтобы установить _valgrind_ на компьютер, введите одну из следующих команд: \
+  ```brew install valgrind``` \
+  или, если у вас есть root-права (для Ubuntu / Linux Mint / Debian) \
+  ```sudo apt install valgrind``` \
+  Чтобы запустить ваш исполняемый файл с помощью этой утилиты, наберите в терминале: \
+  ```valgrind --tool=memcheck --leak-check=yes  ./main.out```
+
+  Не рекомендуется использовать _valgrind_ на OS X, вместо нее лучше использовать _leaks_.
+
+* **Тест сборки.** Программу можно проверить на корректность сборки на тестовой системе. Для этого потребуется
+  установленный _Docker_. Если на системе есть докер, то можно зайти в директорию `materials/build` и запустить оттуда
+  скрипт run.sh. Скрипт обернет ваше решение в докер и запустит его вместе с типовым сценарием сборки.