setup_commands.py

from distutils.core import Command
import sys
import os
import shutil

#---------------------------------------------------------------------------#
# Extra Commands
#---------------------------------------------------------------------------#


class BuildApiDocsCommand(Command):
    """ Helper command to build the available api documents
    This scans all the subdirectories under api and runs the
    build.py script underneath trying to build the api
    documentation for the given format.
    """
    description = "build all the projects api documents"
    user_options = []

    def initialize_options(self):
        """ options setup """
        if not os.path.exists('./build'):
            os.mkdir('./build')

    def finalize_options(self):
        """ options teardown """
        pass

    def run(self):
        """ command runner """
        old_cwd = os.getcwd()
        directories = (d for d in os.listdir('./doc/api') if not d.startswith('.'))
        for entry in directories:
            os.chdir('./doc/api/%s' % entry)
            os.system('python build.py')
            os.chdir(old_cwd)


class DeepCleanCommand(Command):
    """ Helper command to return the directory to a completely
        clean state.
    """
    description = "clean everything that we don't want"
    user_options = []

    def initialize_options(self):
        """ options setup """
        self.trash = [
            'build', 'dist', 'pymodbus3.egg-info',
            os.path.join(os.path.join('doc', 'sphinx'), 'build'),
        ]

    def finalize_options(self):
        pass

    def run(self):
        """ command runner """
        self.__delete_pyc_files()
        self.__delete_trash_dirs()

    def __delete_trash_dirs(self):
        """ remove all directories created in building """
        self.__delete_pyc_files()
        for directory in self.trash:
            if os.path.exists(directory):
                shutil.rmtree(directory)

    def __delete_pyc_files(self):
        """ remove all python cache files """
        for root, dirs, files in os.walk('.'):
            for file in files:
                if file.endswith('.pyc'):
                    os.remove(os.path.join(root, file))


class LintCommand(Command):
    """ Helper command to perform a lint scan of the
    sourcecode and return the results.
    """
    description = "perform a lint scan of the code"
    user_options = []

    def initialize_options(self):
        """ options setup """
        if not os.path.exists('./build'):
            os.mkdir('./build')

    def finalize_options(self):
        pass

    def run(self):
        """ command runner """
        scanners = [s for s in dir(self) if s.find('__try') >= 0]
        for scanner in scanners:
            if getattr(self, scanner)():
                break

    def __try_pyflakes(self):
        try:
            from pyflakes.scripts.pyflakes import main
            sys.argv = '''pyflakes pymodbus3'''.split()
            main()
            return True
        except:
            return False

    def __try_pychecker(self):
        try:
            import pychecker
            sys.argv = '''pychecker pymodbus3/*.py'''.split()
            main()
            return True
        except:
            return False

    def __try_pylint(self):
        try:
            import pylint
            sys.argv = '''pylint pymodbus3/*.py'''.split()
            main()
            return True
        except:
            return False


class Pep8Command(Command):
    """ Helper command to scan for potential pep8 violations
    """
    description = "perform pep8 scan of the code"
    user_options = []

    def initialize_options(self):
        """ options setup """
        if not os.path.exists('./build'):
            os.mkdir('./build')
        self.directories = ['pymodbus3']

    def finalize_options(self):
        pass

    def run(self):
        """ command runner """
        self.__run_pep8()

    def __run_pep8(self):
        try:
            from pep8 import _main as main
            sys.argv = '''pep8 --repeat --count --statistics
            '''.split() + self.directories
            main()
            return True
        except:
            return False

#---------------------------------------------------------------------------# 
# Command Configuration
#---------------------------------------------------------------------------# 
command_classes = {
    'deep_clean': DeepCleanCommand,
    'build_apidocs': BuildApiDocsCommand,
    'lint': LintCommand,
    'pep8': Pep8Command,
}

#---------------------------------------------------------------------------# 
# Export command list
#---------------------------------------------------------------------------# 
__all__ = ['command_classes']