Statistics
| Branch: | Tag: | Revision:

amiro-blt / tools / ide / QtCreator / QtCreatorSetup.sh @ 01c0bf56

History | View | Annotate | Download (25.881 KB)

1
################################################################################
2
# AMiRo-BLT is an bootloader and toolchain designed for the Autonomous Mini    #
3
# Robot (AMiRo) platform.                                                      #
4
# Copyright (C) 2016..2020  Thomas Schöpping et al.                            #
5
#                                                                              #
6
# This program is free software: you can redistribute it and/or modify         #
7
# it under the terms of the GNU General Public License as published by         #
8
# the Free Software Foundation, either version 3 of the License, or            #
9
# (at your option) any later version.                                          #
10
#                                                                              #
11
# This program is distributed in the hope that it will be useful,              #
12
# but WITHOUT ANY WARRANTY; without even the implied warranty of               #
13
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                #
14
# GNU General Public License for more details.                                 #
15
#                                                                              #
16
# You should have received a copy of the GNU General Public License            #
17
# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
18
#                                                                              #
19
# This research/work was supported by the Cluster of Excellence Cognitive      #
20
# Interaction Technology 'CITEC' (EXC 277) at Bielefeld University, which is   #
21
# funded by the German Research Foundation (DFG).                              #
22
################################################################################
23

    
24
#!/bin/bash
25

    
26
# load library
27
source "$(dirname ${BASH_SOURCE[0]})/../../bash/setuplib.sh"
28

    
29
### print welcome text #########################################################
30
# Prints a welcome message to standard out.
31
#
32
# usage:      printWelcomeText
33
# arguments:  n/a
34
# return:     n/a
35
#
36
function printWelcomeText {
37
  printf "######################################################################\n"
38
  printf "#                                                                    #\n"
39
  printf "#                  Welcome to the QtCreator setup!                   #\n"
40
  printf "#                                                                    #\n"
41
  printf "######################################################################\n"
42
  printf "#                                                                    #\n"
43
  printf "# Copyright (c) 2016..2020  Thomas Schöpping                         #\n"
44
  printf "#                                                                    #\n"
45
  printf "# This is free software; see the source for copying conditions.      #\n"
46
  printf "# There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR  #\n"
47
  printf "# A PARTICULAR PURPOSE. The development of this software was         #\n"
48
  printf "# supported by the Excellence Cluster EXC 227 Cognitive Interaction  #\n"
49
  printf "# Technology. The Excellence Cluster EXC 227 is a grant of the       #\n"
50
  printf "# Deutsche Forschungsgemeinschaft (DFG) in the context of the German #\n"
51
  printf "# Excellence Initiative.                                             #\n"
52
  printf "#                                                                    #\n"
53
  printf "######################################################################\n"
54
}
55

    
56
### print help #################################################################
57
# Prints a help text to standard out.
58
#
59
# usage:      printHelp
60
# arguments:  n/a
61
# return:     n/a
62
#
63
function printHelp {
64
  printInfo "printing help text\n"
65
  printf "usage:    $(basename ${BASH_SOURCE[0]}) [-h|--help] [--module=<module>] [-a|--all] [-c|--clean] [-w|--wipe] [-q|--quit] [--log=<file>]\n"
66
  printf "\n"
67
  printf "options:  -h, --help\n"
68
  printf "              Print this help text.\n"
69
  printf "          --module=<module>\n"
70
  printf "              Create project for a single module.\n"
71
  printf "          -a, --all\n"
72
  printf "              Create projects for all modules.\n"
73
  printf "          -c, --clean\n"
74
  printf "              Delete project files.\n"
75
  printf "          -w, --wipe\n"
76
  printf "              Delete project and .user files.\n"
77
  printf "          -q, --quit\n"
78
  printf "              Quit the script.\n"
79
  printf "          --log=<file>\n"
80
  printf "              Specify a log file.\n"
81
}
82

    
83
### read directory where to create/delete projects #############################
84
# Read the directory where to create/delete project files from user.
85
#
86
# usage:      getProjectDir <pathvar>
87
# arguments:  <pathvar>
88
#                 Variable to store the selected path to.
89
# return:     n/a
90
#
91
function getProjectDir {
92
  printLog "reading path for project files from user...\n"
93
  local amirobltdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../Target/)
94
  local input=""
95
  read -p "Path where to create/delete project files: " -i $amirobltdir -e input
