Bash completion for flags

[mabelzhang]

🎉 New feature

Part of gazebosim/gz-tools#1
Used together with gazebosim/gz-tools#87

Summary

Bash completion, installation, tests.

Test it

$ . install/share/gz/gz.completion

$ ign gazebo -
--force-version         --physics-engine        --verbose
--gui-config            --playback              --version
--help                  --record                --versions
--iterations            --record-path           -g
--levels                --record-resources      -h
--log-compress          --record-topic          -r
--log-overwrite         --render-engine         -s
--network-role          --render-engine-gui     -v
--network-secondaries   --render-engine-server  -z

$ ign model -
--force-version  --list           -h               -p
--help           --model          -j               
--joint          --pose           -l               
--link           --versions       -m

Checklist

• Signed all commits for DCO
• Added tests
• Added example and/or tutorial
• Updated documentation (as needed)
• Updated migration guide (as needed)
• Consider updating Python bindings (if the library has them)
• codecheck passed (See contributing)
• All tests passed (See test coverage)
• While waiting for a review on your PR, please help review another open pull request to support the maintainers

Note to maintainers: Remember to use Squash-Merge and edit the commit message to match the pull request summary while retaining Signed-off-by messages.

[codecov]

Codecov Report

Merging #1504 (7c0f3b9) into ign-gazebo3 (900583a) will not change coverage.
The diff coverage is n/a.

@@             Coverage Diff              @@
##           ign-gazebo3    #1504   +/-   ##
============================================
  Coverage        77.76%   77.76%           
============================================
  Files              250      250           
  Lines            14443    14443           
============================================
  Hits             11231    11231           
  Misses            3212     3212           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 900583a...7c0f3b9. Read the comment docs.

[ahcorde]

CI is failing to compile

  /github/workspace/src/ign_TEST.cc: In member function 'virtual void CmdLine_GazeboHelpVsCompletionFlags_Test::TestBody()':
  /github/workspace/src/ign_TEST.cc:199:28: error: 'common' has not been declared
     std::string scriptPath = common::joinPaths(std::string(PROJECT_SOURCE_PATH),
                              ^~~~~~

[mabelzhang]

Oops my Docker image was broken yesterday and I couldn't test things locally. Relying on CI

[mabelzhang]

b34bbe9 adds bash completion for the model command and tests it in a new way as described in gazebosim/gz-gui#392 (comment)

[chapulina]

Pushed some minor tweaks in 7c0f3b9. LGTM!