Я немного использовал rake (программу Ruby make), и у нее есть возможность получить список всех доступных целей, например

> rake --tasks
rake db:charset      # retrieve the charset for your data...
rake db:collation    # retrieve the collation for your da...
rake db:create       # Creates the databases defined in y...
rake db:drop         # Drops the database for your curren...
...

но, кажется, нет никакой возможности сделать это в GNU make.

Похоже, код почти готов для этого, по состоянию на 2007 год - http://www.mail-archive.com/help-make@gnu.org/msg06434.html .

В любом случае, я немного взломал, чтобы извлечь цели из make-файла, который вы можете включить в make-файл.

list:
    @grep '^[^#[:space:]].*:' Makefile

Это даст вам список определенных целей. Это только начало - например, оно не отфильтровывает зависимости.

> make list
list:
copy:
run:
plot:
turnin:

Это попытка улучшить отличный подход @ nobar следующим образом:

• использует более надежную команду для извлечения целевых имен, которая, как мы надеемся, предотвращает любые ложные срабатывания (а также устраняет ненужные sh -c)
• не всегда нацеливается на make-файл в текущем каталоге; уважает make-файлы, явно указанные с-f <file>
• исключает скрытые цели - по договоренности, это цели, имя которых не начинается ни с буквы, ни с цифры
• справляется с одной фальшивой целью
• добавляет к команде префикс, @чтобы предотвратить его отображение перед выполнением

Любопытно, что в GNU makeнет возможности перечислять только имена целей, определенных в make-файле. -pОпция производит вывод , который включает в себя все цели, но хоронит их в много другой информации.

Поместите следующее правило в make-файл для GNU, makeчтобы реализовать именованную цель, listкоторая просто перечисляет все имена целей в алфавитном порядке - то есть: invoke asmake list :

.PHONY: list
list:
    @$(MAKE) -pRrq -f $(lastword $(MAKEFILE_LIST)) : 2>/dev/null | awk -v RS= -F: '/^# File/,/^# Finished Make data base/ {if ($$1 !~ "^[#.]") {print $$1}}' | sort | egrep -v -e '^[^[:alnum:]]' -e '^$@$$'

Важно : вставив это, убедитесь, что последняя строка имеет ровно 1 фактический символ табуляции. (пробелы не работают) .

Обратите внимание, что сортировка результирующего списка целей является наилучшим вариантом, поскольку не сортировка не создает полезного порядка в том порядке, в котором порядок появления целей в make-файле не сохраняется.
Кроме того, подцели правила, состоящего из нескольких целей, неизменно выводятся по отдельности и, следовательно, из-за сортировки обычно не появляются рядом друг с другом; Например, правило, начинающееся с a z:, не будет иметь целей aи zперечисляться рядом друг с другом в выходных данных, если есть дополнительные цели.

Объяснение правила :

• ,PHONY: list
  • объявляет список целей фальшивой целью, т.е. не ссылающейся на файл , поэтому его рецепт должен вызываться безоговорочно

• $(MAKE) -pRrq -f $(lastword $(MAKEFILE_LIST)) : 2>/dev/null

  • Вызывается makeснова, чтобы распечатать и проанализировать базу данных, полученную из make-файла:
    • -p печатает базу данных
    • -Rr подавляет включение встроенных правил и переменных
    • -qтолько проверяет текущее состояние цели (не переделывая ничего), но это само по себе не препятствует выполнению команд рецепта во всех случаях; следовательно:
    • -f $(lastword $(MAKEFILE_LIST))гарантирует, что тот же make-файл нацелен как на исходный вызов, независимо от того, был ли он нацелен неявно или явно -f ....
      Предостережение : это сломается, если ваш make-файл содержит includeдирективы; чтобы решить эту проблему, определите переменную THIS_FILE := $(lastword $(MAKEFILE_LIST)) перед любымinclude директивами и используйте -f $(THIS_FILE)вместо нее.
    • :является намеренно недействительной целью, которая предназначена для обеспечения того, чтобы никакие команды не выполнялись ; 2>/dev/nullподавляет полученное сообщение об ошибке. Примечание. -pТем не менее, это зависит от печати базы данных, которая имеет место в GNU make 3.82. К сожалению, GNU Make предлагает не прямой вариант , чтобы просто распечатать базу данных, без также выполнения по умолчанию (или заданной) задачи; если вам не нужен целевой Makefile, вы можете использовать его make -p -f/dev/null, как рекомендуется на manстранице.

• -v RS=

  • Это идиома awk, которая разбивает ввод на блоки непрерывных непустых строк.
• /^# File/,/^# Finished Make data base/
  • Соответствует диапазону строк в выходных данных, которые содержат все цели (истинно для GNU make 3.82) - ограничивая синтаксический анализ этим диапазоном, нет необходимости иметь дело с ложными срабатываниями из других выходных секций.
