Differences

This shows you the differences between two versions of the page.

--- capacity_building:workshops:tooling [2022/10/08 11:53] – [Demo files used during the presentation] rolf001
+++ capacity_building:workshops:tooling [2023/01/05 14:38] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+/*
 ~~NOTOC~~
+*/
 ====== Tools, Workflow and Resources for Effective Development  ======
-**Live Online Workshop for HSRW and ULSA by Harley Lara - 2022-10-06**
+**Live Online Workshop for [[https://ulsa.edu.ni/|ULSA]] and [[http://hsrw.eu/|HSRW]] by Harley Lara - 2022-10-06**
 Workshop details:
   * **Topic**: Tools, workflow and resources for effective development
-  * **Description**: Hardware and/or Software project development can be a long and complex process, but with the right set of tools everything can be faster and more efficient from the developer's point of view. This workshop is based on providing tools for developers to have a seamless process, producing quality software and hardware. In collaboration with [[https://ulsa.edu.ni/|ULSA]] Nicaragua and [[https://www.hochschule-rhein-waal.de/en/faculties/communication-and-environment/laboratories/eo-lab|EO lab]] [[https://www.hochschule-rhein-waal.de|HSRW]].
+  * **Description**: Hardware and/or Software project development can be a long and complex process, but with the right set of tools everything can be faster and more efficient from the developer's point of view. This workshop is based on providing tools for developers to have a seamless process, producing quality software and hardware. In collaboration with [[https://ulsa.edu.ni/|ULSA]] Nicaragua and the [[https://www.hochschule-rhein-waal.de/en/faculties/communication-and-environment/laboratories/eo-lab|EOLab]] of the [[https://www.hochschule-rhein-waal.de|HSRW]].
   * **Date**: 06 October 2022
   * **Time**: from 16:00 to 18:00 (CEST)
@@ Line 15: / Line 17: @@
 ----
-===== Demo files used during the presentation =====
+===== Demo Scripts Used in the Workshop =====
-<WRAP center round info 60%>
+Download all the files here: {{ :capacity_building:workshops:example_files.zip |example_files.zip}}
-Please change the ''.doc'' extension to the correct extension. The Bash script uses ''.sh'' and ansible-playbooks ''.yml''.
-</WRAP>
-  * {{ :capacity_building:workshops:bash-hello.doc |Hello bash script}}: Print message in the terminal
+  * ''bash-hello.sh'': Print message in the terminal
-  * {{ :capacity_building:workshops:tmux-fzf.doc |Tmux and fzf bash script}}: fuzzy search over a group of specified directories
+  * ''tmux-fzf.sh'': fuzzy search over a group of specified directories
-  * {{ :capacity_building:workshops:bash-software.doc |Software installation bash script}}: Basic bash script to install a set of packages
+  * ''bash-software.sh'': Basic bash script to install a set of packages
-  * {{ :capacity_building:workshops:ansible-software.doc |Software installation ansible playbook}}: Basic playbook to install a set of packages
+  * ''ansible-software.yml'': Basic playbook to install a set of packages
-  * {{ :capacity_building:workshops:bash-software-tags.doc |Tags implementation in bash}}: Minimal and basic tag implementation to emulate ansible tags using bash script
+  * ''bash-software-tags'': Minimal and basic tag implementation to emulate ansible tags using bash script
+===== bash Demo =====
 <file bash hello-bash.sh>
 #!/bin/bash
-#
-# Script used as demo during the workshop
-# "Tools, Workflows and Resources"
-# 06 Oct. 2022, HSRW Germany
-#
-# Copyright (c) 2022 Harley Lara
-#
-# Permission is hereby granted, free of charge, to any person obtaining
-# a copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish,
-# distribute, sublicense, and/or sell copies of the Software, and to
-# permit persons to whom the Software is furnished to do so, subject to
-# the following conditions:
-#
-# The above copyright notice and this permission notice shall be
-# included in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-sudo apt-get update && \
+echo "hello bash scripting"
+</file>
+===== tmux Demo =====
+<file bash tmux-fzf.sh>
+#!/bin/bash
+# Used the next line to set the list of directories
+DIRECTORIES="~/ ~/Documents ~/Desktop"
+# Uncommend the next line if you are using a external file
+# for track the list of directories
+# DIRECTORIES=$(cat ~/EXTERNAL-FILE | tr "\n" " ")
+# Note about the external file
+#       Format of the file:
+#           ~/
+#           ~/Documents
+#           ~/Desktop
+#       One directory per line
+if [[ $# -eq 1 ]]; then
+    SELECTED=$1 && [[ "$SELECTED" == '.' ]] && SELECTED="$PWD"
+else
+    SELECTED=$(find $DIRECTORIES -mindepth 1 -maxdepth 1 -type d | fzf)
+fi
+if [[ -z $SELECTED ]]; then
+    exit 0
+fi
+SELECTED_NAME=$(basename "$SELECTED" | tr . _)
+SELECTED_NAME=${SELECTED_NAME:0:8}
+if [[ -n $TMUX ]]; then
+    # inside tmux
+    tmux switch-client -t "$SELECTED_NAME" || \
+    tmux new-session -ds "$SELECTED_NAME" -c "$SELECTED" && \
+    tmux switch-client -t "$SELECTED_NAME"
+elif [[ -z $TMUX ]]; then
+    # outside tmux
+    tmux new-session -s "$SELECTED_NAME" -c "$SELECTED" || \
+    tmux attach -t "$SELECTED_NAME"
+fi
+</file>
+===== apt - Linux Software Package Manager =====
+<file bash install-some-software-packages.sh>
+#!/bin/bash
+sudo apt update && \
 apt-get install -y \
     build-essential \
@@ Line 62: / Line 90: @@
     libpthread-stubs0-dev
-sudo apt-get install -y \
+sudo apt install -y \
     curl \
     htop \
@@ Line 70: / Line 98: @@
 </file>
-===== Encrytion and Decrytion with Ansible =====
+===== Encryption and Decryption with Ansible =====
+Encryption:
 <code>
-# Encryption:
+$> ansible-vault encrypt FILE_NAME
-ansible-vault encrypt FILE_NAME
+</code>
-# Decryption:
+Decryption:
-ansible-vault decrypt FILE_NAME
+<code>
+$> ansible-vault decrypt FILE_NAME
 </code>