[qa] Added linting of JS and CSS #173

.github/workflows/ci.yml

@@ -42,6 +42,9 @@ jobs:
       run: |
         pip install -U pip wheel setuptools
         pip install -U -r requirements-test.txt
+
+    - name: Install npm dependencies
+      run: sudo npm install -g jshint stylelint
 
     - name: Install openwisp-utils
       run: |

.jshintrc

@@ -0,0 +1,21 @@
+{
+    "unused": true,
+    "esversion": 6,
+    "curly": true,
+    "strict": "global",
+    "globals": {
+        "django": true,
+        "gettext": true,
+        "ReconnectingWebSocket": true,
+        "notificationApiHost": true,
+        "notificationSound": true,
+        "notificationSocket": true,
+        "owNotifyObjectId": true,
+        "owNotifyAppLabel": true,
+        "owNotifyModelName": true,
+        "owIsChangeForm": true,
+        "getAbsoluteUrl": true,
+        "dateTimeStampToDateTimeLocaleString": true
+    },
+    "browser": true
+}

.stylelintrc.json

@@ -0,0 +1,19 @@
+{
+    "rules": {
+      "block-no-empty": null,
+      "color-no-invalid-hex": true,
+      "comment-empty-line-before": ["always", {
+        "ignore": ["stylelint-commands", "after-comment"]
+      }],
+      "declaration-colon-space-after": "always",
+      "indentation": [2, {
+        "except": ["value"]
+      }],
+      "max-empty-lines": 4,
+      "rule-empty-line-before": ["never-multi-line", {
+        "except": ["first-nested"],
+        "ignore": ["after-comment", "inside-block"]
+      }],
+      "unit-allowed-list": ["em", "rem", "%", "s", "px", "vh", "deg"]
+    }
+}

README.rst

@@ -814,6 +814,7 @@ automated builds of different OpenWISP modules.
 ^^^^^^^^^^^^^^^^^^^^^^
 
 Shell script to automatically format Python code. It runs ``isort`` and ``black``.
+It also runs ``stylelint`` to format CSS code.
 
 ``openwisp-qa-check``
 ^^^^^^^^^^^^^^^^^^^^^
@@ -828,6 +829,8 @@ Shell script to run the following quality assurance checks:
 * ``flake8`` - Python code linter
 * ``isort`` - Sorts python imports alphabetically, and seperated into sections
 * ``black`` - Formats python code using a common standard
+* ``csslinter`` - Formats and checks CSS code using stylelint common standard
+* ``jslinter`` - Checks Javascript code using jshint common standard
 
 If a check requires a flag, it can be passed forward in the same way.
 
@@ -841,6 +844,17 @@ Usage example::
 
     openwisp-qa-check --skip-isort
 
+For backward compatibility ``csslinter`` and ``jslinter`` are skipped by default.
+To run them in checks pass arguements in this way.
+
+Usage example::
+
+    # To active csslinter
+    openwisp-qa-check --csslinter
+
+    # To activate jslinter
+    openwisp-qa-check --jslinter
+
 You can do multiple ``checkmigrations`` by passing the arguments with space-delimited string.
 
 For example, this multiple ``checkmigrations``::
@@ -1118,6 +1132,12 @@ Install test requirements:
 
     pip install -r requirements-test.txt
 
+Install node dependencies used for testing:
+
+.. code-block:: shell
+
+    npm install -g stylelint jshint
+
 Set up the pre-push hook to run tests and QA checks automatically right before the git push action, so that if anything fails the push operation will be aborted:
 
 .. code-block:: shell

openwisp-qa-check

