From ace4f826f996214dce669ace7a443244b47e02c7 Mon Sep 17 00:00:00 2001 From: MjSeven <33125422+MjSeven@users.noreply.github.com> Date: Tue, 16 Oct 2018 20:36:25 +0800 Subject: [PATCH 1/2] Delete 20171204 Improve your Bash scripts with Argbash.md --- ... Improve your Bash scripts with Argbash.md | 116 ------------------ 1 file changed, 116 deletions(-) delete mode 100644 sources/tech/20171204 Improve your Bash scripts with Argbash.md diff --git a/sources/tech/20171204 Improve your Bash scripts with Argbash.md b/sources/tech/20171204 Improve your Bash scripts with Argbash.md deleted file mode 100644 index 8b9b565ec1..0000000000 --- a/sources/tech/20171204 Improve your Bash scripts with Argbash.md +++ /dev/null @@ -1,116 +0,0 @@ -Translating by MjSeven - - -# [Improve your Bash scripts with Argbash][1] - -![](https://fedoramagazine.org/wp-content/uploads/2017/11/argbash-1-945x400.png) - -Do you write or maintain non-trivial bash scripts? If so, you probably want them to accept command-line arguments in a standard and robust way. Fedora recently got [a nice addition][2] which can help you produce better scripts. And don’t worry, it won’t cost you much of your time or energy. - -### Why Argbash? - -Bash is an interpreted command-line language with no standard library. Therefore, if you write bash scripts and want command-line interfaces that conform to [POSIX][3] and [GNU CLI][4] standards, you’re used to only two options: - -1. Write the argument-parsing functionality tailored to your script yourself (possibly using the `getopts` builtin). - -2. Use an external bash module. - -The first option looks incredibly silly as implementing the interface properly is not trivial. However, it is suggested as the best choice on various sites ranging from [Stack Overflow][5] to the [Bash Hackers][6] wiki. - -The second option looks smarter, but using a module has its issues. The biggest is you have to bundle its code with your script. This may mean either: - -* You distribute the library as a separate file, or - -* You include the library code at the beginning of your script. - -Having two files instead of one is awkward. So is polluting your bash scripts with a chunk of complex code over thousand lines long. - -This was the main reason why the Argbash [project came to life][7]. Argbash is a code generator, so it generates a tailor-made parsing library for your script. Unlike the generic code of other bash modules, it produces minimal code your script needs. Moreover, you can request even simpler code if you don’t need 100% conformance to these CLI standards. - -### Example - -### Analysis - -Let’s say you want to implement a script that [draws a bar][8] across the terminal window. You do that by repeating a single character of your choice multiple times. This means you need to get the following information from the command-line: - -* _The character which is the element of the line. If not specified, use a dash._  On the command-line, this would be a single-valued positional argument  _character_  with a default value of -. - -* _Length of the line. If not specified, go for 80._  This is a single-valued optional argument  _–length_  with a default of 80. - -* _Verbose mode (for debugging)._  This is a boolean argument  _verbose_ , off by default. - -As the body of the script is really simple, this article focuses on getting the input of the user from the command-line to appropriate script variables. Argbash generates code that saves parsing results to shell variables  __arg_character_ ,  __arg_length_  and  __arg_verbose_ . - -### Execution - -In order to proceed, you need the  _argbash-init_  and  _argbash_  bash scripts that are parts of the  _argbash_  package. Therefore, run this command: - -``` -sudo dnf install argbash -``` - -Then, use  _argbash-init_  to generate a template for  _argbash_ , which generates the executable script. You want three arguments: a positional one called  _character_ , an optional  _length_  and an optional boolean  _verbose_ . Tell this to  _argbash-init_ , and then pass the output to  _argbash_ : - -``` -argbash-init --pos character --opt length --opt-bool verbose script-template.sh -argbash script-template.sh -o script -./script -``` - -See the help message? Looks like the script doesn’t know about the default option for the character argument. So take a look at the [Argbash API][9], and then fix the issue by editing the template section of the script: - -``` -# ... -# ARG_OPTIONAL_SINGLE([length],[l],[Length of the line],[80]) -# ARG_OPTIONAL_BOOLEAN([verbose],[V],[Debug mode]) -# ARG_POSITIONAL_SINGLE([character],[The element of the line],[-]) -# ARG_HELP([The line drawer]) -# ... -``` - -Argbash is so smart that it tries to make every generated script a template of itself. This means you don’t have to worry about storing source templates for further use. You just shouldn’t lose your generated bash scripts. Now, try to regenerate the future line drawer to work as expected: - -``` -argbash script -o script -./script -``` - -As you can see, everything is working all right. The only thing left to do is fill in the line drawing functionality itself. - -### Conclusion - -You might find the section containing parsing code quite long, but consider that it allows you to call  _./script.sh x -Vl50_  and it will be understood the same way as  _./script -V -l 50 x. I_ t does require some code to get this right. - -However, you can shift the balance between generated code complexity and parsing abilities towards more simple code by calling  _argbash-init_  with argument  _–mode_  set to  _minimal_ . This option reduces the size of the script by about 20 lines, which corresponds to a roughly 25% decrease of the generated parsing code size. On the other hand, the  _full_  mode makes the script even smarter. - -If you want to examine the generated code, give  _argbash_  the argument  _–commented_ , which puts comments into the parsing code that reveal the intent behind various sections. Compare that to other argument parsing libraries such as [shflags][10], [argsparse][11] or [bash-modules/arguments][12], and you’ll see the powerful simplicity of Argbash. If something goes horribly wrong and you need to fix a glitch in the parsing functionality quickly, Argbash allows you to do that as well. - -As you’re most likely a Fedora user, you can enjoy the luxury of having command-line Argbash installed from the official repositories. However, there is also an [online parsing code generator][13] at your service. Furthermore, if you’re working on a server with Docker, you can appreciate the [Argbash Docker image][14]. - -So enjoy and make sure that your scripts have a command-line interface that pleases your users. Argbash is here to help, with minimal effort required from your side. - --------------------------------------------------------------------------------- - -via: https://fedoramagazine.org/improve-bash-scripts-argbash/ - -作者：[Matěj Týč ][a] -译者：[译者ID](https://github.com/译者ID) -校对：[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 - -[a]:https://fedoramagazine.org/author/bubla/ -[1]:https://fedoramagazine.org/improve-bash-scripts-argbash/ -[2]:https://argbash.readthedocs.io/ -[3]:http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html -[4]:https://www.gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html -[5]:https://stackoverflow.com/questions/192249/how-do-i-parse-command-line-arguments-in-bash -[6]:http://wiki.bash-hackers.org/howto/getopts_tutorial -[7]:https://argbash.readthedocs.io/ -[8]:http://wiki.bash-hackers.org/snipplets/print_horizontal_line -[9]:http://argbash.readthedocs.io/en/stable/guide.html#argbash-api -[10]:https://raw.githubusercontent.com/Anvil/bash-argsparse/master/argsparse.sh -[11]:https://raw.githubusercontent.com/Anvil/bash-argsparse/master/argsparse.sh -[12]:https://raw.githubusercontent.com/vlisivka/bash-modules/master/main/bash-modules/src/bash-modules/arguments.sh -[13]:https://argbash.io/generate -[14]:https://hub.docker.com/r/matejak/argbash/ From c27a305dcb0e9cccc36d5cbc08872454dbf06e07 Mon Sep 17 00:00:00 2001 From: MjSeven <33125422+MjSeven@users.noreply.github.com> Date: Tue, 16 Oct 2018 20:37:03 +0800 Subject: [PATCH 2/2] Create 20171204 Improve your Bash scripts with Argbash.md --- ... Improve your Bash scripts with Argbash.md | 110 ++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 translated/tech/20171204 Improve your Bash scripts with Argbash.md diff --git a/translated/tech/20171204 Improve your Bash scripts with Argbash.md b/translated/tech/20171204 Improve your Bash scripts with Argbash.md new file mode 100644 index 0000000000..df248d1e5b --- /dev/null +++ b/translated/tech/20171204 Improve your Bash scripts with Argbash.md @@ -0,0 +1,110 @@ +# [使用 Argbash 来改进你的 Bash 脚本][1] + +![](https://fedoramagazine.org/wp-content/uploads/2017/11/argbash-1-945x400.png) + +你编写或维护过有意义的 bash 脚本吗？如果回答是，那么你可能希望它们以标准且健壮的方式接收命令行参数。Fedora 最近得到了[一个很好的附加组件][2]，它可以帮助你生成更好的脚本。不用担心，它不会花费你很多时间或精力。 + +### 为什么是 Argbash? + +Bash 是一种解释性的命令行语言，没有标准库。因此，如果你编写 bash 脚本并希望命令行界面符合 [POSIX][3] 和 [GNU CLI][4] 标准，那么你只需习惯两个选项： + +1. 直接编写为脚本量身定制的参数解析功能（可使用内置的 `getopts`）。 + +2. 使用外部 bash 模块。 + +第一个选项看起来非常愚蠢，因为正确实现接口并非易事。但是，从 [Stack Overflow][5] 到 [Bash Hackers][6] wiki 的各种站点上，它被认为是最佳选择。 + +第二个选项看起来更聪明，但使用模块有它自己的问题。最大的问题是你必须将其代码与脚本捆绑在一起。这可能意味着： + + * 你将库作为单独的文件分发 + + * 在脚本的开头包含库代码 + +有两个文件而不是一个是愚蠢的，但一个文件会使用一串超过千行的复杂代码去污染你的脚本。（to 校正：这句话原文不知该如何理解） + +这是 Argbash [项目诞生][7]的主要原因。Argbash 是一个代码生成器，它为你的脚本生成一个量身定制的解析库。与其他 bash 模块的通用代码不同，它生成脚本所需的最少代码。此外，如果你不需要 100% 符合这些 CLI 标准，你可以生成更简单的代码。 + +### 示例 + +### 分析 + +假设你要实现一个脚本，它可以在终端窗口中[绘制条形图][8]，你可以通过多次重复选择一个字符来做到这一点。这意味着你需要从命令行获取以下信息： + + * _这个字符是直线的元素。如果未指定，使用破折号。_ 在命令行上，这将是单值位置参数 _character_，其默认值为 -。 + + * _直线的长度。如果未指定，会选择 80。_ 这是一个单值可选参数 _-length_，默认值为 80。 + + * _Verbose 模式（用于调试）。_ 这是一个布尔型参数 _verbose_，默认情况下关闭。 + +由于脚本的主体非常简单，因此本文主要关注从命令行获取用户的输入到合适的脚本变量。Argbash 生成的代码将解析结果保存到 shell 变量 _arg\_character_, _arg\_length_ 和 _arg\_verbose_。 + +### 执行 + +要继续下去，你还需要 _argbash-init_ 和 _argbash_ bash 脚本，它们是 _argbash_ 包的一部分。因此，运行以下命令： +``` +sudo dnf install argbash +``` + +然后，使用 _argbash-init_ 来为 _argbash_ 生成模板，它会生成可执行脚本。你需要三个参数：一个名为 _character_ 的位置参数，一个可选的 _length_ 参数以及一个可选的布尔 _verbose_。将这些传递给 _argbash-init_，然后将输出传递给 _argbash_ : +``` +argbash-init --pos character --opt length --opt-bool verbose script-template.sh +argbash script-template.sh -o script +./script +``` + +看到帮助信息了吗？看起来该脚本不知道字符参数的默认选项。因此，看一下 [Argbash API][9]，然后通过编辑脚本的模板部分来解决问题： +``` +# ... +# ARG_OPTIONAL_SINGLE([length],[l],[Length of the line],[80]) +# ARG_OPTIONAL_BOOLEAN([verbose],[V],[Debug mode]) +# ARG_POSITIONAL_SINGLE([character],[The element of the line],[-]) +# ARG_HELP([The line drawer]) +# ... +``` + +Argbash 非常智能，它试图让每个生成的脚本都成为自己的模板，这意味着你不必担心存储源模版以供进一步使用。你不应该丢失生成的 bash 脚本。现在，尝试重新生成将来的线条绘图以按预期工作：（to 校正：这里不清楚） +``` +argbash script -o script +./script +``` + +如你所见，一切正常。剩下要做的唯一事情就是完成线条绘图功能。 + +### 结论 + +你可能会发现包含解析代码的部分很长，但考虑到它允许你调用 _./script.sh x -Vl50_，它将被理解为与 _./script -V -l 50 x_ 相同的方式。确实需要一些代码才能做到这一点。 + +但是，通过调用 _argbash-init_ 并将参数 _-mode_ 设置为 _minimal_，你可以将生成的代码复杂度和解析能力之间的平衡转向更简单的代码。这个选项将脚本的大小减少了大约 20 行，这相当于生成的解析代码大小减少了大约 25%。另一方面，_full_ 选项使脚本更加智能。 + +如果你想要检查生成的代码，请给 _argbash_ 提供参数 _-commented_，它会将注释放入解析代码中，从而揭示各个部分背后的意图。与其他参数解析库相比较，如 [shflags][10], [argsparse][11] 或 [bash-modules/arguments][12]，你将看到 Argbash 强大的简单性。如果出现了严重的错误，你需要快速修复解析功能中的一个故障，Argbash 也允许你这样做。 + +由于你很有可能是 Fedora 用户，因此你可以享受从官方仓库安装命令行 Argbash 的便利。然而，在你的服务中还有一个[在线解析代码生成器][13]。此外，如果你在服务器上使用 Docker 工作，你可以试试 [Argbash Docker 镜像][14]。 + +因此，请享受并确保你的脚本具有令用户满意的命令行界面。Argbash 随时为你提供帮助，你只需付出很少的努力。 + + +-------------------------------------------------------------------------------- + +via: https://fedoramagazine.org/improve-bash-scripts-argbash/ + +作者：[Matěj Týč ][a] +译者：[MjSeven](https://github.com/MjSeven) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]:https://fedoramagazine.org/author/bubla/ +[1]:https://fedoramagazine.org/improve-bash-scripts-argbash/ +[2]:https://argbash.readthedocs.io/ +[3]:http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html +[4]:https://www.gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html +[5]:https://stackoverflow.com/questions/192249/how-do-i-parse-command-line-arguments-in-bash +[6]:http://wiki.bash-hackers.org/howto/getopts_tutorial +[7]:https://argbash.readthedocs.io/ +[8]:http://wiki.bash-hackers.org/snipplets/print_horizontal_line +[9]:http://argbash.readthedocs.io/en/stable/guide.html#argbash-api +[10]:https://raw.githubusercontent.com/Anvil/bash-argsparse/master/argsparse.sh +[11]:https://raw.githubusercontent.com/Anvil/bash-argsparse/master/argsparse.sh +[12]:https://raw.githubusercontent.com/vlisivka/bash-modules/master/main/bash-modules/src/bash-modules/arguments.sh +[13]:https://argbash.io/generate +[14]:https://hub.docker.com/r/matejak/argbash/