Skip to main content

Конференции

Просмотр конференции fido7.ru.php:

Предыдущее Следующее

Дата: 14 Nov 2017, 01:00:44
От: Mithgol the Webmaster @ 2:50/88.0
Кому: Oleg Redut
Тема: Смыслы файлов


Так было 14:13 23 Oct 17 написано от Oleg Redut к Roman Danilov:

 OR>     И всё замусорено скрытыми каталогами и всякими
 OR> .gitignore .travis.yml CHANGELOG.md composer.json LICENSE
 OR> phpunit.xml.dist
 OR> README.md

Думаю, что это не мусор: каждый из этих файлов реально полезен.

Файл .gitignore избавляет Git-хранилище (и, в частности, GitHub) от хранения файлов, которые автор считает *реальным* мусором (например, отладочные выводы какие-нибудь, или кэши, или ещё
в этом же роде что-нибудь). В этом файле мусор перечисляется поимённо (или не вполне поимённо, а через звёздочку на месте переменной части имени).

Файл .travis.yml хранит те настройки, с которыми на сервере https://travis-ci.org/ автозапускается тестирование кода пакета. Они содержат, по меньшей мере, указание тестируемого языка (PHP) ── ещё
там возможна донастройка параметров вызова используемого средства отладки (PHPUnit), но только если автор пакета не был доволен теми настройками, с какими Travis CI сам по умолчанию запускает PHPUnit
(эти настройки для удобства по адресу https://docs.travis-ci.com/user/languages/php/#Default-Build-Script перечислены).

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

Файл composer.json содержит, по-видимому, настройки для правильной работы Composer.

Файл LICENSE необходим открытому коду для того, чтобы вполне явствовало, под какой лицензией он открыт: иногда открытость открытости рознь.

Файл README.md содержит описание пакета.

Файл phpunit.xml.dist, как это на странице https://phpunit.de/manual/current/en/organizing-tests.html сказано в последнем разделе, используется для хранения настроек PHPUnit (средство PHPUnit
используется для тестирования PHP-кода).


Фидонет будет великим и гипертекстовым!    [Ru.Mozilla]     http://Mithgol.Ru/
Mithgol the Webmaster.                    [Братство Нод] [Team А я меняю subj]

... Q: Why did the Cyclops stop teaching?            A: He only had one pupil.

--- Нет таких игр. http://bash.im/comics/20081210
Origin: Пусть прежних жизней прах и тлен сгорает, как ацетилен! (2:50/88)

Предыдущее Следующее

К списку сообщений
К списку конференций