• if ($$1 !~ "^[#.]")
  • Выборочно игнорирует блоки:
    • # ... игнорирует нецелевые объекты, чьи блоки начинаются с # Not a target:
    • . ... игнорирует специальные цели
  • Все остальные блоки должны начинаться со строки, содержащей только имя явно определенной цели, за которой следует :
• egrep -v -e '^[^[:alnum:]]' -e '^$@$$' удаляет нежелательные цели из вывода:
  • '^[^[:alnum:]]'... исключает скрытые цели, которые, по соглашению, являются целями, которые не начинаются ни с буквы, ни с цифры.
  • '^$@$$'... исключает listсаму цель

Запуск make listзатем печатает все цели, каждая на своей линии; xargsвместо этого вы можете создать список, разделенный пробелами.

Под Bash (по крайней мере) это можно сделать автоматически с завершением табуляции:

make spacetabtab

Это, очевидно, не будет работать во многих случаях, но если ваш Makefileбыл создан CMake, вы могли бы запустить make help.

$ make help
The following are some of the valid targets for this Makefile:
... all (the default if no target is provided)
... clean
... depend
... install
etc

Я объединил эти два ответа: https://stackoverflow.com/a/9524878/86967 и https://stackoverflow.com/a/7390874/86967 и сделал несколько экранировок, чтобы их можно было использовать из make-файла.

.PHONY: no_targets__ list
no_targets__:
list:
    sh -c "$(MAKE) -p no_targets__ | awk -F':' '/^[a-zA-Z0-9][^\$$#\/\\t=]*:([^=]|$$)/ {split(\$$1,A,/ /);for(i in A)print A[i]}' | grep -v '__\$$' | sort"

,

$ make -s list
build
clean
default
distclean
doc
fresh
install
list
makefile ## this is kind of extraneous, but whatever...
run

Если у вас есть makeустановленное завершение bash , скрипт завершения определит функцию _make_target_extract_script. Эта функция предназначена для создания sedсценария, который можно использовать для получения целей в виде списка.

Используйте это так:

# Make sure bash completion is enabled
source /etc/bash_completion 

# List targets from Makefile
sed -nrf <(_make_target_extract_script --) Makefile

Как указывает mklement0 , в GNU-make отсутствует функция для перечисления всех целей Makefile, и его ответ и другие вопросы предоставляют способы сделать это.

Тем не менее, в оригинальном посте также упоминается рейк , чей переключатель задач делает что-то немного отличное от простого перечисления всех задач в rakefile. Rake предоставит вам только список задач, с которыми связаны описания. Задачи без описания не будут перечислены . Это дает автору возможность предоставлять настраиваемые описания справки, а также опускать справку для определенных целей.

Если вы хотите эмулировать поведение рейка, когда вы предоставляете описания для каждой цели , для этого есть простой метод: вставлять описания в комментарии для каждой цели, которую вы хотите перечислить.

Вы можете поместить описание рядом с целью или, как я часто это делаю, рядом со спецификацией PHONY над целью, например:

.PHONY: target1 # Target 1 help text
target1: deps
    [... target 1 build commands]

.PHONY: target2 # Target 2 help text
target2:
    [... target 2 build commands]

...                                                                                                         

.PHONY: help # Generate list of targets with descriptions                                                                
help:                                                                                                                    
    @grep '^.PHONY: .* #' Makefile | sed 's/\.PHONY: \(.*\) # \(.*\)/\1 \2/' | expand -t20

Который даст

$ make help
target1             Target 1 help text
target2             Target 2 help text

...
help                Generate list of targets with descriptions

Вы также можете найти краткий пример кода в этом и здесь .

Опять же, это не решает проблему перечисления всех целей в Makefile. Например, если у вас есть большой Makefile, который, возможно, был сгенерирован или кто-то другой написал, и вы хотите быстрый способ перечислить свои цели, не просматривая его, это не поможет.

Однако, если вы пишете Makefile и вам нужен способ генерировать текст справки согласованным, самодокументируемым способом, этот метод может оказаться полезным.

Мой любимый ответ на это был опубликован Крисом Дауном в Unix & Linux Stack Exchange. Я процитирую

Вот как модуль завершения bash makeполучает свой список:

make -qp | awk -F':' '/^[a-zA-Z0-9][^$#\/\t=]*:([^=]|$)/ {split($1,A,/ /);for(i in A)print A[i]}'

Он выводит список целей, разделенных символом новой строки, без разбивки на страницы.

Пользователь Brainstone предлагает использовать трубопровод sort -uдля удаления повторяющихся записей:

make -qp | awk -F':' '/^[a-zA-Z0-9][^$#\/\t=]*:([^=]|$)/ {split($1,A,/ /);for(i in A)print A[i]}' | sort -u

