Создание модуля raku для загрузки zef
Я создал новый модуль Raku и загрузил его с помощью fez, все работает нормально.
dist.ini в верхнем каталоге. Есть такие директивы, как ReadmeFromPOD, которые, похоже, ничего не делают. Этот файл еще нужен? Кажется, это устаревшая проблема с модулями perl для CPAN.
Ответы 2
Обычно вам не нужен файл dist.ini в модуле raku.
Используете ли вы автоматический инструмент для инициализации или подготовки модуля перед использованием fez? Если да, то я бы проверил источник этого инструмента, чтобы понять, почему он создает dist.ini.
Надеюсь, ответ Лиз объяснит вам, что происходит. Те файлы dist.ini, которые вы видели, вероятно, были в дистрибутивах, созданных с помощью популярного инструмента разработки дистрибутивов Mi6. Да, неудобно вручную создавать фрагменты дистрибутива, которые можно сгенерировать автоматически — отсюда и такие инструменты, как Mi6. Похоже, вы тоже должны использовать его. И, может быть, создать проблему для репозитория Mi6, предложив изменить комментарий ; dist.ini в начале файла dist.ini на что-то вроде ; dist.ini (See https://github.com/skaji/mi6), чтобы указать новичкам / карго-культистам правильное направление?
Файл dist.ini используется App::Mi6.
Это не наследие.
Установите App::Mi6, и вы получите инструмент, который автоматически создаст для вас README.md из доступного модуля.
И он также выпустит ваш модуль в экосистему Raku, если вы правильно настроили свои учетные данные.
В основном цикл такой:
mi6 new Foo::Bar
cd Foo-Bar
vi lib/Foo/Bar.rakumod # make your module
vi t/01-basic.rakutest # update tests
vi Changes # add message describing changes
mi6 build # build the README.md among other things
mi6 test # run the tests
mi6 release # release the module to the ecosystem
Спасибо за информацию. Попробую через mi6. Здесь это вообще не упоминается: docs.raku.org/language/modules#Modules
kim — App::Mi6 — самый популярный «помощник» для создания модулей раку. Я прошу прощения за то, что не проверил, что он генерирует dist.ini (и я понимаю, что это должно быть сделано по уважительным причинам), НО я не уверен, что документ, который вы упомянули, «должен» ссылаться на App:: Mi6, поскольку это не требование дистрибутива модуля raku, и это модуль, предоставленный внешним автором. Возможно, было бы лучше сказать «вы можете использовать такой инструмент, как App::Mi6» в документации. Я предлагаю вам опубликовать это как проблему улучшения документа (есть ссылка на странице документа)
Не используя инструмент для установки, я создал dist.ini, как я видел его во многих других дистрибутивах. Кажется неудобным вручную создавать файл Readme.MD. Было бы неплохо, если бы его можно было сгенерировать из моего файла Module.rakudoc.