96
  printLog "user selected path $(realpath $input)\n"
97
  eval $1="$(realpath $input)"
98
}
99

    
100
### retrieves the ARM-NONE-EABI-GCC include directory ##########################
101
# Retrieves the include directory of the currently set arm-none-eabi-gcc.
102
#
103
# usage:      retrieveGccIncludeDir <path>
104
# arguments:  <path>
105
#                 Variable to store the path to.
106
# return:    0
107
#                 No error or warning occurred.
108
#            -1
109
#                 Error: Command 'arm-none-eabi-gcc' not found.
110
#            -2
111
#                 Error: include directory could not be resolved
112
#
113
function retrieveGccIncludeDir {
114
  # retrieve binary path or link
115
  local binpath=$(which arm-none-eabi-gcc)
116
  local gccincpath=""
117
  if [ -z "$binpath" ]; then
118
    printError "command 'arm-none-eabi-gcc' not found\n"
119
    return -1
120
  else 
121

    
122
    # traverse any links
123
    while [ -L "$binpath" ]; do
124
      binpath=$(realpath $(dirname $binpath)/$(readlink $binpath))
125
    done
126
    printInfo "gcc-arm-none-eabi detected: $binpath\n"
127

    
128
    # return include path
129
    gccincpath=$(realpath $(dirname ${binpath})/../arm-none-eabi/include/)
130
    if [ ! -d "$gccincpath" ]; then
131
      printWarning "$gccincpath does not exist\n"
132
      return -2
133
    else
134
      eval $1="$gccincpath"
135
      return 0
136
    fi
137
  fi
138
}
139

    
140
### detect available modules ###################################################
141
# Detect all avalable modules supported by AMiRo-OS.
142
#
143
# usage:      detectModules <modulearray>
144
# arguments:  <modulearray>
145
#                 Array variable to store all detected modules to.
146
# return:     n/a
147
#
148
function detectModules {
149
  local modulesdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../Target/Modules)
150
  local modules_detected=()
151

    
152
  # detect all available modules (via directories)
