openerpcommand/common.py

   1 """
   2 Define a few common arguments for server-side command-line tools.
   3 """
   4 import argparse
   5 import os
   6 try:
   7     from setproctitle import setproctitle
   8 except ImportError:
   9     setproctitle = lambda x: None
  10 import sys
  11
  12 def add_addons_argument(parser):
  13     """
  14     Add a common --addons argument to a parser.
  15     """
  16     parser.add_argument('--addons', metavar='ADDONS',
  17         **required_or_default('ADDONS',
  18                               'colon-separated list of paths to addons'))
  19 def set_addons(args):
  20     """
  21     Turn args.addons into a list instead of a column-separated strings.
  22     Set openerp.toools.config accordingly.
  23     """
  24     import openerp.tools.config
  25     config = openerp.tools.config
  26
  27     assert hasattr(args, 'addons')
  28     if args.addons:
  29         args.addons = args.addons.split(':')
  30     else:
  31         args.addons = []
  32
  33     config['addons_path'] = ','.join(args.addons)
  34
  35 def get_addons_from_paths(paths, exclude):
  36     """
  37     Build a list of available modules from a list of addons paths.
  38     """
  39     exclude = exclude or []
  40     module_names = []
  41     for p in paths:
  42         if os.path.exists(p):
  43             names = list(set(os.listdir(p)))
  44             names = filter(lambda a: not (a.startswith('.') or a in exclude), names)
  45             names = filter(lambda a: os.path.isdir(os.path.join(p, a)), names)
  46             names = filter(lambda a: os.path.exists(os.path.join(p, a, '__openerp__.py')), names)
  47             module_names.extend(names)
  48         else:
  49             print "The addons path `%s` doesn't exist." % p
  50             sys.exit(1)
  51     return module_names
  52
  53 def required_or_default(name, h):
  54     """
  55     Helper to define `argparse` arguments. If the name is the environment,
  56     the argument is optional and draw its value from the environment if not
  57     supplied on the command-line. If it is not in the environment, make it
  58     a mandatory argument.
  59     """
  60     if os.environ.get('OPENERP_' + name.upper()):
  61         d = {'default': os.environ['OPENERP_' + name.upper()]}
  62     else:
  63         d = {'required': True}
  64     d['help'] = h + '. The environment variable OPENERP_' + \
  65         name.upper() + ' can be used instead.'
  66     return d
  67
  68 class Command(object):
  69     """
  70     Base class to create command-line tools. It must be inherited and the
  71     run() method overriden.
  72     """
  73
  74     command_name = 'stand-alone'
  75
  76     def __init__(self, subparsers=None):
  77         if subparsers:
  78             self.parser = parser = subparsers.add_parser(self.command_name,
  79                 description=self.__class__.__doc__)
  80         else:
  81             self.parser = parser = argparse.ArgumentParser(
  82                 description=self.__class__.__doc__)
  83
  84         parser.add_argument('-d', '--database', metavar='DATABASE',
  85             **required_or_default('DATABASE', 'the database to connect to'))
  86         parser.add_argument('-u', '--user', metavar='USER',
  87             **required_or_default('USER', 'the user login or ID. When using '
  88             'RPC, providing an ID avoid the login() step'))
  89         parser.add_argument('-p', '--password', metavar='PASSWORD',
  90             **required_or_default('PASSWORD', 'the user password')) # TODO read it from the command line or from file.
  91
  92         parser.set_defaults(run=self.run_with_args)
  93
  94     def run_with_args(self, args):
  95         self.args = args
  96         self.run()
  97
  98     def run(self):
  99         print 'Stub Command.run().'
 100
 101     @classmethod
 102     def stand_alone(cls):
 103         """
 104         A single Command object is a complete command-line program. See
 105         `openerp-command/stand-alone` for an example.
 106         """
 107         command = cls()
 108         args = command.parser.parse_args()
 109         args.run(args)