Merge pull request #10 from vroncevic/dev

[gen_cc_mod] refactor done based on latest sh_util, upated docs

.github/workflows/gen_cc_mod_docker_checker.yml

@@ -1,11 +1,9 @@
 name: gen_cc_mod docker checker
-
 on:
   push:
     branches: [ master ]
   pull_request:
     branches: [ master ]
-
 jobs:
   build:
     runs-on: ubuntu-latest

.github/workflows/gen_cc_mod_shell_checker.yml

@@ -1,11 +1,9 @@
 name: gen_cc_mod shell checker
-
 on:
   push:
     branches: [ master ]
   pull_request:
     branches: [ master ]
-
 jobs:
   build:
     runs-on: ubuntu-latest

.github/workflows/gen_cc_mod_toc.yaml → .github/workflows/gen_cc_mod_toc.yml

@@ -1,7 +1,5 @@
 name: gen_cc_mod toc
-
 on: push
-
 jobs:
   generateTOC:
     name: TOC Generator

Dockerfile

@@ -15,7 +15,8 @@
 
 FROM debian:10
 RUN apt-get update
-RUN DEBIAN_FRONTEND=noninteractive apt-get install -yq --no-install-recommends \
+RUN DEBIAN_FRONTEND=noninteractive \
+ apt-get install -yq --no-install-recommends \
  tree \
  htop \
  wget \
@@ -24,14 +25,14 @@ RUN DEBIAN_FRONTEND=noninteractive apt-get install -yq --no-install-recommends \
  openssl \ 
  build-essential
 
-RUN wget https://github.com/vroncevic/sh_util/archive/v1.0.0.zip
-RUN unzip v1.0.0.zip
-RUN find /sh_util-1.0.0/ -name "*.editorconfig" -type f -exec rm -Rf {} \;
+RUN wget https://github.com/vroncevic/sh_util/archive/v1.0.zip
+RUN unzip v1.0.zip
+RUN find /sh_util-1.0/ -name "*.editorconfig" -type f -exec rm -Rf {} \;
 RUN mkdir -p /root/scripts/sh_util/ver.1.0/
-RUN cp -R /sh_util-1.0.0/sh_tool/bin/   /root/scripts/sh_util/ver.1.0/
-RUN cp -R /sh_util-1.0.0/sh_tool/conf/  /root/scripts/sh_util/ver.1.0/
-RUN cp -R /sh_util-1.0.0/sh_tool/log/   /root/scripts/sh_util/ver.1.0/
-RUN rm -Rf v1.0.0.zip sh_util-1.0.0
+RUN cp -R /sh_util-1.0/sh_tool/bin/   /root/scripts/sh_util/ver.1.0/
+RUN cp -R /sh_util-1.0/sh_tool/conf/  /root/scripts/sh_util/ver.1.0/
+RUN cp -R /sh_util-1.0/sh_tool/log/   /root/scripts/sh_util/ver.1.0/
+RUN rm -Rf v1.0.zip sh_util-1.0
 RUN mkdir /sh_tool/
 COPY sh_tool /sh_tool/
 RUN find /sh_tool/ -name "*.editorconfig" -type f -exec rm -Rf {} \;

README.md

@@ -1,3 +1,5 @@
+<img align="right" src="https://raw.githubusercontent.com/vroncevic/gen_cc_mod/dev/docs/gen_cc_mod_logo.png" width="25%">
+
 # Generate C++ Module
 
 **gen_cc_mod** is shell tool for generating C++ modules.