153
  for dir in $(ls -d ${modulesdir}/*/); do
154
    modules_detected[${#modules_detected[@]}]=$(basename $dir)
155
  done
156

    
157
  # set the output variable
158
  eval "$1=(${modules_detected[*]})"
159
}
160

    
161
### create project files for a single module ###################################
162
# Create project files for a single module.
163
#
164
# usage:      createModuleProject <modules> [-m|--module=<module>] [-p|--path=<path>] [--gcc=<path>] [-o|--out=<var>] [--gccout=<var>]
165
# arguments:  <modules>
166
#                 Array containing all modules available.
167
#             -m, --module <module>
168
#                 Name (folder name) of the module for which project files shall be generated.
169
#             -p, --path <path>
170
#                 Path where to create the project files.
171
#             --gcc=<path>
172
#                 Path to the GCC include directory.
173
#             -o, --out <var>
174
#                 Variable to store the path to.
175
#             --gccout=<var>
176
#                 Variable to store the path to the GCC include directory to.
177
#                 If this optional arguments is absent, ths function will ask for user input.
178
# return:     0
179
#                 No error or warning occurred.
180
#             1
181
#                 Aborted by user.
182
#             -1
183
#                 No modules available.
184
#             -2
185
#                 The specified <module> could not be found.
186
#             -3
187
#                 Parsing the project for the specified module failed.
188
#             -4
189
#                 Missing dependencies.
190
#
191
function createModuleProject {
192
  local userdir=$(pwd)
193
  local modulesdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../Target/Modules)
194
  local modules=("${!1}")
195
  local module=""
196
  local moduleidx=""
197
  local projectdir=""
198
  local gccincludedir=""
199
  local outvar=""
200
  local gccoutvar=""
201

    
202
  # check dependencies
203
  checkCommands make
204
  if [ $? -ne 0 ]; then
205
    printError "Missing dependencies detected.\n"
206
    return -4
207
  fi
208

    
209
  # parse arguments
210
  local otherargs=()
211
  while [ $# -gt 0 ]; do
212
    if ( parseIsOption $1 ); then
213
      case "$1" in
214
        -m=*|--module=*)
215
          module="${1#*=}"; shift 1;;
216
        -m|--module)
217
          module="$2"; shift 2;;
218
        -p=*|--path=*)
219
          projectdir=$(realpath "${1#*=}"); shift 1;;
220
        -p|--path)
221
          projectdir=$(realpath "$2"); shift 2;;
222
        --gcc=*)
223
          gccincludedir=$(realpath "${1#*=}"); shift 1;;
224
        --gcc)
225
          gccincludedir=$(realpath "$2"); shift 2;;
226
        -o=*|--out=*)
227
          outvar=${1#*=}; shift 1;;
228
        -o|--out)
229
          outvar=$2; shift 2;;
230
        --gccout=*)
231
          gccoutvar=$(realpath "${1#*=}"); shift 1;;
232
        --gccout)
233
          gccoutvar=$(realpath "$2"); shift 2;;
234
        *)
235
          printError "invalid option: $1\n"; shift 1;;
236
      esac
237
    else
238
      otherargs+=("$1")
239
      shift 1
240
    fi
241
  done
242

    
243
  # sanity check for the modules variable
244
  if [ -z "${modules[*]}" ]; then
245
    printError "no modules available\n"
246
    return -1
247
  fi
248

    
249
  # select module
250
  if [ -z $module ]; then
251
    # list all available modules
252
    printInfo "choose a module or type 'A' to abort:\n"
253
    for (( idx=0; idx<${#modules[@]}; ++idx )); do
254
      printf "%4u: %s\n" $(($idx + 1)) "${modules[$idx]}"
255
    done
256
    # read user input
257
    printLog "read user selection\n"
258
    local userinput=""
259
    while [[ ! "$userinput" =~ ^[0-9]+$ ]] || [ ! "$userinput" -gt 0 ] || [ ! "$userinput" -le ${#modules[@]} ] && [[ ! "$userinput" =~ ^[Aa]$ ]]; do
260
      read -p "your selection: " -e userinput
261
      printLog "user selection: $userinput\n"
262
      if [[ ! "$userinput" =~ ^[0-9]+$ ]] || [ ! "$userinput" -gt 0 ] || [ ! "$userinput" -le ${#modules[@]} ] && [[ ! "$userinput" =~ ^[Aa]$ ]]; then
263
        printWarning "Please enter an integer between 1 and ${#modules[@]} or 'A' to abort.\n"
264
      fi
265
    done
266
    if [[ "$userinput" =~ ^[Aa]$ ]]; then
267
      printWarning "aborted by user\n"
268
      return 1
269
    fi
270
    # store selection
271
    moduleidx=$(($userinput - 1))
272
    module="${modules[$moduleidx]}"
273
    printf "\n"
274
  else
275
    # search all modules for the selected one
276
    for (( idx=0; idx<${#modules[@]}; ++idx )); do
277
      if [ "${modules[$idx]}" = "$module" ]; then
278
        moduleidx=$idx
279
        break
280
      fi
281
    done
282
    # error if the module could not be found
283
    if [ -z $moduleidx ]; then
284
      printError "module ($module) not available\n"
285
      return -2
286
    fi
287
  fi
288

    
289
  # read absolute project directory if required
290
  if [ -z "$projectdir" ]; then
291
    getProjectDir projectdir
292
    printf "\n"
293
  fi
294

    
295
  # check for existing project files
296
  local projectfiles="$(find ${projectdir} -maxdepth 1 -type f | grep -E "${module}\.(includes|files|config|creator)$")"
297
  IFS=$'\n'; projectfiles=($projectfiles); unset IFS
298
  if [ ! -z "${projectfiles[*]}" ]; then
299
    printWarning "The following files will be overwritten:\n"
300
    for pfile in ${projectfiles[@]}; do
301
      printWarning "\t$(basename $pfile)\n"
302
    done
303
    local userinput=""
304
    printInfo "Continue and overwrite? [y/n]\n"
305
    readUserInput "YyNn" userinput
306
    case "$userinput" in
307
      Y|y)
308
        ;;
309
      N|n)
310
        printWarning "Project generation for ${module} module aborted by user\n"
311
        return 1
312
        ;;
313
      *)
314
        printError "unexpected input: ${userinput}\n"; return -999;;
315
    esac
316
    printf "\n"
317
  fi
318

    
319
  # print message
320
  printInfo "generating QtCreator project files for the $module module...\n"
321

    
322
  # retrieve absolute GCC include path
323
  if [ -z "$gccincludedir" ]; then
324
    retrieveGccIncludeDir gccincludedir
325
  fi
326

    
327
  # change to project directory
328
  local amirobltrootdir=$(realpath $(dirname ${BASH_SOURCE[0]})/../../..)
329
  cd "$projectdir"
330

    
331
  # run make, but only run the GCC preprocessor and produce no binaries
332
  local sourcefiles=()
333
  local sourcefile=""
334
  local parse_state="WAIT_FOR_INCLUDE_OR_COMPILE"
335
  # capture all output from make and GCC and append the return value of make as last line
336
  printInfo "processing project (this may take a while)...\n"
337
  local rawout=$(make --directory ${amirobltrootdir}/Target/Modules/${module}/Boot --always-make USER_CFLAGS="-v -H" 2>&1 && echo $?)
338
  # check whether the make call was successfull
339
  if [[ $(echo "${rawout}" | tail -n 1) != "0" ]]; then
340
    printError "executing 'make' in module directory failed\n"
341
    cd "$userdir"
342
    return -3
343
  fi
344
  # extract file names from raw output
345
  IFS=$'\n'; rawout=($rawout); unset IFS
346
  for line in "${rawout[@]}"; do
347
    case $parse_state in
348
      WAIT_FOR_INCLUDE_OR_COMPILE)
349
        # lines stating included files look like:
350
        # ... <../relative/path/to/file>
351
        if [[ "$line" =~ ^\.+[[:blank:]].+\..+$ ]]; then
352
          sourcefile=${line##* }
353
          if [[ ! "$sourcefile" =~ ^/ ]]; then
354
            sourcefile=$(realpath ${amirobltrootdir}/Target/Modules/${module}/Boot/${sourcefile})
355
          fi
356
          sourcefiles[${#sourcefiles[@]}]="$sourcefile"
357
        # whenever the next source file is processed, a message appears like:
358
        # Compining <filnemame>
359
        elif [[ "$line" =~ ^\+\+\+[[:blank:]]Compiling[[:blank:]]\[(.+\.c)\]$ ]]; then
360
          printf "."
361
          sourcefile=${BASH_REMATCH[1]}
362
          parse_state="WAIT_FOR_COMPILERCALL"
363
        fi;;
364
      WAIT_FOR_COMPILERCALL)
365
        # wait for the actual call of the compiler to retrieve the full path to the source file
366
        if [[ "$line" == *${sourcefile}* ]]; then
367
          line="${line%%${sourcefile}*}${sourcefile}"
368
          sourcefile=$(realpath ${amirobltrootdir}/Target/Modules/${module}/Boot/${line##* })
369
          sourcefiles[${#sourcefiles[@]}]="$sourcefile"
370
          parse_state="WAIT_FOR_INCLUDE_OR_COMPILE"
371
        fi;;
372
    esac
373
  done
374
  unset rawout
375
  printf "\n"
376
  # sort and remove duplicates
377
  IFS=$'\n'; sourcefiles=($(sort --unique <<< "${sourcefiles[*]}")); unset IFS
378

    
379
  # extract include paths
380
  local includes=()
381
  for source in ${sourcefiles[*]}; do
382
    includes[${#includes[@]}]="$(dirname ${source})"
383
  done
384
  # sort and remove duplicates
385
  IFS=$'\n'; includes=($(sort --unique <<< "${includes[*]}")); unset IFS
386

    
387
  # generate the .files file, containing all source files
388
  echo "" > ${projectdir}/${module}.includes
389
  for inc in ${includes[*]}; do
390
    echo "$inc" >> ${projectdir}/${module}.includes
391
  done
392
  # generate the .incldues file, containing all include paths
393
  echo "" > ${projectdir}/${module}.files
394
  for source in ${sourcefiles[*]}; do
395
    # skip GCC files
396
    if [[ ! "$source" =~ .*/gcc.* ]]; then