@@ -11,8 +11,11 @@ show_help() {
   printf "            [--skip-isort]\n"
   printf "            [--skip-black]\n"
   printf "            [--skip-checkrst]\n"
+  printf "            [--csslinter]\n"
+  printf "            [--jslinter]\n"
   printf "\n"
   printf "Runs all checks for quality assurance. Unneeded checks may be skipped by passing --skip-<check-name> argument.\n"
+  printf "csslinter and jslinter checks are skipped by default for backward compatibility. To run them pass --csslinter or --jslinter as an argument.\n"
   printf "\n"
   printf "General options:\n"
   printf "  --help\t\t\t: Show this help text\n"
@@ -37,6 +40,10 @@ show_help() {
   printf "  --skip-black\t\t\t: Skip black check\n"
   printf "ReStructuredText check options:\n"
   printf "  --skip-checkrst\t\t: Skip ReStructuredText check\n"
+  printf "CSSlinter check options:\n"
+  printf "  --csslinter\t\t\t: Runs stylelint check\n"
+  printf "Jslinter check options:\n"
+  printf "  --jslinter\t\t\t: Runs jshint check\n"
 }
 
 echoerr() { echo "$@" 1>&2; }
@@ -60,6 +67,45 @@ runcheckendline() {
   fi
 }
 
+runstylelintcheck() {
+  package='stylelint'
+  if which node > /dev/null
+    then
+      if [ `npm list -g | grep -c $package` -eq 0 ]; then
+        echo "MODULE NOT FOUND: please install ${package}"
+      else
+        stylelint $(find . -type f -name "*.css") &&
+        echo "SUCCESS: Stylelint check successful!" ||
+        {
+          echoerr "ERROR: Stylelint check failed! Hint: did you forget running openwisp-qa-format?"
+          FAILURE=1
+        }
+      fi
+  else
+    echo "MODULE NOT FOUND: please install node and ${package}"
+  fi
+}
+
+runjshintcheck() {
+  package='jshint'
+  if which node > /dev/null
+    then
+      if [ `npm list -g | grep -c $package` -eq 0 ]; then
+        echo "MODULE NOT FOUND: please install ${package}"
+      else
+        jshint --verbose $(find . -type f -name "*.js" -a ! -path "*vendor/*.js") &&
+        echo "SUCCESS: Jshint check successful!" ||
+        {
+          echoerr "ERROR: Jshint check failed! Hint: please follow js code conventions.\
+          visit: https://openwisp.io/docs/developer/contributing.html#javascript-code-conventions"
+          FAILURE=1
+        }
+      fi
+  else
+    echo "MODULE NOT FOUND: please install node and ${package}"
+  fi
+}
+
 runcheckmigrations() {
   if [ "$MIGRATION_PATH" == "" ]; then
     echoerr "SKIPPED: No migration path specified!"
@@ -151,6 +197,8 @@ SKIP_ISORT=false
 SKIP_RSTCHECK=false
 SKIP_BLACK=false
 SKIP_CHECKCOMMIT=false
+SKIP_CSS_LINTER=true
+SKIP_JS_LINTER=true
 MIGRATION_PATH=""
 MIGRATIONS_TO_IGNORE="0"
 COMMIT_MESSAGE=$(git log $TRAVIS_PULL_REQUEST_SHA --format=%B -n 1)
@@ -188,6 +236,12 @@ while [ "$1" != "" ]; do
   --skip-checkcommit)
     SKIP_CHECKCOMMIT=true
     ;;
+  --csslinter)
+    SKIP_CSS_LINTER=false
+    ;;
+  --jslinter)
+    SKIP_JS_LINTER=false
+    ;;
   --message)
     shift
     COMMIT_MESSAGE="$1"
@@ -235,6 +289,14 @@ if ! $SKIP_FLAKE8; then
   runflake8
 fi
 
+if ! $SKIP_CSS_LINTER; then
+  runstylelintcheck
+fi
+
+if ! $SKIP_JS_LINTER; then
+  runjshintcheck
+fi
+
 if ! $SKIP_RSTCHECK; then
   runrstcheck
 fi

openwisp-qa-format

@@ -3,3 +3,4 @@ set -e
 
 isort .
 black -S .
+stylelint $(find . -type f -name "*.css") --fix