#!/usr/bin/env python
# -*- coding: utf-8 -*-
#
# (c) Copyright 2003-2007 Hewlett-Packard Development Company, L.P.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
#
# Author: Don Welch
#


__version__ = '3.2'
__title__ = 'Printer Discovery Utility'
__doc__ = "Discover USB, parallel, and network printers."


# Std Lib
import sys, getopt

# Local
from base.g import *
from base import device, utils


USAGE = [(__doc__, "", "name", True),
         ("Usage: hp-probe [OPTIONS]", "", "summary", True),
         utils.USAGE_OPTIONS,
         ("Bus to probe:", "-b<bus> or --bus=<bus>", "option", False),
         ("", "<bus>: cups, usb\*, net, bt, fw, par (\*default) (Note: bt and fw not supported in this release.)", "option", False),
         ("Set Time to Live (TTL):", "-t<ttl> or --ttl=<ttl> (Default is 4).", "option", False),
         ("Set timeout:", "-o<timeout in secs.> or --timeout=<timeout is secs.>", "option", False),
         ("Filter by functionality:", "-e<filter list> or --filter=<filter list>", "option", False),
         ("", "<filter list>: comma separated list of one or more of: scan, pcard, fax, copy, or none\*. (\*none is the default)", "option", False),
         ("Search:", "-s<search re> or --search=<search re>", "option", False),
         ("", "<search re> must be a valid regular expression (not case sensitive)", "option", False),
         ("Network discovery method:", "-m<method> or --method=<method>: <method> is 'slp'* or 'mdns'.", "option", False),
         utils.USAGE_LOGGING1, utils.USAGE_LOGGING2, utils.USAGE_LOGGING3,
         utils.USAGE_HELP,
         utils.USAGE_SPACE,
         utils.USAGE_EXAMPLES,
         ("Find all devices on the network:", "hp-probe -bnet", "example", False),
         ("Find all devices on USB that support scanning:", "hp-probe -busb -escan", "example", False),
         ("Find all networked devices that contain the name 'lnx' and that support photo cards or scanning:", "hp-probe -bnet -slnx -escan,pcard", "example", False),
         ("Find all devices that have queues installed in CUPS:", "hp-probe -bcups", "example", False),
         ("Find all devices on the USB bus:", "hp-probe", "example", False),
         ]

def usage(typ='text'):
    if typ == 'text':
        utils.log_title(__title__, __version__)

    utils.format_text(USAGE, typ, __title__, 'hp-probe', __version__)
    sys.exit(0)


log.set_module('hp-probe')



try:
    opts, args = getopt.getopt(sys.argv[1:],
                                'hl:b:t:o:e:s:gm:',
                                ['help', 'help-rest', 'help-man',
                                  'help-desc',
                                  'logging=',
                                  'bus=',
                                  'event=',
                                  'ttl=',
                                  'timeout=',
                                  'filter=',
                                  'search=',
                                  'method=',
                                ]
                              )
except getopt.GetoptError:
    usage()

log_level = logger.DEFAULT_LOG_LEVEL
bus = "usb"
align_debug = False
timeout=10
ttl=4
filter = 'none'
search = ''
method = 'slp'

if os.getenv("HPLIP_DEBUG"):
    log.set_level('debug')

for o, a in opts:

    if o in ('-h', '--help'):
        usage()

    elif o == '--help-rest':
        usage('rest')

    elif o == '--help-man':
        usage('man')

    elif o == '--help-desc':
        print __doc__,
        sys.exit(0)

    elif o == '-g':
        log.set_level('debug')

    elif o in ('-b', '--bus'):
        try:
            bus = a.lower().strip()
        except:
            bus = 'usb'

        if not device.validateBusList(bus):
            usage()

    elif o in ('-l', '--logging'):
        log_level = a.lower().strip()
        if not log.set_level(log_level):
            usage()

    elif o in ('-m', '--method'):
        method = a.lower().strip()

        if method not in ('slp', 'mdns', 'bonjour'):
            log.error("Invalid network search protocol: %s (must be 'slp' or 'mdns')" % method)
            method = 'slp'

        else:
            bus = 'net'

    elif o in ('-t', '--ttl'):
        try:
            ttl = int(a)
        except ValueError:
            ttl = 4
            log.note("TTL value error. TTL set to default of 4 hops.")

    elif o in ('-o', '--timeout'):
        try:
            timeout = int(a)
            if timeout > 45:
                log.note("Timeout > 45secs. Setting to 45secs.")
                timeout = 45
        except ValueError:
            timeout = 5
            log.note("Timeout value error. Timeout set to default of 5secs.")

        if timeout < 0:
            log.error("You must specify a positive timeout in seconds.")
            usage()

    elif o in ('-e', '--filter'):
        filter = a.lower().strip()
        if not device.validateFilterList(filter):
            usage()

    elif o in ('-s', '--search'):
        search = a.lower().strip()

utils.log_title(__title__, __version__)

buses = bus
for bus in buses.split(','):
    if bus == 'net':
        log.info(utils.bold("Probing network for printers. Please wait, this will take approx. %d seconds...\n" % timeout))

    devices = device.probeDevices(None, bus, timeout, ttl, filter, search, method)
    cleanup_spinner()

    max_c1, max_c2, max_c3, max_c4 = 0, 0, 0, 0

    if devices:
        for d in devices:
            max_c1 = max(len(d), max_c1)
            max_c3 = max(len(devices[d][0]), max_c3)
            max_c4 = max(len(devices[d][2]), max_c4)

        if bus == 'net':
            formatter = utils.TextFormatter(
                        (
                            {'width': max_c1, 'margin' : 2},
                            {'width': max_c3, 'margin' : 2},
                            {'width': max_c4, 'margin' : 2},
                        )
                    )

            log.info(formatter.compose(("Device URI", "Model", "Name")))
            log.info(formatter.compose(('-'*max_c1, '-'*max_c3, '-'*max_c4)))
            for d in devices:
                log.info(formatter.compose((d, devices[d][0], devices[d][2])))

        elif bus in ('usb', 'par', 'cups'):
            formatter = utils.TextFormatter(
                        (
                            {'width': max_c1, 'margin' : 2},
                            {'width': max_c3, 'margin' : 2},
                        )
                    )

            log.info(formatter.compose(("Device URI", "Model")))
            log.info(formatter.compose(('-'*max_c1, '-'*max_c3)))
            for d in devices:
                log.info(formatter.compose((d, devices[d][0])))

        else:
            log.error("Invalid bus: %s" % bus)

        log.info("\nFound %d printer(s) on the '%s' bus.\n" % (len(devices), bus))

    else:
        log.warn("No devices found on the '%s' bus. If this isn't the result you are expecting," % bus)

        if bus == 'net':
            log.warn("check your network connections and make sure your internet")
            log.warn("firewall software is disabled.")
        else:
            log.warn("check to make sure your devices are properly connected and powered on.")