397
      echo "$source" >> ${projectdir}/${module}.files
398
    fi
399
  done
400
  # generate a default project configuration file if it doesn't exist yet
401
  if [ ! -f ${projectdir}/${module}.config ]; then
402
    echo "// Add predefined macros for your project here. For example:" > ${projectdir}/${module}.config
403
    echo "// #define YOUR_CONFIGURATION belongs here" >> ${projectdir}/${module}.config
404
  fi
405
  # generate a default .creator file if it doesn't exist yet
406
  if [ ! -f ${projectdir}/${module}.creator ]; then
407
    echo "[general]" > ${projectdir}/${module}.creator
408
  fi
409

    
410
  # go back to user directory
411
  cd $userdir
412

    
413
  # fill the output variables
414
  if [ ! -z "$outvar" ]; then
415
    eval $outvar="$projectdir"
416
  fi
417
  if [ ! -z "$gccoutvar" ]; then
418
    eval $gccoutvar="$gccincludedir"
419
  fi
420

    
421
  return 0
422
}
423

    
424
### create project files for all modules #######################################
425
# Create project files for all modules.
426
#
427
# usage:      createAllProjects <modules> [-p|--path=<path>] [--gcc=<path>] [-o|--out=<var>] [--gccout=<var>]
428
# arguments:  <modules>
429
#                 Array containing all modules available.
430
#             -p, --path <path>
431
#                 Path where to create the project files.
432
#             --gcc=<path>
433
#                 Path to the GCC include directory.
434
#             -o, --out <var>
435
#                 Variable to store the path to.
436
#             --gccout=<var>
437
#                 Variable to store the path to the GCC include directory to.
438
#                 If this optional arguments is absent, ths function will ask for user input.
439
# return:     0
440
#                 No error or warning occurred.
441
#             1
442
#                 Aborted by user.
443
#             -1
444
#                 No modules available.
445
#
446
function createAllProjects {
447
  local modules=("${!1}")
448
  local projectdir=""
449
  local gccincludedir=""
450
  local outvar=""
451
  local gccoutvar=""
452

    
453
  # parse arguments
454
  local otherargs=()
455
  while [ $# -gt 0 ]; do
456
    if ( parseIsOption $1 ); then
457
      case "$1" in
458
        -p=*|--path=*)
459
          projectdir=$(realpath "${1#*=}"); shift 1;;
460
        -p|--path)