@@ -32,11 +34,11 @@ Navigate to release **[page](https://github.com/vroncevic/gen_cc_mod/releases)**
 To install **gen_cc_mod** type the following:
 
 ```
-tar xvzf gen_cc_mod-x.y.z.tar.gz
-cd gen_cc_mod-x.y.z
-cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.1.0/
-cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.1.0/
-cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.1.0/
+tar xvzf gen_cc_mod-x.y.tar.gz
+cd gen_cc_mod-x.y
+cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.x.y/
+cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.x.y/
+cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.x.y/
 ```
 
 ![alt tag](https://raw.githubusercontent.com/vroncevic/gen_cc_mod/dev/docs/setup_tree.png)
@@ -49,7 +51,7 @@ Or You can use docker to create image/container.
 
 ```
 # Create symlink for shell tool
-ln -s /root/scripts/gen_cc_mod/ver.1.0/bin/gen_cc_mod.sh /root/bin/gen_cc_mod
+ln -s /root/scripts/gen_cc_mod/ver.x.y/bin/gen_cc_mod.sh /root/bin/gen_cc_mod
 
 # Setting PATH
 export PATH=${PATH}:/root/bin/
@@ -69,7 +71,7 @@ gen_cc_mod GTKMyOption
 
 Code structure:
 ```
-.
+sh_tool/
 ├── bin/
 │   └── gen_cc_mod.sh
 ├── conf/

docs/Makefile

@@ -1,19 +1,12 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = build
 
-# Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 .PHONY: help Makefile
 
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/build/html/_sources/index.rst.txt

@@ -41,11 +41,11 @@ To install **gen_cc_mod** type the following:
 
 .. code-block:: bash
 
-   tar xvzf gen_cc_mod-x.y.z.tar.gz
-   cd gen_cc_mod-x.y.z
-   cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.1.0/
-   cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.1.0/
-   cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.1.0/
+   tar xvzf gen_cc_mod-x.y.tar.gz
+   cd gen_cc_mod-x.y
+   cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.x.y/
+   cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.x.y/
+   cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.x.y/
 
 Or You can use Docker to create image/container.
 
@@ -70,7 +70,7 @@ Code structure:
 
 .. code-block:: bash
 
-   .
+   sh_tool/
    ├── bin/
    │   └── gen_cc_mod.sh
    ├── conf/

docs/build/html/_static/jquery.js

@@ -9,7 +9,7 @@
  * Released under the MIT license
  * https://jquery.org/license
  *
- * Date: 2019-04-19T06:52Z
+ * Date: 2021-03-09T19:42Z
  */
 ( function( global, factory ) {
 
@@ -4676,11 +4676,40 @@ var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
 
 
 
-// We have to close these tags to support XHTML (#13200)
-var wrapMap = {
+( function() {
+	var fragment = document.createDocumentFragment(),
+		div = fragment.appendChild( document.createElement( "div" ) ),
+		input = document.createElement( "input" );
+
+	// Support: Android 4.0 - 4.3 only
+	// Check state lost if the name is set (#11217)
+	// Support: Windows Web Apps (WWA)
+	// `name` and `type` must use .setAttribute for WWA (#14901)
+	input.setAttribute( "type", "radio" );
+	input.setAttribute( "checked", "checked" );
+	input.setAttribute( "name", "t" );
+
+	div.appendChild( input );
+
+	// Support: Android <=4.1 only
+	// Older WebKit doesn't clone checked state correctly in fragments
+	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
+
+	// Support: IE <=11 only
+	// Make sure textarea (and checkbox) defaultValue is properly cloned
+	div.innerHTML = "<textarea>x</textarea>";
+	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
 
 	// Support: IE <=9 only
-	option: [ 1, "<select multiple='multiple'>", "</select>" ],
+	// IE <=9 replaces <option> tags with their contents when inserted outside of
+	// the select element.
+	div.innerHTML = "<option></option>";
+	support.option = !!div.lastChild;
+} )();
+
+
+// We have to close these tags to support XHTML (#13200)
+var wrapMap = {
 
 	// XHTML parsers do not magically insert elements in the
 	// same way that tag soup parsers do. So we cannot shorten
@@ -4693,12 +4722,14 @@ var wrapMap = {
 	_default: [ 0, "", "" ]
 };
 
-// Support: IE <=9 only
-wrapMap.optgroup = wrapMap.option;
-
 wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
 wrapMap.th = wrapMap.td;
 
+// Support: IE <=9 only
+if ( !support.option ) {
+	wrapMap.optgroup = wrapMap.option = [ 1, "<select multiple='multiple'>", "</select>" ];
+}
+
 
 function getAll( context, tag ) {
 
@@ -4829,32 +4860,6 @@ function buildFragment( elems, context, scripts, selection, ignored ) {
 
 	return fragment;
 }
-
-
-( function() {
-	var fragment = document.createDocumentFragment(),
-		div = fragment.appendChild( document.createElement( "div" ) ),
-		input = document.createElement( "input" );
-
-	// Support: Android 4.0 - 4.3 only
-	// Check state lost if the name is set (#11217)
-	// Support: Windows Web Apps (WWA)
-	// `name` and `type` must use .setAttribute for WWA (#14901)
-	input.setAttribute( "type", "radio" );
-	input.setAttribute( "checked", "checked" );
-	input.setAttribute( "name", "t" );
-
-	div.appendChild( input );
-
-	// Support: Android <=4.1 only
-	// Older WebKit doesn't clone checked state correctly in fragments
-	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
-
-	// Support: IE <=11 only
-	// Make sure textarea (and checkbox) defaultValue is properly cloned
-	div.innerHTML = "<textarea>x</textarea>";
-	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
-} )();
 var documentElement = document.documentElement;
 
 
@@ -5591,13 +5596,6 @@ jQuery.fn.extend( {
 
 var
 
-	/* eslint-disable max-len */
-
-	// See https://github.com/eslint/eslint/issues/3229
-	rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,
-
-	/* eslint-enable */
-
 	// Support: IE <=10 - 11, Edge 12 - 13 only
 	// In IE/Edge using regex groups here causes severe slowdowns.
 	// See https://connect.microsoft.com/IE/feedback/details/1736512/
@@ -5794,7 +5792,7 @@ function remove( elem, selector, keepData ) {
 
 jQuery.extend( {
 	htmlPrefilter: function( html ) {
-		return html.replace( rxhtmlTag, "<$1></$2>" );
+		return html;
 	},
 
 	clone: function( elem, dataAndEvents, deepDataAndEvents ) {

docs/build/html/_static/underscore.js

@@ -1550,6 +1550,13 @@
     return '\\' + escapes[match];
   };
 
+  // In order to prevent third-party code injection through
+  // `_.templateSettings.variable`, we test it against the following regular
+  // expression. It is intentionally a bit more liberal than just matching valid
+  // identifiers, but still prevents possible loopholes through defaults or
+  // destructuring assignment.
+  var bareIdentifier = /^\s*(\w|\$)+\s*$/;
+
   // JavaScript micro-templating, similar to John Resig's implementation.
   // Underscore templating handles arbitrary delimiters, preserves whitespace,
   // and correctly escapes quotes within interpolated code.
@@ -1585,16 +1592,25 @@
     });
     source += "';\n";
 
-    // If a variable is not specified, place data values in local scope.
-    if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n';
+    var argument = settings.variable;
+    if (argument) {
+      // Insure against third-party code injection.
+      if (!bareIdentifier.test(argument)) throw new Error(
+        'variable is not a bare identifier: ' + argument
+      );
+    } else {
+      // If a variable is not specified, place data values in local scope.
+      source = 'with(obj||{}){\n' + source + '}\n';
+      argument = 'obj';
+    }
 
     source = "var __t,__p='',__j=Array.prototype.join," +
       "print=function(){__p+=__j.call(arguments,'');};\n" +
       source + 'return __p;\n';
 
     var render;
     try {
-      render = new Function(settings.variable || 'obj', '_', source);
+      render = new Function(argument, '_', source);
     } catch (e) {
       e.source = source;
       throw e;
@@ -1605,7 +1621,6 @@
     };
 
     // Provide the compiled source as a convenience for precompilation.
-    var argument = settings.variable || 'obj';
     template.source = 'function(' + argument + '){\n' + source + '}';
 
     return template;

docs/build/html/genindex.html

@@ -59,6 +59,10 @@
 
 
 
+              <div class="version">
+                1.0
+              </div>
+
 
 
 

docs/build/html/index.html

@@ -58,6 +58,10 @@
 
 
 
+              <div class="version">
+                1.0
+              </div>
+
 
 
 
@@ -163,11 +167,11 @@ <h1>gen_cc_mod<a class="headerlink" href="#gen-cc-mod" title="Permalink to this
 <h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
 <p>Navigate to release <a class="reference external" href="https://github.com/vroncevic/gen_cc_mod/releases">page</a> download and extract release archive.</p>
 <p>To install <strong>gen_cc_mod</strong> type the following:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>tar xvzf gen_cc_mod-x.y.z.tar.gz
-<span class="nb">cd</span> gen_cc_mod-x.y.z
-cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.1.0/
-cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.1.0/
-cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.1.0/
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>tar xvzf gen_cc_mod-x.y.tar.gz
+<span class="nb">cd</span> gen_cc_mod-x.y
+cp -R ~/sh_tool/bin/   /root/scripts/gen_cc_mod/ver.x.y/
+cp -R ~/sh_tool/conf/  /root/scripts/gen_cc_mod/ver.x.y/
+cp -R ~/sh_tool/log/   /root/scripts/gen_cc_mod/ver.x.y/
 </pre></div>
 </div>
 <p>Or You can use Docker to create image/container.</p>
@@ -184,7 +188,7 @@ <h1>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to t
 <h1>Shell tool structure<a class="headerlink" href="#shell-tool-structure" title="Permalink to this headline">¶</a></h1>
 <p><strong>gen_cc_mod</strong> is based on MOP.</p>
 <p>Code structure:</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>.
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sh_tool/
 ├── bin/
 │   └── gen_cc_mod.sh
 ├── conf/

docs/build/html/search.html

@@ -60,6 +60,10 @@
 
 
 
+              <div class="version">
+                1.0
+              </div>
+
 
 
 

docs/make.bat

@@ -2,8 +2,6 @@
 
 pushd %~dp0
 
-REM Command file for Sphinx documentation
-
 if "%SPHINXBUILD%" == "" (
 	set SPHINXBUILD=sphinx-build
 )