#!/usr/bin/python3
# -*- coding: utf-8 -*-
#
# (c) Copyright 2003-2015 HP 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__ = '4.1'
__mod__ = 'hp-probe'
__title__ = 'Printer Discovery Utility'
__doc__ = "Discover HPLIP supported USB, parallel, and network attached printers."
# Std Lib
import sys
import getopt
import operator
import os
# Local
from base.g import *
from base import device, utils, tui, module
USAGE = [(__doc__, "", "name", True),
("Usage: %s [OPTIONS]" % __mod__, "", "summary", True),
utils.USAGE_OPTIONS,
("Bus to probe:", "-b<bus> or --bus=<bus>", "option", False),
("", r"<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),
("", r"<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),
]
try:
mod = module.Module(__mod__, __title__, __version__, __doc__, USAGE,
(INTERACTIVE_MODE,))
opts, device_uri, printer_name, mode, ui_toolkit, loc = \
mod.parseStdOpts('b:t:o:e:s:m:',
['ttl=', 'filter=', 'search=', 'find=',
'method=', 'time-out=', 'timeout=', 'bus='],
handle_device_printer=False)
bus = None
timeout=10
ttl=4
filter = []
search = ''
method = 'slp'
for o, a in opts:
if o in ('-b', '--bus'):
try:
bus = [x.lower().strip() for x in a.split(',')]
except TypeError:
bus = ['usb']
if not device.validateBusList(bus):
mod.usage(error_msg=['Invalid bus name'])
elif o in ('-m', '--method'):
method = a.lower().strip()
if method not in ('slp', 'mdns', 'bonjour'):
mod.usage(error_msg=["Invalid network search protocol name. Must be 'slp' or 'mdns'."])
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', '--time-out'):
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:
mod.usage(error_msg=["You must specify a positive timeout in seconds."])
elif o in ('-e', '--filter'):
filter = [x.strip().lower() for x in a.split(',')]
if not device.validateFilterList(filter):
mod.usage(error_msg=["Invalid term in filter"])
elif o in ('-s', '--search', '--find'):
search = a.lower().strip()
if bus is None:
bus = tui.connection_table()
if bus is None:
sys.exit(0)
log.info("\nUsing connection type: %s" % bus[0])
log.info("")
tui.header("DEVICE DISCOVERY")
for b in bus:
if b == 'net':
log.info(log.bold("Probing network for printers. Please wait, this will take approx. %d seconds...\n" % timeout))
FILTER_MAP = {'print' : None,
'none' : None,
'scan': 'scan-type',
'copy': 'copy-type',
'pcard': 'pcard-type',
'fax': 'fax-type',
}
filter_dict = {}
for f in filter:
if f in FILTER_MAP:
filter_dict[FILTER_MAP[f]] = (operator.gt, 0)
else:
filter_dict[f] = (operator.gt, 0)
log.debug(filter_dict)
devices = device.probeDevices([b], timeout, ttl, filter_dict, 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 b == '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 b 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" % b)
log.info("\nFound %d printer(s) on the '%s' bus.\n" % (len(devices), b))
else:
log.warn("No devices found on the '%s' bus. If this isn't the result you are expecting," % b)
if b == '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.")
except KeyboardInterrupt:
log.error("User exit")
log.info("")
log.info("Done.")
Mini Shell