461
          projectdir=$(realpath "$2"); shift 2;;
462
        --gcc=*)
463
          gccincludedir=$(realpath "${1#*=}"); shift 1;;
464
        --gcc)
465
          gccincludedir=$(realpath "$2"); shift 2;;
466
        -o=*|--out=*)
467
          outvar=${1#*=}; shift 1;;
468
        -o|--out)
469
          outvar=$2; shift 2;;
470
        --gccout=*)
471
          gccoutvar=$(realpath "${1#*=}"); shift 1;;
472
        --gccout)
473
          gccoutvar=$(realpath "$2"); shift 2;;
474
        *)
475
          printError "invalid option: $1\n"; shift 1;;
476
      esac
477
    else
478
      otherargs+=("$1")
479
      shift 1
480
    fi
481
  done
482

    
483
  # sanity check for the modules variable
484
  if [ -z "${modules[*]}" ]; then
485
    printError "no modules available\n"
486
    return -1
487
  fi
488

    
489
  # read absolute project directory if required
490
  if [ -z "$projectdir" ]; then
491
    getProjectDir projectdir
492
  fi
493

    
494
  # check for existing project files
495
  local projectfiles=()
496
  for module in ${modules[@]}; do
497
    local pfiles="$(find ${projectdir} -maxdepth 1 -type f | grep -E "${module}\.(includes|files|config|creator)$")"
498
    IFS=$'\n'; pfiles=($pfiles); unset IFS
499
    projectfiles=( ${projectfiles[*]} ${pfiles[*]} )
500
  done
501
  if [ ! -z "${projectfiles[*]}" ]; then
502
    printWarning "The following files will be removed:\n"
503
    for pfile in ${projectfiles[@]}; do
504
      printWarning "\t$(basename $pfile)\n"
505
    done
506
    local userinput=""
507
    printInfo "Continue and overwrite? [y/n]\n"
508
    readUserInput "YyNn" userinput
509
    case "${userinput}" in
510
      Y|y)
511
        for pfile in ${projectfiles[*]}; do
512
          rm "$pfile"
513
        done
514
        ;;
515
      N|n)
516
        printWarning "Project generation aborted by user\n"
517
        return 1
518
        ;;
519
      *)
520
        printError "unexpected input: ${userinput}\n"
521
        return 999
522
        ;;
523
    esac
524
  fi
525

    
526
  # print message
527
  printf "\n"
528
  printInfo "generating QtCreator project files for all modules...\n"
529

    
530
  # retrieve absolute GCC include path
531
  if [ -z "$gccincludedir" ]; then
532
    retrieveGccIncludeDir gccincludedir
533
  fi
534

    
535
  # iterate over all modules