Источник: Как перечислить все цели в make? (Unix & Linux SE)

Ответ @ nobar показывает, как использовать завершение табуляции для вывода списка целей make-файла .

• Это прекрасно работает для платформ, которые предоставляют эту функциональность по умолчанию (например, Debian, Fedora ).

• На других платформах (например, Ubuntu ) вы должны явно загрузить эту функциональность, как подразумевается в ответе @ hek2mgl :

  • . /etc/bash_completion устанавливает несколько функций завершения табуляции, в том числе для make
  • Кроме того, чтобы установить только вкладку завершения для make:
    • . /usr/share/bash-completion/completions/make

• Для платформ, которые вообще не предлагают эту функциональность , таких как OSX , вы можете использовать следующие команды (адаптированные здесь ) для ее реализации:

_complete_make() { COMPREPLY=($(compgen -W "$(make -pRrq : 2>/dev/null | awk -v RS= -F: '/^# File/,/^# Finished Make data base/ {if ($1 !~ "^[#.]") {print $1}}' | egrep -v '^[^[:alnum:]]' | sort | xargs)" -- "${COMP_WORDS[$COMP_CWORD]}")); }
complete -F _complete_make make

• Примечание: это не так сложно, как функциональность дополнения табуляции, которая поставляется с дистрибутивами Linux: в первую очередь это неизменно предназначается для make-файла в текущем каталоге , даже если командная строка предназначается для другого make-файла с -f <file>.

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

help:
    @grep -B1 -E "^[a-zA-Z0-9_-]+\:([^\=]|$$)" Makefile \
     | grep -v -- -- \
     | sed 'N;s/\n/###/' \
     | sed -n 's/^#: \(.*\)###\(.*\):.*/\2###\1/p' \
     | column -t  -s '###'


#: Starts the container stack
up: a b
  command

#: Pulls in new container images
pull: c d 
    another command

make-target-not-shown:

# this does not count as a description, so leaving
# your implementation comments alone, e.g TODOs
also-not-shown:

Так что, рассматривая вышесказанное как Makefile и запустив его, вы получите что-то вроде

> make help
up          Starts the container stack
pull        Pulls in new container images

Пояснение к цепочке команд:

• Сначала выполните поиск всех целей и их предыдущей строки, см. Https://unix.stackexchange.com/a/320709/223029 .
• Затем избавьтесь от разделителя групп, см. Https://stackoverflow.com/a/2168139/1242922 .
• Затем мы свернем каждую пару строк, чтобы проанализировать ее позже, см. Https://stackoverflow.com/a/9605559/1242922 .
• Затем мы анализируем правильные строки и удаляем те, которые не совпадают, см. Https://stackoverflow.com/a/8255627/1242922 , а также задаем вывод в желаемом порядке: команда, затем описание.
• Наконец, мы организуем вывод в виде таблицы.

Здесь много работоспособных решений, но, как мне нравится говорить, «если это стоит сделать один раз, то стоит сделать снова». Я высказал предположение о предложении использования (вкладка) (вкладка), но, как некоторые отмечали, у вас может не быть поддержки завершения, или, если у вас много включаемых файлов, вы можете захотеть более простой способ узнать, где определена цель.

Я не проверял нижеприведенное с суб-марками ... Я думаю, что это не сработает. Как известно, рекурсивный делает вредным.

.PHONY: list ls
ls list :
    @# search all include files for targets.
    @# ... excluding special targets, and output dynamic rule definitions unresolved.
    @for inc in $(MAKEFILE_LIST); do \
    echo ' =' $$inc '= '; \
    grep -Eo '^[^\.#[:blank:]]+.*:.*' $$inc | grep -v ':=' | \
    cut -f 1 | sort | sed 's/.*/  &/' | sed -n 's/:.*$$//p' | \
    tr $$ \\\ | tr $(open_paren) % | tr $(close_paren) % \
; done

# to get around escaping limitations:
open_paren := \(
close_paren := \)

Что мне нравится, потому что:

• список целей по включаемому файлу.
• вывести необработанные динамические целевые определения (заменяет разделители переменных по модулю)
• выводить каждую цель на новой строке
• кажется более понятным (субъективное мнение)

Объяснение:

• файл foreach в MAKEFILE_LIST
• выведите имя файла
• строки grep, содержащие двоеточие, которые не имеют отступов, не являются комментариями и не начинаются с точки
• исключить выражения непосредственного присваивания (: =)
• вырезать, сортировать, делать отступы и рубить зависимости правил (после двоеточия)
• переменные Munge для ограничения расширения

Пример вывода:

 = Makefile = 
  includes
  ls list
 = util/kiss/snapshots.mk = 
  rotate-db-snapshots
  rotate-file-snapshots
  snap-db
  snap-files
  snapshot
 = util/kiss/main.mk = 
  dirs
  install
   %MK_DIR_PREFIX%env-config.php
   %MK_DIR_PREFIX%../srdb

Это было полезно для меня, потому что я хотел видеть цели сборки, требуемые (и их зависимости) целью make. Я знаю, что создание целей не может начинаться с "." персонаж. Я не знаю, какие языки поддерживаются, поэтому я использовал скобочные выражения egrep.

cat Makefile | egrep "^[[:alnum:][:punct:]]{0,}:[[:space:]]{0,}[[:alnum:][:punct:][:space:]]{0,}$"

Это далеко не чисто, но сделал работу для меня.

make -p 2&>/dev/null | grep -A 100000 "# Files" | grep -v "^$" | grep -v "^\(\s\|#\|\.\)" | grep -v "Makefile:" | cut -d ":" -f 1

Я использую make -pэтот дамп внутренней базы данных, ditch stderr, использую быструю и грязную информацию, grep -A 100000чтобы сохранить нижнюю часть вывода. Затем я очищаю вывод парой grep -vи, наконец, использую, cutчтобы получить то, что находится перед двоеточием, а именно цели.

Этого достаточно для моих вспомогательных скриптов на большинстве моих Makefiles.

РЕДАКТИРОВАТЬ: добавил, grep -v Makefileчто это внутреннее правило

Это изменение очень полезного ответа jsp ( https://stackoverflow.com/a/45843594/814145 ). Мне нравится идея получить не только список целей, но и их описание. Makefile jsp помещает описание в качестве комментария, который, как я обнаружил, часто повторяется в команде echo description the description. Поэтому вместо этого я извлекаю описание из команды echo для каждой цели.

Пример Makefile:

.PHONY: all
all: build
        : "same as 'make build'"

.PHONY: build
build:
        @echo "Build the project"

.PHONY: clean
clean:
        @echo "Clean the project"

.PHONY: help
help:
        @echo -n "Common make targets"
        @echo ":"
        @cat Makefile | sed -n '/^\.PHONY: / h; /\(^\t@*echo\|^\t:\)/ {H; x; /PHONY/ s/.PHONY: \(.*\)\n.*"\(.*\)"/    make \1\t\2/p; d; x}'| sort -k2,2 |expand -t 20

Выход make help:

$ make help
Common make targets:
    make all        same as 'make build'
    make build      Build the project
    make clean      Clean the project
    make help       Common make targets

Ноты:

• То же Jsp ответ «s, только Фиктивные цели могут быть перечислены, которые могут или не могут работать для вашего случая
• Кроме того, в нем перечислены только те цели PHONY, которые имеют команду echoили :в качестве первой команды рецепта. :означает «ничего не делать». Я использую это здесь для тех целей, которые не нужны эхо, такие какall цель выше.
• Есть дополнительная хитрость для helpцели, чтобы добавить «:» в make helpвывод.

Еще один дополнительный ответ на выше.

протестировано на MacOSX с использованием только cat и awk на терминале

cat Makefile | awk '!/SHELL/ && /^[A-z]/ {print $1}' | awk '{print substr($0, 1, length($0)-1)}'

будет вывод файла make, как показано ниже:

target1

target2

target3

в Makefile это должен быть тот же оператор, убедитесь, что вы экранируете переменные, используя переменную $$, а не переменную $.

объяснение

кошка - выплевывает содержимое

| - труба анализирует вывод на следующий awk

awk - запускает регулярное выражение, исключая "shell" и принимая только строки "Az", затем выводит первый столбец за $ 1

awk - еще раз удаляет последний символ ":" из списка

это грубый вывод, и вы можете делать более интересные вещи с помощью только AWK. Старайтесь избегать sed, поскольку он не так согласован в вариантах BSD, т.е. некоторые из них работают на * nix, но не работают на BSD, таких как MacOSX.

Больше

Вы должны иметь возможность добавить это (с изменениями) в файл для make , в папку завершения bash по умолчанию /usr/local/etc/bash-completion.d/, что означает, что когда вы «сделаете вкладку вкладки » ... она завершит цели основаны на сценарии с одним вкладышем.

Я обычно делаю:

grep install_targets Makefile

Это вернулось бы с чем-то вроде:

install_targets = install-xxx1 install-xxx2 ... etc

надеюсь, это поможет

Для сценария Bash

Вот очень простой способ сделать это на bashоснове комментария @ cibercitizen1 выше :

grep : Makefile | awk -F: '/^[^.]/ {print $1;}'

Смотрите также более авторитетный ответ от @ Marc.2377, в котором говорится, как это makeделает модуль завершения Bash .

не уверен, почему предыдущий ответ был таким сложным:

list:
    cat Makefile | grep "^[A-z]" | awk '{print $$1}' | sed "s/://g"