Skip to content

Syntaxchecks for Bash, PHP, Python, Ruby, Yaml and Crontab files. Ready to use with Jenkins, Bamboo, Bitbucket Pipelines and Travis CI.

License

Notifications You must be signed in to change notification settings

neikei/syntaxchecks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Syntaxchecks

Build Status

Introduction

The syntaxchecks are for PHP, Python, Ruby, Yaml and Crontab files. It is easy to use and implement into continuous integration tools like Jenkins, Bamboo and Bitbucket Pipeline.

Requirements

  • Git >= 1.7
  • PHP >= 5.6
  • Python >= 2.7.12
  • Ruby >= 2.3.1
# Installation on Debian/Ubuntu
sudo apt install git php-cli python ruby

Implemented checks

  • Bash
  • PHP
  • Python
  • Ruby
  • YAML
  • Crontabs

Parameter

Parameter Description Example
-p Path to the project -p "/tmp/project"
-s Enable strict mode (Default: off) -s
-a Check all files in path -a
-c Check files in last commits -c 1
-r Overwrite exclude regex -r "^./vendor/.$"

Usage

Manual execution

# Check all files in project
./syntaxchecks.sh -p "/tmp/project" -a

# Check all files in project and stop at the first error
./syntaxchecks.sh -p "/tmp/project" -a -s

# Check all files in the last 5 commits of the project and stop at the first error
./syntaxchecks.sh -p "/tmp/project" -c 5 -s

Makefile

.PHONY: syntaxcheck
syntaxcheck:
        @echo "==> Syntaxcheck started"
        wget https://github.com/neikei/syntaxchecks/archive/master.zip
        unzip master.zip && rm master.zip
        syntaxchecks-master/syntaxchecks.sh -p "`pwd`" -a -s
        rm -rf syntaxchecks-master
        @echo -e "==> Syntaxcheck finished\n"

Jenkins

# Install syntaxchecks in the home path of the jenkins application user
su - jenkins
cd ~
git clone https://github.com/neikei/syntaxchecks.git

# Build step to execute the syntaxchecks with Jenkins
~/syntaxchecks/syntaxchecks.sh -p "`pwd`" -c 1 -s

Bamboo

# Install syntaxchecks in the home path of the bamboo application user
su - bamboo
cd ~
git clone https://github.com/neikei/syntaxchecks.git

# Build step to execute the syntaxchecks with Bamboo
~/syntaxchecks/syntaxchecks.sh -p "${bamboo.build.working.directory}" -c 1 -s

Bitbucket Pipelines

image: php:7.1.1

pipelines:
  default:
    - step:
        script:
          - apt-get update && apt-get install -y unzip wget git php-cli python ruby
          - wget https://github.com/neikei/syntaxchecks/archive/master.zip
          - unzip master.zip && rm master.zip
          - syntaxchecks-master/syntaxchecks.sh -p "`pwd`" -c 1 -s
          - rm -rf syntaxchecks-master

Travis CI

script:
  - wget https://github.com/neikei/syntaxchecks/archive/master.zip
  - unzip master.zip && rm master.zip
  - syntaxchecks-master/syntaxchecks.sh -p "`pwd`" -a -s

Regular expressions

# find files for syntaxchecks
regex_bash_files="^.*\.sh$"
regex_php_files="^.*\.(php|php.skel|php.skel.*)$"
regex_yaml_files="^.*\.(yaml|yml)$"
regex_python_files="^.*\.py$"
regex_ruby_files="^.*(\.rb|Vagrantfile)$"
regex_crontab_files="^.*\.cron$"
# exclude vendor and cache directories
regex_exclude="^.*/(vendor|cache)/.*$"

Third party software

  • chkcrontab - Modified to check crontabs without defiened user.

Example crontab format:

# m h  dom mon dow   command
0 5 * * 1 echo "Hello world!"

About

Syntaxchecks for Bash, PHP, Python, Ruby, Yaml and Crontab files. Ready to use with Jenkins, Bamboo, Bitbucket Pipelines and Travis CI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published