536
  local retval=1
537
  for module in ${modules[@]}; do
538
    if [ $retval != 0 ]; then
539
      printf "\n"
540
    fi
541
    createModuleProject modules[@] --module="$module" --path="$projectdir" --gcc="$gccincludedir"
542
    retval=$?
543
  done
544

    
545
  return 0
546
}
547

    
548
### delete project files #######################################################
549
# Deletes all project files and optionally .user files, too.
550
#
551
# usage:      deleteProjects [-p|--path=<path>] [-m|--module=<module>] [-o|--out=<var>] [-w|-wipe]
552
# arguments:  -p, --path <path>
553
#                 Path where to delete the project files.
554
#             -m, --module <module>
555
#                 Module name for which the project files shall be deleted.
556
#             -o, --out <var>
557
#                 Variable to store the path to.
558
#             -w, --wipe
559
#                 Delete .user files as well.
560
# return:
561
#  -  0: no error
562
#
563
function deleteProjects {
564
  local modulename=""
565
  local projectdir=""
566
  local outvar=""
567
  local wipe=false
568
  local files=""
569

    
570
  # parse arguments
571
  local otherargs=()
572
  while [ $# -gt 0 ]; do
573
    if ( parseIsOption $1 ); then
574
      case "$1" in
575
        -p=*|--path=*)
576
          projectdir=$(realpath "${1#*=}"); shift 1;;
577
        -p|--path)
578
          projectdir=$(realpath "$2"); shift 2;;
579
        -m=*|--module=*)
580
          modulename="${1#*=}"; shift 1;;
581
        -m|--module)
582
          modulename="${2}"; shift 2;;
583
        -o=*|--out=*)
584
          outvar=${1#*=}; shift 1;;
585
        -o|--out)
586
          outvar=$2; shift 2;;
587
        -w|--wipe)
588
          wipe=true; shift 1;;
589
        *)
590
          printError "invalid option: $1\n"; shift 1;;
591
      esac
592
    else
593
      otherargs+=("$1")
594
      shift 1
595
    fi
596
  done
597

    
598
  # read absolute project directory if required
599
  if [ -z "$projectdir" ]; then
600
    getProjectDir projectdir
601
  fi
602

    
603
  # list all files to be deleted
604
  if [ -z "$modulename" ]; then
605
    if [ $wipe != true ]; then
606
      files=$(find "${projectdir}" -maxdepth 1 -type f | grep -E "^.+\.(includes|files|config|creator|cflags|cxxflags)$")
607
    else
608
      files=$(find "${projectdir}" -maxdepth 1 -type f | grep -E "^.+\.(includes|files|config|creator|cflags|cxxflags|creator(\.user(\..+)?)?)$")
609
    fi
610
  else
611
    if [ $wipe != true ]; then
612
      files=$(find "${projectdir}" -maxdepth 1 -type f | grep -E "^${modulename}\.(includes|files|config|creator|cflags|cxxflags)$")
613
    else
614
      files=$(find "${projectdir}" -maxdepth 1 -type f | grep -E "^${modulename}\.(includes|files|config|creator|cflags|cxxflags|creator(\.user(\..+)?)?)$")
615
    fi
616
  fi
617
  if [ ! -z "$files" ]; then
618
    printInfo "Deleting the following files:\n"
619
    while read line; do
620
      printInfo "\t$(basename ${line})\n"
621
      rm ${line} 2>&1 | tee -a $LOG_FILE
622
    done <<< "${files}"
623
  else
624
    printInfo "No project files found\n"
625
  fi
626

    
627
  # store the path to the output variable, if required
628
  if [ ! -z "$outvar" ]; then
629
    eval $outvar="$projectdir"
630
  fi
631

    
632
  return 0
