Changed behavior for run subcommand per @lkedwards suggestions

 --target NAME(s)  list of specific application names to execute.
                   No name is required if only one application exists.
                   If no name is supplied and more than one candidate
                   exists or a name has no match a list is produced
                   and fpm(1) exits.
                   Simple "globbing" is supported where "?" represents
                   any single character and "*" represents any string.
                   Therefore a quoted asterisk '*' runs all programs.

Author: urbanjost

fpm/src/fpm.f90

@@ -1,5 +1,5 @@
 module fpm
-use fpm_strings, only: string_t, operator(.in.)
+use fpm_strings, only: string_t, operator(.in.), glob
 use fpm_backend, only: build_package
 use fpm_command_line, only: fpm_build_settings, fpm_new_settings, &
                       fpm_run_settings, fpm_install_settings, fpm_test_settings
@@ -266,7 +266,8 @@ subroutine cmd_run(settings,test)
 
                     do j=1,size(settings%name)
 
-                        if (trim(settings%name(j))==exe_source%exe_name) then
+                        !*!if (trim(settings%name(j))==exe_source%exe_name) then
+                        if (glob(trim(exe_source%exe_name),trim(settings%name(j)))) then
 
                             found(j) = .true.
                             exe_cmd%s = exe_target%output_file
@@ -295,14 +296,19 @@ subroutine cmd_run(settings,test)
     end if
 
     ! Check all names are valid
-    if (any(.not.found)) then
-
-        write(stderr,'(A)',advance="no")'fpm::run<ERROR> specified names '
-        do j=1,size(settings%name)
-            if (.not.found(j)) write(stderr,'(A)',advance="no") '"'//trim(settings%name(j))//'" '
-        end do
-        write(stderr,'(A)') 'not found.'
-        write(stderr,*)
+    ! or no name and found more than one file
+    if ( any(.not.found) .or. (size(settings%name).eq.0 .and. size(executables).gt.1 .and. .not.test) ) then
+        if(any(.not.found))then
+           write(stderr,'(A)',advance="no")'fpm::run<ERROR> specified names '
+           do j=1,size(settings%name)
+               if (.not.found(j)) write(stderr,'(A)',advance="no") '"'//trim(settings%name(j))//'" '
+           end do
+           write(stderr,'(A)') 'not found.'
+           write(stderr,*)
+        else if(settings%verbose)then
+           write(stderr,'(A)',advance="yes")'<INFO>when more than one executable is available'
+           write(stderr,'(A)',advance="yes")'      program names must be specified.'
+        endif
 
         j = 1
         nCol = LINE_WIDTH/col_width

fpm/src/fpm_command_line.f90

@@ -698,9 +698,14 @@ subroutine set_help()
     ' "example" can be used with this subcommand.                           ', &
     '                                                                       ', &
     'OPTIONS                                                                ', &
-    ' --target NAME(s)  optional list of specific names to execute.         ', &
-    '                   The default is to run all the applications in app/  ', &
-    '                   or the programs listed in the "fpm.toml" file.      ', &
+    ' --target NAME(s)  list of specific application names to execute.      ', &
+    '                   No name is required if only one application exists. ', &
+    '                   If no name is supplied and more than one candidate  ', &
+    '                   exists or a name has no match a list is produced    ', &
+    '                   and fpm(1) exits.                                   ', &
+    '                   Simple "globbing" is supported where "?" represents ', &
+    '                   any single character and "*" represents any string. ', &
+    '                   Therefore a quoted asterisk ''*'' runs all programs.  ', &
     ' --example  run example programs instead of applications               ', &
     ' --release  selects the optimized build instead of the debug           ', &
     '            build.                                                     ', &
@@ -717,16 +722,16 @@ subroutine set_help()
     'EXAMPLES                                                               ', &
     ' fpm(1) "run" project applications                                     ', &
     '                                                                       ', &
-    '  # run default programs in /app or as specified in "fpm.toml"         ', &
-    '  fpm run                                                              ', &
+    '  # run all default programs in /app or as specified in "fpm.toml"     ', &
+    '  fpm run ''*''                                                          ', &
     '                                                                       ', &
-    '  # run default programs in /app or as specified in "fpm.toml"         ', &
-    '  # using the compiler command "f90".                                  ', &
+    '  # run default program using the compiler command "f90". If more      ', &
+    '  # than one app exists a list displays and names must be specified.   ', &
     '  fpm run --compiler f90                                               ', &
     '                                                                       ', &
-    '  # run example and demonstration programs instead of the default      ', &
-    '  # application programs (specified in "fpm.toml")                     ', &
-    '  fpm run --example                                                    ', &
+    '  # run example demonstration programs instead of the application      ', &
+    '  # programs ( defaults can be overridden in "fpm.toml").              ', &
+    '  fpm run --example ''*''                                                ', &
     '                                                                       ', &
     '  # run a specific program and pass arguments to the command           ', &
     '  fpm run mytest -- -x 10 -y 20 --title "my title line"                ', &
@@ -756,7 +761,7 @@ subroutine set_help()
     '    o src/     for modules and procedure source                        ', &
     '    o app/     main program(s) for applications                        ', &
     '    o test/    main program(s) and support files for project tests     ', &
-    '    o example/ main program(s) for examples and demonstrations         ', &
+    '    o example/ main program(s) for example programs                    ', &
     ' Changed or new files found are rebuilt. The results are placed in     ', &
     ' the build/ directory.                                                 ', &
     '                                                                       ', &