633
}
634

    
635
### main function of this script ###############################################
636
# Creates, deletes and wipes QtCreator project files for the three AMiRo base modules.
637
#
638
# usage:      see function printHelp
639
# arguments:  see function printHelp
640
# return:     0
641
#                 No error or warning ocurred.
642
#
643
function main {
644
# print welcome/info text if not suppressed
645
  if [[ $@ != *"--noinfo"* ]]; then
646
    printWelcomeText
647
  else
648
    printf "######################################################################\n"
649
  fi
650
  printf "\n"
651

    
652
  # if --help or -h was specified, print the help text and exit
653
  if [[ $@ == *"--help"* || $@ == *"-h"* ]]; then
654
    printHelp
655
    printf "\n"
656
    quitScript
657
  fi
658

    
659
  # set log file if specified
660
  if [[ $@ == *"--log"* ]] || [[ $@ == *"--LOG"* ]]; then
661
    # get the parameter (file name)
662
    local cmdidx=1
663
    while [[ ! "${!cmdidx}" = "--log"* ]] && [[ ! "${!cmdidx}" = "--LOG"* ]]; do
664
      cmdidx=$[cmdidx + 1]
665
    done
666
    local cmd="${!cmdidx}"
667
    local logfile=""
668
    if [[ "$cmd" = "--log="* ]] || [[ "$cmd" = "--LOG="* ]]; then
669
      logfile=${cmd#*=}
670
    else
671
      local filenameidx=$((cmdidx + 1))
672
      logfile="${!filenameidx}"
673
    fi
674
    # optionally force silent appending
675
    if [[ "$cmd" = "--LOG"* ]]; then
676
      setLogFile --option=c --quiet "$logfile" LOG_FILE
677
    else
678
      setLogFile "$logfile" LOG_FILE
679
      printf "\n"
680
    fi
681
  fi
682
  # log script name
683
  printLog "this is $(realpath ${BASH_SOURCE[0]})\n"
684

    
685
  # detect available modules and inform user
686
  local modules=()
687
  detectModules modules
688
  case "${#modules[@]}" in
689
    0)
690
      printInfo "no module has been detected\n";;
691
    1)
692
      printInfo "1 module has been detected:\n";;
693
    *)
694
      printInfo "${#modules[@]} modules have been detected:\n"
695
  esac
696
  for (( idx=0; idx<${#modules[@]}; ++idx )); do
697
    printInfo "  - ${modules[$idx]}\n"
698
  done
699
  printf "\n"
700

    
701
  # parse arguments
702
  local otherargs=()
703
  while [ $# -gt 0 ]; do
704
    if ( parseIsOption $1 ); then
705
      case "$1" in
706
        -h|--help) # already handled; ignore
707
          shift 1;;
708
        -m=*|--module=*)
709
          createModuleProject modules[@] --module="${1#*=}"; printf "\n"; shift 1;;
710
        -m|--module)
711
          createModuleProject modules[@] --module="${2}"; printf "\n"; shift 2;;
712
        -a|--all)
713
          createAllProjects modules[@]; shift 1;;
714
        -c|--clean)
715
          deleteProjects; printf "\n"; shift 1;;
716
        -w|--wipe)
717
          deleteProjects --wipe; printf "\n"; shift 1;;
718
        -q|--quit)
719
          quitScript; shift 1;;
720
        --log=*|--LOG=*) # already handled; ignore
721
          shift 1;;
722
        --log|--LOG) # already handled; ignore
723
          shift 2;;
724
        --noinfo) # already handled; ignore
725
          shift 1;;
726
        *)
727
          printError "invalid option: $1\n"; shift 1;;
728
      esac
729
    else
730
      otherargs+=("$1")
731
      shift 1
732
    fi
733
  done
734

    
735
  # interactive menu
736
  while ( true ); do
737
    # main menu info prompt and selection
738
    printInfo "QtCreator setup main menu\n"
739
    printf "Please select one of the following actions:\n"
740
    printf "  [M] - create a project for a single module\n"
741
    printf "  [A] - create a project for all modules\n"
742
    printf "  [C] - clean all project files\n"
743
    printf "  [W] - wipe all project and .user files\n"
744
    printf "  [Q] - quit this setup\n"
745
    local userinput=""
746
    readUserInput "MmAaCcWwQq" userinput
747
    printf "\n"
748

    
749
    # evaluate user selection
750
    case "$userinput" in
751
      M|m)
752
        createModuleProject modules[@]; printf "\n";;
753
      A|a)
754
        createAllProjects modules[@]; printf "\n";;
755
      C|c)
756
        deleteProjects; printf "\n";;
757
      W|w)
758
        deleteProjects --wipe; printf "\n";;
759
      Q|q)
760
        quitScript;;
761
      *) # sanity check (exit with error)
762
        printError "unexpected argument: $userinput\n";;
763
    esac
764
  done
765

    
766
  exit 0
767
}
768

    
769
################################################################################
770
# SCRIPT ENTRY POINT                                                           #
771
################################################################################
772

    
773
main "$@"
774