![\"wukong-robot\"](\"http://hahack-1253537070.file.myqcloud.com/images/wukong-icons/256_256.png\"){kind=icon}
\n \n\n \n \n \n
\n wukong-robot 是一个简单、灵活、优雅的中文语音对话机器人/智能音箱项目，目的是让中国的 Maker 和 Haker 们也能快速打造个性化的智能音箱。wukong-robot 还可能是第一个开源的脑机唤醒智能音箱。 \n
\n\n 截至 2023 年 3 月 31 日，wukong-robot 的安装设备数已超过 13,000 台，唤醒次数累积超过了 700,000 次。\n
\n\n\n ![\"wukong-project\"](\"https://img.shields.io/badge/project-wukong-informational.svg?style=flat-square\"){kind=icon}
\n ![\"捐赠\"](\"https://img.shields.io/badge/%EF%BF%A5-donate-green.svg?style=flat-square\"){kind=icon}
\n ![\"Python3.7+\"](\"https://img.shields.io/badge/Python-){kind=icon}
![\"docker-pulls\"](\"https://img.shields.io/docker/pulls/wzpan/wukong-robot.svg?style=flat-square&colorB=success\")
\n ![\"browse-code\"](\"https://img.shields.io/badge/browse-code-purple.svg?style=flat-square\"){kind=icon}
\n
\n ![](\"https://opencollective.com/wukong-robot/sponsors.svg?avatarHeight=36\")
\n
\n ![\"wukong-robot\"](\"https://wzpan-1253537070.cos.ap-guangzhou.myqcloud.com/wukong/wukong-robot-3.3.0.png\")
\n
\n ![\"wukong-robot](\"https://wzpan-1253537070.cos.ap-guangzhou.myqcloud.com/wukong/wukong-robot-workflow.png\")
\n
\n ![\"demo\"](\"https://wzpan-1253537070.cos.ap-guangzhou.myqcloud.com/wukong/user-demo.jpg\")
\n
![](\"http://hahack.com/images/misc/alipay.png\" "\\"支付宝\\"")
| ![](\"http://hahack.com/images/misc/wechatpay.jpeg\" "\\"微信支付\\"")
|\n\n如果以上的图裂了，可以下载图片（[支付宝](http://hahack.com/images/misc/alipay.png) | [微信](http://hahack.com/images/misc/wechatpay.jpeg)）到本地进行扫描。\n\n* 对于企业用户，建议[成为这个项目的 backer](https://opencollective.com/wukong-robot/contribute/tier/8131-sponsor)，您将可以把一个带链接的 logo 放在 wukong-robot 后台管理端的首页、捐赠页面以及 Github 项目首页中。\n\n\n ![](\"https://opencollective.com/wukong-robot/sponsor/0/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/1/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/2/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/3/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/4/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/5/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/6/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/7/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/8/avatar.svg\"){kind=avatar}
\n![](\"https://opencollective.com/wukong-robot/sponsor/9/avatar.svg\"){kind=avatar}
\n
| |\n\n如果以上的图裂了，可以下载图片（[支付宝](http://hahack.com/images/misc/alipay.png) | [微信](http://hahack.com/images/misc/wechatpay.jpeg)）到本地进行扫描。\n\n## 感谢\n\n* 悟空的前身是 [dingdang-robot](https://github.com/dingdang-robot/dingdang-robot) 项目和 [jasper-client](https://github.com/jasperproject/jasper-client) 项目。感谢 [Shubhro Saha](http://www.shubhro.com/), [Charles Marsh](http://www.crmarsh.com/) and [Jan Holthuis](http://homepage.ruhr-uni-bochum.de/Jan.Holthuis/) 在 Jasper 项目上做出的优秀贡献；\n* 感谢三咲智子提供了备选的后台管理端 Demo 体验地址。\n* 感谢 aliciacai 贡献的 wukong-robot 图标。\n* 感谢所有为[本项目](https://github.com/wzpan/wukong-robot/graphs/contributors)、 [wukong-contrib](https://github.com/wzpan/wukong-contrib/graphs/contributors) 项目以及[dingdang-robot](https://github.com/dingdang-robot/dingdang-robot/graphs/contributors) 项目做出过贡献的人！\n\n## Star 历史\n\n[](https://star-history.com/#wzpan/wukong-robot&Date)\n\n## 免责声明\n\n* wukong-robot 只用作个人学习研究，如因使用 wukong-robot 导致任何损失，本人概不负责。\n* 本开源项目与腾讯叮当助手及优必选悟空项目没有任何关系。\n"
},
{
"path": "VERSION",
"content": "3.5.3\n"
},
{
"path": "docker/Dockerfile",
"content": "# 使用官方 Python 3.8 基础镜像\nFROM python:3.8-slim\n\n# 设置工作目录\nWORKDIR /app\n\n# 安装依赖库\nRUN apt-get update && apt-get install -y \\\n git \\\n portaudio19-dev \\\n python3-pyaudio \\\n sox \\\n pulseaudio \\\n libsox-fmt-all \\\n ffmpeg \\\n wget \\\n swig \\\n libpcre3 \\\n libpcre3-dev \\\n libatlas-base-dev \\\n build-essential \\\n && rm -rf /var/lib/apt/lists/*\n\n# 克隆项目仓库\nRUN git clone https://github.com/wzpan/wukong-robot.git .\n\n# 安装 PyAudio\nRUN pip install pyaudio\n\n# 安装 Python 依赖\nRUN pip install --trusted-host pypi.python.org -r requirements.txt\n\n# 安装 wukong-contrib\nRUN mkdir -p $HOME/.wukong \\\n && cd $HOME/.wukong \\\n && git clone http://github.com/wzpan/wukong-contrib.git contrib \\\n && pip install -r contrib/requirements.txt\n\n# 下载并编译 snowboy\nRUN wget https://wzpan-1253537070.cos.ap-guangzhou.myqcloud.com/misc/snowboy.tar.bz2 \\\n && tar -xvjf snowboy.tar.bz2 \\\n && cd snowboy/swig/Python3 \\\n && make \\\n && cp _snowboydetect.so /app/snowboy/\n\n# 暴露端口\nEXPOSE 5001\n\n# 设置 ENTRYPOINT\nENTRYPOINT [\"python\", \"wukong.py\"]\n"
},
{
"path": "docker/DockerfileArm",
"content": "# 使用官方 Python 3.8 基于 ARM 的镜像\nFROM arm32v7/python:3.8-slim\n\nMAINTAINER wzpan\n\n# 设置工作目录\nWORKDIR /app\n\n# 安装依赖库\nRUN apt-get update && apt-get install -y \\\n git \\\n portaudio19-dev \\\n python3-pyaudio \\\n sox \\\n pulseaudio \\\n libsox-fmt-all \\\n ffmpeg \\\n wget \\\n swig \\\n libpcre3 \\\n libpcre3-dev \\\n libatlas-base-dev \\\n libffi-dev \\\n build-essential \\\n && rm -rf /var/lib/apt/lists/*\n\n# 克隆项目仓库\nRUN git clone https://github.com/wzpan/wukong-robot.git .\n\n# 安装 PyAudio\nRUN pip install pyaudio\n\n# 安装 Python 依赖\nRUN pip install --trusted-host pypi.python.org -r requirements.txt\n\n# 安装 wukong-contrib\nRUN mkdir -p $HOME/.wukong \\\n && cd $HOME/.wukong \\\n && git clone http://github.com/wzpan/wukong-contrib.git contrib \\\n && pip install -r contrib/requirements.txt\n\n# 下载并编译 snowboy\nRUN wget https://wzpan-1253537070.cos.ap-guangzhou.myqcloud.com/misc/snowboy.tar.bz2 \\\n && tar -xvjf snowboy.tar.bz2 \\\n && cd snowboy/swig/Python3 \\\n && make \\\n && cp _snowboydetect.so /app/snowboy/\n\n# 暴露端口\nEXPOSE 5001\n\n# 设置 ENTRYPOINT\nENTRYPOINT [\"python\", \"wukong.py\"]\n"
},
{
"path": "docs/.buildinfo",
"content": "# Sphinx build info version 1\n# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.\nconfig: bed81550a26bd552fac818a5876d05a1\ntags: 645f666f9bcd5a90fca523b33c5a78b7\n"
},
{
"path": "docs/.nojekyll",
"content": ""
},
{
"path": "docs/AI.html",
"content": "\n\n\n\n \n\n \n \n \n \n \n# Copyright 2001-2016 by Vinay Sajip. All Rights Reserved.\n#\n# Permission to use, copy, modify, and distribute this software and its\n# documentation for any purpose and without fee is hereby granted,\n# provided that the above copyright notice appear in all copies and that\n# both that copyright notice and this permission notice appear in\n# supporting documentation, and that the name of Vinay Sajip\n# not be used in advertising or publicity pertaining to distribution\n# of the software without specific, written prior permission.\n# VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING\n# ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL\n# VINAY SAJIP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR\n# ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER\n# IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT\n# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n\n"""\nLogging package for Python. Based on PEP 282 and comments thereto in\ncomp.lang.python.\n\nCopyright (C) 2001-2016 Vinay Sajip. All Rights Reserved.\n\nTo use, simply 'import logging' and log away!\n"""\n\nimport sys, os, time, io, traceback, warnings, weakref, collections\n\nfrom string import Template\n\n__all__ = ['BASIC_FORMAT', 'BufferingFormatter', 'CRITICAL', 'DEBUG', 'ERROR',\n 'FATAL', 'FileHandler', 'Filter', 'Formatter', 'Handler', 'INFO',\n 'LogRecord', 'Logger', 'LoggerAdapter', 'NOTSET', 'NullHandler',\n 'StreamHandler', 'WARN', 'WARNING', 'addLevelName', 'basicConfig',\n 'captureWarnings', 'critical', 'debug', 'disable', 'error',\n 'exception', 'fatal', 'getLevelName', 'getLogger', 'getLoggerClass',\n 'info', 'log', 'makeLogRecord', 'setLoggerClass', 'warn', 'warning',\n 'getLogRecordFactory', 'setLogRecordFactory', 'lastResort']\n\ntry:\n import threading\nexcept ImportError: #pragma: no cover\n threading = None\n\n__author__ = "Vinay Sajip <vinay_sajip@red-dove.com>"\n__status__ = "production"\n# The following module attributes are no longer updated.\n__version__ = "0.5.1.2"\n__date__ = "07 February 2010"\n\n#---------------------------------------------------------------------------\n# Miscellaneous module data\n#---------------------------------------------------------------------------\n\n#\n#_startTime is used as the base when calculating the relative time of events\n#\n_startTime = time.time()\n\n#\n#raiseExceptions is used to see if exceptions during handling should be\n#propagated\n#\nraiseExceptions = True\n\n#\n# If you don't want threading information in the log, set this to zero\n#\nlogThreads = True\n\n#\n# If you don't want multiprocessing information in the log, set this to zero\n#\nlogMultiprocessing = True\n\n#\n# If you don't want process information in the log, set this to zero\n#\nlogProcesses = True\n\n#---------------------------------------------------------------------------\n# Level related stuff\n#---------------------------------------------------------------------------\n#\n# Default levels and level names, these can be replaced with any positive set\n# of values having corresponding names. There is a pseudo-level, NOTSET, which\n# is only really there as a lower limit for user-defined levels. Handlers and\n# loggers are initialized with NOTSET so that they will log all messages, even\n# at user-defined levels.\n#\n\nCRITICAL = 50\nFATAL = CRITICAL\nERROR = 40\nWARNING = 30\nWARN = WARNING\nINFO = 20\nDEBUG = 10\nNOTSET = 0\n\n_levelToName = {\n CRITICAL: 'CRITICAL',\n ERROR: 'ERROR',\n WARNING: 'WARNING',\n INFO: 'INFO',\n DEBUG: 'DEBUG',\n NOTSET: 'NOTSET',\n}\n_nameToLevel = {\n 'CRITICAL': CRITICAL,\n 'ERROR': ERROR,\n 'WARN': WARNING,\n 'WARNING': WARNING,\n 'INFO': INFO,\n 'DEBUG': DEBUG,\n 'NOTSET': NOTSET,\n}\n\n[文档]def getLevelName(level):\n """\n Return the textual representation of logging level 'level'.\n\n If the level is one of the predefined levels (CRITICAL, ERROR, WARNING,\n INFO, DEBUG) then you get the corresponding string. If you have\n associated levels with names using addLevelName then the name you have\n associated with 'level' is returned.\n\n If a numeric value corresponding to one of the defined levels is passed\n in, the corresponding string representation is returned.\n\n Otherwise, the string "Level %s" % level is returned.\n """\n # See Issues #22386 and #27937 for why it's this way\n return (_levelToName.get(level) or _nameToLevel.get(level) or\n "Level %s" % level)\n\n[文档]def addLevelName(level, levelName):\n """\n Associate 'levelName' with 'level'.\n\n This is used when converting levels to text during message formatting.\n """\n _acquireLock()\n try: #unlikely to cause an exception, but you never know...\n _levelToName[level] = levelName\n _nameToLevel[levelName] = level\n finally:\n _releaseLock()\n\nif hasattr(sys, '_getframe'):\n currentframe = lambda: sys._getframe(3)\nelse: #pragma: no cover\n def currentframe():\n """Return the frame object for the caller's stack frame."""\n try:\n raise Exception\n except Exception:\n return sys.exc_info()[2].tb_frame.f_back\n\n#\n# _srcfile is used when walking the stack to check when we've got the first\n# caller stack frame, by skipping frames whose filename is that of this\n# module's source. It therefore should contain the filename of this module's\n# source file.\n#\n# Ordinarily we would use __file__ for this, but frozen modules don't always\n# have __file__ set, for some reason (see Issue #21736). Thus, we get the\n# filename from a handy code object from a function defined in this module.\n# (There's no particular reason for picking addLevelName.)\n#\n\n_srcfile = os.path.normcase(addLevelName.__code__.co_filename)\n\n# _srcfile is only used in conjunction with sys._getframe().\n# To provide compatibility with older versions of Python, set _srcfile\n# to None if _getframe() is not available; this value will prevent\n# findCaller() from being called. You can also do this if you want to avoid\n# the overhead of fetching caller information, even when _getframe() is\n# available.\n#if not hasattr(sys, '_getframe'):\n# _srcfile = None\n\n\ndef _checkLevel(level):\n if isinstance(level, int):\n rv = level\n elif str(level) == level:\n if level not in _nameToLevel:\n raise ValueError("Unknown level: %r" % level)\n rv = _nameToLevel[level]\n else:\n raise TypeError("Level not an integer or a valid string: %r" % level)\n return rv\n\n#---------------------------------------------------------------------------\n# Thread-related stuff\n#---------------------------------------------------------------------------\n\n#\n#_lock is used to serialize access to shared data structures in this module.\n#This needs to be an RLock because fileConfig() creates and configures\n#Handlers, and so might arbitrary user threads. Since Handler code updates the\n#shared dictionary _handlers, it needs to acquire the lock. But if configuring,\n#the lock would already have been acquired - so we need an RLock.\n#The same argument applies to Loggers and Manager.loggerDict.\n#\nif threading:\n _lock = threading.RLock()\nelse: #pragma: no cover\n _lock = None\n\n\ndef _acquireLock():\n """\n Acquire the module-level lock for serializing access to shared data.\n\n This should be released with _releaseLock().\n """\n if _lock:\n _lock.acquire()\n\ndef _releaseLock():\n """\n Release the module-level lock acquired by calling _acquireLock().\n """\n if _lock:\n _lock.release()\n\n#---------------------------------------------------------------------------\n# The logging record\n#---------------------------------------------------------------------------\n\n[文档]class LogRecord(object):\n """\n A LogRecord instance represents an event being logged.\n\n LogRecord instances are created every time something is logged. They\n contain all the information pertinent to the event being logged. The\n main information passed in is in msg and args, which are combined\n using str(msg) % args to create the message field of the record. The\n record also includes information such as when the record was created,\n the source line where the logging call was made, and any exception\n information to be logged.\n """\n def __init__(self, name, level, pathname, lineno,\n msg, args, exc_info, func=None, sinfo=None, **kwargs):\n """\n Initialize a logging record with interesting information.\n """\n ct = time.time()\n self.name = name\n self.msg = msg\n #\n # The following statement allows passing of a dictionary as a sole\n # argument, so that you can do something like\n # logging.debug("a %(a)d b %(b)s", {'a':1, 'b':2})\n # Suggested by Stefan Behnel.\n # Note that without the test for args[0], we get a problem because\n # during formatting, we test to see if the arg is present using\n # 'if self.args:'. If the event being logged is e.g. 'Value is %d'\n # and if the passed arg fails 'if self.args:' then no formatting\n # is done. For example, logger.warning('Value is %d', 0) would log\n # 'Value is %d' instead of 'Value is 0'.\n # For the use case of passing a dictionary, this should not be a\n # problem.\n # Issue #21172: a request was made to relax the isinstance check\n # to hasattr(args[0], '__getitem__'). However, the docs on string\n # formatting still seem to suggest a mapping object is required.\n # Thus, while not removing the isinstance check, it does now look\n # for collections.Mapping rather than, as before, dict.\n if (args and len(args) == 1 and isinstance(args[0], collections.Mapping)\n and args[0]):\n args = args[0]\n self.args = args\n self.levelname = getLevelName(level)\n self.levelno = level\n self.pathname = pathname\n try:\n self.filename = os.path.basename(pathname)\n self.module = os.path.splitext(self.filename)[0]\n except (TypeError, ValueError, AttributeError):\n self.filename = pathname\n self.module = "Unknown module"\n self.exc_info = exc_info\n self.exc_text = None # used to cache the traceback text\n self.stack_info = sinfo\n self.lineno = lineno\n self.funcName = func\n self.created = ct\n self.msecs = (ct - int(ct)) * 1000\n self.relativeCreated = (self.created - _startTime) * 1000\n if logThreads and threading:\n self.thread = threading.get_ident()\n self.threadName = threading.current_thread().name\n else: # pragma: no cover\n self.thread = None\n self.threadName = None\n if not logMultiprocessing: # pragma: no cover\n self.processName = None\n else:\n self.processName = 'MainProcess'\n mp = sys.modules.get('multiprocessing')\n if mp is not None:\n # Errors may occur if multiprocessing has not finished loading\n # yet - e.g. if a custom import hook causes third-party code\n # to run when multiprocessing calls import. See issue 8200\n # for an example\n try:\n self.processName = mp.current_process().name\n except Exception: #pragma: no cover\n pass\n if logProcesses and hasattr(os, 'getpid'):\n self.process = os.getpid()\n else:\n self.process = None\n\n def __str__(self):\n return '<LogRecord: %s, %s, %s, %s, "%s">'%(self.name, self.levelno,\n self.pathname, self.lineno, self.msg)\n\n __repr__ = __str__\n\n[文档] def getMessage(self):\n """\n Return the message for this LogRecord.\n\n Return the message for this LogRecord after merging any user-supplied\n arguments with the message.\n """\n msg = str(self.msg)\n if self.args:\n msg = msg % self.args\n return msg\n\n#\n# Determine which class to use when instantiating log records.\n#\n_logRecordFactory = LogRecord\n\n[文档]def setLogRecordFactory(factory):\n """\n Set the factory to be used when instantiating a log record.\n\n :param factory: A callable which will be called to instantiate\n a log record.\n """\n global _logRecordFactory\n _logRecordFactory = factory\n\n[文档]def getLogRecordFactory():\n """\n Return the factory to be used when instantiating a log record.\n """\n\n return _logRecordFactory\n\n[文档]def makeLogRecord(dict):\n """\n Make a LogRecord whose attributes are defined by the specified dictionary,\n This function is useful for converting a logging event received over\n a socket connection (which is sent as a dictionary) into a LogRecord\n instance.\n """\n rv = _logRecordFactory(None, None, "", 0, "", (), None, None)\n rv.__dict__.update(dict)\n return rv\n\n#---------------------------------------------------------------------------\n# Formatter classes and functions\n#---------------------------------------------------------------------------\n\nclass PercentStyle(object):\n\n default_format = '%(message)s'\n asctime_format = '%(asctime)s'\n asctime_search = '%(asctime)'\n\n def __init__(self, fmt):\n self._fmt = fmt or self.default_format\n\n def usesTime(self):\n return self._fmt.find(self.asctime_search) >= 0\n\n def format(self, record):\n return self._fmt % record.__dict__\n\nclass StrFormatStyle(PercentStyle):\n default_format = '{message}'\n asctime_format = '{asctime}'\n asctime_search = '{asctime'\n\n def format(self, record):\n return self._fmt.format(**record.__dict__)\n\n\nclass StringTemplateStyle(PercentStyle):\n default_format = '${message}'\n asctime_format = '${asctime}'\n asctime_search = '${asctime}'\n\n def __init__(self, fmt):\n self._fmt = fmt or self.default_format\n self._tpl = Template(self._fmt)\n\n def usesTime(self):\n fmt = self._fmt\n return fmt.find('$asctime') >= 0 or fmt.find(self.asctime_format) >= 0\n\n def format(self, record):\n return self._tpl.substitute(**record.__dict__)\n\nBASIC_FORMAT = "%(levelname)s:%(name)s:%(message)s"\n\n_STYLES = {\n '%': (PercentStyle, BASIC_FORMAT),\n '{': (StrFormatStyle, '{levelname}:{name}:{message}'),\n '$': (StringTemplateStyle, '${levelname}:${name}:${message}'),\n}\n\n[文档]class Formatter(object):\n """\n Formatter instances are used to convert a LogRecord to text.\n\n Formatters need to know how a LogRecord is constructed. They are\n responsible for converting a LogRecord to (usually) a string which can\n be interpreted by either a human or an external system. The base Formatter\n allows a formatting string to be specified. If none is supplied, the\n default value of "%s(message)" is used.\n\n The Formatter can be initialized with a format string which makes use of\n knowledge of the LogRecord attributes - e.g. the default value mentioned\n above makes use of the fact that the user's message and arguments are pre-\n formatted into a LogRecord's message attribute. Currently, the useful\n attributes in a LogRecord are described by:\n\n %(name)s Name of the logger (logging channel)\n %(levelno)s Numeric logging level for the message (DEBUG, INFO,\n WARNING, ERROR, CRITICAL)\n %(levelname)s Text logging level for the message ("DEBUG", "INFO",\n "WARNING", "ERROR", "CRITICAL")\n %(pathname)s Full pathname of the source file where the logging\n call was issued (if available)\n %(filename)s Filename portion of pathname\n %(module)s Module (name portion of filename)\n %(lineno)d Source line number where the logging call was issued\n (if available)\n %(funcName)s Function name\n %(created)f Time when the LogRecord was created (time.time()\n return value)\n %(asctime)s Textual time when the LogRecord was created\n %(msecs)d Millisecond portion of the creation time\n %(relativeCreated)d Time in milliseconds when the LogRecord was created,\n relative to the time the logging module was loaded\n (typically at application startup time)\n %(thread)d Thread ID (if available)\n %(threadName)s Thread name (if available)\n %(process)d Process ID (if available)\n %(message)s The result of record.getMessage(), computed just as\n the record is emitted\n """\n\n converter = time.localtime\n\n def __init__(self, fmt=None, datefmt=None, style='%'):\n """\n Initialize the formatter with specified format strings.\n\n Initialize the formatter either with the specified format string, or a\n default as described above. Allow for specialized date formatting with\n the optional datefmt argument (if omitted, you get the ISO8601 format).\n\n Use a style parameter of '%', '{' or '$' to specify that you want to\n use one of %-formatting, :meth:`str.format` (``{}``) formatting or\n :class:`string.Template` formatting in your format string.\n\n .. versionchanged:: 3.2\n Added the ``style`` parameter.\n """\n if style not in _STYLES:\n raise ValueError('Style must be one of: %s' % ','.join(\n _STYLES.keys()))\n self._style = _STYLES[style][0](fmt)\n self._fmt = self._style._fmt\n self.datefmt = datefmt\n\n default_time_format = '%Y-%m-%d %H:%M:%S'\n default_msec_format = '%s,%03d'\n\n[文档] def formatTime(self, record, datefmt=None):\n """\n Return the creation time of the specified LogRecord as formatted text.\n\n This method should be called from format() by a formatter which\n wants to make use of a formatted time. This method can be overridden\n in formatters to provide for any specific requirement, but the\n basic behaviour is as follows: if datefmt (a string) is specified,\n it is used with time.strftime() to format the creation time of the\n record. Otherwise, the ISO8601 format is used. The resulting\n string is returned. This function uses a user-configurable function\n to convert the creation time to a tuple. By default, time.localtime()\n is used; to change this for a particular formatter instance, set the\n 'converter' attribute to a function with the same signature as\n time.localtime() or time.gmtime(). To change it for all formatters,\n for example if you want all logging times to be shown in GMT,\n set the 'converter' attribute in the Formatter class.\n """\n ct = self.converter(record.created)\n if datefmt:\n s = time.strftime(datefmt, ct)\n else:\n t = time.strftime(self.default_time_format, ct)\n s = self.default_msec_format % (t, record.msecs)\n return s\n\n[文档] def formatException(self, ei):\n """\n Format and return the specified exception information as a string.\n\n This default implementation just uses\n traceback.print_exception()\n """\n sio = io.StringIO()\n tb = ei[2]\n # See issues #9427, #1553375. Commented out for now.\n #if getattr(self, 'fullstack', False):\n # traceback.print_stack(tb.tb_frame.f_back, file=sio)\n traceback.print_exception(ei[0], ei[1], tb, None, sio)\n s = sio.getvalue()\n sio.close()\n if s[-1:] == "\\n":\n s = s[:-1]\n return s\n\n[文档] def usesTime(self):\n """\n Check if the format uses the creation time of the record.\n """\n return self._style.usesTime()\n\n\n\n[文档] def formatStack(self, stack_info):\n """\n This method is provided as an extension point for specialized\n formatting of stack information.\n\n The input data is a string as returned from a call to\n :func:`traceback.print_stack`, but with the last trailing newline\n removed.\n\n The base implementation just returns the value passed in.\n """\n return stack_info\n\n[文档] def format(self, record):\n """\n Format the specified record as text.\n\n The record's attribute dictionary is used as the operand to a\n string formatting operation which yields the returned string.\n Before formatting the dictionary, a couple of preparatory steps\n are carried out. The message attribute of the record is computed\n using LogRecord.getMessage(). If the formatting string uses the\n time (as determined by a call to usesTime(), formatTime() is\n called to format the event time. If there is exception information,\n it is formatted using formatException() and appended to the message.\n """\n record.message = record.getMessage()\n if self.usesTime():\n record.asctime = self.formatTime(record, self.datefmt)\n s = self.formatMessage(record)\n if record.exc_info:\n # Cache the traceback text to avoid converting it multiple times\n # (it's constant anyway)\n if not record.exc_text:\n record.exc_text = self.formatException(record.exc_info)\n if record.exc_text:\n if s[-1:] != "\\n":\n s = s + "\\n"\n s = s + record.exc_text\n if record.stack_info:\n if s[-1:] != "\\n":\n s = s + "\\n"\n s = s + self.formatStack(record.stack_info)\n return s\n\n#\n# The default formatter to use when no other is specified\n#\n_defaultFormatter = Formatter()\n\n[文档]class BufferingFormatter(object):\n """\n A formatter suitable for formatting a number of records.\n """\n def __init__(self, linefmt=None):\n """\n Optionally specify a formatter which will be used to format each\n individual record.\n """\n if linefmt:\n self.linefmt = linefmt\n else:\n self.linefmt = _defaultFormatter\n\n[文档] def formatHeader(self, records):\n """\n Return the header string for the specified records.\n """\n return ""\n\n\n\n[文档] def format(self, records):\n """\n Format the specified records and return the result as a string.\n """\n rv = ""\n if len(records) > 0:\n rv = rv + self.formatHeader(records)\n for record in records:\n rv = rv + self.linefmt.format(record)\n rv = rv + self.formatFooter(records)\n return rv\n\n#---------------------------------------------------------------------------\n# Filter classes and functions\n#---------------------------------------------------------------------------\n\n[文档]class Filter(object):\n """\n Filter instances are used to perform arbitrary filtering of LogRecords.\n\n Loggers and Handlers can optionally use Filter instances to filter\n records as desired. The base filter class only allows events which are\n below a certain point in the logger hierarchy. For example, a filter\n initialized with "A.B" will allow events logged by loggers "A.B",\n "A.B.C", "A.B.C.D", "A.B.D" etc. but not "A.BB", "B.A.B" etc. If\n initialized with the empty string, all events are passed.\n """\n def __init__(self, name=''):\n """\n Initialize a filter.\n\n Initialize with the name of the logger which, together with its\n children, will have its events allowed through the filter. If no\n name is specified, allow every event.\n """\n self.name = name\n self.nlen = len(name)\n\n[文档] def filter(self, record):\n """\n Determine if the specified record is to be logged.\n\n Is the specified record to be logged? Returns 0 for no, nonzero for\n yes. If deemed appropriate, the record may be modified in-place.\n """\n if self.nlen == 0:\n return True\n elif self.name == record.name:\n return True\n elif record.name.find(self.name, 0, self.nlen) != 0:\n return False\n return (record.name[self.nlen] == ".")\n\nclass Filterer(object):\n """\n A base class for loggers and handlers which allows them to share\n common code.\n """\n def __init__(self):\n """\n Initialize the list of filters to be an empty list.\n """\n self.filters = []\n\n def addFilter(self, filter):\n """\n Add the specified filter to this handler.\n """\n if not (filter in self.filters):\n self.filters.append(filter)\n\n def removeFilter(self, filter):\n """\n Remove the specified filter from this handler.\n """\n if filter in self.filters:\n self.filters.remove(filter)\n\n def filter(self, record):\n """\n Determine if a record is loggable by consulting all the filters.\n\n The default is to allow the record to be logged; any filter can veto\n this and the record is then dropped. Returns a zero value if a record\n is to be dropped, else non-zero.\n\n .. versionchanged:: 3.2\n\n Allow filters to be just callables.\n """\n rv = True\n for f in self.filters:\n if hasattr(f, 'filter'):\n result = f.filter(record)\n else:\n result = f(record) # assume callable - will raise if not\n if not result:\n rv = False\n break\n return rv\n\n#---------------------------------------------------------------------------\n# Handler classes and functions\n#---------------------------------------------------------------------------\n\n_handlers = weakref.WeakValueDictionary() #map of handler names to handlers\n_handlerList = [] # added to allow handlers to be removed in reverse of order initialized\n\ndef _removeHandlerRef(wr):\n """\n Remove a handler reference from the internal cleanup list.\n """\n # This function can be called during module teardown, when globals are\n # set to None. It can also be called from another thread. So we need to\n # pre-emptively grab the necessary globals and check if they're None,\n # to prevent race conditions and failures during interpreter shutdown.\n acquire, release, handlers = _acquireLock, _releaseLock, _handlerList\n if acquire and release and handlers:\n acquire()\n try:\n if wr in handlers:\n handlers.remove(wr)\n finally:\n release()\n\ndef _addHandlerRef(handler):\n """\n Add a handler to the internal cleanup list using a weak reference.\n """\n _acquireLock()\n try:\n _handlerList.append(weakref.ref(handler, _removeHandlerRef))\n finally:\n _releaseLock()\n\n[文档]class Handler(Filterer):\n """\n Handler instances dispatch logging events to specific destinations.\n\n The base handler class. Acts as a placeholder which defines the Handler\n interface. Handlers can optionally use Formatter instances to format\n records as desired. By default, no formatter is specified; in this case,\n the 'raw' message as determined by record.message is logged.\n """\n def __init__(self, level=NOTSET):\n """\n Initializes the instance - basically setting the formatter to None\n and the filter list to empty.\n """\n Filterer.__init__(self)\n self._name = None\n self.level = _checkLevel(level)\n self.formatter = None\n # Add the handler to the global _handlerList (for cleanup on shutdown)\n _addHandlerRef(self)\n self.createLock()\n\n\n\n[文档] def set_name(self, name):\n _acquireLock()\n try:\n if self._name in _handlers:\n del _handlers[self._name]\n self._name = name\n if name:\n _handlers[name] = self\n finally:\n _releaseLock()\n\n name = property(get_name, set_name)\n\n[文档] def createLock(self):\n """\n Acquire a thread lock for serializing access to the underlying I/O.\n """\n if threading:\n self.lock = threading.RLock()\n else: #pragma: no cover\n self.lock = None\n\n[文档] def acquire(self):\n """\n Acquire the I/O thread lock.\n """\n if self.lock:\n self.lock.acquire()\n\n[文档] def release(self):\n """\n Release the I/O thread lock.\n """\n if self.lock:\n self.lock.release()\n\n[文档] def setLevel(self, level):\n """\n Set the logging level of this handler. level must be an int or a str.\n """\n self.level = _checkLevel(level)\n\n[文档] def format(self, record):\n """\n Format the specified record.\n\n If a formatter is set, use it. Otherwise, use the default formatter\n for the module.\n """\n if self.formatter:\n fmt = self.formatter\n else:\n fmt = _defaultFormatter\n return fmt.format(record)\n\n[文档] def emit(self, record):\n """\n Do whatever it takes to actually log the specified logging record.\n\n This version is intended to be implemented by subclasses and so\n raises a NotImplementedError.\n """\n raise NotImplementedError('emit must be implemented '\n 'by Handler subclasses')\n\n[文档] def handle(self, record):\n """\n Conditionally emit the specified logging record.\n\n Emission depends on filters which may have been added to the handler.\n Wrap the actual emission of the record with acquisition/release of\n the I/O thread lock. Returns whether the filter passed the record for\n emission.\n """\n rv = self.filter(record)\n if rv:\n self.acquire()\n try:\n self.emit(record)\n finally:\n self.release()\n return rv\n\n[文档] def setFormatter(self, fmt):\n """\n Set the formatter for this handler.\n """\n self.formatter = fmt\n\n[文档] def flush(self):\n """\n Ensure all logging output has been flushed.\n\n This version does nothing and is intended to be implemented by\n subclasses.\n """\n pass\n\n[文档] def close(self):\n """\n Tidy up any resources used by the handler.\n\n This version removes the handler from an internal map of handlers,\n _handlers, which is used for handler lookup by name. Subclasses\n should ensure that this gets called from overridden close()\n methods.\n """\n #get the module data lock, as we're updating a shared structure.\n _acquireLock()\n try: #unlikely to raise an exception, but you never know...\n if self._name and self._name in _handlers:\n del _handlers[self._name]\n finally:\n _releaseLock()\n\n[文档] def handleError(self, record):\n """\n Handle errors which occur during an emit() call.\n\n This method should be called from handlers when an exception is\n encountered during an emit() call. If raiseExceptions is false,\n exceptions get silently ignored. This is what is mostly wanted\n for a logging system - most users will not care about errors in\n the logging system, they are more interested in application errors.\n You could, however, replace this with a custom handler if you wish.\n The record which was being processed is passed in to this method.\n """\n if raiseExceptions and sys.stderr: # see issue 13807\n t, v, tb = sys.exc_info()\n try:\n sys.stderr.write('--- Logging error ---\\n')\n traceback.print_exception(t, v, tb, None, sys.stderr)\n sys.stderr.write('Call stack:\\n')\n # Walk the stack frame up until we're out of logging,\n # so as to print the calling context.\n frame = tb.tb_frame\n while (frame and os.path.dirname(frame.f_code.co_filename) ==\n __path__[0]):\n frame = frame.f_back\n if frame:\n traceback.print_stack(frame, file=sys.stderr)\n else:\n # couldn't find the right stack frame, for some reason\n sys.stderr.write('Logged from file %s, line %s\\n' % (\n record.filename, record.lineno))\n # Issue 18671: output logging message and arguments\n try:\n sys.stderr.write('Message: %r\\n'\n 'Arguments: %s\\n' % (record.msg,\n record.args))\n except Exception:\n sys.stderr.write('Unable to print the message and arguments'\n ' - possible formatting error.\\nUse the'\n ' traceback above to help find the error.\\n'\n )\n except OSError: #pragma: no cover\n pass # see issue 5971\n finally:\n del t, v, tb\n\n[文档]class StreamHandler(Handler):\n """\n A handler class which writes logging records, appropriately formatted,\n to a stream. Note that this class does not close the stream, as\n sys.stdout or sys.stderr may be used.\n """\n\n terminator = '\\n'\n\n def __init__(self, stream=None):\n """\n Initialize the handler.\n\n If stream is not specified, sys.stderr is used.\n """\n Handler.__init__(self)\n if stream is None:\n stream = sys.stderr\n self.stream = stream\n\n[文档] def flush(self):\n """\n Flushes the stream.\n """\n self.acquire()\n try:\n if self.stream and hasattr(self.stream, "flush"):\n self.stream.flush()\n finally:\n self.release()\n\n[文档] def emit(self, record):\n """\n Emit a record.\n\n If a formatter is specified, it is used to format the record.\n The record is then written to the stream with a trailing newline. If\n exception information is present, it is formatted using\n traceback.print_exception and appended to the stream. If the stream\n has an 'encoding' attribute, it is used to determine how to do the\n output to the stream.\n """\n try:\n msg = self.format(record)\n stream = self.stream\n stream.write(msg)\n stream.write(self.terminator)\n self.flush()\n except Exception:\n self.handleError(record)\n\n[文档]class FileHandler(StreamHandler):\n """\n A handler class which writes formatted logging records to disk files.\n """\n def __init__(self, filename, mode='a', encoding=None, delay=False):\n """\n Open the specified file and use it as the stream for logging.\n """\n #keep the absolute path, otherwise derived classes which use this\n #may come a cropper when the current directory changes\n self.baseFilename = os.path.abspath(filename)\n self.mode = mode\n self.encoding = encoding\n self.delay = delay\n if delay:\n #We don't open the stream, but we still need to call the\n #Handler constructor to set level, formatter, lock etc.\n Handler.__init__(self)\n self.stream = None\n else:\n StreamHandler.__init__(self, self._open())\n\n[文档] def close(self):\n """\n Closes the stream.\n """\n self.acquire()\n try:\n try:\n if self.stream:\n try:\n self.flush()\n finally:\n stream = self.stream\n self.stream = None\n if hasattr(stream, "close"):\n stream.close()\n finally:\n # Issue #19523: call unconditionally to\n # prevent a handler leak when delay is set\n StreamHandler.close(self)\n finally:\n self.release()\n\n def _open(self):\n """\n Open the current base file with the (original) mode and encoding.\n Return the resulting stream.\n """\n return open(self.baseFilename, self.mode, encoding=self.encoding)\n\n[文档] def emit(self, record):\n """\n Emit a record.\n\n If the stream was not opened because 'delay' was specified in the\n constructor, open it before calling the superclass's emit.\n """\n if self.stream is None:\n self.stream = self._open()\n StreamHandler.emit(self, record)\n\nclass _StderrHandler(StreamHandler):\n """\n This class is like a StreamHandler using sys.stderr, but always uses\n whatever sys.stderr is currently set to rather than the value of\n sys.stderr at handler construction time.\n """\n def __init__(self, level=NOTSET):\n """\n Initialize the handler.\n """\n Handler.__init__(self, level)\n\n @property\n def stream(self):\n return sys.stderr\n\n\n_defaultLastResort = _StderrHandler(WARNING)\nlastResort = _defaultLastResort\n\n#---------------------------------------------------------------------------\n# Manager classes and functions\n#---------------------------------------------------------------------------\n\nclass PlaceHolder(object):\n """\n PlaceHolder instances are used in the Manager logger hierarchy to take\n the place of nodes for which no loggers have been defined. This class is\n intended for internal use only and not as part of the public API.\n """\n def __init__(self, alogger):\n """\n Initialize with the specified logger being a child of this placeholder.\n """\n self.loggerMap = { alogger : None }\n\n def append(self, alogger):\n """\n Add the specified logger as a child of this placeholder.\n """\n if alogger not in self.loggerMap:\n self.loggerMap[alogger] = None\n\n#\n# Determine which class to use when instantiating loggers.\n#\n\n[文档]def setLoggerClass(klass):\n """\n Set the class to be used when instantiating a logger. The class should\n define __init__() such that only a name argument is required, and the\n __init__() should call Logger.__init__()\n """\n if klass != Logger:\n if not issubclass(klass, Logger):\n raise TypeError("logger not derived from logging.Logger: "\n + klass.__name__)\n global _loggerClass\n _loggerClass = klass\n\n[文档]def getLoggerClass():\n """\n Return the class to be used when instantiating a logger.\n """\n return _loggerClass\n\nclass Manager(object):\n """\n There is [under normal circumstances] just one Manager instance, which\n holds the hierarchy of loggers.\n """\n def __init__(self, rootnode):\n """\n Initialize the manager with the root node of the logger hierarchy.\n """\n self.root = rootnode\n self.disable = 0\n self.emittedNoHandlerWarning = False\n self.loggerDict = {}\n self.loggerClass = None\n self.logRecordFactory = None\n\n def getLogger(self, name):\n """\n Get a logger with the specified name (channel name), creating it\n if it doesn't yet exist. This name is a dot-separated hierarchical\n name, such as "a", "a.b", "a.b.c" or similar.\n\n If a PlaceHolder existed for the specified name [i.e. the logger\n didn't exist but a child of it did], replace it with the created\n logger and fix up the parent/child references which pointed to the\n placeholder to now point to the logger.\n """\n rv = None\n if not isinstance(name, str):\n raise TypeError('A logger name must be a string')\n _acquireLock()\n try:\n if name in self.loggerDict:\n rv = self.loggerDict[name]\n if isinstance(rv, PlaceHolder):\n ph = rv\n rv = (self.loggerClass or _loggerClass)(name)\n rv.manager = self\n self.loggerDict[name] = rv\n self._fixupChildren(ph, rv)\n self._fixupParents(rv)\n else:\n rv = (self.loggerClass or _loggerClass)(name)\n rv.manager = self\n self.loggerDict[name] = rv\n self._fixupParents(rv)\n finally:\n _releaseLock()\n return rv\n\n def setLoggerClass(self, klass):\n """\n Set the class to be used when instantiating a logger with this Manager.\n """\n if klass != Logger:\n if not issubclass(klass, Logger):\n raise TypeError("logger not derived from logging.Logger: "\n + klass.__name__)\n self.loggerClass = klass\n\n def setLogRecordFactory(self, factory):\n """\n Set the factory to be used when instantiating a log record with this\n Manager.\n """\n self.logRecordFactory = factory\n\n def _fixupParents(self, alogger):\n """\n Ensure that there are either loggers or placeholders all the way\n from the specified logger to the root of the logger hierarchy.\n """\n name = alogger.name\n i = name.rfind(".")\n rv = None\n while (i > 0) and not rv:\n substr = name[:i]\n if substr not in self.loggerDict:\n self.loggerDict[substr] = PlaceHolder(alogger)\n else:\n obj = self.loggerDict[substr]\n if isinstance(obj, Logger):\n rv = obj\n else:\n assert isinstance(obj, PlaceHolder)\n obj.append(alogger)\n i = name.rfind(".", 0, i - 1)\n if not rv:\n rv = self.root\n alogger.parent = rv\n\n def _fixupChildren(self, ph, alogger):\n """\n Ensure that children of the placeholder ph are connected to the\n specified logger.\n """\n name = alogger.name\n namelen = len(name)\n for c in ph.loggerMap.keys():\n #The if means ... if not c.parent.name.startswith(nm)\n if c.parent.name[:namelen] != name:\n alogger.parent = c.parent\n c.parent = alogger\n\n#---------------------------------------------------------------------------\n# Logger classes and functions\n#---------------------------------------------------------------------------\n\n[文档]class Logger(Filterer):\n """\n Instances of the Logger class represent a single logging channel. A\n "logging channel" indicates an area of an application. Exactly how an\n "area" is defined is up to the application developer. Since an\n application can have any number of areas, logging channels are identified\n by a unique string. Application areas can be nested (e.g. an area\n of "input processing" might include sub-areas "read CSV files", "read\n XLS files" and "read Gnumeric files"). To cater for this natural nesting,\n channel names are organized into a namespace hierarchy where levels are\n separated by periods, much like the Java or Python package namespace. So\n in the instance given above, channel names might be "input" for the upper\n level, and "input.csv", "input.xls" and "input.gnu" for the sub-levels.\n There is no arbitrary limit to the depth of nesting.\n """\n def __init__(self, name, level=NOTSET):\n """\n Initialize the logger with a name and an optional level.\n """\n Filterer.__init__(self)\n self.name = name\n self.level = _checkLevel(level)\n self.parent = None\n self.propagate = True\n self.handlers = []\n self.disabled = False\n\n[文档] def setLevel(self, level):\n """\n Set the logging level of this logger. level must be an int or a str.\n """\n self.level = _checkLevel(level)\n\n[文档] def debug(self, msg, *args, **kwargs):\n """\n Log 'msg % args' with severity 'DEBUG'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.debug("Houston, we have a %s", "thorny problem", exc_info=1)\n """\n if self.isEnabledFor(DEBUG):\n self._log(DEBUG, msg, args, **kwargs)\n\n[文档] def info(self, msg, *args, **kwargs):\n """\n Log 'msg % args' with severity 'INFO'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.info("Houston, we have a %s", "interesting problem", exc_info=1)\n """\n if self.isEnabledFor(INFO):\n self._log(INFO, msg, args, **kwargs)\n\n[文档] def warning(self, msg, *args, **kwargs):\n """\n Log 'msg % args' with severity 'WARNING'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.warning("Houston, we have a %s", "bit of a problem", exc_info=1)\n """\n if self.isEnabledFor(WARNING):\n self._log(WARNING, msg, args, **kwargs)\n\n[文档] def warn(self, msg, *args, **kwargs):\n warnings.warn("The 'warn' method is deprecated, "\n "use 'warning' instead", DeprecationWarning, 2)\n self.warning(msg, *args, **kwargs)\n\n[文档] def error(self, msg, *args, **kwargs):\n """\n Log 'msg % args' with severity 'ERROR'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.error("Houston, we have a %s", "major problem", exc_info=1)\n """\n if self.isEnabledFor(ERROR):\n self._log(ERROR, msg, args, **kwargs)\n\n[文档] def exception(self, msg, *args, exc_info=True, **kwargs):\n """\n Convenience method for logging an ERROR with exception information.\n """\n self.error(msg, *args, exc_info=exc_info, **kwargs)\n\n[文档] def critical(self, msg, *args, **kwargs):\n """\n Log 'msg % args' with severity 'CRITICAL'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.critical("Houston, we have a %s", "major disaster", exc_info=1)\n """\n if self.isEnabledFor(CRITICAL):\n self._log(CRITICAL, msg, args, **kwargs)\n\n fatal = critical\n\n[文档] def log(self, level, msg, *args, **kwargs):\n """\n Log 'msg % args' with the integer severity 'level'.\n\n To pass exception information, use the keyword argument exc_info with\n a true value, e.g.\n\n logger.log(level, "We have a %s", "mysterious problem", exc_info=1)\n """\n if not isinstance(level, int):\n if raiseExceptions:\n raise TypeError("level must be an integer")\n else:\n return\n if self.isEnabledFor(level):\n self._log(level, msg, args, **kwargs)\n\n[文档] def findCaller(self, stack_info=False):\n """\n Find the stack frame of the caller so that we can note the source\n file name, line number and function name.\n """\n f = currentframe()\n #On some versions of IronPython, currentframe() returns None if\n #IronPython isn't run with -X:Frames.\n if f is not None:\n f = f.f_back\n rv = "(unknown file)", 0, "(unknown function)", None\n while hasattr(f, "f_code"):\n co = f.f_code\n filename = os.path.normcase(co.co_filename)\n if filename == _srcfile:\n f = f.f_back\n continue\n sinfo = None\n if stack_info:\n sio = io.StringIO()\n sio.write('Stack (most recent call last):\\n')\n traceback.print_stack(f, file=sio)\n sinfo = sio.getvalue()\n if sinfo[-1] == '\\n':\n sinfo = sinfo[:-1]\n sio.close()\n rv = (co.co_filename, f.f_lineno, co.co_name, sinfo)\n break\n return rv\n\n[文档] def makeRecord(self, name, level, fn, lno, msg, args, exc_info,\n func=None, extra=None, sinfo=None):\n """\n A factory method which can be overridden in subclasses to create\n specialized LogRecords.\n """\n rv = _logRecordFactory(name, level, fn, lno, msg, args, exc_info, func,\n sinfo)\n if extra is not None:\n for key in extra:\n if (key in ["message", "asctime"]) or (key in rv.__dict__):\n raise KeyError("Attempt to overwrite %r in LogRecord" % key)\n rv.__dict__[key] = extra[key]\n return rv\n\n def _log(self, level, msg, args, exc_info=None, extra=None, stack_info=False):\n """\n Low-level logging routine which creates a LogRecord and then calls\n all the handlers of this logger to handle the record.\n """\n sinfo = None\n if _srcfile:\n #IronPython doesn't track Python frames, so findCaller raises an\n #exception on some versions of IronPython. We trap it here so that\n #IronPython can use logging.\n try:\n fn, lno, func, sinfo = self.findCaller(stack_info)\n except ValueError: # pragma: no cover\n fn, lno, func = "(unknown file)", 0, "(unknown function)"\n else: # pragma: no cover\n fn, lno, func = "(unknown file)", 0, "(unknown function)"\n if exc_info:\n if isinstance(exc_info, BaseException):\n exc_info = (type(exc_info), exc_info, exc_info.__traceback__)\n elif not isinstance(exc_info, tuple):\n exc_info = sys.exc_info()\n record = self.makeRecord(self.name, level, fn, lno, msg, args,\n exc_info, func, extra, sinfo)\n self.handle(record)\n\n[文档] def handle(self, record):\n """\n Call the handlers for the specified record.\n\n This method is used for unpickled records received from a socket, as\n well as those created locally. Logger-level filtering is applied.\n """\n if (not self.disabled) and self.filter(record):\n self.callHandlers(record)\n\n[文档] def addHandler(self, hdlr):\n """\n Add the specified handler to this logger.\n """\n _acquireLock()\n try:\n if not (hdlr in self.handlers):\n self.handlers.append(hdlr)\n finally:\n _releaseLock()\n\n[文档] def removeHandler(self, hdlr):\n """\n Remove the specified handler from this logger.\n """\n _acquireLock()\n try:\n if hdlr in self.handlers:\n self.handlers.remove(hdlr)\n finally:\n _releaseLock()\n\n[文档] def hasHandlers(self):\n """\n See if this logger has any handlers configured.\n\n Loop through all handlers for this logger and its parents in the\n logger hierarchy. Return True if a handler was found, else False.\n Stop searching up the hierarchy whenever a logger with the "propagate"\n attribute set to zero is found - that will be the last logger which\n is checked for the existence of handlers.\n """\n c = self\n rv = False\n while c:\n if c.handlers:\n rv = True\n break\n if not c.propagate:\n break\n else:\n c = c.parent\n return rv\n\n[文档] def callHandlers(self, record):\n """\n Pass a record to all relevant handlers.\n\n Loop through all handlers for this logger and its parents in the\n logger hierarchy. If no handler was found, output a one-off error\n message to sys.stderr. Stop searching up the hierarchy whenever a\n logger with the "propagate" attribute set to zero is found - that\n will be the last logger whose handlers are called.\n """\n c = self\n found = 0\n while c:\n for hdlr in c.handlers:\n found = found + 1\n if record.levelno >= hdlr.level:\n hdlr.handle(record)\n if not c.propagate:\n c = None #break out\n else:\n c = c.parent\n if (found == 0):\n if lastResort:\n if record.levelno >= lastResort.level:\n lastResort.handle(record)\n elif raiseExceptions and not self.manager.emittedNoHandlerWarning:\n sys.stderr.write("No handlers could be found for logger"\n " \\"%s\\"\\n" % self.name)\n self.manager.emittedNoHandlerWarning = True\n\n[文档] def getEffectiveLevel(self):\n """\n Get the effective level for this logger.\n\n Loop through this logger and its parents in the logger hierarchy,\n looking for a non-zero logging level. Return the first one found.\n """\n logger = self\n while logger:\n if logger.level:\n return logger.level\n logger = logger.parent\n return NOTSET\n\n[文档] def isEnabledFor(self, level):\n """\n Is this logger enabled for level 'level'?\n """\n if self.manager.disable >= level:\n return False\n return level >= self.getEffectiveLevel()\n\n[文档] def getChild(self, suffix):\n """\n Get a logger which is a descendant to this one.\n\n This is a convenience method, such that\n\n logging.getLogger('abc').getChild('def.ghi')\n\n is the same as\n\n logging.getLogger('abc.def.ghi')\n\n It's useful, for example, when the parent logger is named using\n __name__ rather than a literal string.\n """\n if self.root is not self:\n suffix = '.'.join((self.name, suffix))\n return self.manager.getLogger(suffix)\n\nclass RootLogger(Logger):\n """\n A root logger is not that different to any other logger, except that\n it must have a logging level and there is only one instance of it in\n the hierarchy.\n """\n def __init__(self, level):\n """\n Initialize the logger with the name "root".\n """\n Logger.__init__(self, "root", level)\n\n_loggerClass = Logger\n\n[文档]class LoggerAdapter(object):\n """\n An adapter for loggers which makes it easier to specify contextual\n information in logging output.\n """\n\n def __init__(self, logger, extra):\n """\n Initialize the adapter with a logger and a dict-like object which\n provides contextual information. This constructor signature allows\n easy stacking of LoggerAdapters, if so desired.\n\n You can effectively pass keyword arguments as shown in the\n following example:\n\n adapter = LoggerAdapter(someLogger, dict(p1=v1, p2="v2"))\n """\n self.logger = logger\n self.extra = extra\n\n[文档] def process(self, msg, kwargs):\n """\n Process the logging message and keyword arguments passed in to\n a logging call to insert contextual information. You can either\n manipulate the message itself, the keyword args or both. Return\n the message and kwargs modified (or not) to suit your needs.\n\n Normally, you'll only need to override this one method in a\n LoggerAdapter subclass for your specific needs.\n """\n kwargs["extra"] = self.extra\n return msg, kwargs\n\n #\n # Boilerplate convenience methods\n #\n[文档] def debug(self, msg, *args, **kwargs):\n """\n Delegate a debug call to the underlying logger.\n """\n self.log(DEBUG, msg, *args, **kwargs)\n\n[文档] def info(self, msg, *args, **kwargs):\n """\n Delegate an info call to the underlying logger.\n """\n self.log(INFO, msg, *args, **kwargs)\n\n[文档] def warning(self, msg, *args, **kwargs):\n """\n Delegate a warning call to the underlying logger.\n """\n self.log(WARNING, msg, *args, **kwargs)\n\n[文档] def warn(self, msg, *args, **kwargs):\n warnings.warn("The 'warn' method is deprecated, "\n "use 'warning' instead", DeprecationWarning, 2)\n self.warning(msg, *args, **kwargs)\n\n[文档] def error(self, msg, *args, **kwargs):\n """\n Delegate an error call to the underlying logger.\n """\n self.log(ERROR, msg, *args, **kwargs)\n\n[文档] def exception(self, msg, *args, exc_info=True, **kwargs):\n """\n Delegate an exception call to the underlying logger.\n """\n self.log(ERROR, msg, *args, exc_info=exc_info, **kwargs)\n\n[文档] def critical(self, msg, *args, **kwargs):\n """\n Delegate a critical call to the underlying logger.\n """\n self.log(CRITICAL, msg, *args, **kwargs)\n\n[文档] def log(self, level, msg, *args, **kwargs):\n """\n Delegate a log call to the underlying logger, after adding\n contextual information from this adapter instance.\n """\n if self.isEnabledFor(level):\n msg, kwargs = self.process(msg, kwargs)\n self.logger._log(level, msg, args, **kwargs)\n\n[文档] def isEnabledFor(self, level):\n """\n Is this logger enabled for level 'level'?\n """\n if self.logger.manager.disable >= level:\n return False\n return level >= self.getEffectiveLevel()\n\n[文档] def setLevel(self, level):\n """\n Set the specified level on the underlying logger.\n """\n self.logger.setLevel(level)\n\n[文档] def getEffectiveLevel(self):\n """\n Get the effective level for the underlying logger.\n """\n return self.logger.getEffectiveLevel()\n\n[文档] def hasHandlers(self):\n """\n See if the underlying logger has any handlers.\n """\n return self.logger.hasHandlers()\n\nroot = RootLogger(WARNING)\nLogger.root = root\nLogger.manager = Manager(Logger.root)\n\n#---------------------------------------------------------------------------\n# Configuration classes and functions\n#---------------------------------------------------------------------------\n\n[文档]def basicConfig(**kwargs):\n """\n Do basic configuration for the logging system.\n\n This function does nothing if the root logger already has handlers\n configured. It is a convenience method intended for use by simple scripts\n to do one-shot configuration of the logging package.\n\n The default behaviour is to create a StreamHandler which writes to\n sys.stderr, set a formatter using the BASIC_FORMAT format string, and\n add the handler to the root logger.\n\n A number of optional keyword arguments may be specified, which can alter\n the default behaviour.\n\n filename Specifies that a FileHandler be created, using the specified\n filename, rather than a StreamHandler.\n filemode Specifies the mode to open the file, if filename is specified\n (if filemode is unspecified, it defaults to 'a').\n format Use the specified format string for the handler.\n datefmt Use the specified date/time format.\n style If a format string is specified, use this to specify the\n type of format string (possible values '%', '{', '$', for\n %-formatting, :meth:`str.format` and :class:`string.Template`\n - defaults to '%').\n level Set the root logger level to the specified level.\n stream Use the specified stream to initialize the StreamHandler. Note\n that this argument is incompatible with 'filename' - if both\n are present, 'stream' is ignored.\n handlers If specified, this should be an iterable of already created\n handlers, which will be added to the root handler. Any handler\n in the list which does not have a formatter assigned will be\n assigned the formatter created in this function.\n\n Note that you could specify a stream created using open(filename, mode)\n rather than passing the filename and mode in. However, it should be\n remembered that StreamHandler does not close its stream (since it may be\n using sys.stdout or sys.stderr), whereas FileHandler closes its stream\n when the handler is closed.\n\n .. versionchanged:: 3.2\n Added the ``style`` parameter.\n\n .. versionchanged:: 3.3\n Added the ``handlers`` parameter. A ``ValueError`` is now thrown for\n incompatible arguments (e.g. ``handlers`` specified together with\n ``filename``/``filemode``, or ``filename``/``filemode`` specified\n together with ``stream``, or ``handlers`` specified together with\n ``stream``.\n """\n # Add thread safety in case someone mistakenly calls\n # basicConfig() from multiple threads\n _acquireLock()\n try:\n if len(root.handlers) == 0:\n handlers = kwargs.pop("handlers", None)\n if handlers is None:\n if "stream" in kwargs and "filename" in kwargs:\n raise ValueError("'stream' and 'filename' should not be "\n "specified together")\n else:\n if "stream" in kwargs or "filename" in kwargs:\n raise ValueError("'stream' or 'filename' should not be "\n "specified together with 'handlers'")\n if handlers is None:\n filename = kwargs.pop("filename", None)\n mode = kwargs.pop("filemode", 'a')\n if filename:\n h = FileHandler(filename, mode)\n else:\n stream = kwargs.pop("stream", None)\n h = StreamHandler(stream)\n handlers = [h]\n dfs = kwargs.pop("datefmt", None)\n style = kwargs.pop("style", '%')\n if style not in _STYLES:\n raise ValueError('Style must be one of: %s' % ','.join(\n _STYLES.keys()))\n fs = kwargs.pop("format", _STYLES[style][1])\n fmt = Formatter(fs, dfs, style)\n for h in handlers:\n if h.formatter is None:\n h.setFormatter(fmt)\n root.addHandler(h)\n level = kwargs.pop("level", None)\n if level is not None:\n root.setLevel(level)\n if kwargs:\n keys = ', '.join(kwargs.keys())\n raise ValueError('Unrecognised argument(s): %s' % keys)\n finally:\n _releaseLock()\n\n#---------------------------------------------------------------------------\n# Utility functions at module level.\n# Basically delegate everything to the root logger.\n#---------------------------------------------------------------------------\n\n[文档]def getLogger(name=None):\n """\n Return a logger with the specified name, creating it if necessary.\n\n If no name is specified, return the root logger.\n """\n if name:\n return Logger.manager.getLogger(name)\n else:\n return root\n\n[文档]def critical(msg, *args, **kwargs):\n """\n Log a message with severity 'CRITICAL' on the root logger. If the logger\n has no handlers, call basicConfig() to add a console handler with a\n pre-defined format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.critical(msg, *args, **kwargs)\n\nfatal = critical\n\n[文档]def error(msg, *args, **kwargs):\n """\n Log a message with severity 'ERROR' on the root logger. If the logger has\n no handlers, call basicConfig() to add a console handler with a pre-defined\n format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.error(msg, *args, **kwargs)\n\n[文档]def exception(msg, *args, exc_info=True, **kwargs):\n """\n Log a message with severity 'ERROR' on the root logger, with exception\n information. If the logger has no handlers, basicConfig() is called to add\n a console handler with a pre-defined format.\n """\n error(msg, *args, exc_info=exc_info, **kwargs)\n\n[文档]def warning(msg, *args, **kwargs):\n """\n Log a message with severity 'WARNING' on the root logger. If the logger has\n no handlers, call basicConfig() to add a console handler with a pre-defined\n format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.warning(msg, *args, **kwargs)\n\n[文档]def warn(msg, *args, **kwargs):\n warnings.warn("The 'warn' function is deprecated, "\n "use 'warning' instead", DeprecationWarning, 2)\n warning(msg, *args, **kwargs)\n\n[文档]def info(msg, *args, **kwargs):\n """\n Log a message with severity 'INFO' on the root logger. If the logger has\n no handlers, call basicConfig() to add a console handler with a pre-defined\n format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.info(msg, *args, **kwargs)\n\n[文档]def debug(msg, *args, **kwargs):\n """\n Log a message with severity 'DEBUG' on the root logger. If the logger has\n no handlers, call basicConfig() to add a console handler with a pre-defined\n format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.debug(msg, *args, **kwargs)\n\n[文档]def log(level, msg, *args, **kwargs):\n """\n Log 'msg % args' with the integer severity 'level' on the root logger. If\n the logger has no handlers, call basicConfig() to add a console handler\n with a pre-defined format.\n """\n if len(root.handlers) == 0:\n basicConfig()\n root.log(level, msg, *args, **kwargs)\n\n[文档]def disable(level):\n """\n Disable all logging calls of severity 'level' and below.\n """\n root.manager.disable = level\n\ndef shutdown(handlerList=_handlerList):\n """\n Perform any cleanup actions in the logging system (e.g. flushing\n buffers).\n\n Should be called at application exit.\n """\n for wr in reversed(handlerList[:]):\n #errors might occur, for example, if files are locked\n #we just ignore them if raiseExceptions is not set\n try:\n h = wr()\n if h:\n try:\n h.acquire()\n h.flush()\n h.close()\n except (OSError, ValueError):\n # Ignore errors which might be caused\n # because handlers have been closed but\n # references to them are still around at\n # application exit.\n pass\n finally:\n h.release()\n except: # ignore everything, as we're shutting down\n if raiseExceptions:\n raise\n #else, swallow\n\n#Let's try and shutdown automatically on application exit...\nimport atexit\natexit.register(shutdown)\n\n# Null handler\n\n[文档]class NullHandler(Handler):\n """\n This handler does nothing. It's intended to be used to avoid the\n "No handlers could be found for logger XXX" one-off warning. This is\n important for library code, which may contain code to log events. If a user\n of the library does not configure logging, the one-off warning might be\n produced; to avoid this, the library developer simply needs to instantiate\n a NullHandler and add it to the top-level logger of the library module or\n package.\n """\n\n\n\n\n\n\n# Warnings integration\n\n_warnings_showwarning = None\n\ndef _showwarning(message, category, filename, lineno, file=None, line=None):\n """\n Implementation of showwarnings which redirects to logging, which will first\n check to see if the file parameter is None. If a file is specified, it will\n delegate to the original warnings implementation of showwarning. Otherwise,\n it will call warnings.formatwarning and will log the resulting string to a\n warnings logger named "py.warnings" with level logging.WARNING.\n """\n if file is not None:\n if _warnings_showwarning is not None:\n _warnings_showwarning(message, category, filename, lineno, file, line)\n else:\n s = warnings.formatwarning(message, category, filename, lineno, line)\n logger = getLogger("py.warnings")\n if not logger.handlers:\n logger.addHandler(NullHandler())\n logger.warning("%s", s)\n\n[文档]def captureWarnings(capture):\n """\n If capture is true, redirect all warnings to the logging package.\n If capture is False, ensure that warnings are not redirected to logging\n but to their original destinations.\n """\n global _warnings_showwarning\n if capture:\n if _warnings_showwarning is None:\n _warnings_showwarning = warnings.showwarning\n warnings.showwarning = _showwarning\n else:\n if _warnings_showwarning is not None:\n warnings.showwarning = _warnings_showwarning\n _warnings_showwarning = None\n\n# -*- coding: utf-8-*-\n\nimport os\nimport subprocess\nimport time\nfrom robot import config, constants, logging\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Plugin(AbstractPlugin):\n\n SLUG = "camera"\n\n[文档] def handle(self, text, parsed):\n quality = config.get('/camera/quality', 100)\n count_down = config.get('/camera/count_down', 3)\n dest_path = config.get('/camera/dest_path', os.path.expanduser('~/pictures'))\n device = config.get('/camera/device', '/dev/video0')\n vertical_flip = config.get('/camera/verical_flip', False)\n horizontal_flip = config.get('/camera/horizontal_flip', False)\n sound = config.get('/camera/sound', True)\n camera_type = config.get('/camera/type', 0)\n if config.has('/camera/usb_camera') and config.get('/camera/usb_camera'):\n camera_type = 0\n if any(word in text for word in [u"安静", u"偷偷", u"悄悄"]):\n sound = False\n try:\n if not os.path.exists(dest_path):\n os.makedirs(dest_path)\n except Exception:\n self.say(u"抱歉，照片目录创建失败", cache=True)\n return\n dest_file = os.path.join(dest_path, "%s.jpg" % time.time())\n if camera_type == 0:\n # usb camera\n logger.info('usb camera')\n command = ['fswebcam', '--no-banner', '-r', '1024x765', '-q', '-d', device]\n if vertical_flip:\n command.extend(['-s', 'v'])\n if horizontal_flip:\n command.extend(['-s', 'h'])\n command.append(dest_file)\n elif camera_type == 1:\n # Raspberry Pi 5MP\n logger.info('Raspberry Pi 5MP camera')\n command = ['raspistill', '-o', dest_file, '-q', str(quality)]\n if count_down > 0 and sound:\n command.extend(['-t', str(count_down*1000)])\n if vertical_flip:\n command.append('-vf')\n if horizontal_flip:\n command.append('-hf')\n else:\n # notebook camera\n logger.info('notebook camera')\n command = ['imagesnap', dest_file]\n if count_down > 0 and sound:\n command.extend(['-w', str(count_down)])\n if sound and count_down > 0:\n self.say(u"收到，%d秒后启动拍照" % (count_down), cache=True)\n if camera_type == 0:\n time.sleep(count_down)\n\n try:\n subprocess.run(command, shell=False, check=True)\n if sound: \n self.play(constants.getData('camera.wav'))\n photo_url = 'http://{}:{}/photo/{}'.format(config.get('/server/host'), config.get('/server/port'), os.path.basename(dest_file))\n self.say(u'拍照成功：{}'.format(photo_url), cache=True)\n except subprocess.CalledProcessError as e:\n logger.error(e)\n if sound:\n self.say(u"拍照失败，请检查相机是否连接正确", cache=True) \n\n\n\n\n# -*- coding: utf-8-*-\n\nimport os\nfrom robot import constants, utils\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\n[文档]class Plugin(AbstractPlugin):\n\n SLUG = 'cleancache'\n\n[文档] def handle(self, text, parsed):\n temp = constants.TEMP_PATH\n for f in os.listdir(temp):\n if f != 'DIR':\n utils.check_and_delete(os.path.join(temp, f))\n self.say(u'缓存目录已清空', cache=True)\n\n[文档] def isValid(self, text, parsed):\n return any(word in text.lower() for word in ["清除缓存", u"清空缓存", u"清缓存"])\n\n# -*- coding: utf-8-*-\n# author: wzpan\n# 写诗\n\nimport logging\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nlogger = logging.getLogger(__name__)\n\n\n \n \n\n# -*- coding: utf-8-*-\nimport imaplib\nimport email\nimport time\nimport datetime\nfrom robot import logging\nfrom dateutil import parser\nfrom robot import config\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\n[文档]class Plugin(AbstractPlugin):\n\n SLUG = 'email'\n\n[文档] def getSender(self, msg):\n """\n Returns the best-guess sender of an email.\n\n Arguments:\n msg -- the email whose sender is desired\n\n Returns:\n Sender of the sender.\n """\n fromstr = str(msg["From"])\n ls = fromstr.split(' ')\n if(len(ls) == 2):\n fromname = email.header.decode_header(str(ls[0]).strip('\\"'))\n sender = fromname[0][0]\n elif(len(ls) > 2):\n fromname = email.header.decode_header(str(fromstr[:fromstr.find('<')])\n .strip('\\"'))\n sender = fromname[0][0]\n else:\n sender = msg['From']\n if isinstance(sender, bytes):\n try:\n return sender.decode('utf-8')\n except UnicodeDecodeError:\n return sender.decode('gbk')\n else:\n return sender\n\n[文档] def isSelfEmail(self, msg):\n """ Whether the email is sent by the user """\n fromstr = str(msg["From"])\n addr = (fromstr[fromstr.find('<')+1:fromstr.find('>')]).strip('\\"')\n address = config.get()[self.SLUG]['address'].strip()\n return addr == address\n\n[文档] def getSubject(self, msg):\n """\n Returns the title of an email\n\n Arguments:\n msg -- the email\n\n Returns:\n Title of the email.\n """\n subject = email.header.decode_header(msg['subject'])\n if isinstance(subject[0][0], bytes):\n try:\n sub = subject[0][0].decode('utf-8')\n except UnicodeDecodeError:\n sub = subject[0][0].decode('gbk')\n else:\n sub = subject[0][0]\n to_read = False\n if sub.strip() == '':\n return ''\n to_read = config.get('/email/read_email_title', True)\n if to_read:\n return '邮件标题为 %s' % sub\n return ''\n\n[文档] def isNewEmail(msg):\n """ Wether an email is a new email """\n date = str(msg['Date'])\n dtext = date.split(',')[1].split('+')[0].strip()\n dtime = time.strptime(dtext, '%d %b %Y %H:%M:%S')\n current = time.localtime()\n dt = datetime.datetime(*dtime[:6])\n cr = datetime.datetime(*current[:6])\n return (cr - dt).days == 0\n\n\n\n[文档] def getMostRecentDate(self, emails):\n """\n Returns the most recent date of any email in the list provided.\n\n Arguments:\n emails -- a list of emails to check\n\n Returns:\n Date of the most recent email.\n """\n dates = [self.getDate(e) for e in emails]\n dates.sort(reverse=True)\n if dates:\n return dates[0]\n return None\n\n[文档] def fetchUnreadEmails(self, since=None, markRead=False, limit=None):\n """\n Fetches a list of unread email objects from a user's email inbox.\n\n Arguments:\n since -- if provided, no emails before this date will be returned\n markRead -- if True, marks all returned emails as read in target inbox\n\n Returns:\n A list of unread email objects.\n """\n logger = logging.getLogger(__name__)\n profile = config.get()\n conn = imaplib.IMAP4(profile[self.SLUG]['imap_server'],\n profile[self.SLUG]['imap_port'])\n conn.debug = 0\n\n msgs = []\n try:\n conn.login(profile[self.SLUG]['address'], profile[self.SLUG]['password'])\n conn.select(readonly=(not markRead))\n (retcode, messages) = conn.search(None, '(UNSEEN)')\n except Exception:\n logger.warning("抱歉，您的邮箱账户验证失败了，请检查下配置")\n return None\n\n if retcode == 'OK' and messages != [b'']:\n numUnread = len(messages[0].split(b' '))\n if limit and numUnread > limit:\n return numUnread\n\n for num in messages[0].split(b' '):\n # parse email RFC822 format\n ret, data = conn.fetch(num, '(RFC822)')\n if data is None:\n continue\n msg = email.message_from_string(data[0][1].decode('utf-8'))\n\n if not since or self.getDate(msg) > since:\n msgs.append(msg)\n\n conn.close()\n conn.logout()\n\n return msgs\n \n\n[文档] def handle(self, text, parsed):\n msgs = self.fetchUnreadEmails(limit=5)\n\n if msgs is None:\n self.say(\n u"抱歉，您的邮箱账户验证失败了", cache=True)\n return\n\n if isinstance(msgs, int):\n response = "您有 %d 封未读邮件" % msgs\n self.say(response, cache=True)\n return\n\n senders = [str(self.getSender(e)) for e in msgs]\n\n if not senders:\n self.say(u"您没有未读邮件，真棒！", cache=True)\n elif len(senders) == 1:\n self.say(u"您有来自 {} 的未读邮件。{}".format(senders[0], self.getSubject(msgs[0])))\n else:\n response = u"您有 %d 封未读邮件" % len(\n senders)\n unique_senders = list(set(senders))\n if len(unique_senders) > 1:\n unique_senders[-1] = ', ' + unique_senders[-1]\n response += "。这些邮件的发件人包括："\n response += ' 和 '.join(senders)\n else:\n response += "，邮件都来自 " + unique_senders[0]\n self.say(response)\n\n\n\n\n# -*- coding: utf-8-*-\nfrom robot import logging\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Plugin(AbstractPlugin):\n\n IS_IMMERSIVE = True # 这是个沉浸式技能\n\n def __init__(self, con):\n super(Plugin, self).__init__(con)\n self.silent_count = 0\n\n[文档] def handle(self, text, parsed):\n if any (word in text for word in ['开启', '激活', '开始', '进入', '打开']):\n self.silent_count = 0\n self.say('进入极客模式', cache=True, onCompleted=lambda: self.onAsk(self.activeListen(silent=True)))\n else:\n self.say('退出极客模式', cache=True)\n\n[文档] def onAsk(self, input):\n if input:\n logger.debug('input: {}'.format(input))\n self.silent_count = 0\n self.con.doResponse(input)\n else:\n self.silent_count += 1\n if self.silent_count >= 5:\n self.say('退出极客模式', cache=True)\n self.clearImmersive()\n else:\n self.onAsk(self.activeListen(silent=True))\n\n\n\n[文档] def isValidImmersive(self, text, parsed):\n return '模式' in text and \\\n any(word in text for word in ['即刻', '即可', '极客', '即客', '集团', '集客']) and \\\n any(word in text for word in ['退出', '结束', '停止'])\n\n[文档] def isValid(self, text, parsed): \n return '模式' in text and \\\n any(word in text for word in ['即刻', '即可', '即客', '集团', '极客', '集客']) and \\\n any (word in text for word in ['开启', '激活', '开始', '进入', '打开'])\n\n\n# -*- coding: utf-8-*-\nimport os\nfrom robot import config, logging\nfrom robot.Player import MusicPlayer\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Plugin(AbstractPlugin):\n\n IS_IMMERSIVE = True # 这是个沉浸式技能\n\n def __init__(self, con):\n super(Plugin, self).__init__(con)\n self.player = None\n self.song_list = None \n\n[文档] def get_song_list(self, path):\n if not os.path.exists(path) or \\\n not os.path.isdir(path):\n return []\n song_list = list(filter(lambda d: d.endswith('.mp3'), os.listdir(path)))\n return [os.path.join(path, song) for song in song_list]\n\n[文档] def init_music_player(self):\n self.song_list = self.get_song_list(config.get('/LocalPlayer/path'))\n if self.song_list == None:\n logger.error('{} 插件配置有误'.format(self.SLUG))\n logger.info('本地音乐列表：{}'.format(self.song_list))\n return MusicPlayer(self.song_list, self)\n\n[文档] def handle(self, text, parsed):\n if not self.player:\n self.player = self.init_music_player()\n if len(self.song_list) == 0:\n self.clearImmersive() # 去掉沉浸式\n self.say('本地音乐目录并没有音乐文件，播放失败')\n return\n if self.nlu.hasIntent(parsed, 'MUSICRANK'):\n self.player.play()\n elif self.nlu.hasIntent(parsed, 'CHANGE_TO_NEXT'):\n self.player.next()\n elif self.nlu.hasIntent(parsed, 'CHANGE_TO_LAST'):\n self.player.prev()\n elif self.nlu.hasIntent(parsed, 'CHANGE_VOL'):\n slots = self.nlu.getSlots(parsed, 'CHANGE_VOL')\n for slot in slots:\n if slot['name'] == 'user_d':\n word = self.nlu.getSlotWords(parsed, 'CHANGE_VOL', 'user_d')[0]\n if word == '--HIGHER--':\n self.player.turnUp()\n else:\n self.player.turnDown()\n return\n elif slot['name'] == 'user_vd':\n word = self.nlu.getSlotWords(parsed, 'CHANGE_VOL', 'user_vd')[0]\n if word == '--LOUDER--':\n self.player.turnUp()\n else:\n self.player.turnDown()\n\n elif self.nlu.hasIntent(parsed, 'PAUSE'):\n self.player.pause()\n elif self.nlu.hasIntent(parsed, 'CONTINUE'):\n self.player.resume()\n elif self.nlu.hasIntent(parsed, 'CLOSE_MUSIC'):\n self.player.stop()\n self.clearImmersive() # 去掉沉浸式\n else:\n self.say('没听懂你的意思呢，要停止播放，请说停止播放', wait=True)\n self.player.resume()\n\n\n\n\n\n[文档] def isValidImmersive(self, text, parsed):\n return any(self.nlu.hasIntent(parsed, intent) for intent in ['CHANGE_TO_LAST', 'CHANGE_TO_NEXT', 'CHANGE_VOL', 'CLOSE_MUSIC', 'PAUSE', 'CONTINUE'])\n\n\n\n\n# -*- coding: utf-8-*-\n# author: wzpan\n# 写诗\n\nimport logging\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nINTENT = "BUILT_POEM"\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Plugin(AbstractPlugin):\n\n SLUG = "poem"\n\n[文档] def handle(self, text, parsed):\n try:\n responds = self.nlu.getSay(parsed, INTENT)\n self.say(responds, cache=True)\n except Exception as e:\n logger.error(e)\n self.say('抱歉，写诗插件出问题了，请稍后再试', cache=True)\n\n[文档] def isValid(self, text, parsed):\n return self.nlu.hasIntent(parsed, INTENT) and '写' in text and '诗' in text\n \n \n\n# -*- coding: utf-8-*-\nimport requests\nimport json\nfrom robot import logging\nfrom robot import config\nfrom uuid import getnode as get_mac\nfrom abc import ABCMeta, abstractmethod\n\nlogger = logging.getLogger(__name__)\n\n[文档]class AbstractRobot(object):\n\n __metaclass__ = ABCMeta\n\n[文档] @classmethod\n def get_instance(cls):\n profile = cls.get_config()\n instance = cls(**profile)\n return instance\n\n def __init__(self, **kwargs):\n pass\n\n\n\n\n[文档]class TulingRobot(AbstractRobot):\n\n SLUG = "tuling"\n\n def __init__(self, tuling_key):\n """\n 图灵机器人\n """\n super(self.__class__, self).__init__()\n self.tuling_key = tuling_key\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get ali_yuyin config from config\n return config.get('tuling', {})\n\n[文档] def chat(self, texts):\n """\n 使用图灵机器人聊天\n\n Arguments:\n texts -- user input, typically speech, to be parsed by a module\n """\n msg = ''.join(texts)\n try:\n url = "http://www.tuling123.com/openapi/api"\n userid = str(get_mac())[:32]\n body = {'key': self.tuling_key, 'info': msg, 'userid': userid}\n r = requests.post(url, data=body)\n respond = json.loads(r.text)\n result = ''\n if respond['code'] == 100000:\n result = respond['text'].replace('<br>', ' ')\n result = result.replace(u'\\xa0', u' ')\n elif respond['code'] == 200000:\n result = respond['url']\n elif respond['code'] == 302000:\n for k in respond['list']:\n result = result + u"【" + k['source'] + u"】 " +\\\n k['article'] + "\\t" + k['detailurl'] + "\\n"\n else:\n result = respond['text'].replace('<br>', ' ')\n result = result.replace(u'\\xa0', u' ')\n logger.info('{} 回答：{}'.format(self.SLUG, result))\n return result\n except Exception:\n logger.critical("Tuling robot failed to responsed for %r",\n msg, exc_info=True) \n return "抱歉, 我的大脑短路了，请稍后再试试."\n\n\n[文档]class Emotibot(AbstractRobot):\n\n SLUG = "emotibot"\n\n def __init__(self, appid, location, more):\n """\n Emotibot机器人\n """\n super(self.__class__, self).__init__() \n self.appid, self.location, self.more = appid, location, more\n\n[文档] @classmethod\n def get_config(self):\n appid = config.get('/emotibot/appid', '')\n location = config.get('location', '深圳')\n more = config.get('active_mode', False) \n return {\n 'appid': appid,\n 'location': location,\n 'more': more\n }\n\n[文档] def chat(self, texts):\n """\n 使用Emotibot机器人聊天\n\n Arguments:\n texts -- user input, typically speech, to be parsed by a module\n """\n msg = ''.join(texts)\n try:\n url = "http://idc.emotibot.com/api/ApiKey/openapi.php"\n userid = str(get_mac())[:32]\n register_data = {\n "cmd": "chat",\n "appid": self.appid,\n "userid": userid,\n "text": msg,\n "location": self.location\n }\n r = requests.post(url, params=register_data)\n jsondata = json.loads(r.text)\n result = ''\n responds = []\n if jsondata['return'] == 0:\n if self.more:\n datas = jsondata.get('data')\n for data in datas:\n if data.get('type') == 'text':\n responds.append(data.get('value'))\n else:\n responds.append(jsondata.get('data')[0].get('value'))\n result = '\\n'.join(responds)\n else:\n result = "抱歉, 我的大脑短路了，请稍后再试试."\n logger.info('{} 回答：{}'.format(self.SLUG, result)) \n return result\n except Exception:\n logger.critical("Emotibot failed to responsed for %r",\n msg, exc_info=True)\n return "抱歉, 我的大脑短路了，请稍后再试试."\n\n\n\n\n[文档]def get_robot_by_slug(slug):\n """\n Returns:\n A robot implementation available on the current platform\n """\n if not slug or type(slug) is not str:\n raise TypeError("Invalid slug '%s'", slug)\n\n selected_robots = list(filter(lambda robot: hasattr(robot, "SLUG") and\n robot.SLUG == slug, get_robots()))\n if len(selected_robots) == 0:\n raise ValueError("No robot found for slug '%s'" % slug)\n else:\n if len(selected_robots) > 1:\n logger.warning("WARNING: Multiple robots found for slug '%s'. " +\n "This is most certainly a bug." % slug) \n robot = selected_robots[0]\n logger.info("使用 {} 对话机器人".format(robot.SLUG))\n return robot.get_instance()\n\n\n[文档]def get_robots():\n def get_subclasses(cls):\n subclasses = set()\n for subclass in cls.__subclasses__():\n subclasses.add(subclass)\n subclasses.update(get_subclasses(subclass))\n return subclasses\n return [robot for robot in\n list(get_subclasses(AbstractRobot))\n if hasattr(robot, 'SLUG') and robot.SLUG]\n\n# -*- coding: utf-8-*-\nimport json\nfrom aip import AipSpeech\nfrom .sdk import TencentSpeech, AliSpeech, XunfeiSpeech\nfrom . import utils, config\nfrom robot import logging\nfrom abc import ABCMeta, abstractmethod\n\nlogger = logging.getLogger(__name__)\n\n[文档]class AbstractASR(object):\n """\n Generic parent class for all ASR engines\n """\n\n __metaclass__ = ABCMeta\n\n\n\n[文档] @classmethod\n def get_instance(cls):\n profile = cls.get_config()\n instance = cls(**profile)\n return instance\n\n\n\n\n[文档]class BaiduASR(AbstractASR):\n """\n 百度的语音识别API.\n dev_pid:\n - 1936: 普通话远场\n - 1536：普通话(支持简单的英文识别)\n - 1537：普通话(纯中文识别)\n - 1737：英语\n - 1637：粤语\n - 1837：四川话\n 要使用本模块, 首先到 yuyin.baidu.com 注册一个开发者账号,\n 之后创建一个新应用, 然后在应用管理的"查看key"中获得 API Key 和 Secret Key\n 填入 config.xml 中.\n ...\n baidu_yuyin: \n appid: '9670645'\n api_key: 'qg4haN8b2bGvFtCbBGqhrmZy'\n secret_key: '585d4eccb50d306c401d7df138bb02e7'\n ...\n """\n\n SLUG = "baidu-asr"\n\n def __init__(self, appid, api_key, secret_key, dev_pid=1936, **args):\n super(self.__class__, self).__init__()\n self.client = AipSpeech(appid, api_key, secret_key)\n self.dev_pid = dev_pid\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get baidu_yuyin config from config\n return config.get('baidu_yuyin', {})\n\n[文档] def transcribe(self, fp):\n # 识别本地文件\n pcm = utils.get_pcm_from_wav(fp)\n res = self.client.asr(pcm, 'pcm', 16000, {\n 'dev_pid': self.dev_pid,\n })\n if res['err_no'] == 0:\n logger.info('{} 语音识别到了：{}'.format(self.SLUG, res['result']))\n return ''.join(res['result'])\n else:\n logger.info('{} 语音识别出错了: {}'.format(self.SLUG, res['err_msg']))\n return ''\n\n\n[文档]class TencentASR(AbstractASR):\n """\n 腾讯的语音识别API.\n """\n\n SLUG = "tencent-asr"\n\n def __init__(self, appid, secretid, secret_key, region='ap-guangzhou', **args):\n super(self.__class__, self).__init__()\n self.engine = TencentSpeech.tencentSpeech(secret_key, secretid)\n self.region = region\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get tencent_yuyin config from config\n return config.get('tencent_yuyin', {})\n\n[文档] def transcribe(self, fp):\n mp3_path = utils.convert_wav_to_mp3(fp)\n r = self.engine.ASR(mp3_path, 'mp3', '1', self.region)\n utils.check_and_delete(mp3_path)\n res = json.loads(r)\n if 'Response' in res and 'Result' in res['Response']:\n logger.info('{} 语音识别到了：{}'.format(self.SLUG, res['Response']['Result']))\n return res['Response']['Result']\n else:\n logger.critical('{} 语音识别出错了'.format(self.SLUG), exc_info=True)\n return ''\n\n\n[文档]class XunfeiASR(AbstractASR):\n """\n 科大讯飞的语音识别API.\n 外网ip查询：https://ip.51240.com/\n """\n\n SLUG = "xunfei-asr"\n\n def __init__(self, appid, asr_api_key, asr_api_secret, tts_api_key, voice='xiaoyan'):\n super(self.__class__, self).__init__()\n self.appid = appid\n self.api_key = asr_api_key\n self.api_secret = asr_api_secret\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get xunfei_yuyin config from config\n return config.get('xunfei_yuyin', {})\n\n[文档] def transcribe(self, fp):\n return XunfeiSpeech.transcribe(fp, self.appid, self.api_key, self.api_secret)\n\n\n[文档]class AliASR(AbstractASR):\n """\n 阿里的语音识别API.\n """\n\n SLUG = "ali-asr"\n\n def __init__(self, appKey, token, **args):\n super(self.__class__, self).__init__()\n self.appKey, self.token = appKey, token\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get ali_yuyin config from config\n return config.get('ali_yuyin', {})\n\n[文档] def transcribe(self, fp):\n result = AliSpeech.asr(self.appKey, self.token, fp)\n if result is not None:\n logger.info('{} 语音识别到了：{}'.format(self.SLUG, result))\n return result\n else:\n logger.critical('{} 语音识别出错了'.format(self.SLUG), exc_info=True)\n return ''\n\n\n[文档]def get_engine_by_slug(slug=None):\n """\n Returns:\n An ASR Engine implementation available on the current platform\n\n Raises:\n ValueError if no speaker implementation is supported on this platform\n """\n\n if not slug or type(slug) is not str:\n raise TypeError("无效的 ASR slug '%s'", slug)\n\n selected_engines = list(filter(lambda engine: hasattr(engine, "SLUG") and\n engine.SLUG == slug, get_engines()))\n\n if len(selected_engines) == 0:\n raise ValueError("错误：找不到名为 {} 的 ASR 引擎".format(slug))\n else:\n if len(selected_engines) > 1:\n logger.warning("注意: 有多个 ASR 名称与指定的引擎名 {} 匹配").format(slug)\n engine = selected_engines[0]\n logger.info("使用 {} ASR 引擎".format(engine.SLUG))\n return engine.get_instance()\n\n\n[文档]def get_engines():\n def get_subclasses(cls):\n subclasses = set()\n for subclass in cls.__subclasses__():\n subclasses.add(subclass)\n subclasses.update(get_subclasses(subclass))\n return subclasses\n return [engine for engine in\n list(get_subclasses(AbstractASR))\n if hasattr(engine, 'SLUG') and engine.SLUG]\n\n# -*- coding: utf-8-*-\nfrom robot import logging\nfrom . import plugin_loader\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Brain(object):\n\n def __init__(self, conversation):\n """\n 大脑模块，负责处理技能的匹配和响应\n\n 参数：\n conversation -- 管理对话\n """\n self.conversation = conversation\n self.plugins = plugin_loader.get_plugins(self.conversation)\n self.handling = False\n\n[文档] def isImmersive(self, plugin, text, parsed):\n return self.conversation.getImmersiveMode() == plugin.SLUG and \\\n plugin.isValidImmersive(text, parsed)\n\n[文档] def printPlugins(self):\n plugin_list = []\n for plugin in self.plugins:\n plugin_list.append(plugin.SLUG)\n logger.info('已激活插件：{}'.format(plugin_list))\n\n[文档] def query(self, text):\n """\n query 模块\n\n Arguments:\n text -- 用户输入\n """\n\n args = {\n "service_id": "S13442",\n "api_key": 'w5v7gUV3iPGsGntcM84PtOOM',\n "secret_key": 'KffXwW6E1alcGplcabcNs63Li6GvvnfL'\n }\n parsed = self.conversation.doParse(text, **args)\n\n for plugin in self.plugins:\n if not plugin.isValid(text, parsed) and not self.isImmersive(plugin, text, parsed):\n continue\n\n logger.info("'{}' 命中技能 {}".format(text, plugin.SLUG))\n self.conversation.matchPlugin = plugin.SLUG\n\n if plugin.IS_IMMERSIVE:\n self.conversation.setImmersiveMode(plugin.SLUG)\n\n continueHandle = False\n try:\n self.handling = True\n continueHandle = plugin.handle(text, parsed)\n self.handling = False \n except Exception:\n logger.critical('Failed to execute plugin',\n exc_info=True)\n reply = u"抱歉，插件{}出故障了，晚点再试试吧".format(plugin.SLUG)\n self.conversation.say(reply, plugin=plugin.SLUG)\n else:\n logger.debug("Handling of phrase '%s' by " +\n "plugin '%s' completed", text,\n plugin.SLUG) \n finally:\n if not continueHandle:\n return True\n\n logger.debug("No plugin was able to handle phrase {} ".format(text))\n return False\n\n[文档] def restore(self):\n """ 恢复某个技能的处理 """\n if not self.conversation.immersiveMode:\n return\n for plugin in self.plugins:\n if plugin.SLUG == self.conversation.immersiveMode and plugin.restore:\n plugin.restore()\n\n[文档] def pause(self):\n """ 暂停某个技能的处理 """\n if not self.conversation.immersiveMode:\n return\n for plugin in self.plugins:\n if plugin.SLUG == self.conversation.immersiveMode and plugin.pause:\n plugin.pause()\n\n[文档] def understand(self, fp):\n if self.conversation and self.conversation.asr:\n return self.conversation.asr.transcribe(fp)\n return None\n\n[文档] def say(self, msg, cache=False):\n if self.conversation and self.conversation.tts:\n self.conversation.tts.say(msg, cache)\n\n \n \n\n# -*- coding: utf-8-*-\n\nfrom robot import config\nfrom watchdog.events import FileSystemEventHandler\n\n\n\n# -*- coding: utf-8-*-\nimport time \nimport uuid\nimport cProfile\nimport pstats\nimport io\nimport re\nimport os\nfrom robot.Brain import Brain\nfrom snowboy import snowboydecoder\nfrom robot import logging, ASR, TTS, NLU, AI, Player, config, constants, utils, statistic\n\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Conversation(object):\n\n def __init__(self, profiling=False):\n self.reload()\n # 历史会话消息\n self.history = []\n # 沉浸模式，处于这个模式下，被打断后将自动恢复这个技能\n self.matchPlugin = None\n self.immersiveMode = None\n self.isRecording = False\n self.profiling = profiling\n self.onSay = None\n self.hasPardon = False\n\n\n\n[文档] def interrupt(self):\n if self.player is not None and self.player.is_playing():\n self.player.stop()\n self.player = None\n if self.immersiveMode:\n self.brain.pause()\n\n[文档] def reload(self):\n """ 重新初始化 """\n try:\n self.asr = ASR.get_engine_by_slug(config.get('asr_engine', 'tencent-asr'))\n self.ai = AI.get_robot_by_slug(config.get('robot', 'tuling'))\n self.tts = TTS.get_engine_by_slug(config.get('tts_engine', 'baidu-tts'))\n self.nlu = NLU.get_engine_by_slug(config.get('nlu_engine', 'unit'))\n self.player = None\n self.brain = Brain(self)\n self.brain.printPlugins()\n except Exception as e:\n logger.critical("对话初始化失败：{}".format(e))\n\n\n\n[文档] def doResponse(self, query, UUID='', onSay=None):\n statistic.report(1)\n self.interrupt()\n self.appendHistory(0, query, UUID)\n\n if onSay:\n self.onSay = onSay\n\n if query.strip() == '':\n self.pardon()\n return\n\n lastImmersiveMode = self.immersiveMode\n\n if not self.brain.query(query):\n # 没命中技能，使用机器人回复\n msg = self.ai.chat(query)\n self.say(msg, True, onCompleted=self.checkRestore)\n else:\n if lastImmersiveMode is not None and lastImmersiveMode != self.matchPlugin:\n time.sleep(1)\n if self.player is not None and self.player.is_playing():\n logger.debug('等说完再checkRestore')\n self.player.appendOnCompleted(lambda: self.checkRestore())\n else:\n logger.debug('checkRestore')\n self.checkRestore()\n\n\n\n\n\n\n\n[文档] def converse(self, fp, callback=None):\n """ 核心对话逻辑 """\n Player.play(constants.getData('beep_lo.wav'))\n logger.info('结束录音')\n self.isRecording = False\n if self.profiling:\n logger.info('性能调试已打开')\n pr = cProfile.Profile()\n pr.enable()\n self.doConverse(fp, callback)\n pr.disable()\n s = io.StringIO()\n sortby = 'cumulative'\n ps = pstats.Stats(pr, stream=s).sort_stats(sortby)\n ps.print_stats()\n print(s.getvalue())\n else:\n self.doConverse(fp, callback)\n\n[文档] def doConverse(self, fp, callback=None, onSay=None):\n try:\n self.interrupt()\n query = self.asr.transcribe(fp)\n utils.check_and_delete(fp)\n self.doResponse(query, callback, onSay)\n except Exception as e:\n logger.critical(e)\n utils.clean()\n\n[文档] def appendHistory(self, t, text, UUID=''):\n """ 将会话历史加进历史记录 """\n if t in (0, 1) and text is not None and text != '':\n if text.endswith(',') or text.endswith('，'):\n text = text[:-1]\n if UUID == '' or UUID == None or UUID == 'null':\n UUID = str(uuid.uuid1())\n # 将图片处理成HTML\n pattern = r'https?://.+\\.(?:png|jpg|jpeg|bmp|gif|JPG|PNG|JPEG|BMP|GIF)'\n url_pattern = r'^https?://.+'\n imgs = re.findall(pattern, text)\n for img in imgs:\n text = text.replace(img, '<img src={} class="img"/>'.format(img))\n urls = re.findall(url_pattern, text)\n for url in urls:\n text = text.replace(url, '<a href={} target="_blank">{}</a>'.format(url, url))\n self.history.append({'type': t, 'text': text, 'time': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(time.time())), 'uuid': UUID})\n\n def _onCompleted(self, msg):\n if config.get('active_mode', False) and \\\n (\n msg.endswith('?') or \n msg.endswith(u'？') or \n u'告诉我' in msg or u'请回答' in msg\n ):\n query = self.activeListen()\n self.doResponse(query)\n\n[文档] def pardon(self):\n if not self.hasPardon:\n self.say("抱歉，刚刚没听清，能再说一遍吗？", onCompleted=lambda: self.doResponse(self.activeListen()))\n self.hasPardon = True\n else:\n self.say("没听清呢")\n self.hasPardon = False\n\n[文档] def say(self, msg, cache=False, plugin='', onCompleted=None, wait=False):\n """ \n 说一句话\n :param msg: 内容\n :param cache: 是否缓存这句话的音频\n :param plugin: 来自哪个插件的消息（将带上插件的说明）\n :param onCompleted: 完成的回调\n :param wait: 是否要等待说完（为True将阻塞主线程直至说完这句话）\n """\n if plugin != '':\n self.appendHistory(1, "[{}] {}".format(plugin, msg))\n else:\n self.appendHistory(1, msg)\n pattern = r'^https?://.+'\n if re.match(pattern, msg):\n logger.info("内容包含URL，所以不读出来")\n return\n voice = ''\n cache_path = ''\n if utils.getCache(msg):\n logger.info("命中缓存，播放缓存语音")\n voice = utils.getCache(msg)\n cache_path = utils.getCache(msg)\n else:\n try:\n voice = self.tts.get_speech(msg)\n cache_path = utils.saveCache(voice, msg)\n except Exception as e:\n logger.error('保存缓存失败：{}'.format(e))\n if self.onSay:\n logger.info(cache)\n audio = 'http://{}:{}/audio/{}'.format(config.get('/server/host'), config.get('/server/port'), os.path.basename(cache_path))\n logger.info('onSay: {}, {}'.format(msg, audio))\n if plugin != '':\n self.onSay("[{}] {}".format(plugin, msg), audio)\n else:\n self.onSay(msg, audio)\n self.onSay = None\n if onCompleted is None:\n onCompleted = lambda: self._onCompleted(msg) \n self.player = Player.SoxPlayer()\n self.player.play(voice, not cache, onCompleted, wait)\n if not cache:\n utils.check_and_delete(cache_path, 60) # 60秒后将自动清理不缓存的音频\n utils.lruCache() # 清理缓存\n\n[文档] def activeListen(self, silent=False):\n """ 主动问一个问题(适用于多轮对话) """\n logger.debug('activeListen')\n try:\n if not silent:\n time.sleep(1)\n Player.play(constants.getData('beep_hi.wav'))\n listener = snowboydecoder.ActiveListener([constants.getHotwordModel(config.get('hotword', 'wukong.pmdl'))])\n voice = listener.listen(\n silent_count_threshold=config.get('silent_threshold', 15),\n recording_timeout=config.get('recording_timeout', 5) * 4\n )\n if not silent:\n Player.play(constants.getData('beep_lo.wav'))\n if voice:\n query = self.asr.transcribe(voice)\n utils.check_and_delete(voice)\n return query\n return ''\n except Exception as e: \n logger.error(e)\n return '' \n\n[文档] def play(self, src, delete=False, onCompleted=None, volume=1):\n """ 播放一个音频 """\n if self.player:\n self.interrupt()\n self.player = Player.SoxPlayer()\n self.player.play(src, delete, onCompleted=onCompleted, volume=volume)\n \n\n# -*- coding: utf-8-*-\nfrom .sdk import unit\nfrom robot import logging\nfrom abc import ABCMeta, abstractmethod\n\nlogger = logging.getLogger(__name__)\n\n[文档]class AbstractNLU(object):\n """\n Generic parent class for all NLU engines\n """\n\n __metaclass__ = ABCMeta\n\n\n\n[文档] @classmethod\n def get_instance(cls):\n profile = cls.get_config()\n instance = cls(**profile)\n return instance\n\n[文档] @abstractmethod\n def parse(self, query, **args):\n """\n 进行 NLU 解析\n\n :param query: 用户的指令字符串\n :param **args: 可选的参数\n """\n return None\n\n[文档] @abstractmethod\n def getIntent(self, parsed):\n """ \n 提取意图\n\n :param parsed: 解析结果\n :returns: 意图数组\n """\n return None\n\n[文档] @abstractmethod\n def hasIntent(self, parsed, intent):\n """ \n 判断是否包含某个意图\n\n :param parsed: 解析结果\n :param intent: 意图的名称\n :returns: True: 包含; False: 不包含\n """\n return False\n\n[文档] @abstractmethod\n def getSlots(self, parsed, intent):\n """ \n 提取某个意图的所有词槽\n \n :param parsed: 解析结果\n :param intent: 意图的名称\n :returns: 词槽列表。你可以通过 name 属性筛选词槽，\n 再通过 normalized_word 属性取出相应的值\n """\n return None\n\n[文档] @abstractmethod\n def getSlotWords(self, parsed, intent, name):\n """ \n 找出命中某个词槽的内容\n \n :param parsed: 解析结果\n :param intent: 意图的名称\n :param name: 词槽名\n :returns: 命中该词槽的值的列表。\n """\n return None\n\n[文档] @abstractmethod\n def getSay(self, parsed, intent):\n """\n 提取回复文本\n\n :param parsed: 解析结果\n :param intent: 意图的名称\n :returns: 回复文本\n """\n return ""\n\n\n[文档]class UnitNLU(AbstractNLU):\n """\n 百度UNIT的NLU API.\n """\n\n SLUG = "unit"\n\n def __init__(self):\n super(self.__class__, self).__init__()\n\n\n\n[文档] def parse(self, query, **args):\n """\n 使用百度 UNIT 进行 NLU 解析\n\n :param query: 用户的指令字符串\n :param **args: UNIT 的相关参数\n - service_id: UNIT 的 service_id\n - api_key: UNIT apk_key\n - secret_key: UNIT secret_key\n :returns: UNIT 解析结果。如果解析失败，返回 None\n """\n if 'service_id' not in args or \\\n 'api_key' not in args or \\\n 'secret_key' not in args:\n logger.critical('{} NLU 失败：参数错误！'.format(self.SLUG))\n return None\n return unit.getUnit(query,\n args['service_id'],\n args['api_key'],\n args['secret_key'])\n\n[文档] def getIntent(self, parsed):\n """ \n 提取意图\n\n :param parsed: 解析结果\n :returns: 意图数组\n """\n return unit.getIntent(parsed)\n\n[文档] def hasIntent(self, parsed, intent):\n """ \n 判断是否包含某个意图\n\n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: True: 包含; False: 不包含\n """\n return unit.hasIntent(parsed, intent)\n\n[文档] def getSlots(self, parsed, intent):\n """ \n 提取某个意图的所有词槽\n \n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: 词槽列表。你可以通过 name 属性筛选词槽，\n 再通过 normalized_word 属性取出相应的值\n """\n return unit.getSlots(parsed, intent)\n\n[文档] def getSlotWords(self, parsed, intent, name):\n """ \n 找出命中某个词槽的内容\n \n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :param name: 词槽名\n :returns: 命中该词槽的值的列表。\n """\n return unit.getSlotWords(parsed, intent, name)\n\n[文档] def getSay(self, parsed, intent):\n """\n 提取 UNIT 的回复文本\n\n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: UNIT 的回复文本\n """\n return unit.getSay(parsed, intent)\n\n\n[文档]def get_engine_by_slug(slug=None):\n """\n Returns:\n An NLU Engine implementation available on the current platform\n\n Raises:\n ValueError if no speaker implementation is supported on this platform\n """\n\n if not slug or type(slug) is not str:\n raise TypeError("无效的 NLU slug '%s'", slug)\n\n selected_engines = list(filter(lambda engine: hasattr(engine, "SLUG") and\n engine.SLUG == slug, get_engines()))\n\n if len(selected_engines) == 0:\n raise ValueError("错误：找不到名为 {} 的 NLU 引擎".format(slug))\n else:\n if len(selected_engines) > 1:\n logger.warning("注意: 有多个 NLU 名称与指定的引擎名 {} 匹配").format(slug) \n engine = selected_engines[0]\n logger.info("使用 {} NLU 引擎".format(engine.SLUG))\n return engine.get_instance()\n\n\n[文档]def get_engines():\n def get_subclasses(cls):\n subclasses = set()\n for subclass in cls.__subclasses__():\n subclasses.add(subclass)\n subclasses.update(get_subclasses(subclass))\n return subclasses\n return [engine for engine in\n list(get_subclasses(AbstractNLU))\n if hasattr(engine, 'SLUG') and engine.SLUG]\n\n# -*- coding: utf-8-*-\nimport subprocess\nimport os\nimport platform\nfrom . import utils\nimport _thread as thread\nfrom robot import logging\nfrom ctypes import CFUNCTYPE, c_char_p, c_int, cdll\nfrom contextlib import contextmanager\n\nlogger = logging.getLogger(__name__)\n\n\n\nERROR_HANDLER_FUNC = CFUNCTYPE(None, c_char_p, c_int, c_char_p, c_int, c_char_p)\n\nc_error_handler = ERROR_HANDLER_FUNC(py_error_handler)\n\n[文档]@contextmanager\ndef no_alsa_error():\n try:\n asound = cdll.LoadLibrary('libasound.so')\n asound.snd_lib_error_set_handler(c_error_handler)\n yield\n asound.snd_lib_error_set_handler(None)\n except:\n yield\n pass\n\n[文档]def play(fname, onCompleted=None):\n player = getPlayerByFileName(fname)\n player.play(fname, onCompleted)\n\n[文档]def getPlayerByFileName(fname):\n foo, ext = os.path.splitext(fname)\n if ext in ['.mp3', '.wav']:\n return SoxPlayer()\n\n[文档]class AbstractPlayer(object):\n\n def __init__(self, **kwargs):\n super(AbstractPlayer, self).__init__()\n\n\n\n\n\n\n\n\n \n\n[文档]class SoxPlayer(AbstractPlayer):\n SLUG = 'SoxPlayer'\n\n def __init__(self, **kwargs):\n super(SoxPlayer, self).__init__(**kwargs)\n self.playing = False\n self.proc = None\n self.delete = False\n self.onCompleteds = []\n\n[文档] def doPlay(self):\n cmd = ['play', str(self.src)]\n logger.debug('Executing %s', ' '.join(cmd))\n self.proc = subprocess.Popen(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)\n self.playing = True\n self.proc.wait()\n self.playing = False\n if self.delete:\n utils.check_and_delete(self.src)\n logger.debug('play completed')\n if self.proc.returncode == 0:\n for onCompleted in self.onCompleteds:\n if onCompleted: \n onCompleted()\n self.onCompleteds = []\n \n[文档] def play(self, src, delete=False, onCompleted=None, wait=False):\n if (os.path.exists(src)):\n self.src = src\n self.delete = delete\n self.onCompleteds.append(onCompleted)\n if not wait:\n thread.start_new_thread(self.doPlay, ())\n else:\n self.doPlay()\n else:\n logger.critical('path not exists: {}'.format(src))\n\n[文档] def appendOnCompleted(self, onCompleted):\n if onCompleted:\n self.onCompleteds.append(onCompleted)\n\n\n\n[文档] def stop(self):\n if self.proc:\n self.onCompleteds = []\n self.proc.terminate()\n if self.delete:\n utils.check_and_delete(self.src)\n\n\n\n\n[文档]class MusicPlayer(SoxPlayer):\n """\n 给音乐播放器插件使用的，\n 在 SOXPlayer 的基础上增加了列表的支持，\n 并支持暂停和恢复播放\n """\n SLUG = 'MusicPlayer'\n\n def __init__(self, playlist, plugin, **kwargs):\n super(MusicPlayer, self).__init__(**kwargs)\n self.playlist = playlist\n self.plugin = plugin\n self.idx = 0\n self.pausing = False\n self.last_paused = None\n\n[文档] def update_playlist(self, playlist):\n super().stop()\n self.playlist = playlist\n self.idx = 0\n self.play()\n\n[文档] def play(self):\n logger.debug('MusicPlayer play')\n path = self.playlist[self.idx]\n super().stop()\n super().play(path, False, self.next)\n\n[文档] def next(self):\n logger.debug('MusicPlayer next')\n super().stop()\n self.idx = (self.idx+1) % len(self.playlist)\n self.play()\n\n[文档] def prev(self):\n logger.debug('MusicPlayer prev')\n super().stop()\n self.idx = (self.idx-1) % len(self.playlist)\n self.play()\n\n\n\n[文档] def stop(self):\n if self.proc:\n logger.debug('MusicPlayer stop')\n # STOP current play process\n self.last_paused = utils.write_temp_file(str(self.proc.pid), 'pid', 'w')\n self.onCompleteds = []\n subprocess.run(['pkill', '-STOP', '-F', self.last_paused])\n\n[文档] def resume(self):\n logger.debug('MusicPlayer resume')\n self.pausing = False\n self.onCompleteds = [self.next]\n if self.last_paused is not None:\n print(self.last_paused)\n subprocess.run(['pkill', '-CONT', '-F', self.last_paused])\n\n\n\n\n\n[文档] def turnUp(self):\n system = platform.system()\n if system == 'Darwin':\n res = subprocess.run(['osascript', '-e', 'output volume of (get volume settings)'], shell=False, capture_output=True, text=True)\n volume = int(res.stdout.strip())\n volume += 20\n if volume >= 100:\n volume = 100\n self.plugin.say('音量已经最大啦', wait=True)\n subprocess.run(['osascript', '-e', 'set volume output volume {}'.format(volume)])\n elif system == 'Linux':\n res = subprocess.run(["amixer sget Master | grep 'Mono:' | awk -F'[][]' '{ print $2 }'"], shell=True, capture_output=True, text=True)\n print(res.stdout)\n if res.stdout != '' and res.stdout.strip().endswith('%'):\n volume = int(res.stdout.strip().replace('%', ''))\n volume += 20\n if volume >= 100:\n volume = 100\n self.plugin.say('音量已经最大啦', wait=True)\n subprocess.run(['amixer', 'set', 'Master', '{}%'.format(volume)])\n else:\n subprocess.run(['amixer', 'set', 'Master', '20%+'])\n else:\n self.plugin.say('当前系统不支持调节音量')\n self.resume()\n\n[文档] def turnDown(self):\n system = platform.system()\n if system == 'Darwin':\n res = subprocess.run(['osascript', '-e', 'output volume of (get volume settings)'], shell=False, capture_output=True, text=True)\n volume = int(res.stdout.strip())\n volume -= 20\n if volume <= 20:\n volume = 20\n self.plugin.say('音量已经很小啦', wait=True)\n subprocess.run(['osascript', '-e', 'set volume output volume {}'.format(volume)])\n elif system == 'Linux':\n res = subprocess.run(["amixer sget Master | grep 'Mono:' | awk -F'[][]' '{ print $2 }'"], shell=True, capture_output=True, text=True)\n if res.stdout != '' and res.stdout.endswith('%'):\n volume = int(res.stdout.replace('%', '').strip())\n volume -= 20\n if volume <= 20:\n volume = 20\n self.plugin.say('音量已经最小啦', wait=True)\n subprocess.run(['amixer', 'set', 'Master', '{}%'.format(volume)])\n else:\n subprocess.run(['amixer', 'set', 'Master', '20%-'])\n else:\n self.plugin.say('当前系统不支持调节音量')\n self.resume()\n\n# -*- coding: utf-8-*-\nfrom aip import AipSpeech\nfrom .sdk import TencentSpeech, AliSpeech\nfrom . import utils, config\nfrom robot import logging\nimport base64\nimport time\nimport requests\nimport hashlib\nfrom abc import ABCMeta, abstractmethod\n\nlogger = logging.getLogger(__name__)\n\n[文档]class AbstractTTS(object):\n """\n Generic parent class for all TTS engines\n """\n\n __metaclass__ = ABCMeta\n\n\n\n[文档] @classmethod\n def get_instance(cls):\n profile = cls.get_config()\n instance = cls(**profile)\n return instance\n\n\n\n[文档]class BaiduTTS(AbstractTTS):\n """\n 使用百度语音合成技术\n 要使用本模块, 首先到 yuyin.baidu.com 注册一个开发者账号,\n 之后创建一个新应用, 然后在应用管理的"查看key"中获得 API Key 和 Secret Key\n 填入 config.yml 中.\n ...\n baidu_yuyin: \n appid: '9670645'\n api_key: 'qg4haN8b2bGvFtCbBGqhrmZy'\n secret_key: '585d4eccb50d306c401d7df138bb02e7'\n dev_pid: 1936\n per: 1\n lan: 'zh'\n ...\n """\n\n SLUG = "baidu-tts"\n\n def __init__(self, appid, api_key, secret_key, per=1, lan='zh', **args):\n super(self.__class__, self).__init__()\n self.client = AipSpeech(appid, api_key, secret_key)\n self.per, self.lan = str(per), lan\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get baidu_yuyin config from config\n return config.get('baidu_yuyin', {})\n\n[文档] def get_speech(self, phrase):\n result = self.client.synthesis(phrase, self.lan, 1, {'per': self.per});\n # 识别正确返回语音二进制 错误则返回dict 参照下面错误码\n if not isinstance(result, dict):\n tmpfile = utils.write_temp_file(result, '.mp3')\n logger.info('{} 语音合成成功，合成路径：{}'.format(self.SLUG, tmpfile))\n return tmpfile\n else:\n logger.critical('{} 合成失败！'.format(self.SLUG), exc_info=True)\n\n\n[文档]class TencentTTS(AbstractTTS):\n """\n 腾讯的语音合成\n region: 服务地域，挑个离自己最近的区域有助于提升速度。\n 有效值：https://cloud.tencent.com/document/api/441/17365#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8\n voiceType:\n - 0：女声1，亲和风格(默认)\n - 1：男声1，成熟风格\n - 2：男声2，成熟风格\n language:\n - 1: 中文，最大100个汉字（标点符号算一个汉子）\n - 2: 英文，最大支持400个字母（标点符号算一个字母）\n """\n\n SLUG = "tencent-tts"\n\n def __init__(self, appid, secretid, secret_key, region='ap-guangzhou', voiceType=0, language=1, **args):\n super(self.__class__, self).__init__()\n self.engine = TencentSpeech.tencentSpeech(secret_key, secretid)\n self.region, self.voiceType, self.language = region, voiceType, language\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get tencent_yuyin config from config\n return config.get('tencent_yuyin', {})\n \n[文档] def get_speech(self, phrase):\n result = self.engine.TTS(phrase, self.voiceType, self.language, self.region)\n if 'Response' in result and 'Audio' in result['Response']:\n audio = result['Response']['Audio']\n data = base64.b64decode(audio)\n tmpfile = utils.write_temp_file(data, '.wav')\n logger.info('{} 语音合成成功，合成路径：{}'.format(self.SLUG, tmpfile))\n return tmpfile\n else:\n logger.critical('{} 合成失败！'.format(self.SLUG), exc_info=True)\n\n\n[文档]class XunfeiTTS(AbstractTTS):\n """\n 科大讯飞的语音识别API.\n 外网ip查询：https://ip.51240.com/\n voice_name: https://www.xfyun.cn/services/online_tts\n """\n\n SLUG = "xunfei-tts"\n\n def __init__(self, appid, asr_api_key, asr_api_secret, tts_api_key, voice='xiaoyan'):\n super(self.__class__, self).__init__()\n self.appid, self.api_key, self.voice_name = appid, tts_api_key, voice\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get xunfei_yuyin config from config\n return config.get('xunfei_yuyin', {}) \n\n[文档] def getHeader(self, aue):\n curTime = str(int(time.time()))\n # curTime = '1526542623'\n param = "{\\"aue\\":\\""+aue+"\\",\\"auf\\":\\"audio/L16;rate=16000\\",\\"voice_name\\":\\"" + self.voice_name + "\\",\\"engine_type\\":\\"intp65\\"}"\n logger.debug("param:{}".format(param))\n paramBase64 = str(base64.b64encode(param.encode('utf-8')), 'utf-8')\n logger.debug("x_param:{}".format(paramBase64))\n\n m2 = hashlib.md5()\n m2.update((self.api_key + curTime + paramBase64).encode('utf-8'))\n checkSum = m2.hexdigest()\n header = {\n 'X-CurTime': curTime,\n 'X-Param': paramBase64,\n 'X-Appid': self.appid,\n 'X-CheckSum': checkSum,\n 'X-Real-Ip':'127.0.0.1',\n 'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8',\n }\n return header\n\n\n\n[文档] def get_speech(self, phrase):\n URL = "http://api.xfyun.cn/v1/service/v1/tts"\n r = requests.post(URL, headers=self.getHeader('lame'), data=self.getBody(phrase))\n contentType = r.headers['Content-Type']\n if contentType == "audio/mpeg":\n tmpfile = utils.write_temp_file(r.content, '.mp3')\n logger.info('{} 语音合成成功，合成路径：{}'.format(self.SLUG, tmpfile))\n return tmpfile\n else :\n logger.critical('{} 合成失败！{}'.format(self.SLUG, r.text), exc_info=True)\n\n\n[文档]class AliTTS(AbstractTTS):\n """\n 阿里的TTS\n voice: 发音人，默认是 xiaoyun\n 全部发音人列表：https://help.aliyun.com/document_detail/84435.html?spm=a2c4g.11186623.2.24.67ce5275q2RGsT\n """\n SLUG = "ali-tts"\n\n def __init__(self, appKey, token, voice='xiaoyun', **args):\n super(self.__class__, self).__init__()\n self.appKey, self.token, self.voice = appKey, token, voice\n\n[文档] @classmethod\n def get_config(cls):\n # Try to get ali_yuyin config from config\n return config.get('ali_yuyin', {})\n \n[文档] def get_speech(self, phrase):\n tmpfile = AliSpeech.tts(self.appKey, self.token, self.voice, phrase)\n if tmpfile is not None:\n logger.info('{} 语音合成成功，合成路径：{}'.format(self.SLUG, tmpfile))\n return tmpfile\n else:\n logger.critical('{} 合成失败！'.format(self.SLUG), exc_info=True)\n\n[文档]def get_engine_by_slug(slug=None):\n """\n Returns:\n A TTS Engine implementation available on the current platform\n\n Raises:\n ValueError if no speaker implementation is supported on this platform\n """\n\n if not slug or type(slug) is not str:\n raise TypeError("无效的 TTS slug '%s'", slug)\n\n selected_engines = list(filter(lambda engine: hasattr(engine, "SLUG") and\n engine.SLUG == slug, get_engines()))\n\n if len(selected_engines) == 0:\n raise ValueError("错误：找不到名为 {} 的 TTS 引擎".format(slug))\n else:\n if len(selected_engines) > 1:\n logger.warning("注意: 有多个 TTS 名称与指定的引擎名 {} 匹配").format(slug) \n engine = selected_engines[0]\n logger.info("使用 {} TTS 引擎".format(engine.SLUG))\n return engine.get_instance()\n\n\n[文档]def get_engines():\n def get_subclasses(cls):\n subclasses = set()\n for subclass in cls.__subclasses__():\n subclasses.add(subclass)\n subclasses.update(get_subclasses(subclass))\n return subclasses\n return [engine for engine in\n list(get_subclasses(AbstractTTS))\n if hasattr(engine, 'SLUG') and engine.SLUG]\n\nimport os\nimport requests\nimport json\nimport semver\nfrom subprocess import call\nfrom robot import constants, logging\nfrom datetime import datetime, timedelta\n\nlogger = logging.getLogger(__name__)\nlogger.setLevel(level=logging.INFO)\n\n_updater = None\nURL = 'https://service-e32kknxi-1253537070.ap-hongkong.apigateway.myqcloud.com/release/wukong'\nDEV_URL = 'https://service-e32kknxi-1253537070.ap-hongkong.apigateway.myqcloud.com/release/wukong-dev'\n\n[文档]class Updater(object):\n\n def __init__(self):\n self.last_check = datetime.now() - timedelta(days=1.5)\n self.update_info = {}\n\n def _pull(self, cwd, tag):\n if os.path.exists(cwd):\n return call(['git checkout master && git pull && git checkout {}'.format(tag, tag, tag)], cwd=cwd, shell=True) == 0\n else:\n logger.error("目录 {} 不存在".format(cwd))\n return False\n\n def _pip(self, cwd):\n if os.path.exists(cwd):\n return call(['pip3', 'install', '-r', 'requirements.txt'], cwd=cwd, shell=False) == 0\n else:\n logger.error("目录 {} 不存在".format(cwd))\n return False\n\n[文档] def update(self):\n update_info = self.fetch()\n success = True\n if update_info == {}:\n logger.info('恭喜你，wukong-robot 已经是最新！')\n if 'main' in update_info:\n if self._pull(constants.APP_PATH, update_info['main']['version']) and self._pip(constants.APP_PATH):\n logger.info('wukong-robot 更新成功！')\n self.update_info.pop('main')\n else:\n logger.info('wukong-robot 更新失败！')\n success = False\n if 'contrib' in update_info:\n if self._pull(constants.CONTRIB_PATH, update_info['contrib']['version']) and self._pip(constants.CONTRIB_PATH):\n logger.info('wukong-contrib 更新成功！')\n self.update_info.pop('contrib')\n else:\n logger.info('wukong-contrib 更新失败！')\n success = False\n return success\n\n def _get_version(self, path, current):\n if os.path.exists(os.path.join(path, 'VERSION')):\n with open(os.path.join(path, 'VERSION'), 'r') as f:\n return f.read().strip()\n else:\n return current\n\n[文档] def fetch(self, dev=False):\n global URL, DEV_URL\n url = URL\n if dev:\n url = DEV_URL\n now = datetime.now()\n if (now - self.last_check).seconds <= 1800:\n logger.debug('30 分钟内已检查过更新，使用上次的检查结果：{}'.format(self.update_info)) \n return self.update_info\n try:\n self.last_check = now\n r = requests.get(url, timeout=3)\n info = json.loads(r.text)\n main_version = info['main']['version']\n contrib_version = info['contrib']['version']\n # 检查主仓库\n current_main_version = self._get_version(constants.APP_PATH, main_version)\n current_contrib_version = self._get_version(constants.CONTRIB_PATH, contrib_version)\n if semver.compare(main_version, current_main_version) > 0:\n logger.info('主仓库检查到更新：{}'.format(info['main']))\n self.update_info['main'] = info['main']\n if semver.compare(contrib_version, current_contrib_version) > 0:\n logger.info('插件库检查到更新：{}'.format(info['contrib']))\n self.update_info['contrib'] = info['contrib']\n if 'notices' in info:\n self.update_info['notices'] = info['notices']\n return self.update_info\n except Exception as e:\n logger.error("检查更新失败：", e)\n return {}\n\n[文档]def fetch(dev):\n global _updater\n if not _updater:\n _updater = Updater()\n return _updater.fetch(dev)\n \n \nif __name__ == '__main__':\n fetch()\n\n# -*- coding: utf-8-*-\nimport yaml\nimport logging\nimport os\nfrom . import constants\n\nlogger = logging.getLogger(__name__)\n\n_config = {}\nhas_init = False\n\n\n\n[文档]def init():\n global has_init\n if os.path.isfile(constants.CONFIG_PATH):\n logger.critical("错误：{} 应该是个目录，而不应该是个文件".format(constants.CONFIG_PATH))\n if not os.path.exists(constants.CONFIG_PATH):\n os.makedirs(constants.CONFIG_PATH)\n if not os.path.exists(constants.getConfigPath()):\n yes_no = input("配置文件{}不存在，要创建吗？(y/n)".format(constants.getConfigPath()))\n if yes_no.lower() == 'y':\n constants.newConfig()\n doInit(constants.getConfigPath())\n else:\n doInit(constants.getDefaultConfigPath())\n else:\n doInit(constants.getConfigPath())\n has_init = True\n\n[文档]def doInit(config_file=constants.getDefaultConfigPath()):\n # Create config dir if it does not exist yet\n if not os.path.exists(constants.CONFIG_PATH):\n try:\n os.makedirs(constants.CONFIG_PATH)\n except OSError:\n logger.error("Could not create config dir: '%s'",\n constants.CONFIG_PATH, exc_info=True)\n raise\n\n # Check if config dir is writable\n if not os.access(constants.CONFIG_PATH, os.W_OK):\n logger.critical("Config dir %s is not writable. Dingdang " +\n "won't work correctly.",\n constants.CONFIG_PATH)\n\n global _config\n\n # Read config\n logger.debug("Trying to read config file: '%s'", config_file)\n try:\n with open(config_file, "r") as f:\n _config = yaml.safe_load(f)\n except Exception as e:\n logger.error("配置文件 {} 读取失败: {}".format(config_file, e))\n raise\n\n\n[文档]def get_path(items, default=None):\n global _config\n curConfig = _config\n if isinstance(items, str) and items[0] == '/':\n items = items.split('/')[1:]\n for key in items:\n if key in curConfig:\n curConfig = curConfig[key]\n else:\n logger.warning("/%s not specified in profile, defaulting to "\n "'%s'", '/'.join(items), default)\n return default\n return curConfig\n\n\n[文档]def has_path(items):\n global _config\n curConfig = _config\n if isinstance(items, str) and items[0] == '/':\n items = items.split('/')[1:]\n else:\n items = [items]\n for key in items:\n if key in curConfig:\n curConfig = curConfig[key]\n else:\n return False\n return True\n\n\n[文档]def has(item):\n """\n 判断配置里是否包含某个配置项\n\n :param item: 配置项名\n :returns: True: 包含; False: 不包含\n """\n return has_path(item)\n\n\n[文档]def get(item='', default=None):\n """\n 获取某个配置的值\n\n :param item: 配置项名。如果是多级配置，则以 "/a/b" 的形式提供\n :param default: 默认值（可选）\n :returns: 这个配置的值。如果没有该配置，则提供一个默认值\n """\n global has_init\n if not has_init:\n init()\n if not item:\n return _config\n if item[0] == '/':\n return get_path(item, default)\n try:\n return _config[item]\n except KeyError:\n logger.warning("%s not specified in profile, defaulting to '%s'",\n item, default)\n return default\n \n\n\n[文档]def getText():\n if os.path.exists(constants.getConfigPath()):\n with open(constants.getConfigPath(), 'r') as f:\n return f.read()\n return ''\n\n\n\n\n# -*- coding: utf-8-*-\nimport os\nimport shutil\n\n# Wukong main directory\nAPP_PATH = os.path.normpath(os.path.join(\n os.path.dirname(os.path.abspath(__file__)), os.pardir))\n \nLIB_PATH = os.path.join(APP_PATH, "robot")\nDATA_PATH = os.path.join(APP_PATH, "static")\nTEMP_PATH = os.path.join(APP_PATH, "temp")\nTEMPLATE_PATH = os.path.join(APP_PATH, "server", "templates")\nPLUGIN_PATH = os.path.join(APP_PATH, "plugins")\nDEFAULT_CONFIG_NAME = 'default.yml'\nCUSTOM_CONFIG_NAME = 'config.yml'\n\nCONFIG_PATH = os.path.expanduser(\n os.getenv('WUKONG_CONFIG', '~/.wukong')\n)\nCONTRIB_PATH = os.path.expanduser(\n os.getenv('WUKONG_CONFIG', '~/.wukong/contrib')\n)\nCUSTOM_PATH = os.path.expanduser(\n os.getenv('WUKONG_CONFIG', '~/.wukong/custom')\n)\n\n[文档]def getConfigPath():\n """\n 获取配置文件的路径\n\n returns: 配置文件的存储路径\n """\n return os.path.join(CONFIG_PATH, CUSTOM_CONFIG_NAME)\n\n[文档]def getConfigData(*fname):\n """\n 获取配置目录下的指定文件的路径\n\n :param *fname: 指定文件名。如果传多个，则自动拼接\n :returns: 配置目录下的某个文件的存储路径\n """\n return os.path.join(CONFIG_PATH, *fname)\n\n[文档]def getData(*fname):\n """\n 获取资源目录下指定文件的路径\n\n :param *fname: 指定文件名。如果传多个，则自动拼接\n :returns: 配置文件的存储路径\n """\n return os.path.join(DATA_PATH, *fname)\n\n\n\n\n\n[文档]def getHotwordModel(fname):\n if os.path.exists(getData(fname)):\n return getData(fname)\n else:\n return getConfigData(fname)\n\n\n"""\nfrom https://github.com/tinue/APA102_Pi\nThis is the main driver module for APA102 LEDs\n"""\nimport spidev\nfrom math import ceil\n\nRGB_MAP = { 'rgb': [3, 2, 1], 'rbg': [3, 1, 2], 'grb': [2, 3, 1],\n 'gbr': [2, 1, 3], 'brg': [1, 3, 2], 'bgr': [1, 2, 3] }\n\n[文档]class APA102:\n """\n Driver for APA102 LEDS (aka "DotStar").\n\n (c) Martin Erzberger 2016-2017\n\n My very first Python code, so I am sure there is a lot to be optimized ;)\n\n Public methods are:\n - set_pixel\n - set_pixel_rgb\n - show\n - clear_strip\n - cleanup\n\n Helper methods for color manipulation are:\n - combine_color\n - wheel\n\n The rest of the methods are used internally and should not be used by the\n user of the library.\n\n Very brief overview of APA102: An APA102 LED is addressed with SPI. The bits\n are shifted in one by one, starting with the least significant bit.\n\n An LED usually just forwards everything that is sent to its data-in to\n data-out. While doing this, it remembers its own color and keeps glowing\n with that color as long as there is power.\n\n An LED can be switched to not forward the data, but instead use the data\n to change it's own color. This is done by sending (at least) 32 bits of\n zeroes to data-in. The LED then accepts the next correct 32 bit LED\n frame (with color information) as its new color setting.\n\n After having received the 32 bit color frame, the LED changes color,\n and then resumes to just copying data-in to data-out.\n\n The really clever bit is this: While receiving the 32 bit LED frame,\n the LED sends zeroes on its data-out line. Because a color frame is\n 32 bits, the LED sends 32 bits of zeroes to the next LED.\n As we have seen above, this means that the next LED is now ready\n to accept a color frame and update its color.\n\n So that's really the entire protocol:\n - Start by sending 32 bits of zeroes. This prepares LED 1 to update\n its color.\n - Send color information one by one, starting with the color for LED 1,\n then LED 2 etc.\n - Finish off by cycling the clock line a few times to get all data\n to the very last LED on the strip\n\n The last step is necessary, because each LED delays forwarding the data\n a bit. Imagine ten people in a row. When you yell the last color\n information, i.e. the one for person ten, to the first person in\n the line, then you are not finished yet. Person one has to turn around\n and yell it to person 2, and so on. So it takes ten additional "dummy"\n cycles until person ten knows the color. When you look closer,\n you will see that not even person 9 knows its own color yet. This\n information is still with person 2. Essentially the driver sends additional\n zeroes to LED 1 as long as it takes for the last color frame to make it\n down the line to the last LED.\n """\n # Constants\n MAX_BRIGHTNESS = 31 # Safeguard: Set to a value appropriate for your setup\n LED_START = 0b11100000 # Three "1" bits, followed by 5 brightness bits\n\n def __init__(self, num_led, global_brightness=MAX_BRIGHTNESS,\n order='rgb', bus=0, device=1, max_speed_hz=8000000):\n self.num_led = num_led # The number of LEDs in the Strip\n order = order.lower()\n self.rgb = RGB_MAP.get(order, RGB_MAP['rgb'])\n # Limit the brightness to the maximum if it's set higher\n if global_brightness > self.MAX_BRIGHTNESS:\n self.global_brightness = self.MAX_BRIGHTNESS\n else:\n self.global_brightness = global_brightness\n\n self.leds = [self.LED_START,0,0,0] * self.num_led # Pixel buffer\n self.spi = spidev.SpiDev() # Init the SPI device\n self.spi.open(bus, device) # Open SPI port 0, slave device (CS) 1\n # Up the speed a bit, so that the LEDs are painted faster\n if max_speed_hz:\n self.spi.max_speed_hz = max_speed_hz\n\n[文档] def clock_start_frame(self):\n """Sends a start frame to the LED strip.\n\n This method clocks out a start frame, telling the receiving LED\n that it must update its own color now.\n """\n self.spi.xfer2([0] * 4) # Start frame, 32 zero bits\n\n\n[文档] def clock_end_frame(self):\n """Sends an end frame to the LED strip.\n\n As explained above, dummy data must be sent after the last real colour\n information so that all of the data can reach its destination down the line.\n The delay is not as bad as with the human example above.\n It is only 1/2 bit per LED. This is because the SPI clock line\n needs to be inverted.\n\n Say a bit is ready on the SPI data line. The sender communicates\n this by toggling the clock line. The bit is read by the LED\n and immediately forwarded to the output data line. When the clock goes\n down again on the input side, the LED will toggle the clock up\n on the output to tell the next LED that the bit is ready.\n\n After one LED the clock is inverted, and after two LEDs it is in sync\n again, but one cycle behind. Therefore, for every two LEDs, one bit\n of delay gets accumulated. For 300 LEDs, 150 additional bits must be fed to\n the input of LED one so that the data can reach the last LED.\n\n Ultimately, we need to send additional numLEDs/2 arbitrary data bits,\n in order to trigger numLEDs/2 additional clock changes. This driver\n sends zeroes, which has the benefit of getting LED one partially or\n fully ready for the next update to the strip. An optimized version\n of the driver could omit the "clockStartFrame" method if enough zeroes have\n been sent as part of "clockEndFrame".\n """\n # Round up num_led/2 bits (or num_led/16 bytes)\n for _ in range((self.num_led + 15) // 16):\n self.spi.xfer2([0x00])\n\n\n[文档] def clear_strip(self):\n """ Turns off the strip and shows the result right away."""\n\n for led in range(self.num_led):\n self.set_pixel(led, 0, 0, 0)\n self.show()\n\n\n[文档] def set_pixel(self, led_num, red, green, blue, bright_percent=100):\n """Sets the color of one pixel in the LED stripe.\n\n The changed pixel is not shown yet on the Stripe, it is only\n written to the pixel buffer. Colors are passed individually.\n If brightness is not set the global brightness setting is used.\n """\n if led_num < 0:\n return # Pixel is invisible, so ignore\n if led_num >= self.num_led:\n return # again, invisible\n\n # Calculate pixel brightness as a percentage of the\n # defined global_brightness. Round up to nearest integer\n # as we expect some brightness unless set to 0\n brightness = ceil(bright_percent*self.global_brightness/100.0)\n brightness = int(brightness)\n\n # LED startframe is three "1" bits, followed by 5 brightness bits\n ledstart = (brightness & 0b00011111) | self.LED_START\n\n start_index = 4 * led_num\n self.leds[start_index] = ledstart\n self.leds[start_index + self.rgb[0]] = red\n self.leds[start_index + self.rgb[1]] = green\n self.leds[start_index + self.rgb[2]] = blue\n\n\n[文档] def set_pixel_rgb(self, led_num, rgb_color, bright_percent=100):\n """Sets the color of one pixel in the LED stripe.\n\n The changed pixel is not shown yet on the Stripe, it is only\n written to the pixel buffer.\n Colors are passed combined (3 bytes concatenated)\n If brightness is not set the global brightness setting is used.\n """\n self.set_pixel(led_num, (rgb_color & 0xFF0000) >> 16,\n (rgb_color & 0x00FF00) >> 8, rgb_color & 0x0000FF,\n bright_percent)\n\n\n[文档] def rotate(self, positions=1):\n """ Rotate the LEDs by the specified number of positions.\n\n Treating the internal LED array as a circular buffer, rotate it by\n the specified number of positions. The number could be negative,\n which means rotating in the opposite direction.\n """\n cutoff = 4 * (positions % self.num_led)\n self.leds = self.leds[cutoff:] + self.leds[:cutoff]\n\n\n[文档] def show(self):\n """Sends the content of the pixel buffer to the strip.\n\n Todo: More than 1024 LEDs requires more than one xfer operation.\n """\n self.clock_start_frame()\n # xfer2 kills the list, unfortunately. So it must be copied first\n # SPI takes up to 4096 Integers. So we are fine for up to 1024 LEDs.\n self.spi.xfer2(list(self.leds))\n self.clock_end_frame()\n\n\n[文档] def cleanup(self):\n """Release the SPI device; Call this method at the end"""\n\n self.spi.close() # Close SPI port\n\n[文档] @staticmethod\n def combine_color(red, green, blue):\n """Make one 3*8 byte color value."""\n\n return (red << 16) + (green << 8) + blue\n\n\n[文档] def wheel(self, wheel_pos):\n """Get a color from a color wheel; Green -> Red -> Blue -> Green"""\n\n if wheel_pos > 255:\n wheel_pos = 255 # Safeguard\n if wheel_pos < 85: # Green -> Red\n return self.combine_color(wheel_pos * 3, 255 - wheel_pos * 3, 0)\n if wheel_pos < 170: # Red -> Blue\n wheel_pos -= 85\n return self.combine_color(255 - wheel_pos * 3, 0, wheel_pos * 3)\n # Blue -> Green\n wheel_pos -= 170\n return self.combine_color(0, wheel_pos * 3, 255 - wheel_pos * 3)\n\n\n[文档] def dump_array(self):\n """For debug purposes: Dump the LED array onto the console."""\n\n print(self.leds)\n\nfrom . import apa102\nimport time\nimport threading\ntry:\n import queue as Queue\nexcept ImportError:\n import Queue as Queue\n\n\n[文档]class Pixels:\n PIXELS_N = 3\n\n def __init__(self):\n self.basis = [0] * 3 * self.PIXELS_N\n self.basis[0] = 1\n self.basis[4] = 1\n self.basis[8] = 2\n\n self.colors = [0] * 3 * self.PIXELS_N\n self.dev = apa102.APA102(num_led=self.PIXELS_N)\n\n self.next = threading.Event()\n self.queue = Queue.Queue()\n self.thread = threading.Thread(target=self._run)\n self.thread.daemon = True\n self.thread.start()\n\n[文档] def wakeup(self, direction=0):\n def f():\n self._wakeup(direction)\n\n self.next.set()\n self.queue.put(f)\n\n\n\n\n\n\n\n\n\n def _run(self):\n while True:\n func = self.queue.get()\n func()\n\n def _wakeup(self, direction=0):\n for i in range(1, 25):\n colors = [i * v for v in self.basis]\n self.write(colors)\n time.sleep(0.01)\n\n self.colors = colors\n\n def _listen(self):\n for i in range(1, 25):\n colors = [i * v for v in self.basis]\n self.write(colors)\n time.sleep(0.01)\n\n self.colors = colors\n\n def _think(self):\n colors = self.colors\n\n self.next.clear()\n while not self.next.is_set():\n colors = colors[3:] + colors[:3]\n self.write(colors)\n time.sleep(0.2)\n\n t = 0.1\n for i in range(0, 5):\n colors = colors[3:] + colors[:3]\n self.write([(v * (4 - i) / 4) for v in colors])\n time.sleep(t)\n t /= 2\n\n # time.sleep(0.5)\n\n self.colors = colors\n\n def _speak(self):\n colors = self.colors\n\n self.next.clear()\n while not self.next.is_set():\n for i in range(5, 25):\n colors = [(v * i / 24) for v in colors]\n self.write(colors)\n time.sleep(0.01)\n\n time.sleep(0.3)\n\n for i in range(24, 4, -1):\n colors = [(v * i / 24) for v in colors]\n self.write(colors)\n time.sleep(0.01)\n\n time.sleep(0.3)\n\n self._off()\n\n def _off(self):\n self.write([0] * 3 * self.PIXELS_N)\n\n[文档] def write(self, colors):\n for i in range(self.PIXELS_N):\n self.dev.set_pixel(i, int(colors[3*i]), int(colors[3*i + 1]), int(colors[3*i + 2]))\n\n self.dev.show()\n\n\npixels = Pixels()\n\n\nif __name__ == '__main__':\n while True:\n\n try:\n pixels.wakeup()\n time.sleep(3)\n pixels.think()\n time.sleep(3)\n pixels.speak()\n time.sleep(3)\n pixels.off()\n time.sleep(3)\n except KeyboardInterrupt:\n break\n\n\n pixels.off()\n time.sleep(1)\n\nimport logging\nimport os\nfrom robot import constants\nfrom logging.handlers import RotatingFileHandler\n\nPAGE = 4096\n\nDEBUG = logging.DEBUG\nINFO = logging.INFO\nWARNING = logging.WARNING\nERROR = logging.ERROR\n\n[文档]def tail(filepath, n=10):\n """\n 实现 tail -n\n """\n res = ""\n with open(filepath, 'rb') as f:\n f_len = f.seek(0, 2)\n rem = f_len % PAGE\n page_n = f_len // PAGE\n r_len = rem if rem else PAGE\n while True:\n # 如果读取的页大小>=文件大小，直接读取数据输出\n if r_len >= f_len:\n f.seek(0)\n lines = f.readlines()[::-1]\n break\n\n f.seek(-r_len, 2)\n # print('f_len: {}, rem: {}, page_n: {}, r_len: {}'.format(f_len, rem, page_n, r_len))\n lines = f.readlines()[::-1]\n count = len(lines) -1 # 末行可能不完整，减一行，加大读取量\n\n if count >= n: # 如果读取到的行数>=指定行数，则退出循环读取数据\n break\n else: # 如果读取行数不够，载入更多的页大小读取数据\n r_len += PAGE\n page_n -= 1\n\n for line in lines[:n][::-1]:\n res += line.decode('utf-8')\n return res\n\n[文档]def getLogger(name):\n """ \n 作用同标准模块 logging.getLogger(name) \n \n :returns: logger\n """\n formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')\n\n logger = logging.getLogger(name)\n logger.setLevel(logging.INFO)\n \n # FileHandler\n file_handler = RotatingFileHandler(os.path.join(constants.TEMP_PATH, 'wukong.log'), maxBytes=1024*1024,backupCount=5)\n file_handler.setLevel(level=logging.DEBUG)\n file_handler.setFormatter(formatter)\n logger.addHandler(file_handler)\n\n return logger\n\n[文档]def readLog(lines=200):\n """ \n 获取最新的指定行数的 log\n\n :param lines: 最大的行数\n :returns: 最新指定行数的 log\n """\n log_path = os.path.join(constants.TEMP_PATH, 'wukong.log')\n if os.path.exists(log_path):\n return tail(log_path, lines)\n return ''\n \n\n# -*- coding: utf-8-*-\nimport pkgutil\nfrom . import constants\nfrom . import config\nfrom robot import logging\nfrom robot.sdk.AbstractPlugin import AbstractPlugin\n\nlogger = logging.getLogger(__name__)\n_has_init = False\n\n# plugins run at query\n_plugins_query = []\n\n[文档]def init_plugins(con):\n """\n 动态加载技能插件\n\n 参数：\n con -- 会话模块\n """\n\n global _has_init\n locations = [\n constants.PLUGIN_PATH,\n constants.CONTRIB_PATH,\n constants.CUSTOM_PATH\n ]\n logger.debug("检查插件目录：{}".format(locations))\n\n global _plugins_query\n nameSet = set()\n\n for finder, name, ispkg in pkgutil.walk_packages(locations):\n try:\n loader = finder.find_module(name)\n mod = loader.load_module(name)\n except Exception:\n logger.warning("插件 {} 加载出错，跳过".format(name),\n exc_info=True)\n continue\n\n if not hasattr(mod, 'Plugin'):\n logger.debug("模块 {} 非插件，跳过".format(name))\n continue\n\n # plugins run at query\n plugin = mod.Plugin(con)\n\n if plugin.SLUG == 'AbstractPlugin':\n plugin.SLUG = name\n\n # check conflict\n if plugin.SLUG in nameSet:\n logger.warning("插件 {} SLUG({}) 重复，跳过".format(name,\n plugin.SLUG))\n continue\n nameSet.add(plugin.SLUG)\n\n # whether a plugin is enabled\n if config.has(plugin.SLUG) and 'enable' in config.get(plugin.SLUG):\n if not config.get(plugin.SLUG)['enable']:\n logger.info("插件 {} 已被禁用".format(name))\n continue\n\n if issubclass(mod.Plugin, AbstractPlugin):\n logger.info("插件 {} 加载成功 ".format(name))\n _plugins_query.append(plugin)\n\n def sort_priority(m):\n if hasattr(m, 'PRIORITY'):\n return m.PRIORITY\n return 0\n\n _plugins_query.sort(key=sort_priority, reverse=True)\n _has_init = True\n\n\n[文档]def get_plugins(con):\n global _plugins_query\n _plugins_query = []\n init_plugins(con)\n return _plugins_query\n\n\nfrom abc import ABCMeta, abstractmethod\nfrom robot import constants\nfrom robot import logging\nimport sys\n\nlogger = logging.getLogger(__name__)\n\ntry:\n sys.path.append(constants.CONTRIB_PATH)\nexcept Exception as e:\n logger.debug("未检测到插件目录,Error:{}".format(e))\n \n[文档]class AbstractPlugin(metaclass=ABCMeta):\n """ 技能插件基类 """\n\n SLUG = 'AbstractPlugin'\n IS_IMMERSIVE = False\n\n def __init__(self, con):\n if self.IS_IMMERSIVE is not None:\n self.isImmersive = self.IS_IMMERSIVE\n else:\n self.isImmersive = False\n self.priority = 0\n self.con = con\n self.nlu = self.con.nlu\n\n[文档] def play(self, src, delete=False, onCompleted=None, volume=1):\n self.con.play(src, delete, onCompleted, volume)\n\n[文档] def say(self, text, cache=False, onCompleted=None, wait=False):\n self.con.say(text, cache=cache, plugin=self.SLUG, onCompleted=onCompleted, wait=wait)\n\n\n\n\n\n[文档] @abstractmethod\n def isValid(self, query, parsed):\n """\n 是否适合由该插件处理\n\n 参数：\n query -- 用户的指令字符串\n parsed -- 用户指令经过 NLU 解析后的结果\n\n 返回：\n True: 适合由该插件处理\n False: 不适合由该插件处理\n """\n return False\n\n[文档] @abstractmethod\n def handle(self, query, parsed):\n """\n 处理逻辑\n\n 参数：\n query -- 用户的指令字符串\n parsed -- 用户指令经过 NLU 解析后的结果\n """\n pass\n\n[文档] def isValidImmersive(self, query, parsed):\n """\n 是否适合在沉浸模式下处理，\n 仅适用于有沉浸模式的插件（如音乐等）\n 当用户唤醒时，可以响应更多指令集。\n 例如：“"上一首"、"下一首" 等\n """\n return False\n\n[文档] def pause(self):\n """\n 暂停当前正在处理的任务，\n 当处于该沉浸模式下且被唤醒时，\n 将自动触发这个方法，\n 可以用于强制暂停一个耗时的操作 \n """\n return\n\n[文档] def restore(self):\n """\n 恢复当前插件，\n 仅适用于有沉浸模式的插件（如音乐等）\n 当用户误唤醒或者唤醒进行闲聊后，\n 可以自动恢复当前插件的处理逻辑\n """\n return\n \n\n# -*- coding: UTF-8 -*-\n\nimport http.client\nimport urllib.parse\nimport json\nfrom robot import utils\nfrom robot import logging\n\nlogger = logging.getLogger(__name__)\n\n[文档]def processGETRequest(appKey, token, voice, text, format, sampleRate) :\n host = 'nls-gateway.cn-shanghai.aliyuncs.com'\n url = 'https://' + host + '/stream/v1/tts'\n # 设置URL请求参数\n url = url + '?appkey=' + appKey\n url = url + '&token=' + token\n url = url + '&text=' + text\n url = url + '&format=' + format\n url = url + '&sample_rate=' + str(sampleRate)\n url = url + '&voice=' + voice\n logger.debug(url)\n conn = http.client.HTTPSConnection(host)\n conn.request(method='GET', url=url)\n # 处理服务端返回的响应\n response = conn.getresponse()\n logger.debug('Response status and response reason:')\n logger.debug(response.status ,response.reason)\n contentType = response.getheader('Content-Type')\n logger.debug(contentType)\n body = response.read()\n if 'audio/mpeg' == contentType :\n logger.debug('The GET request succeed!')\n tmpfile = utils.write_temp_file(body, '.mp3')\n conn.close()\n return tmpfile\n else :\n logger.debug('The GET request failed: ' + str(body))\n conn.close()\n return None\n\n[文档]def processPOSTRequest(appKey, token, voice, text, format, sampleRate) :\n host = 'nls-gateway.cn-shanghai.aliyuncs.com'\n url = 'https://' + host + '/stream/v1/tts'\n # 设置HTTPS Headers\n httpHeaders = {\n 'Content-Type': 'application/json'\n }\n # 设置HTTPS Body\n body = {'appkey': appKey, 'token': token, 'text': text, 'format': format, 'sample_rate': sampleRate, 'voice': voice}\n body = json.dumps(body)\n logger.debug('The POST request body content: ' + body)\n # Python 2.x 请使用httplib\n # conn = httplib.HTTPSConnection(host)\n # Python 3.x 请使用http.client\n conn = http.client.HTTPSConnection(host)\n conn.request(method='POST', url=url, body=body, headers=httpHeaders)\n # 处理服务端返回的响应\n response = conn.getresponse()\n logger.debug('Response status and response reason:')\n logger.debug(response.status ,response.reason)\n contentType = response.getheader('Content-Type')\n logger.debug(contentType)\n body = response.read()\n if 'audio/mpeg' == contentType :\n logger.debug('The POST request succeed!')\n tmpfile = utils.write_temp_file(body, '.mp3')\n conn.close()\n return tmpfile\n else :\n logger.critical('The POST request failed: ' + str(body))\n conn.close()\n return None\n\n[文档]def process(request, token, audioContent) :\n # 读取音频文件\n host = 'nls-gateway.cn-shanghai.aliyuncs.com'\n # 设置HTTP请求头部\n httpHeaders = {\n 'X-NLS-Token': token,\n 'Content-type': 'application/octet-stream',\n 'Content-Length': len(audioContent)\n }\n conn = http.client.HTTPConnection(host)\n conn.request(method='POST', url=request, body=audioContent, headers=httpHeaders)\n response = conn.getresponse()\n logger.debug('Response status and response reason:')\n logger.debug(response.status ,response.reason)\n body = response.read()\n try:\n logger.debug('Recognize response is:')\n body = json.loads(body)\n logger.debug(body)\n status = body['status']\n if status == 20000000 :\n result = body['result']\n logger.debug('Recognize result: ' + result)\n conn.close()\n return result\n else :\n logger.critical('Recognizer failed!')\n conn.close()\n return None\n except ValueError:\n logger.debug('The response is not json format string')\n conn.close()\n return None\n\n[文档]def tts(appKey, token, voice, text):\n # 采用RFC 3986规范进行urlencode编码\n textUrlencode = text\n textUrlencode = urllib.parse.quote_plus(textUrlencode)\n textUrlencode = textUrlencode.replace("+", "%20")\n textUrlencode = textUrlencode.replace("*", "%2A")\n textUrlencode = textUrlencode.replace("%7E", "~")\n format = 'mp3'\n sampleRate = 16000\n return processPOSTRequest(appKey, token, voice, text, format, sampleRate)\n\n[文档]def asr(appKey, token, wave_file):\n # 服务请求地址\n url = 'http://nls-gateway.cn-shanghai.aliyuncs.com/stream/v1/asr'\n pcm = utils.get_pcm_from_wav(wave_file)\n # 音频文件\n format = 'pcm'\n sampleRate = 16000\n enablePunctuationPrediction = True\n enableInverseTextNormalization = True\n enableVoiceDetection = False\n # 设置RESTful请求参数\n request = url + '?appkey=' + appKey\n request = request + '&format=' + format\n request = request + '&sample_rate=' + str(sampleRate)\n if enablePunctuationPrediction :\n request = request + '&enable_punctuation_prediction=' + 'true'\n if enableInverseTextNormalization :\n request = request + '&enable_inverse_text_normalization=' + 'true'\n if enableVoiceDetection :\n request = request + '&enable_voice_detection=' + 'true'\n logger.debug('Request: ' + request)\n return process(request, token, pcm)\n \n\n# -*- coding:utf-8 -*-\nimport urllib.request\nimport hmac\nimport hashlib\nimport base64\nimport time\nimport random\nimport os\nimport json\n\n\n[文档]def formatSignString(param):\n signstr = "POSTaai.qcloud.com/asr/v1/"\n for t in param:\n if 'appid' in t:\n signstr += str(t[1])\n break\n signstr += "?"\n for x in param:\n tmp = x\n if 'appid' in x:\n continue\n for t in tmp:\n signstr += str(t)\n signstr += "="\n signstr = signstr[:-1]\n signstr += "&"\n signstr = signstr[:-1]\n # print 'signstr',signstr\n return signstr\n\n\n[文档]def sign(signstr, secret_key):\n sign_bytes= bytes(signstr , 'utf-8')\n secret_bytes = bytes(secret_key, 'utf-8')\n hmacstr = hmac.new(secret_bytes, sign_bytes, hashlib.sha1).digest()\n s = base64.b64encode(hmacstr).decode('utf-8')\n return s\n\n\n[文档]def randstr(n):\n seed = "1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"\n sa = []\n for i in range(n):\n sa.append(random.choice(seed))\n salt = ''.join(sa)\n # print salt\n return salt\n\n\n[文档]def sendVoice(secret_key, secretid, appid, engine_model_type, res_type, result_text_format, voice_format, filepath, cutlength, template_name=""):\n if len(str(secret_key)) == 0:\n print('secretKey can not empty')\n return\n if len(str(secretid)) == 0:\n print('secretid can not empty')\n return\n if len(str(appid)) == 0:\n print('appid can not empty')\n return\n if len(str(engine_model_type)) == 0 or (\n str(engine_model_type) != '8k_0' and str(engine_model_type) != '16k_0' and str(\n engine_model_type) != '16k_en'):\n print('engine_model_type is not right')\n return\n if len(str(res_type)) == 0 or (str(res_type) != '0' and str(res_type) != '1'):\n print('res_type is not right')\n return\n if len(str(result_text_format)) == 0 or (str(result_text_format) != '0' and str(result_text_format) != '1' and str(\n result_text_format) != '2' and str(result_text_format) != '3'):\n print('result_text_format is not right')\n return\n if len(str(voice_format)) == 0 or (\n str(voice_format) != '1' and str(voice_format) != '4' and str(voice_format) != '6'):\n print('voice_format is not right')\n return\n if len(str(filepath)) == 0:\n print('filepath can not empty')\n return\n if len(str(cutlength)) == 0 or str(cutlength).isdigit() == False or cutlength > 200000:\n print('cutlength can not empty')\n return\n # secret_key = "oaYWFO70LGDmcpfwo8uF1IInayysGtgZ"\n query_arr = dict()\n query_arr['appid'] = appid\n query_arr['projectid'] = 1013976\n if len(template_name) > 0:\n query_arr['template_name'] = template_name\n query_arr['sub_service_type'] = 1\n query_arr['engine_model_type'] = engine_model_type\n query_arr['res_type'] = res_type\n query_arr['result_text_format'] = result_text_format\n query_arr['voice_id'] = randstr(16)\n query_arr['timeout'] = 100\n query_arr['source'] = 0\n query_arr['secretid'] = secretid\n query_arr['timestamp'] = str(int(time.time()))\n query_arr['expired'] = int(time.time()) + 24 * 60 * 60\n query_arr['nonce'] = query_arr['timestamp'][0:4]\n query_arr['voice_format'] = voice_format\n file_object = open(filepath, 'rb')\n file_object.seek(0, os.SEEK_END)\n datalen = file_object.tell()\n file_object.seek(0, os.SEEK_SET)\n seq = 0\n response = []\n while (datalen > 0):\n end = 0\n if (datalen < cutlength):\n end = 1\n query_arr['end'] = end\n query_arr['seq'] = seq\n query = sorted(query_arr.items(), key=lambda d: d[0])\n signstr = formatSignString(query)\n autho = sign(signstr, secret_key)\n\n if (datalen < cutlength):\n content = file_object.read(datalen)\n else:\n content = file_object.read(cutlength)\n seq = seq + 1\n datalen = datalen - cutlength\n headers = dict()\n headers['Authorization'] = autho\n headers['Content-Length'] = len(content)\n requrl = "http://"\n requrl += signstr[4::]\n req = urllib.request.Request(requrl, data=content, headers=headers) \n res_data = urllib.request.urlopen(req)\n r = res_data.read().decode('utf-8')\n res = json.loads(r)\n if res['code'] == 0:\n response.append(res['text']) \n file_object.close()\n return response[len(response)-1]\n\n\n\n# coding: utf-8\n#!/usr/bin/env python3\n\n\n'Tencent ASR && TTS API'\n__author__ = 'Charles Li, Joseph Pan'\n\nimport time\nimport uuid\nimport json\nimport random\nimport requests\nimport hmac\nimport base64\nimport urllib\n#腾讯web API一句话识别请求\n[文档]class tencentSpeech(object):\n __slots__ = 'SECRET_ID', 'SECRET_KEY', 'SourceType', 'URL', 'VoiceFormat', 'PrimaryLanguage', 'Text', 'VoiceType', 'Region'\n\n def __init__(self, SECRET_KEY, SECRET_ID):\n self.SECRET_KEY, self.SECRET_ID = SECRET_KEY, SECRET_ID\n @property\n def secret_id(self):\n return self.SECRET_ID\n @secret_id.setter\n def secret_id(self, SECRET_ID):\n if not isinstance(SECRET_ID, str):\n raise ValueError('SecretId must be a string!')\n if len(SECRET_ID)==0:\n raise ValueError('SecretId can not be empty!')\n self.SECRET_ID = SECRET_ID\n @property\n def secret_key(self):\n return self.SECRET_KEY\n @secret_key.setter\n def secret_key(self, SECRET_KEY):\n if not isinstance(SECRET_KEY, str):\n raise ValueError('SecretKey must be a string!')\n if len(SECRET_KEY)==0:\n raise ValueError('SecretKey can not be empty!')\n self.SECRET_KEY = SECRET_KEY\n @property\n def source_type(self):\n return self.sourcetype\n @source_type.setter\n def source_type(self, SourceType):\n if not isinstance(SourceType, str):\n raise ValueError('SecretType must be an string!')\n if len(SourceType)==0:\n raise ValueError('SourceType can not be empty!')\n self.SourceType = SourceType\n @property\n def url(self):\n return self.URL\n @url.setter\n def url(self, URL):\n if not isinstance(URL, str):\n raise ValueError('url must be an string!')\n if len(URL)==0:\n raise ValueError('url can not be empty!')\n self.URL = URL\n @property\n def voiceformat(self):\n return self.VoiceFormat\n @voiceformat.setter\n def voiceformat(self, VoiceFormat):\n if not isinstance(VoiceFormat, str):\n raise ValueError('voiceformat must be an string!')\n if len(VoiceFormat)==0:\n raise ValueError('voiceformat can not be empty!')\n self.VoiceFormat = VoiceFormat\n @property\n def text(self):\n return self.Text\n @text.setter\n def text(self, Text):\n if not isinstance(Text, str):\n raise ValueError('text must be an string!')\n if len(Text)==0:\n raise ValueError('text can not be empty!')\n self.Text = Text\n @property\n def region(self):\n return self.Region\n @region.setter\n def region(self, Region):\n if not isinstance(Region, str):\n raise ValueError('region must be an string!')\n if len(Region)==0:\n raise ValueError('region can not be empty!')\n self.Region = Region\n @property\n def primarylanguage(self):\n return self.PrimaryLanguage\n @primarylanguage.setter\n def primarylanguage(self, PrimaryLanguage):\n self.PrimaryLanguage = PrimaryLanguage\n @property\n def voicetype(self):\n return self.VoiceType\n @voicetype.setter\n def voicetype(self, VoiceType): \n self.VoiceType = VoiceType\n[文档] def TTS(self, text, voicetype, primarylanguage, region):\n self.text, self.voicetype, self.primarylanguage, self.region = text, voicetype, primarylanguage, region\n return self.textToSpeech()\n[文档] def textToSpeech(self):\n #生成body\n def make_body(config_dict, sign_encode):\n ##注意URL编码的时候分str编码，整段编码会丢data\n body = ''\n for a, b in config_dict:\n body += urllib.parse.quote(a) + '=' + urllib.parse.quote(str(b)) + '&'\n return body + 'Signature=' + sign_encode\n HOST = 'aai.tencentcloudapi.com'\n config_dict= {\n 'Action' : 'TextToVoice',\n 'Version' : '2018-05-22',\n 'ProjectId' : 0,\n 'Region' : self.Region,\n 'VoiceType' : self.VoiceType,\n 'Timestamp' : int(time.time()),\n 'Nonce' : random.randint(100000, 200000),\n 'SecretId' : self.SECRET_ID,\n 'Text' : self.Text,\n 'PrimaryLanguage': self.PrimaryLanguage,\n 'ModelType' : 1,\n 'SessionId' : uuid.uuid1()\n }\n #按key排序\n config_dict = sorted(config_dict.items())\n signstr = self.formatSignString(config_dict)\n sign_encode = urllib.parse.quote(self.encode_sign(signstr, self.SECRET_KEY))\n body = make_body(config_dict, sign_encode)\n #Get URL\n req_url = "https://aai.tencentcloudapi.com"\n header = {\n 'Host' : HOST,\n 'Content-Type' : 'application/x-www-form-urlencoded',\n 'Charset' : 'UTF-8'\n }\n request = requests.post(req_url, headers = header, data = body)\n #有些音频utf8解码失败，存在编码错误\n s = request.content.decode("utf8","ignore")\n return json.loads(s)\n[文档] def ASR(self, URL, voiceformat, sourcetype, region):\n self.url, self.voiceformat, self.source_type, self.region = URL, voiceformat, sourcetype, region\n return self.oneSentenceRecognition()\n[文档] def oneSentenceRecognition(self):\n #生成body\n def make_body(config_dict, sign_encode):\n ##注意URL编码的时候分str编码，整段编码会丢data\n body = ''\n for a, b in config_dict:\n body += urllib.parse.quote(a) + '=' + urllib.parse.quote(str(b)) + '&'\n return body + 'Signature=' + sign_encode\n HOST = 'aai.tencentcloudapi.com'\n config_dict= {\n 'Action' : 'SentenceRecognition',\n 'Version' : '2018-05-22',\n 'Region' : self.Region,\n 'ProjectId' : 0,\n 'SubServiceType' : 2,\n 'EngSerViceType' : '16k',\n 'VoiceFormat' : self.VoiceFormat,\n 'UsrAudioKey' : random.randint(0, 20),\n 'Timestamp' : int(time.time()),\n 'Nonce' : random.randint(100000, 200000),\n 'SecretId' : self.SECRET_ID,\n 'SourceType' : self.SourceType\n }\n if self.SourceType == '0':\n config_dict['Url'] = urllib.parse.quote(str(self.url))\n else:\n #不能大于1M\n file_path = self.URL\n file = open(file_path, 'rb')\n content = file.read()\n config_dict['DataLen'] = len(content)\n config_dict['Data'] = base64.b64encode(content).decode()\n #config_dict['Data'] = content\n file.close()\n #按key排序\n config_dict = sorted(config_dict.items())\n signstr = self.formatSignString(config_dict)\n sign_encode = urllib.parse.quote(self.encode_sign(signstr, self.SECRET_KEY))\n body = make_body(config_dict, sign_encode)\n #Get URL\n req_url = "https://aai.tencentcloudapi.com"\n header = {\n 'Host' : HOST,\n 'Content-Type' : 'application/x-www-form-urlencoded',\n 'Charset' : 'UTF-8'\n }\n request = requests.post(req_url, headers = header, data = body)\n #有些音频utf8解码失败，存在编码错误\n s = request.content.decode("utf8","ignore")\n return s\n #拼接url和参数\n[文档] def formatSignString(self, config_dict):\n signstr="POSTaai.tencentcloudapi.com/?"\n argArr = []\n for a, b in config_dict:\n argArr.append(a + "=" + str(b))\n config_str = "&".join(argArr)\n return signstr + config_str\n #生成签名\n[文档] def encode_sign(self, signstr, SECRET_KEY):\n myhmac = hmac.new(SECRET_KEY.encode(), signstr.encode(), digestmod = 'sha1')\n code = myhmac.digest()\n #hmac() 完一定要decode()和 python 2 hmac不一样\n signature = base64.b64encode(code).decode()\n return signature\n \n\nimport websocket\nimport hashlib\nimport base64\nimport hmac\nimport json\nfrom urllib.parse import urlencode\nimport time\nimport ssl\nfrom wsgiref.handlers import format_date_time\nfrom datetime import datetime\nfrom time import mktime\nimport _thread as thread\n\nfrom robot import logging\nlogger = logging.getLogger(__name__)\n\nSTATUS_FIRST_FRAME = 0 # 第一帧的标识\nSTATUS_CONTINUE_FRAME = 1 # 中间帧标识\nSTATUS_LAST_FRAME = 2 # 最后一帧的标识\n\nwsParam = None\ngResult = ''\n\n[文档]class Ws_Param(object):\n # 初始化\n def __init__(self, APPID, APIKey, APISecret, AudioFile):\n # 控制台鉴权信息\n self.APPID = APPID\n self.APIKey = APIKey\n self.APISecret = APISecret\n\n # 固定参数，可不用修改\n self.Host = "iat-api.xfyun.cn/v2/iat"\n self.HttpProto = "HTTP/1.1"\n self.HttpMethod = "GET"\n self.RequestUri = "/v2/iat"\n self.Algorithm = "hmac-sha256"\n self.url = "wss://" + self.Host + self.RequestUri\n\n # 设置测试音频文件\n self.AudioFile = AudioFile\n # 公共参数(common)\n self.CommonArgs = {"app_id": self.APPID}\n # 业务参数(business)，更多个性化参数可在官网查看\n self.BusinessArgs = {"domain": "iat", "language": "zh_cn", "accent": "mandarin"}\n\n # 生成url\n[文档] def create_url(self):\n url = 'wss://ws-api.xfyun.cn/v2/iat'\n # 生成RFC1123格式的时间戳\n now = datetime.now()\n date = format_date_time(mktime(now.timetuple()))\n\n # 拼接字符串\n signature_origin = "host: " + "ws-api.xfyun.cn" + "\\n"\n signature_origin += "date: " + date + "\\n"\n signature_origin += "GET " + "/v2/iat " + "HTTP/1.1"\n # 进行hmac-sha256进行加密\n signature_sha = hmac.new(self.APISecret.encode('utf-8'), signature_origin.encode('utf-8'),\n digestmod=hashlib.sha256).digest()\n signature_sha = base64.b64encode(signature_sha).decode(encoding='utf-8')\n\n authorization_origin = "api_key=\\"%s\\", algorithm=\\"%s\\", headers=\\"%s\\", signature=\\"%s\\"" % (\n self.APIKey, "hmac-sha256", "host date request-line", signature_sha)\n authorization = base64.b64encode(authorization_origin.encode('utf-8')).decode(encoding='utf-8')\n # 将请求的鉴权参数组合为字典\n v = {\n "authorization": authorization,\n "date": date,\n "host": "ws-api.xfyun.cn"\n }\n # 拼接鉴权参数，生成url\n url = url + '?' + urlencode(v)\n # 此处打印出建立连接时候的url,参考本demo的时候可取消上方打印的注释，比对相同参数时生成的url与自己代码生成的url是否一致\n logger.debug('websocket url :', url)\n return url\n\n\n# 收到websocket消息的处理\n[文档]def on_message(ws, message):\n global gResult\n try:\n code = json.loads(message)["code"]\n sid = json.loads(message)["sid"]\n if code != 0:\n errMsg = json.loads(message)["message"]\n logger.critical("xunfei-asr 识别出错了：sid:%s call error:%s code is:%s" % (sid, errMsg, code))\n else:\n data = json.loads(message)["data"]["result"]["ws"]\n result = ""\n for i in data:\n for w in i["cw"]:\n result += w["w"]\n gResult = gResult + result\n logger.info("sid:%s call success!,data is:%s" % (sid, json.dumps(data, ensure_ascii=False)))\n except Exception as e:\n logger.critical("xunfei-asr 识别出错了：", e)\n\n\n# 收到websocket错误的处理\n\n\n\n# 收到websocket关闭的处理\n\n\n\n# 收到websocket连接建立的处理\n[文档]def on_open(ws):\n global wsParam\n def run(*args):\n frameSize = 1220 # 每一帧的音频大小\n intervel = 0.04 # 发送音频间隔(单位:s)\n status = STATUS_FIRST_FRAME # 音频的状态信息，标识音频是第一帧，还是中间帧、最后一帧\n with open(wsParam.AudioFile, "rb") as fp:\n while True:\n buf = fp.read(frameSize)\n # 文件结束\n if not buf:\n status = STATUS_LAST_FRAME\n # 第一帧处理\n # 发送第一帧音频，带business 参数\n # appid 必须带上，只需第一帧发送\n if status == STATUS_FIRST_FRAME:\n\n d = {"common": wsParam.CommonArgs,\n "business": wsParam.BusinessArgs,\n "data": {"status": 0, "format": "audio/L16;rate=16000",\n "audio": str(base64.b64encode(buf), 'utf-8'),\n "encoding": "raw"}}\n d = json.dumps(d)\n ws.send(d)\n status = STATUS_CONTINUE_FRAME\n # 中间帧处理\n elif status == STATUS_CONTINUE_FRAME:\n d = {"data": {"status": 1, "format": "audio/L16;rate=16000",\n "audio": str(base64.b64encode(buf), 'utf-8'),\n "encoding": "raw"}}\n ws.send(json.dumps(d))\n # 最后一帧处理\n elif status == STATUS_LAST_FRAME:\n d = {"data": {"status": 2, "format": "audio/L16;rate=16000",\n "audio": str(base64.b64encode(buf), 'utf-8'),\n "encoding": "raw"}}\n ws.send(json.dumps(d))\n time.sleep(1)\n break\n # 模拟音频采样间隔\n time.sleep(intervel)\n ws.close()\n\n thread.start_new_thread(run, ())\n\n\n[文档]def transcribe(fpath, appid, api_key, api_secret):\n """\n 科大讯飞ASR\n """\n global wsParam, gResult\n gResult = ''\n wsParam = Ws_Param(appid, api_key, APISecret=api_secret, AudioFile=fpath)\n websocket.enableTrace(False)\n wsUrl = wsParam.create_url()\n ws = websocket.WebSocketApp(wsUrl, on_message=on_message, on_error=on_error, on_close=on_close)\n ws.on_open = on_open\n ws.run_forever(sslopt={"cert_reqs": ssl.CERT_NONE})\n return gResult\n\n# encoding:utf-8\nimport requests\nimport datetime\nimport uuid\nimport json\nimport os\nfrom dateutil import parser as dparser\nfrom robot import constants, logging\n\nlogger = logging.getLogger(__name__)\n\n[文档]def get_token(api_key, secret_key):\n cache = open(os.path.join(constants.TEMP_PATH, 'baidustt.ini'), 'a+')\n try:\n pms = cache.readlines()\n if len(pms) > 0:\n time = pms[0]\n tk = pms[1]\n # 计算token是否过期 官方说明一个月，这里保守29天\n time = dparser.parse(time)\n endtime = datetime.datetime.now()\n if (endtime - time).days <= 29:\n return tk\n finally:\n cache.close()\n URL = 'http://openapi.baidu.com/oauth/2.0/token'\n params = {'grant_type': 'client_credentials',\n 'client_id': api_key,\n 'client_secret': secret_key}\n r = requests.get(URL, params=params)\n try:\n r.raise_for_status()\n token = r.json()['access_token']\n return token\n except requests.exceptions.HTTPError:\n return ''\n\n[文档]def getUnit(query, service_id, api_key, secret_key):\n """ \n NLU 解析\n\n :param query: 用户的指令字符串\n :param service_id: UNIT 的 service_id\n :param api_key: UNIT apk_key\n :param secret_key: UNIT secret_key\n :returns: UNIT 解析结果。如果解析失败，返回 None\n """\n access_token = get_token(api_key, secret_key)\n url = 'https://aip.baidubce.com/rpc/2.0/unit/service/chat?access_token=' + access_token\n request={\n "query":query,\n "user_id":"888888",\n }\n body={\n "log_id": str(uuid.uuid1()),\n "version":"2.0",\n "service_id": service_id,\n "session_id": str(uuid.uuid1()),\n "request":request\n }\n try:\n headers = {'Content-Type': 'application/json'}\n request = requests.post(url, json=body, headers=headers)\n return json.loads(request.text)\n except Exception:\n return None\n\n\n[文档]def getIntent(parsed):\n """ \n 提取意图\n\n :param parsed: UNIT 解析结果\n :returns: 意图数组\n """\n if parsed is not None and 'result' in parsed and \\\n 'response_list' in parsed['result']:\n return parsed['result']['response_list'][0]['schema']['intent']\n else:\n return ''\n\n\n[文档]def hasIntent(parsed, intent):\n """ \n 判断是否包含某个意图\n\n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: True: 包含; False: 不包含\n """\n if parsed is not None and 'result' in parsed and \\\n 'response_list' in parsed['result']:\n response_list = parsed['result']['response_list']\n for response in response_list:\n if response['schema']['intent'] == intent:\n return True\n return False\n else:\n return False\n\n\n[文档]def getSlots(parsed, intent=''):\n """ \n 提取某个意图的所有词槽\n \n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: 词槽列表。你可以通过 name 属性筛选词槽，\n再通过 normalized_word 属性取出相应的值\n """\n if parsed is not None and 'result' in parsed and \\\n 'response_list' in parsed['result']:\n response_list = parsed['result']['response_list']\n if intent == '':\n return parsed['result']['response_list'][0]['schema']['slots']\n for response in response_list:\n if response['schema']['intent'] == intent:\n return response['schema']['slots']\n else:\n return []\n\n[文档]def getSlotWords(parsed, intent, name):\n """ \n 找出命中某个词槽的内容\n \n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :param name: 词槽名\n :returns: 命中该词槽的值的列表。\n """\n slots = getSlots(parsed, intent)\n words = []\n for slot in slots:\n if slot['name'] == name:\n words.append(slot['normalized_word'])\n return words\n\n[文档]def getSay(parsed, intent=''):\n """\n 提取 UNIT 的回复文本\n\n :param parsed: UNIT 解析结果\n :param intent: 意图的名称\n :returns: UNIT 的回复文本\n """\n if parsed is not None and 'result' in parsed and \\\n 'response_list' in parsed['result']:\n response_list = parsed['result']['response_list']\n if intent == '':\n return response_list[0]['action_list'][0]['say']\n for response in response_list:\n if response['schema']['intent'] == intent:\n return response['action_list'][0]['say']\n return ''\n else:\n return ''\n\n\nif __name__ == '__main__':\n parsed = getUnit('今天的天气', "S13442", 'w5v7gUV3iPGsGntcM84PtOOM', 'KffXwW6E1alcGplcabcNs63Li6GvvnfL')\n print(parsed)\n\n# -*- coding: utf-8-*-\n\nfrom . import config\nimport uuid\nimport requests\nimport threading\n\n[文档]def getUUID():\n mac = uuid.UUID(int=uuid.getnode()).hex[-12:]\n return ":".join([mac[e:e+2] for e in range(0, 11, 2)])\n\n\n\n[文档]class ReportThread (threading.Thread):\n\n def __init__(self, t):\n # 需要执行父类的初始化方法\n threading.Thread.__init__(self)\n self.t = t\n\n[文档] def run(self):\n to_report = config.get('statistic', True)\n if to_report:\n try:\n persona = config.get("robot_name_cn", '孙悟空')\n url = 'http://livecv.hahack.com:8022/statistic'\n payload = {'type': str(self.t), 'uuid': getUUID(), 'name': persona, 'project': 'wukong'}\n requests.post(url, data=payload, timeout=3)\n except Exception:\n return\n\n \n\n# -*- coding: utf-8-*-\n\nimport os\nimport tempfile\nimport wave\nimport shutil\nimport re\nimport time\nimport hashlib\nimport subprocess\nfrom . import constants, config\nfrom robot import logging\nfrom pydub import AudioSegment\nfrom pytz import timezone\nimport _thread as thread\n\nimport smtplib\nfrom email.mime.text import MIMEText\nfrom email.mime.multipart import MIMEMultipart\n\nlogger = logging.getLogger(__name__)\n\ndo_not_bother = False\n\n[文档]def sendEmail(SUBJECT, BODY, ATTACH_LIST, TO, FROM, SENDER,\n PASSWORD, SMTP_SERVER, SMTP_PORT):\n """\n 发送邮件\n\n :param SUBJECT: 邮件标题\n :param BODY: 邮件正文\n :param ATTACH_LIST: 附件\n :param TO: 收件人\n :param FROM: 发件人\n :param SENDER: 发件人信息\n :param PASSWORD: 密码\n :param SMTP_SERVER: smtp 服务器\n :param SMTP_PORT: smtp 端口号\n :returns: True: 发送成功; False: 发送失败\n """\n txt = MIMEText(BODY.encode('utf-8'), 'html', 'utf-8')\n msg = MIMEMultipart()\n msg.attach(txt) \n\n for attach in ATTACH_LIST:\n try:\n att = MIMEText(open(attach, 'rb').read(), 'base64', 'utf-8')\n filename = os.path.basename(attach)\n att["Content-Type"] = 'application/octet-stream'\n att["Content-Disposition"] = 'attachment; filename="%s"' % filename\n msg.attach(att)\n except Exception:\n logger.error(u'附件 %s 发送失败！' % attach)\n continue\n\n msg['From'] = SENDER\n msg['To'] = TO\n msg['Subject'] = SUBJECT\n\n try:\n session = smtplib.SMTP()\n session.connect(SMTP_SERVER, SMTP_PORT)\n session.starttls()\n session.login(FROM, PASSWORD)\n session.sendmail(SENDER, TO, msg.as_string())\n session.close()\n return True\n except Exception as e:\n logger.error(e)\n return False\n\n\n[文档]def emailUser(SUBJECT="", BODY="", ATTACH_LIST=[]):\n """\n 给用户发送邮件\n\n :param SUBJECT: subject line of the email\n :param BODY: body text of the email\n :returns: True: 发送成功; False: 发送失败\n """\n # add footer\n if BODY:\n BODY = u"%s，<br><br>这是您要的内容：<br>%s<br>" % (config['first_name'], BODY)\n\n recipient = config.get('/email/address', '')\n robot_name = config.get('robot_name_cn', 'wukong-robot')\n recipient = robot_name + " <%s>" % recipient\n user = config.get('/email/address', '')\n password = config.get('/email/password', '')\n server = config.get('/email/smtp_server', '')\n port = config.get('/email/smtp_port', '')\n\n if not recipient or not user or not password or not server or not port:\n return False\n try:\n sendEmail(SUBJECT, BODY, ATTACH_LIST, user, user,\n recipient, password, server, port)\n return True\n except Exception as e:\n logger.error(e)\n return False\n\n\n[文档]def get_file_content(filePath):\n """\n 读取文件内容并返回\n\n :param filePath: 文件路径\n :returns: 文件内容\n :raises IOError: 读取失败则抛出 IOError\n """\n with open(filePath, 'rb') as fp:\n return fp.read()\n\n[文档]def check_and_delete(fp, wait=0):\n """ \n 检查并删除文件/文件夹\n\n :param fp: 文件路径\n """\n def run():\n if wait > 0:\n time.sleep(wait)\n if isinstance(fp, str) and os.path.exists(fp):\n if os.path.isfile(fp):\n os.remove(fp)\n else:\n shutil.rmtree(fp)\n \n thread.start_new_thread(run, ())\n\n\n[文档]def write_temp_file(data, suffix, mode='w+b'):\n """ \n 写入临时文件\n\n :param data: 数据\n :param suffix: 后缀名\n :param mode: 写入模式，默认为 w+b\n :returns: 文件保存后的路径\n """\n with tempfile.NamedTemporaryFile(mode=mode, suffix=suffix, delete=False) as f:\n f.write(data)\n tmpfile = f.name\n return tmpfile\n\n[文档]def get_pcm_from_wav(wav_path):\n """ \n 从 wav 文件中读取 pcm\n \n :param wav_path: wav 文件路径\n :returns: pcm 数据\n """\n wav = wave.open(wav_path, 'rb')\n return wav.readframes(wav.getnframes())\n\n[文档]def convert_wav_to_mp3(wav_path):\n """ \n 将 wav 文件转成 mp3\n\n :param wav_path: wav 文件路径\n :returns: mp3 文件路径\n """\n if not os.path.exists(wav_path):\n logger.critical("文件错误 {}".format(wav_path))\n return None\n mp3_path = wav_path.replace('.wav', '.mp3')\n AudioSegment.from_wav(wav_path).export(mp3_path, format="mp3")\n return mp3_path\n\n[文档]def convert_mp3_to_wav(mp3_path):\n """ \n 将 mp3 文件转成 wav\n\n :param mp3_path: mp3 文件路径\n :returns: wav 文件路径\n """\n target = mp3_path.replace(".mp3", ".wav")\n if not os.path.exists(mp3_path):\n logger.critical("文件错误 {}".format(mp3_path))\n return None\n AudioSegment.from_mp3(mp3_path).export(target, format="wav")\n return target \n\n[文档]def clean():\n """ 清理垃圾数据 """\n temp = constants.TEMP_PATH\n temp_files = os.listdir(temp)\n for f in temp_files:\n if os.path.isfile(os.path.join(temp, f)) and re.match(r'output[\\d]*\\.wav', os.path.basename(f)):\n os.remove(os.path.join(temp, f))\n\n[文档]def is_proper_time():\n """ 是否合适时间 """\n if do_not_bother == True:\n return False\n if not config.has('do_not_bother'):\n return True\n bother_profile = config.get('do_not_bother')\n if not bother_profile['enable']:\n return True\n if 'since' not in bother_profile or 'till' not in bother_profile:\n return True\n since = bother_profile['since']\n till = bother_profile['till']\n current = time.localtime(time.time()).tm_hour\n if till > since:\n return current not in range(since, till)\n else:\n return not (current in range(since, 25) or\n current in range(-1, till))\n\n[文档]def get_do_not_bother_on_hotword():\n """ 打开勿扰模式唤醒词 """\n return config.get('/do_not_bother/on_hotword', '悟空别吵.pmdl')\n\n[文档]def get_do_not_bother_off_hotword():\n """ 关闭勿扰模式唤醒词 """\n return config.get('/do_not_bother/off_hotword', '悟空醒醒.pmdl')\n\n\n\n[文档]def getCache(msg):\n """ 获取缓存的语音 """\n md5 = hashlib.md5(msg.encode('utf-8')).hexdigest()\n mp3_cache = os.path.join(constants.TEMP_PATH, md5 + '.mp3')\n wav_cache = os.path.join(constants.TEMP_PATH, md5 + '.wav')\n if os.path.exists(mp3_cache):\n return mp3_cache\n elif os.path.exists(wav_cache):\n return wav_cache\n return None\n\n[文档]def saveCache(voice, msg):\n """ 获取缓存的语音 """\n foo, ext = os.path.splitext(voice)\n md5 = hashlib.md5(msg.encode('utf-8')).hexdigest()\n target = os.path.join(constants.TEMP_PATH, md5+ext)\n shutil.copyfile(voice, target)\n return target\n \n\n[文档]def lruCache():\n """ 清理最近未使用的缓存 """\n def run(*args):\n if config.get('/lru_cache/enable', True): \n days = config.get('/lru_cache/days', 7)\n subprocess.run('find . -name "*.mp3" -atime +%d -exec rm {} \\;' % days, cwd=constants.TEMP_PATH, shell=True)\n\n thread.start_new_thread(run, ())\n\n\n#!/usr/bin/env python\n\nimport collections\nimport pyaudio\nfrom . import snowboydetect\nfrom robot import utils, logging\nimport time\nimport wave\nimport os\nfrom ctypes import CFUNCTYPE, c_char_p, c_int, cdll\nfrom contextlib import contextmanager\nfrom robot import constants\n\n\nlogger = logging.getLogger("snowboy")\nTOP_DIR = os.path.dirname(os.path.abspath(__file__))\n\nRESOURCE_FILE = os.path.join(TOP_DIR, "resources/common.res")\nDETECT_DING = os.path.join(TOP_DIR, "resources/ding.wav")\nDETECT_DONG = os.path.join(TOP_DIR, "resources/dong.wav")\n\n\n\nERROR_HANDLER_FUNC = CFUNCTYPE(None, c_char_p, c_int, c_char_p, c_int, c_char_p)\n\nc_error_handler = ERROR_HANDLER_FUNC(py_error_handler)\n\n[文档]@contextmanager\ndef no_alsa_error():\n try:\n asound = cdll.LoadLibrary('libasound.so')\n asound.snd_lib_error_set_handler(c_error_handler)\n yield\n asound.snd_lib_error_set_handler(None)\n except:\n yield\n pass\n\n[文档]class RingBuffer(object):\n """Ring buffer to hold audio from PortAudio"""\n\n def __init__(self, size=4096):\n self._buf = collections.deque(maxlen=size)\n\n\n\n[文档] def get(self):\n """Retrieves data from the beginning of buffer and clears it"""\n tmp = bytes(bytearray(self._buf))\n self._buf.clear()\n return tmp\n\n\n[文档]def play_audio_file(fname=DETECT_DING):\n """Simple callback function to play a wave file. By default it plays\n a Ding sound.\n\n :param str fname: wave file name\n :return: None\n """\n ding_wav = wave.open(fname, 'rb')\n ding_data = ding_wav.readframes(ding_wav.getnframes())\n with no_alsa_error():\n audio = pyaudio.PyAudio()\n stream_out = audio.open(\n format=audio.get_format_from_width(ding_wav.getsampwidth()),\n channels=ding_wav.getnchannels(),\n rate=ding_wav.getframerate(), input=False, output=True)\n stream_out.start_stream()\n stream_out.write(ding_data)\n time.sleep(0.2)\n stream_out.stop_stream()\n stream_out.close()\n audio.terminate()\n\n\n[文档]class ActiveListener(object):\n """ Active Listening with VAD """\n def __init__(self, decoder_model,\n resource=RESOURCE_FILE):\n logger.debug("activeListen __init__()")\n self.recordedData = []\n model_str = ",".join(decoder_model)\n self.detector = snowboydetect.SnowboyDetect(\n resource_filename=resource.encode(), model_str=model_str.encode())\n self.ring_buffer = RingBuffer(\n self.detector.NumChannels() * self.detector.SampleRate() * 5)\n\n[文档] def listen(self, interrupt_check=lambda: False, sleep_time=0.03, silent_count_threshold=15, recording_timeout=100):\n """\n :param interrupt_check: a function that returns True if the main loop\n needs to stop.\n :param silent_count_threshold: indicates how long silence must be heard\n to mark the end of a phrase that is\n being recorded.\n :param float sleep_time: how much time in second every loop waits.\n :param recording_timeout: limits the maximum length of a recording.\n :return: recorded file path\n """\n logger.debug("activeListen listen()")\n\n self._running = True\n\n def audio_callback(in_data, frame_count, time_info, status):\n self.ring_buffer.extend(in_data)\n play_data = chr(0) * len(in_data)\n return play_data, pyaudio.paContinue\n\n with no_alsa_error(): \n self.audio = pyaudio.PyAudio()\n \n logger.debug('opening audio stream')\n\n try:\n self.stream_in = self.audio.open(\n input=True, output=False,\n format=self.audio.get_format_from_width(\n self.detector.BitsPerSample() / 8),\n channels=self.detector.NumChannels(),\n rate=self.detector.SampleRate(),\n frames_per_buffer=2048,\n stream_callback=audio_callback)\n except Exception as e:\n logger.critical(e)\n return \n\n logger.debug('audio stream opened')\n\n if interrupt_check():\n logger.debug("detect voice return")\n return\n\n silentCount = 0\n recordingCount = 0\n\n logger.debug("begin activeListen loop")\n \n while self._running is True:\n\n if interrupt_check():\n logger.debug("detect voice break")\n break\n data = self.ring_buffer.get()\n if len(data) == 0:\n time.sleep(sleep_time)\n continue\n \n status = self.detector.RunDetection(data)\n if status == -1:\n logger.warning("Error initializing streams or reading audio data")\n \n stopRecording = False\n if recordingCount > recording_timeout:\n stopRecording = True\n elif status == -2: #silence found\n if silentCount > silent_count_threshold:\n stopRecording = True\n else:\n silentCount = silentCount + 1\n elif status == 0: #voice found\n silentCount = 0\n\n if stopRecording == True:\n return self.saveMessage()\n\n recordingCount = recordingCount + 1\n self.recordedData.append(data)\n\n logger.debug("finished.")\n\n\n[文档] def saveMessage(self):\n """\n Save the message stored in self.recordedData to a timestamped file.\n """\n filename = os.path.join(constants.TEMP_PATH, 'output' + str(int(time.time())) + '.wav')\n data = b''.join(self.recordedData)\n\n #use wave to save data\n wf = wave.open(filename, 'wb')\n wf.setnchannels(self.detector.NumChannels())\n wf.setsampwidth(self.audio.get_sample_size(\n self.audio.get_format_from_width(self.detector.BitsPerSample() / 8)))\n wf.setframerate(self.detector.SampleRate())\n wf.writeframes(data)\n wf.close()\n logger.debug("finished saving: " + filename)\n\n self.stream_in.stop_stream()\n self.stream_in.close()\n self.audio.terminate()\n \n return filename\n \n \n\n\n[文档]class HotwordDetector(object):\n """\n Snowboy decoder to detect whether a keyword specified by `decoder_model`\n exists in a microphone input stream.\n\n :param decoder_model: decoder model file path, a string or a list of strings\n :param resource: resource file path.\n :param sensitivity: decoder sensitivity, a float of a list of floats.\n The bigger the value, the more senstive the\n decoder. If an empty list is provided, then the\n default sensitivity in the model will be used.\n :param audio_gain: multiply input volume by this factor.\n :param apply_frontend: applies the frontend processing algorithm if True.\n """\n\n def __init__(self, decoder_model,\n resource=RESOURCE_FILE,\n sensitivity=[],\n audio_gain=1,\n apply_frontend=False):\n\n self._running = False\n\n tm = type(decoder_model)\n ts = type(sensitivity)\n if tm is not list:\n decoder_model = [decoder_model]\n if ts is not list:\n sensitivity = [sensitivity]\n model_str = ",".join(decoder_model)\n\n self.detector = snowboydetect.SnowboyDetect(\n resource_filename=resource.encode(), model_str=model_str.encode())\n self.detector.SetAudioGain(audio_gain)\n self.detector.ApplyFrontend(apply_frontend)\n self.num_hotwords = self.detector.NumHotwords()\n\n if len(decoder_model) > 1 and len(sensitivity) == 1:\n sensitivity = sensitivity * self.num_hotwords\n if len(sensitivity) != 0:\n assert self.num_hotwords == len(sensitivity), \\\n "number of hotwords in decoder_model (%d) and sensitivity " \\\n "(%d) does not match" % (self.num_hotwords, len(sensitivity))\n sensitivity_str = ",".join([str(t) for t in sensitivity])\n if len(sensitivity) != 0:\n self.detector.SetSensitivity(sensitivity_str.encode()) \n\n self.ring_buffer = RingBuffer(\n self.detector.NumChannels() * self.detector.SampleRate() * 5)\n\n[文档] def start(self, detected_callback=play_audio_file,\n interrupt_check=lambda: False,\n sleep_time=0.03,\n audio_recorder_callback=None,\n silent_count_threshold=15,\n recording_timeout=100):\n """\n Start the voice detector. For every `sleep_time` second it checks the\n audio buffer for triggering keywords. If detected, then call\n corresponding function in `detected_callback`, which can be a single\n function (single model) or a list of callback functions (multiple\n models). Every loop it also calls `interrupt_check` -- if it returns\n True, then breaks from the loop and return.\n\n :param detected_callback: a function or list of functions. The number of\n items must match the number of models in\n `decoder_model`.\n :param interrupt_check: a function that returns True if the main loop\n needs to stop.\n :param float sleep_time: how much time in second every loop waits.\n :param audio_recorder_callback: if specified, this will be called after\n a keyword has been spoken and after the\n phrase immediately after the keyword has\n been recorded. The function will be\n passed the name of the file where the\n phrase was recorded.\n :param silent_count_threshold: indicates how long silence must be heard\n to mark the end of a phrase that is\n being recorded.\n :param recording_timeout: limits the maximum length of a recording.\n :return: None\n """\n self._running = True\n\n def audio_callback(in_data, frame_count, time_info, status):\n self.ring_buffer.extend(in_data)\n play_data = chr(0) * len(in_data)\n return play_data, pyaudio.paContinue\n\n with no_alsa_error():\n self.audio = pyaudio.PyAudio()\n self.stream_in = self.audio.open(\n input=True, output=False,\n format=self.audio.get_format_from_width(\n self.detector.BitsPerSample() / 8),\n channels=self.detector.NumChannels(),\n rate=self.detector.SampleRate(),\n frames_per_buffer=2048,\n stream_callback=audio_callback)\n\n if interrupt_check():\n logger.debug("detect voice return")\n return\n\n tc = type(detected_callback)\n if tc is not list:\n detected_callback = [detected_callback]\n if len(detected_callback) == 1 and self.num_hotwords > 1:\n detected_callback *= self.num_hotwords\n\n assert self.num_hotwords == len(detected_callback), \\\n "Error: hotwords in your models (%d) do not match the number of " \\\n "callbacks (%d)" % (self.num_hotwords, len(detected_callback))\n\n logger.debug("detecting...")\n\n state = "PASSIVE"\n while self._running is True: \n if interrupt_check():\n logger.debug("detect voice break")\n break\n data = self.ring_buffer.get()\n if len(data) == 0:\n time.sleep(sleep_time)\n continue\n\n status = self.detector.RunDetection(data)\n if status == -1:\n logger.warning("Error initializing streams or reading audio data")\n\n #small state machine to handle recording of phrase after keyword\n if state == "PASSIVE":\n if status > 0: #key word found\n\n self.recordedData = []\n self.recordedData.append(data)\n silentCount = 0\n recordingCount = 0\n message = "Keyword " + str(status) + " detected at time: "\n message += time.strftime("%Y-%m-%d %H:%M:%S",\n time.localtime(time.time()))\n logger.info(message)\n callback = detected_callback[status-1] \n if callback is not None:\n callback()\n\n if audio_recorder_callback is not None and status == 1 and utils.is_proper_time():\n state = "ACTIVE"\n continue\n\n elif state == "ACTIVE":\n stopRecording = False\n if recordingCount > recording_timeout:\n stopRecording = True\n elif status == -2: #silence found\n if silentCount > silent_count_threshold:\n stopRecording = True\n else:\n silentCount = silentCount + 1\n elif status == 0: #voice found\n silentCount = 0\n\n if stopRecording == True:\n fname = self.saveMessage()\n audio_recorder_callback(fname)\n state = "PASSIVE" \n continue\n\n recordingCount = recordingCount + 1\n self.recordedData.append(data) \n\n logger.debug("finished.")\n\n\n[文档] def saveMessage(self):\n """\n Save the message stored in self.recordedData to a timestamped file.\n """\n filename = os.path.join(constants.TEMP_PATH, 'output' + str(int(time.time())) + '.wav')\n data = b''.join(self.recordedData)\n\n #use wave to save data\n wf = wave.open(filename, 'wb')\n wf.setnchannels(self.detector.NumChannels())\n wf.setsampwidth(self.audio.get_sample_size(\n self.audio.get_format_from_width(\n self.detector.BitsPerSample() / 8)))\n wf.setframerate(self.detector.SampleRate())\n wf.writeframes(data)\n wf.close()\n logger.debug("finished saving: " + filename)\n return filename\n\n[文档] def terminate(self):\n """\n Terminate audio stream. Users can call start() again to detect.\n :return: None\n """\n if self._running:\n self.stream_in.stop_stream()\n self.stream_in.close()\n self.audio.terminate()\n self._running = False\n\n# This file was automatically generated by SWIG (http://www.swig.org).\n# Version 3.0.12\n#\n# Do not make changes to this file unless you know what you are doing--modify\n# the SWIG interface file instead.\n\nfrom sys import version_info as _swig_python_version_info\nif _swig_python_version_info >= (2, 7, 0):\n def swig_import_helper():\n import importlib\n pkg = __name__.rpartition('.')[0]\n mname = '.'.join((pkg, '_snowboydetect')).lstrip('.')\n try:\n return importlib.import_module(mname)\n except ImportError:\n return importlib.import_module('_snowboydetect')\n _snowboydetect = swig_import_helper()\n del swig_import_helper\nelif _swig_python_version_info >= (2, 6, 0):\n def swig_import_helper():\n from os.path import dirname\n import imp\n fp = None\n try:\n fp, pathname, description = imp.find_module('_snowboydetect', [dirname(__file__)])\n except ImportError:\n import _snowboydetect\n return _snowboydetect\n try:\n _mod = imp.load_module('_snowboydetect', fp, pathname, description)\n finally:\n if fp is not None:\n fp.close()\n return _mod\n _snowboydetect = swig_import_helper()\n del swig_import_helper\nelse:\n import _snowboydetect\ndel _swig_python_version_info\n\ntry:\n _swig_property = property\nexcept NameError:\n pass # Python < 2.2 doesn't have 'property'.\n\ntry:\n import builtins as __builtin__\nexcept ImportError:\n import __builtin__\n\ndef _swig_setattr_nondynamic(self, class_type, name, value, static=1):\n if (name == "thisown"):\n return self.this.own(value)\n if (name == "this"):\n if type(value).__name__ == 'SwigPyObject':\n self.__dict__[name] = value\n return\n method = class_type.__swig_setmethods__.get(name, None)\n if method:\n return method(self, value)\n if (not static):\n if _newclass:\n object.__setattr__(self, name, value)\n else:\n self.__dict__[name] = value\n else:\n raise AttributeError("You cannot add attributes to %s" % self)\n\n\ndef _swig_setattr(self, class_type, name, value):\n return _swig_setattr_nondynamic(self, class_type, name, value, 0)\n\n\ndef _swig_getattr(self, class_type, name):\n if (name == "thisown"):\n return self.this.own()\n method = class_type.__swig_getmethods__.get(name, None)\n if method:\n return method(self)\n raise AttributeError("'%s' object has no attribute '%s'" % (class_type.__name__, name))\n\n\ndef _swig_repr(self):\n try:\n strthis = "proxy of " + self.this.__repr__()\n except __builtin__.Exception:\n strthis = ""\n return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)\n\ntry:\n _object = object\n _newclass = 1\nexcept __builtin__.Exception:\n class _object:\n pass\n _newclass = 0\n\n[文档]class SnowboyDetect(_object):\n __swig_setmethods__ = {}\n __setattr__ = lambda self, name, value: _swig_setattr(self, SnowboyDetect, name, value)\n __swig_getmethods__ = {}\n __getattr__ = lambda self, name: _swig_getattr(self, SnowboyDetect, name)\n __repr__ = _swig_repr\n\n def __init__(self, resource_filename, model_str):\n this = _snowboydetect.new_SnowboyDetect(resource_filename, model_str)\n try:\n self.this.append(this)\n except __builtin__.Exception:\n self.this = this\n\n\n\n\n\n[文档] def SetSensitivity(self, sensitivity_str):\n return _snowboydetect.SnowboyDetect_SetSensitivity(self, sensitivity_str)\n\n[文档] def SetHighSensitivity(self, high_sensitivity_str):\n return _snowboydetect.SnowboyDetect_SetHighSensitivity(self, high_sensitivity_str)\n\n\n\n[文档] def SetAudioGain(self, audio_gain):\n return _snowboydetect.SnowboyDetect_SetAudioGain(self, audio_gain)\n\n\n\n\n\n[文档] def ApplyFrontend(self, apply_frontend):\n return _snowboydetect.SnowboyDetect_ApplyFrontend(self, apply_frontend)\n\n\n\n\n\n\n __swig_destroy__ = _snowboydetect.delete_SnowboyDetect\n __del__ = lambda self: None\nSnowboyDetect_swigregister = _snowboydetect.SnowboyDetect_swigregister\nSnowboyDetect_swigregister(SnowboyDetect)\n\n[文档]class SnowboyVad(_object):\n __swig_setmethods__ = {}\n __setattr__ = lambda self, name, value: _swig_setattr(self, SnowboyVad, name, value)\n __swig_getmethods__ = {}\n __getattr__ = lambda self, name: _swig_getattr(self, SnowboyVad, name)\n __repr__ = _swig_repr\n\n def __init__(self, resource_filename):\n this = _snowboydetect.new_SnowboyVad(resource_filename)\n try:\n self.this.append(this)\n except __builtin__.Exception:\n self.this = this\n\n\n\n\n\n[文档] def SetAudioGain(self, audio_gain):\n return _snowboydetect.SnowboyVad_SetAudioGain(self, audio_gain)\n\n[文档] def ApplyFrontend(self, apply_frontend):\n return _snowboydetect.SnowboyVad_ApplyFrontend(self, apply_frontend)\n\n\n\n\n\n\n __swig_destroy__ = _snowboydetect.delete_SnowboyVad\n __del__ = lambda self: None\nSnowboyVad_swigregister = _snowboydetect.SnowboyVad_swigregister\nSnowboyVad_swigregister(SnowboyVad)\n\n# This file is compatible with both classic and new-style classes.\n\n\n\n# -*- coding: utf-8-*-\nfrom snowboy import snowboydecoder\nfrom robot import config, utils, constants, logging, statistic, Player\nfrom robot.Updater import Updater\nfrom robot.ConfigMonitor import ConfigMonitor\nfrom robot.Conversation import Conversation\nfrom server import server\nfrom watchdog.observers import Observer\nimport sys\nimport os\nimport signal\nimport hashlib\nimport fire\nimport urllib3\nurllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)\n\nlogger = logging.getLogger(__name__)\n\n[文档]class Wukong(object):\n\n _profiling = False\n _dev = False\n \n[文档] def init(self):\n global conversation\n self.detector = None\n self._interrupted = False \n print('''\n********************************************************\n* wukong-robot - 中文语音对话机器人 *\n* (c) 2019 潘伟洲 <m@hahack.com> *\n* https://github.com/wzpan/wukong-robot.git *\n********************************************************\n\n 如需退出，可以按 Ctrl-4 组合键。\n\n''')\n \n config.init()\n self._conversation = Conversation(self._profiling)\n self._conversation.say('{} 你好！试试对我喊唤醒词叫醒我吧'.format(config.get('first_name', '主人')), True)\n self._observer = Observer()\n event_handler = ConfigMonitor(self._conversation)\n self._observer.schedule(event_handler, constants.CONFIG_PATH, False)\n self._observer.schedule(event_handler, constants.DATA_PATH, False)\n self._observer.start()\n\n def _signal_handler(self, signal, frame):\n self._interrupted = True\n utils.clean()\n self._observer.stop()\n\n def _detected_callback(self):\n if not utils.is_proper_time():\n logger.warning('勿扰模式开启中')\n return\n if self._conversation.isRecording:\n logger.warning('正在录音中，跳过')\n return\n Player.play(constants.getData('beep_hi.wav'))\n logger.info('开始录音')\n self._conversation.interrupt()\n self._conversation.isRecording = True;\n\n def _do_not_bother_on_callback(self):\n if config.get('/do_not_bother/hotword_switch', False):\n utils.do_not_bother = True\n Player.play(constants.getData('off.wav'))\n logger.info('勿扰模式打开')\n\n def _do_not_bother_off_callback(self):\n if config.get('/do_not_bother/hotword_switch', False):\n utils.do_not_bother = False\n Player.play(constants.getData('on.wav'))\n logger.info('勿扰模式关闭')\n\n def _interrupt_callback(self):\n return self._interrupted\n\n[文档] def run(self):\n self.init()\n\n # capture SIGINT signal, e.g., Ctrl+C\n signal.signal(signal.SIGINT, self._signal_handler)\n\n # site\n server.run(self._conversation, self)\n\n statistic.report(0)\n\n try:\n self.initDetector()\n except AttributeError:\n logger.error('初始化离线唤醒功能失败')\n pass\n\n[文档] def initDetector(self):\n if self.detector is not None:\n self.detector.terminate()\n if config.get('/do_not_bother/hotword_switch', False):\n models = [\n constants.getHotwordModel(config.get('hotword', 'wukong.pmdl')),\n constants.getHotwordModel(utils.get_do_not_bother_on_hotword()),\n constants.getHotwordModel(utils.get_do_not_bother_off_hotword())\n ]\n else:\n models = constants.getHotwordModel(config.get('hotword', 'wukong.pmdl'))\n self.detector = snowboydecoder.HotwordDetector(models, sensitivity=config.get('sensitivity', 0.5))\n # main loop\n try:\n if config.get('/do_not_bother/hotword_switch', False):\n callbacks = [self._detected_callback,\n self._do_not_bother_on_callback,\n self._do_not_bother_off_callback]\n else:\n callbacks = self._detected_callback\n self.detector.start(detected_callback=callbacks,\n audio_recorder_callback=self._conversation.converse,\n interrupt_check=self._interrupt_callback,\n silent_count_threshold=config.get('silent_threshold', 15),\n recording_timeout=config.get('recording_timeout', 5) * 4,\n sleep_time=0.03)\n self.detector.terminate()\n except Exception as e:\n logger.critical('离线唤醒机制初始化失败：{}'.format(e))\n\n\n\n\n\n\n\n[文档] def restart(self):\n logger.critical('程序重启...')\n try:\n self.detector.terminate()\n except AttributeError:\n pass\n python = sys.executable\n os.execl(python, python, * sys.argv)\n\n\n\n\n\nif __name__ == '__main__':\n if len(sys.argv) == 1:\n wukong = Wukong()\n wukong.run()\n else:\n fire.Fire(Wukong)\n\n' + _('Hide Search Matches') + '
')\n .appendTo($('#searchbox'));\n }\n },\n\n /**\n * init the domain index toggle buttons\n */\n initIndexTable : function() {\n var togglers = $('img.toggler').click(function() {\n var src = $(this).attr('src');\n var idnum = $(this).attr('id').substr(7);\n $('tr.cg-' + idnum).toggle();\n if (src.substr(-9) === 'minus.png')\n $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');\n else\n $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');\n }).css('display', '');\n if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {\n togglers.click();\n }\n },\n\n /**\n * helper function to hide the search marks again\n */\n hideSearchWords : function() {\n $('#searchbox .highlight-link').fadeOut(300);\n $('span.highlighted').removeClass('highlighted');\n },\n\n /**\n * make the url absolute\n */\n makeURL : function(relativeURL) {\n return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;\n },\n\n /**\n * get the current relative url\n */\n getCurrentURL : function() {\n var path = document.location.pathname;\n var parts = path.split(/\\//);\n $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\\//), function() {\n if (this === '..')\n parts.pop();\n });\n var url = parts.join('/');\n return path.substring(url.lastIndexOf('/') + 1, path.length - 1);\n },\n\n initOnKeyListeners: function() {\n $(document).keyup(function(event) {\n var activeElementType = document.activeElement.tagName;\n // don't navigate when in search box or textarea\n if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') {\n switch (event.keyCode) {\n case 37: // left\n var prevHref = $('link[rel=\"prev\"]').prop('href');\n if (prevHref) {\n window.location.href = prevHref;\n return false;\n }\n case 39: // right\n var nextHref = $('link[rel=\"next\"]').prop('href');\n if (nextHref) {\n window.location.href = nextHref;\n return false;\n }\n }\n }\n });\n }\n};\n\n// quick alias for translations\n_ = Documentation.gettext;\n\n$(document).ready(function() {\n Documentation.init();\n});\n" }, { "path": "docs/_static/documentation_options.js", "content": "var DOCUMENTATION_OPTIONS = {\n URL_ROOT: document.getElementById(\"documentation_options\").getAttribute('data-url_root'),\n VERSION: '1.2.0',\n LANGUAGE: 'zh_CN',\n COLLAPSE_INDEX: false,\n FILE_SUFFIX: '.html',\n HAS_SOURCE: true,\n SOURCELINK_SUFFIX: '.txt',\n NAVIGATION_WITH_KEYS: false,\n};" }, { "path": "docs/_static/jquery-3.2.1.js", "content": "/*!\n * jQuery JavaScript Library v3.2.1\n * https://jquery.com/\n *\n * Includes Sizzle.js\n * https://sizzlejs.com/\n *\n * Copyright JS Foundation and other contributors\n * Released under the MIT license\n * https://jquery.org/license\n *\n * Date: 2017-03-20T18:59Z\n */\n( function( global, factory ) {\n\n\t\"use strict\";\n\n\tif ( typeof module === \"object\" && typeof module.exports === \"object\" ) {\n\n\t\t// For CommonJS and CommonJS-like environments where a proper `window`\n\t\t// is present, execute the factory and get jQuery.\n\t\t// For environments that do not have a `window` with a `document`\n\t\t// (such as Node.js), expose a factory as module.exports.\n\t\t// This accentuates the need for the creation of a real `window`.\n\t\t// e.g. var jQuery = require(\"jquery\")(window);\n\t\t// See ticket #14549 for more info.\n\t\tmodule.exports = global.document ?\n\t\t\tfactory( global, true ) :\n\t\t\tfunction( w ) {\n\t\t\t\tif ( !w.document ) {\n\t\t\t\t\tthrow new Error( \"jQuery requires a window with a document\" );\n\t\t\t\t}\n\t\t\t\treturn factory( w );\n\t\t\t};\n\t} else {\n\t\tfactory( global );\n\t}\n\n// Pass this if window is not defined yet\n} )( typeof window !== \"undefined\" ? window : this, function( window, noGlobal ) {\n\n// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1\n// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode\n// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common\n// enough that all such attempts are guarded in a try block.\n\"use strict\";\n\nvar arr = [];\n\nvar document = window.document;\n\nvar getProto = Object.getPrototypeOf;\n\nvar slice = arr.slice;\n\nvar concat = arr.concat;\n\nvar push = arr.push;\n\nvar indexOf = arr.indexOf;\n\nvar class2type = {};\n\nvar toString = class2type.toString;\n\nvar hasOwn = class2type.hasOwnProperty;\n\nvar fnToString = hasOwn.toString;\n\nvar ObjectFunctionString = fnToString.call( Object );\n\nvar support = {};\n\n\n\n\tfunction DOMEval( code, doc ) {\n\t\tdoc = doc || document;\n\n\t\tvar script = doc.createElement( \"script\" );\n\n\t\tscript.text = code;\n\t\tdoc.head.appendChild( script ).parentNode.removeChild( script );\n\t}\n/* global Symbol */\n// Defining this global in .eslintrc.json would create a danger of using the global\n// unguarded in another place, it seems safer to define global only for this module\n\n\n\nvar\n\tversion = \"3.2.1\",\n\n\t// Define a local copy of jQuery\n\tjQuery = function( selector, context ) {\n\n\t\t// The jQuery object is actually just the init constructor 'enhanced'\n\t\t// Need init if jQuery is called (just allow error to be thrown if not included)\n\t\treturn new jQuery.fn.init( selector, context );\n\t},\n\n\t// Support: Android <=4.0 only\n\t// Make sure we trim BOM and NBSP\n\trtrim = /^[\\s\\uFEFF\\xA0]+|[\\s\\uFEFF\\xA0]+$/g,\n\n\t// Matches dashed string for camelizing\n\trmsPrefix = /^-ms-/,\n\trdashAlpha = /-([a-z])/g,\n\n\t// Used by jQuery.camelCase as callback to replace()\n\tfcamelCase = function( all, letter ) {\n\t\treturn letter.toUpperCase();\n\t};\n\njQuery.fn = jQuery.prototype = {\n\n\t// The current version of jQuery being used\n\tjquery: version,\n\n\tconstructor: jQuery,\n\n\t// The default length of a jQuery object is 0\n\tlength: 0,\n\n\ttoArray: function() {\n\t\treturn slice.call( this );\n\t},\n\n\t// Get the Nth element in the matched element set OR\n\t// Get the whole matched element set as a clean array\n\tget: function( num ) {\n\n\t\t// Return all the elements in a clean array\n\t\tif ( num == null ) {\n\t\t\treturn slice.call( this );\n\t\t}\n\n\t\t// Return just the one element from the set\n\t\treturn num < 0 ? this[ num + this.length ] : this[ num ];\n\t},\n\n\t// Take an array of elements and push it onto the stack\n\t// (returning the new matched element set)\n\tpushStack: function( elems ) {\n\n\t\t// Build a new jQuery matched element set\n\t\tvar ret = jQuery.merge( this.constructor(), elems );\n\n\t\t// Add the old object onto the stack (as a reference)\n\t\tret.prevObject = this;\n\n\t\t// Return the newly-formed element set\n\t\treturn ret;\n\t},\n\n\t// Execute a callback for every element in the matched set.\n\teach: function( callback ) {\n\t\treturn jQuery.each( this, callback );\n\t},\n\n\tmap: function( callback ) {\n\t\treturn this.pushStack( jQuery.map( this, function( elem, i ) {\n\t\t\treturn callback.call( elem, i, elem );\n\t\t} ) );\n\t},\n\n\tslice: function() {\n\t\treturn this.pushStack( slice.apply( this, arguments ) );\n\t},\n\n\tfirst: function() {\n\t\treturn this.eq( 0 );\n\t},\n\n\tlast: function() {\n\t\treturn this.eq( -1 );\n\t},\n\n\teq: function( i ) {\n\t\tvar len = this.length,\n\t\t\tj = +i + ( i < 0 ? len : 0 );\n\t\treturn this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );\n\t},\n\n\tend: function() {\n\t\treturn this.prevObject || this.constructor();\n\t},\n\n\t// For internal use only.\n\t// Behaves like an Array's method, not like a jQuery method.\n\tpush: push,\n\tsort: arr.sort,\n\tsplice: arr.splice\n};\n\njQuery.extend = jQuery.fn.extend = function() {\n\tvar options, name, src, copy, copyIsArray, clone,\n\t\ttarget = arguments[ 0 ] || {},\n\t\ti = 1,\n\t\tlength = arguments.length,\n\t\tdeep = false;\n\n\t// Handle a deep copy situation\n\tif ( typeof target === \"boolean\" ) {\n\t\tdeep = target;\n\n\t\t// Skip the boolean and the target\n\t\ttarget = arguments[ i ] || {};\n\t\ti++;\n\t}\n\n\t// Handle case when target is a string or something (possible in deep copy)\n\tif ( typeof target !== \"object\" && !jQuery.isFunction( target ) ) {\n\t\ttarget = {};\n\t}\n\n\t// Extend jQuery itself if only one argument is passed\n\tif ( i === length ) {\n\t\ttarget = this;\n\t\ti--;\n\t}\n\n\tfor ( ; i < length; i++ ) {\n\n\t\t// Only deal with non-null/undefined values\n\t\tif ( ( options = arguments[ i ] ) != null ) {\n\n\t\t\t// Extend the base object\n\t\t\tfor ( name in options ) {\n\t\t\t\tsrc = target[ name ];\n\t\t\t\tcopy = options[ name ];\n\n\t\t\t\t// Prevent never-ending loop\n\t\t\t\tif ( target === copy ) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Recurse if we're merging plain objects or arrays\n\t\t\t\tif ( deep && copy && ( jQuery.isPlainObject( copy ) ||\n\t\t\t\t\t( copyIsArray = Array.isArray( copy ) ) ) ) {\n\n\t\t\t\t\tif ( copyIsArray ) {\n\t\t\t\t\t\tcopyIsArray = false;\n\t\t\t\t\t\tclone = src && Array.isArray( src ) ? src : [];\n\n\t\t\t\t\t} else {\n\t\t\t\t\t\tclone = src && jQuery.isPlainObject( src ) ? src : {};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Never move original objects, clone them\n\t\t\t\t\ttarget[ name ] = jQuery.extend( deep, clone, copy );\n\n\t\t\t\t// Don't bring in undefined values\n\t\t\t\t} else if ( copy !== undefined ) {\n\t\t\t\t\ttarget[ name ] = copy;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Return the modified object\n\treturn target;\n};\n\njQuery.extend( {\n\n\t// Unique for each copy of jQuery on the page\n\texpando: \"jQuery\" + ( version + Math.random() ).replace( /\\D/g, \"\" ),\n\n\t// Assume jQuery is ready without the ready module\n\tisReady: true,\n\n\terror: function( msg ) {\n\t\tthrow new Error( msg );\n\t},\n\n\tnoop: function() {},\n\n\tisFunction: function( obj ) {\n\t\treturn jQuery.type( obj ) === \"function\";\n\t},\n\n\tisWindow: function( obj ) {\n\t\treturn obj != null && obj === obj.window;\n\t},\n\n\tisNumeric: function( obj ) {\n\n\t\t// As of jQuery 3.0, isNumeric is limited to\n\t\t// strings and numbers (primitives or objects)\n\t\t// that can be coerced to finite numbers (gh-2662)\n\t\tvar type = jQuery.type( obj );\n\t\treturn ( type === \"number\" || type === \"string\" ) &&\n\n\t\t\t// parseFloat NaNs numeric-cast false positives (\"\")\n\t\t\t// ...but misinterprets leading-number strings, particularly hex literals (\"0x...\")\n\t\t\t// subtraction forces infinities to NaN\n\t\t\t!isNaN( obj - parseFloat( obj ) );\n\t},\n\n\tisPlainObject: function( obj ) {\n\t\tvar proto, Ctor;\n\n\t\t// Detect obvious negatives\n\t\t// Use toString instead of jQuery.type to catch host objects\n\t\tif ( !obj || toString.call( obj ) !== \"[object Object]\" ) {\n\t\t\treturn false;\n\t\t}\n\n\t\tproto = getProto( obj );\n\n\t\t// Objects with no prototype (e.g., `Object.create( null )`) are plain\n\t\tif ( !proto ) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Objects with prototype are plain iff they were constructed by a global Object function\n\t\tCtor = hasOwn.call( proto, \"constructor\" ) && proto.constructor;\n\t\treturn typeof Ctor === \"function\" && fnToString.call( Ctor ) === ObjectFunctionString;\n\t},\n\n\tisEmptyObject: function( obj ) {\n\n\t\t/* eslint-disable no-unused-vars */\n\t\t// See https://github.com/eslint/eslint/issues/6125\n\t\tvar name;\n\n\t\tfor ( name in obj ) {\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t},\n\n\ttype: function( obj ) {\n\t\tif ( obj == null ) {\n\t\t\treturn obj + \"\";\n\t\t}\n\n\t\t// Support: Android <=2.3 only (functionish RegExp)\n\t\treturn typeof obj === \"object\" || typeof obj === \"function\" ?\n\t\t\tclass2type[ toString.call( obj ) ] || \"object\" :\n\t\t\ttypeof obj;\n\t},\n\n\t// Evaluates a script in a global context\n\tglobalEval: function( code ) {\n\t\tDOMEval( code );\n\t},\n\n\t// Convert dashed to camelCase; used by the css and data modules\n\t// Support: IE <=9 - 11, Edge 12 - 13\n\t// Microsoft forgot to hump their vendor prefix (#9572)\n\tcamelCase: function( string ) {\n\t\treturn string.replace( rmsPrefix, \"ms-\" ).replace( rdashAlpha, fcamelCase );\n\t},\n\n\teach: function( obj, callback ) {\n\t\tvar length, i = 0;\n\n\t\tif ( isArrayLike( obj ) ) {\n\t\t\tlength = obj.length;\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tif ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\tfor ( i in obj ) {\n\t\t\t\tif ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn obj;\n\t},\n\n\t// Support: Android <=4.0 only\n\ttrim: function( text ) {\n\t\treturn text == null ?\n\t\t\t\"\" :\n\t\t\t( text + \"\" ).replace( rtrim, \"\" );\n\t},\n\n\t// results is for internal usage only\n\tmakeArray: function( arr, results ) {\n\t\tvar ret = results || [];\n\n\t\tif ( arr != null ) {\n\t\t\tif ( isArrayLike( Object( arr ) ) ) {\n\t\t\t\tjQuery.merge( ret,\n\t\t\t\t\ttypeof arr === \"string\" ?\n\t\t\t\t\t[ arr ] : arr\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\tpush.call( ret, arr );\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t},\n\n\tinArray: function( elem, arr, i ) {\n\t\treturn arr == null ? -1 : indexOf.call( arr, elem, i );\n\t},\n\n\t// Support: Android <=4.0 only, PhantomJS 1 only\n\t// push.apply(_, arraylike) throws on ancient WebKit\n\tmerge: function( first, second ) {\n\t\tvar len = +second.length,\n\t\t\tj = 0,\n\t\t\ti = first.length;\n\n\t\tfor ( ; j < len; j++ ) {\n\t\t\tfirst[ i++ ] = second[ j ];\n\t\t}\n\n\t\tfirst.length = i;\n\n\t\treturn first;\n\t},\n\n\tgrep: function( elems, callback, invert ) {\n\t\tvar callbackInverse,\n\t\t\tmatches = [],\n\t\t\ti = 0,\n\t\t\tlength = elems.length,\n\t\t\tcallbackExpect = !invert;\n\n\t\t// Go through the array, only saving the items\n\t\t// that pass the validator function\n\t\tfor ( ; i < length; i++ ) {\n\t\t\tcallbackInverse = !callback( elems[ i ], i );\n\t\t\tif ( callbackInverse !== callbackExpect ) {\n\t\t\t\tmatches.push( elems[ i ] );\n\t\t\t}\n\t\t}\n\n\t\treturn matches;\n\t},\n\n\t// arg is for internal usage only\n\tmap: function( elems, callback, arg ) {\n\t\tvar length, value,\n\t\t\ti = 0,\n\t\t\tret = [];\n\n\t\t// Go through the array, translating each of the items to their new values\n\t\tif ( isArrayLike( elems ) ) {\n\t\t\tlength = elems.length;\n\t\t\tfor ( ; i < length; i++ ) {\n\t\t\t\tvalue = callback( elems[ i ], i, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret.push( value );\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Go through every key on the object,\n\t\t} else {\n\t\t\tfor ( i in elems ) {\n\t\t\t\tvalue = callback( elems[ i ], i, arg );\n\n\t\t\t\tif ( value != null ) {\n\t\t\t\t\tret.push( value );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Flatten any nested arrays\n\t\treturn concat.apply( [], ret );\n\t},\n\n\t// A global GUID counter for objects\n\tguid: 1,\n\n\t// Bind a function to a context, optionally partially applying any\n\t// arguments.\n\tproxy: function( fn, context ) {\n\t\tvar tmp, args, proxy;\n\n\t\tif ( typeof context === \"string\" ) {\n\t\t\ttmp = fn[ context ];\n\t\t\tcontext = fn;\n\t\t\tfn = tmp;\n\t\t}\n\n\t\t// Quick check to determine if target is callable, in the spec\n\t\t// this throws a TypeError, but we will just return undefined.\n\t\tif ( !jQuery.isFunction( fn ) ) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// Simulated bind\n\t\targs = slice.call( arguments, 2 );\n\t\tproxy = function() {\n\t\t\treturn fn.apply( context || this, args.concat( slice.call( arguments ) ) );\n\t\t};\n\n\t\t// Set the guid of unique handler to the same of original handler, so it can be removed\n\t\tproxy.guid = fn.guid = fn.guid || jQuery.guid++;\n\n\t\treturn proxy;\n\t},\n\n\tnow: Date.now,\n\n\t// jQuery.support is not used in Core but other projects attach their\n\t// properties to it so it needs to exist.\n\tsupport: support\n} );\n\nif ( typeof Symbol === \"function\" ) {\n\tjQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];\n}\n\n// Populate the class2type map\njQuery.each( \"Boolean Number String Function Array Date RegExp Object Error Symbol\".split( \" \" ),\nfunction( i, name ) {\n\tclass2type[ \"[object \" + name + \"]\" ] = name.toLowerCase();\n} );\n\nfunction isArrayLike( obj ) {\n\n\t// Support: real iOS 8.2 only (not reproducible in simulator)\n\t// `in` check used to prevent JIT error (gh-2145)\n\t// hasOwn isn't used here due to false negatives\n\t// regarding Nodelist length in IE\n\tvar length = !!obj && \"length\" in obj && obj.length,\n\t\ttype = jQuery.type( obj );\n\n\tif ( type === \"function\" || jQuery.isWindow( obj ) ) {\n\t\treturn false;\n\t}\n\n\treturn type === \"array\" || length === 0 ||\n\t\ttypeof length === \"number\" && length > 0 && ( length - 1 ) in obj;\n}\nvar Sizzle =\n/*!\n * Sizzle CSS Selector Engine v2.3.3\n * https://sizzlejs.com/\n *\n * Copyright jQuery Foundation and other contributors\n * Released under the MIT license\n * http://jquery.org/license\n *\n * Date: 2016-08-08\n */\n(function( window ) {\n\nvar i,\n\tsupport,\n\tExpr,\n\tgetText,\n\tisXML,\n\ttokenize,\n\tcompile,\n\tselect,\n\toutermostContext,\n\tsortInput,\n\thasDuplicate,\n\n\t// Local document vars\n\tsetDocument,\n\tdocument,\n\tdocElem,\n\tdocumentIsHTML,\n\trbuggyQSA,\n\trbuggyMatches,\n\tmatches,\n\tcontains,\n\n\t// Instance-specific data\n\texpando = \"sizzle\" + 1 * new Date(),\n\tpreferredDoc = window.document,\n\tdirruns = 0,\n\tdone = 0,\n\tclassCache = createCache(),\n\ttokenCache = createCache(),\n\tcompilerCache = createCache(),\n\tsortOrder = function( a, b ) {\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t}\n\t\treturn 0;\n\t},\n\n\t// Instance methods\n\thasOwn = ({}).hasOwnProperty,\n\tarr = [],\n\tpop = arr.pop,\n\tpush_native = arr.push,\n\tpush = arr.push,\n\tslice = arr.slice,\n\t// Use a stripped-down indexOf as it's faster than native\n\t// https://jsperf.com/thor-indexof-vs-for/5\n\tindexOf = function( list, elem ) {\n\t\tvar i = 0,\n\t\t\tlen = list.length;\n\t\tfor ( ; i < len; i++ ) {\n\t\t\tif ( list[i] === elem ) {\n\t\t\t\treturn i;\n\t\t\t}\n\t\t}\n\t\treturn -1;\n\t},\n\n\tbooleans = \"checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped\",\n\n\t// Regular expressions\n\n\t// http://www.w3.org/TR/css3-selectors/#whitespace\n\twhitespace = \"[\\\\x20\\\\t\\\\r\\\\n\\\\f]\",\n\n\t// http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier\n\tidentifier = \"(?:\\\\\\\\.|[\\\\w-]|[^\\0-\\\\xa0])+\",\n\n\t// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors\n\tattributes = \"\\\\[\" + whitespace + \"*(\" + identifier + \")(?:\" + whitespace +\n\t\t// Operator (capture 2)\n\t\t\"*([*^$|!~]?=)\" + whitespace +\n\t\t// \"Attribute values must be CSS identifiers [capture 5] or strings [capture 3 or capture 4]\"\n\t\t\"*(?:'((?:\\\\\\\\.|[^\\\\\\\\'])*)'|\\\"((?:\\\\\\\\.|[^\\\\\\\\\\\"])*)\\\"|(\" + identifier + \"))|)\" + whitespace +\n\t\t\"*\\\\]\",\n\n\tpseudos = \":(\" + identifier + \")(?:\\\\((\" +\n\t\t// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:\n\t\t// 1. quoted (capture 3; capture 4 or capture 5)\n\t\t\"('((?:\\\\\\\\.|[^\\\\\\\\'])*)'|\\\"((?:\\\\\\\\.|[^\\\\\\\\\\\"])*)\\\")|\" +\n\t\t// 2. simple (capture 6)\n\t\t\"((?:\\\\\\\\.|[^\\\\\\\\()[\\\\]]|\" + attributes + \")*)|\" +\n\t\t// 3. anything else (capture 2)\n\t\t\".*\" +\n\t\t\")\\\\)|)\",\n\n\t// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter\n\trwhitespace = new RegExp( whitespace + \"+\", \"g\" ),\n\trtrim = new RegExp( \"^\" + whitespace + \"+|((?:^|[^\\\\\\\\])(?:\\\\\\\\.)*)\" + whitespace + \"+$\", \"g\" ),\n\n\trcomma = new RegExp( \"^\" + whitespace + \"*,\" + whitespace + \"*\" ),\n\trcombinators = new RegExp( \"^\" + whitespace + \"*([>+~]|\" + whitespace + \")\" + whitespace + \"*\" ),\n\n\trattributeQuotes = new RegExp( \"=\" + whitespace + \"*([^\\\\]'\\\"]*?)\" + whitespace + \"*\\\\]\", \"g\" ),\n\n\trpseudo = new RegExp( pseudos ),\n\tridentifier = new RegExp( \"^\" + identifier + \"$\" ),\n\n\tmatchExpr = {\n\t\t\"ID\": new RegExp( \"^#(\" + identifier + \")\" ),\n\t\t\"CLASS\": new RegExp( \"^\\\\.(\" + identifier + \")\" ),\n\t\t\"TAG\": new RegExp( \"^(\" + identifier + \"|[*])\" ),\n\t\t\"ATTR\": new RegExp( \"^\" + attributes ),\n\t\t\"PSEUDO\": new RegExp( \"^\" + pseudos ),\n\t\t\"CHILD\": new RegExp( \"^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\\\(\" + whitespace +\n\t\t\t\"*(even|odd|(([+-]|)(\\\\d*)n|)\" + whitespace + \"*(?:([+-]|)\" + whitespace +\n\t\t\t\"*(\\\\d+)|))\" + whitespace + \"*\\\\)|)\", \"i\" ),\n\t\t\"bool\": new RegExp( \"^(?:\" + booleans + \")$\", \"i\" ),\n\t\t// For use in libraries implementing .is()\n\t\t// We use this for POS matching in `select`\n\t\t\"needsContext\": new RegExp( \"^\" + whitespace + \"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\\\(\" +\n\t\t\twhitespace + \"*((?:-\\\\d)?\\\\d*)\" + whitespace + \"*\\\\)|)(?=[^-]|$)\", \"i\" )\n\t},\n\n\trinputs = /^(?:input|select|textarea|button)$/i,\n\trheader = /^h\\d$/i,\n\n\trnative = /^[^{]+\\{\\s*\\[native \\w/,\n\n\t// Easily-parseable/retrievable ID or TAG or CLASS selectors\n\trquickExpr = /^(?:#([\\w-]+)|(\\w+)|\\.([\\w-]+))$/,\n\n\trsibling = /[+~]/,\n\n\t// CSS escapes\n\t// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters\n\trunescape = new RegExp( \"\\\\\\\\([\\\\da-f]{1,6}\" + whitespace + \"?|(\" + whitespace + \")|.)\", \"ig\" ),\n\tfunescape = function( _, escaped, escapedWhitespace ) {\n\t\tvar high = \"0x\" + escaped - 0x10000;\n\t\t// NaN means non-codepoint\n\t\t// Support: Firefox<24\n\t\t// Workaround erroneous numeric interpretation of +\"0x\"\n\t\treturn high !== high || escapedWhitespace ?\n\t\t\tescaped :\n\t\t\thigh < 0 ?\n\t\t\t\t// BMP codepoint\n\t\t\t\tString.fromCharCode( high + 0x10000 ) :\n\t\t\t\t// Supplemental Plane codepoint (surrogate pair)\n\t\t\t\tString.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );\n\t},\n\n\t// CSS string/identifier serialization\n\t// https://drafts.csswg.org/cssom/#common-serializing-idioms\n\trcssescape = /([\\0-\\x1f\\x7f]|^-?\\d)|^-$|[^\\0-\\x1f\\x7f-\\uFFFF\\w-]/g,\n\tfcssescape = function( ch, asCodePoint ) {\n\t\tif ( asCodePoint ) {\n\n\t\t\t// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER\n\t\t\tif ( ch === \"\\0\" ) {\n\t\t\t\treturn \"\\uFFFD\";\n\t\t\t}\n\n\t\t\t// Control characters and (dependent upon position) numbers get escaped as code points\n\t\t\treturn ch.slice( 0, -1 ) + \"\\\\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + \" \";\n\t\t}\n\n\t\t// Other potentially-special ASCII characters get backslash-escaped\n\t\treturn \"\\\\\" + ch;\n\t},\n\n\t// Used for iframes\n\t// See setDocument()\n\t// Removing the function wrapper causes a \"Permission Denied\"\n\t// error in IE\n\tunloadHandler = function() {\n\t\tsetDocument();\n\t},\n\n\tdisabledAncestor = addCombinator(\n\t\tfunction( elem ) {\n\t\t\treturn elem.disabled === true && (\"form\" in elem || \"label\" in elem);\n\t\t},\n\t\t{ dir: \"parentNode\", next: \"legend\" }\n\t);\n\n// Optimize for push.apply( _, NodeList )\ntry {\n\tpush.apply(\n\t\t(arr = slice.call( preferredDoc.childNodes )),\n\t\tpreferredDoc.childNodes\n\t);\n\t// Support: Android<4.0\n\t// Detect silently failing push.apply\n\tarr[ preferredDoc.childNodes.length ].nodeType;\n} catch ( e ) {\n\tpush = { apply: arr.length ?\n\n\t\t// Leverage slice if possible\n\t\tfunction( target, els ) {\n\t\t\tpush_native.apply( target, slice.call(els) );\n\t\t} :\n\n\t\t// Support: IE<9\n\t\t// Otherwise append directly\n\t\tfunction( target, els ) {\n\t\t\tvar j = target.length,\n\t\t\t\ti = 0;\n\t\t\t// Can't trust NodeList.length\n\t\t\twhile ( (target[j++] = els[i++]) ) {}\n\t\t\ttarget.length = j - 1;\n\t\t}\n\t};\n}\n\nfunction Sizzle( selector, context, results, seed ) {\n\tvar m, i, elem, nid, match, groups, newSelector,\n\t\tnewContext = context && context.ownerDocument,\n\n\t\t// nodeType defaults to 9, since context defaults to document\n\t\tnodeType = context ? context.nodeType : 9;\n\n\tresults = results || [];\n\n\t// Return early from calls with invalid selector or context\n\tif ( typeof selector !== \"string\" || !selector ||\n\t\tnodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {\n\n\t\treturn results;\n\t}\n\n\t// Try to shortcut find operations (as opposed to filters) in HTML documents\n\tif ( !seed ) {\n\n\t\tif ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) {\n\t\t\tsetDocument( context );\n\t\t}\n\t\tcontext = context || document;\n\n\t\tif ( documentIsHTML ) {\n\n\t\t\t// If the selector is sufficiently simple, try using a \"get*By*\" DOM method\n\t\t\t// (excepting DocumentFragment context, where the methods don't exist)\n\t\t\tif ( nodeType !== 11 && (match = rquickExpr.exec( selector )) ) {\n\n\t\t\t\t// ID selector\n\t\t\t\tif ( (m = match[1]) ) {\n\n\t\t\t\t\t// Document context\n\t\t\t\t\tif ( nodeType === 9 ) {\n\t\t\t\t\t\tif ( (elem = context.getElementById( m )) ) {\n\n\t\t\t\t\t\t\t// Support: IE, Opera, Webkit\n\t\t\t\t\t\t\t// TODO: identify versions\n\t\t\t\t\t\t\t// getElementById can match elements by name instead of ID\n\t\t\t\t\t\t\tif ( elem.id === m ) {\n\t\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t// Element context\n\t\t\t\t\t} else {\n\n\t\t\t\t\t\t// Support: IE, Opera, Webkit\n\t\t\t\t\t\t// TODO: identify versions\n\t\t\t\t\t\t// getElementById can match elements by name instead of ID\n\t\t\t\t\t\tif ( newContext && (elem = newContext.getElementById( m )) &&\n\t\t\t\t\t\t\tcontains( context, elem ) &&\n\t\t\t\t\t\t\telem.id === m ) {\n\n\t\t\t\t\t\t\tresults.push( elem );\n\t\t\t\t\t\t\treturn results;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t// Type selector\n\t\t\t\t} else if ( match[2] ) {\n\t\t\t\t\tpush.apply( results, context.getElementsByTagName( selector ) );\n\t\t\t\t\treturn results;\n\n\t\t\t\t// Class selector\n\t\t\t\t} else if ( (m = match[3]) && support.getElementsByClassName &&\n\t\t\t\t\tcontext.getElementsByClassName ) {\n\n\t\t\t\t\tpush.apply( results, context.getElementsByClassName( m ) );\n\t\t\t\t\treturn results;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Take advantage of querySelectorAll\n\t\t\tif ( support.qsa &&\n\t\t\t\t!compilerCache[ selector + \" \" ] &&\n\t\t\t\t(!rbuggyQSA || !rbuggyQSA.test( selector )) ) {\n\n\t\t\t\tif ( nodeType !== 1 ) {\n\t\t\t\t\tnewContext = context;\n\t\t\t\t\tnewSelector = selector;\n\n\t\t\t\t// qSA looks outside Element context, which is not what we want\n\t\t\t\t// Thanks to Andrew Dupont for this workaround technique\n\t\t\t\t// Support: IE <=8\n\t\t\t\t// Exclude object elements\n\t\t\t\t} else if ( context.nodeName.toLowerCase() !== \"object\" ) {\n\n\t\t\t\t\t// Capture the context ID, setting it first if necessary\n\t\t\t\t\tif ( (nid = context.getAttribute( \"id\" )) ) {\n\t\t\t\t\t\tnid = nid.replace( rcssescape, fcssescape );\n\t\t\t\t\t} else {\n\t\t\t\t\t\tcontext.setAttribute( \"id\", (nid = expando) );\n\t\t\t\t\t}\n\n\t\t\t\t\t// Prefix every selector in the list\n\t\t\t\t\tgroups = tokenize( selector );\n\t\t\t\t\ti = groups.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tgroups[i] = \"#\" + nid + \" \" + toSelector( groups[i] );\n\t\t\t\t\t}\n\t\t\t\t\tnewSelector = groups.join( \",\" );\n\n\t\t\t\t\t// Expand context for sibling selectors\n\t\t\t\t\tnewContext = rsibling.test( selector ) && testContext( context.parentNode ) ||\n\t\t\t\t\t\tcontext;\n\t\t\t\t}\n\n\t\t\t\tif ( newSelector ) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tpush.apply( results,\n\t\t\t\t\t\t\tnewContext.querySelectorAll( newSelector )\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn results;\n\t\t\t\t\t} catch ( qsaError ) {\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tif ( nid === expando ) {\n\t\t\t\t\t\t\tcontext.removeAttribute( \"id\" );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// All others\n\treturn select( selector.replace( rtrim, \"$1\" ), context, results, seed );\n}\n\n/**\n * Create key-value caches of limited size\n * @returns {function(string, object)} Returns the Object data after storing it on itself with\n *\tproperty name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)\n *\tdeleting the oldest entry\n */\nfunction createCache() {\n\tvar keys = [];\n\n\tfunction cache( key, value ) {\n\t\t// Use (key + \" \") to avoid collision with native prototype properties (see Issue #157)\n\t\tif ( keys.push( key + \" \" ) > Expr.cacheLength ) {\n\t\t\t// Only keep the most recent entries\n\t\t\tdelete cache[ keys.shift() ];\n\t\t}\n\t\treturn (cache[ key + \" \" ] = value);\n\t}\n\treturn cache;\n}\n\n/**\n * Mark a function for special use by Sizzle\n * @param {Function} fn The function to mark\n */\nfunction markFunction( fn ) {\n\tfn[ expando ] = true;\n\treturn fn;\n}\n\n/**\n * Support testing using an element\n * @param {Function} fn Passed the created element and returns a boolean result\n */\nfunction assert( fn ) {\n\tvar el = document.createElement(\"fieldset\");\n\n\ttry {\n\t\treturn !!fn( el );\n\t} catch (e) {\n\t\treturn false;\n\t} finally {\n\t\t// Remove from its parent by default\n\t\tif ( el.parentNode ) {\n\t\t\tel.parentNode.removeChild( el );\n\t\t}\n\t\t// release memory in IE\n\t\tel = null;\n\t}\n}\n\n/**\n * Adds the same handler for all of the specified attrs\n * @param {String} attrs Pipe-separated list of attributes\n * @param {Function} handler The method that will be applied\n */\nfunction addHandle( attrs, handler ) {\n\tvar arr = attrs.split(\"|\"),\n\t\ti = arr.length;\n\n\twhile ( i-- ) {\n\t\tExpr.attrHandle[ arr[i] ] = handler;\n\t}\n}\n\n/**\n * Checks document order of two siblings\n * @param {Element} a\n * @param {Element} b\n * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b\n */\nfunction siblingCheck( a, b ) {\n\tvar cur = b && a,\n\t\tdiff = cur && a.nodeType === 1 && b.nodeType === 1 &&\n\t\t\ta.sourceIndex - b.sourceIndex;\n\n\t// Use IE sourceIndex if available on both nodes\n\tif ( diff ) {\n\t\treturn diff;\n\t}\n\n\t// Check if b follows a\n\tif ( cur ) {\n\t\twhile ( (cur = cur.nextSibling) ) {\n\t\t\tif ( cur === b ) {\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn a ? 1 : -1;\n}\n\n/**\n * Returns a function to use in pseudos for input types\n * @param {String} type\n */\nfunction createInputPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn name === \"input\" && elem.type === type;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for buttons\n * @param {String} type\n */\nfunction createButtonPseudo( type ) {\n\treturn function( elem ) {\n\t\tvar name = elem.nodeName.toLowerCase();\n\t\treturn (name === \"input\" || name === \"button\") && elem.type === type;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for :enabled/:disabled\n * @param {Boolean} disabled true for :disabled; false for :enabled\n */\nfunction createDisabledPseudo( disabled ) {\n\n\t// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable\n\treturn function( elem ) {\n\n\t\t// Only certain elements can match :enabled or :disabled\n\t\t// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled\n\t\t// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled\n\t\tif ( \"form\" in elem ) {\n\n\t\t\t// Check for inherited disabledness on relevant non-disabled elements:\n\t\t\t// * listed form-associated elements in a disabled fieldset\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#category-listed\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled\n\t\t\t// * option elements in a disabled optgroup\n\t\t\t// https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled\n\t\t\t// All such elements have a \"form\" property.\n\t\t\tif ( elem.parentNode && elem.disabled === false ) {\n\n\t\t\t\t// Option elements defer to a parent optgroup if present\n\t\t\t\tif ( \"label\" in elem ) {\n\t\t\t\t\tif ( \"label\" in elem.parentNode ) {\n\t\t\t\t\t\treturn elem.parentNode.disabled === disabled;\n\t\t\t\t\t} else {\n\t\t\t\t\t\treturn elem.disabled === disabled;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Support: IE 6 - 11\n\t\t\t\t// Use the isDisabled shortcut property to check for disabled fieldset ancestors\n\t\t\t\treturn elem.isDisabled === disabled ||\n\n\t\t\t\t\t// Where there is no isDisabled, check manually\n\t\t\t\t\t/* jshint -W018 */\n\t\t\t\t\telem.isDisabled !== !disabled &&\n\t\t\t\t\t\tdisabledAncestor( elem ) === disabled;\n\t\t\t}\n\n\t\t\treturn elem.disabled === disabled;\n\n\t\t// Try to winnow out elements that can't be disabled before trusting the disabled property.\n\t\t// Some victims get caught in our net (label, legend, menu, track), but it shouldn't\n\t\t// even exist on them, let alone have a boolean value.\n\t\t} else if ( \"label\" in elem ) {\n\t\t\treturn elem.disabled === disabled;\n\t\t}\n\n\t\t// Remaining elements are neither :enabled nor :disabled\n\t\treturn false;\n\t};\n}\n\n/**\n * Returns a function to use in pseudos for positionals\n * @param {Function} fn\n */\nfunction createPositionalPseudo( fn ) {\n\treturn markFunction(function( argument ) {\n\t\targument = +argument;\n\t\treturn markFunction(function( seed, matches ) {\n\t\t\tvar j,\n\t\t\t\tmatchIndexes = fn( [], seed.length, argument ),\n\t\t\t\ti = matchIndexes.length;\n\n\t\t\t// Match elements found at the specified indexes\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( seed[ (j = matchIndexes[i]) ] ) {\n\t\t\t\t\tseed[j] = !(matches[j] = seed[j]);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t});\n}\n\n/**\n * Checks a node for validity as a Sizzle context\n * @param {Element|Object=} context\n * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value\n */\nfunction testContext( context ) {\n\treturn context && typeof context.getElementsByTagName !== \"undefined\" && context;\n}\n\n// Expose support vars for convenience\nsupport = Sizzle.support = {};\n\n/**\n * Detects XML nodes\n * @param {Element|Object} elem An element or a document\n * @returns {Boolean} True iff elem is a non-HTML XML node\n */\nisXML = Sizzle.isXML = function( elem ) {\n\t// documentElement is verified for cases where it doesn't yet exist\n\t// (such as loading iframes in IE - #4833)\n\tvar documentElement = elem && (elem.ownerDocument || elem).documentElement;\n\treturn documentElement ? documentElement.nodeName !== \"HTML\" : false;\n};\n\n/**\n * Sets document-related variables once based on the current document\n * @param {Element|Object} [doc] An element or document object to use to set the document\n * @returns {Object} Returns the current document\n */\nsetDocument = Sizzle.setDocument = function( node ) {\n\tvar hasCompare, subWindow,\n\t\tdoc = node ? node.ownerDocument || node : preferredDoc;\n\n\t// Return early if doc is invalid or already selected\n\tif ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) {\n\t\treturn document;\n\t}\n\n\t// Update global variables\n\tdocument = doc;\n\tdocElem = document.documentElement;\n\tdocumentIsHTML = !isXML( document );\n\n\t// Support: IE 9-11, Edge\n\t// Accessing iframe documents after unload throws \"permission denied\" errors (jQuery #13936)\n\tif ( preferredDoc !== document &&\n\t\t(subWindow = document.defaultView) && subWindow.top !== subWindow ) {\n\n\t\t// Support: IE 11, Edge\n\t\tif ( subWindow.addEventListener ) {\n\t\t\tsubWindow.addEventListener( \"unload\", unloadHandler, false );\n\n\t\t// Support: IE 9 - 10 only\n\t\t} else if ( subWindow.attachEvent ) {\n\t\t\tsubWindow.attachEvent( \"onunload\", unloadHandler );\n\t\t}\n\t}\n\n\t/* Attributes\n\t---------------------------------------------------------------------- */\n\n\t// Support: IE<8\n\t// Verify that getAttribute really returns attributes and not properties\n\t// (excepting IE8 booleans)\n\tsupport.attributes = assert(function( el ) {\n\t\tel.className = \"i\";\n\t\treturn !el.getAttribute(\"className\");\n\t});\n\n\t/* getElement(s)By*\n\t---------------------------------------------------------------------- */\n\n\t// Check if getElementsByTagName(\"*\") returns only elements\n\tsupport.getElementsByTagName = assert(function( el ) {\n\t\tel.appendChild( document.createComment(\"\") );\n\t\treturn !el.getElementsByTagName(\"*\").length;\n\t});\n\n\t// Support: IE<9\n\tsupport.getElementsByClassName = rnative.test( document.getElementsByClassName );\n\n\t// Support: IE<10\n\t// Check if getElementById returns elements by name\n\t// The broken getElementById methods don't pick up programmatically-set names,\n\t// so use a roundabout getElementsByName test\n\tsupport.getById = assert(function( el ) {\n\t\tdocElem.appendChild( el ).id = expando;\n\t\treturn !document.getElementsByName || !document.getElementsByName( expando ).length;\n\t});\n\n\t// ID filter and find\n\tif ( support.getById ) {\n\t\tExpr.filter[\"ID\"] = function( id ) {\n\t\t\tvar attrId = id.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\treturn elem.getAttribute(\"id\") === attrId;\n\t\t\t};\n\t\t};\n\t\tExpr.find[\"ID\"] = function( id, context ) {\n\t\t\tif ( typeof context.getElementById !== \"undefined\" && documentIsHTML ) {\n\t\t\t\tvar elem = context.getElementById( id );\n\t\t\t\treturn elem ? [ elem ] : [];\n\t\t\t}\n\t\t};\n\t} else {\n\t\tExpr.filter[\"ID\"] = function( id ) {\n\t\t\tvar attrId = id.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\tvar node = typeof elem.getAttributeNode !== \"undefined\" &&\n\t\t\t\t\telem.getAttributeNode(\"id\");\n\t\t\t\treturn node && node.value === attrId;\n\t\t\t};\n\t\t};\n\n\t\t// Support: IE 6 - 7 only\n\t\t// getElementById is not reliable as a find shortcut\n\t\tExpr.find[\"ID\"] = function( id, context ) {\n\t\t\tif ( typeof context.getElementById !== \"undefined\" && documentIsHTML ) {\n\t\t\t\tvar node, i, elems,\n\t\t\t\t\telem = context.getElementById( id );\n\n\t\t\t\tif ( elem ) {\n\n\t\t\t\t\t// Verify the id attribute\n\t\t\t\t\tnode = elem.getAttributeNode(\"id\");\n\t\t\t\t\tif ( node && node.value === id ) {\n\t\t\t\t\t\treturn [ elem ];\n\t\t\t\t\t}\n\n\t\t\t\t\t// Fall back on getElementsByName\n\t\t\t\t\telems = context.getElementsByName( id );\n\t\t\t\t\ti = 0;\n\t\t\t\t\twhile ( (elem = elems[i++]) ) {\n\t\t\t\t\t\tnode = elem.getAttributeNode(\"id\");\n\t\t\t\t\t\tif ( node && node.value === id ) {\n\t\t\t\t\t\t\treturn [ elem ];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn [];\n\t\t\t}\n\t\t};\n\t}\n\n\t// Tag\n\tExpr.find[\"TAG\"] = support.getElementsByTagName ?\n\t\tfunction( tag, context ) {\n\t\t\tif ( typeof context.getElementsByTagName !== \"undefined\" ) {\n\t\t\t\treturn context.getElementsByTagName( tag );\n\n\t\t\t// DocumentFragment nodes don't have gEBTN\n\t\t\t} else if ( support.qsa ) {\n\t\t\t\treturn context.querySelectorAll( tag );\n\t\t\t}\n\t\t} :\n\n\t\tfunction( tag, context ) {\n\t\t\tvar elem,\n\t\t\t\ttmp = [],\n\t\t\t\ti = 0,\n\t\t\t\t// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too\n\t\t\t\tresults = context.getElementsByTagName( tag );\n\n\t\t\t// Filter out possible comments\n\t\t\tif ( tag === \"*\" ) {\n\t\t\t\twhile ( (elem = results[i++]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 ) {\n\t\t\t\t\t\ttmp.push( elem );\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn tmp;\n\t\t\t}\n\t\t\treturn results;\n\t\t};\n\n\t// Class\n\tExpr.find[\"CLASS\"] = support.getElementsByClassName && function( className, context ) {\n\t\tif ( typeof context.getElementsByClassName !== \"undefined\" && documentIsHTML ) {\n\t\t\treturn context.getElementsByClassName( className );\n\t\t}\n\t};\n\n\t/* QSA/matchesSelector\n\t---------------------------------------------------------------------- */\n\n\t// QSA and matchesSelector support\n\n\t// matchesSelector(:active) reports false when true (IE9/Opera 11.5)\n\trbuggyMatches = [];\n\n\t// qSa(:focus) reports false when true (Chrome 21)\n\t// We allow this because of a bug in IE8/9 that throws an error\n\t// whenever `document.activeElement` is accessed on an iframe\n\t// So, we allow :focus to pass through QSA all the time to avoid the IE error\n\t// See https://bugs.jquery.com/ticket/13378\n\trbuggyQSA = [];\n\n\tif ( (support.qsa = rnative.test( document.querySelectorAll )) ) {\n\t\t// Build QSA regex\n\t\t// Regex strategy adopted from Diego Perini\n\t\tassert(function( el ) {\n\t\t\t// Select is set to empty string on purpose\n\t\t\t// This is to test IE's treatment of not explicitly\n\t\t\t// setting a boolean content attribute,\n\t\t\t// since its presence should be enough\n\t\t\t// https://bugs.jquery.com/ticket/12359\n\t\t\tdocElem.appendChild( el ).innerHTML = \"\" +\n\t\t\t\t\"\";\n\n\t\t\t// Support: IE8, Opera 11-12.16\n\t\t\t// Nothing should be selected when empty strings follow ^= or $= or *=\n\t\t\t// The test attribute must be unknown in Opera but \"safe\" for WinRT\n\t\t\t// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section\n\t\t\tif ( el.querySelectorAll(\"[msallowcapture^='']\").length ) {\n\t\t\t\trbuggyQSA.push( \"[*^$]=\" + whitespace + \"*(?:''|\\\"\\\")\" );\n\t\t\t}\n\n\t\t\t// Support: IE8\n\t\t\t// Boolean attributes and \"value\" are not treated correctly\n\t\t\tif ( !el.querySelectorAll(\"[selected]\").length ) {\n\t\t\t\trbuggyQSA.push( \"\\\\[\" + whitespace + \"*(?:value|\" + booleans + \")\" );\n\t\t\t}\n\n\t\t\t// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+\n\t\t\tif ( !el.querySelectorAll( \"[id~=\" + expando + \"-]\" ).length ) {\n\t\t\t\trbuggyQSA.push(\"~=\");\n\t\t\t}\n\n\t\t\t// Webkit/Opera - :checked should return selected option elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\t// IE8 throws error here and will not see later tests\n\t\t\tif ( !el.querySelectorAll(\":checked\").length ) {\n\t\t\t\trbuggyQSA.push(\":checked\");\n\t\t\t}\n\n\t\t\t// Support: Safari 8+, iOS 8+\n\t\t\t// https://bugs.webkit.org/show_bug.cgi?id=136851\n\t\t\t// In-page `selector#id sibling-combinator selector` fails\n\t\t\tif ( !el.querySelectorAll( \"a#\" + expando + \"+*\" ).length ) {\n\t\t\t\trbuggyQSA.push(\".#.+[+~]\");\n\t\t\t}\n\t\t});\n\n\t\tassert(function( el ) {\n\t\t\tel.innerHTML = \"\" +\n\t\t\t\t\"\";\n\n\t\t\t// Support: Windows 8 Native Apps\n\t\t\t// The type and name attributes are restricted during .innerHTML assignment\n\t\t\tvar input = document.createElement(\"input\");\n\t\t\tinput.setAttribute( \"type\", \"hidden\" );\n\t\t\tel.appendChild( input ).setAttribute( \"name\", \"D\" );\n\n\t\t\t// Support: IE8\n\t\t\t// Enforce case-sensitivity of name attribute\n\t\t\tif ( el.querySelectorAll(\"[name=d]\").length ) {\n\t\t\t\trbuggyQSA.push( \"name\" + whitespace + \"*[*^$|!~]?=\" );\n\t\t\t}\n\n\t\t\t// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)\n\t\t\t// IE8 throws error here and will not see later tests\n\t\t\tif ( el.querySelectorAll(\":enabled\").length !== 2 ) {\n\t\t\t\trbuggyQSA.push( \":enabled\", \":disabled\" );\n\t\t\t}\n\n\t\t\t// Support: IE9-11+\n\t\t\t// IE's :disabled selector does not pick up the children of disabled fieldsets\n\t\t\tdocElem.appendChild( el ).disabled = true;\n\t\t\tif ( el.querySelectorAll(\":disabled\").length !== 2 ) {\n\t\t\t\trbuggyQSA.push( \":enabled\", \":disabled\" );\n\t\t\t}\n\n\t\t\t// Opera 10-11 does not throw on post-comma invalid pseudos\n\t\t\tel.querySelectorAll(\"*,:x\");\n\t\t\trbuggyQSA.push(\",.*:\");\n\t\t});\n\t}\n\n\tif ( (support.matchesSelector = rnative.test( (matches = docElem.matches ||\n\t\tdocElem.webkitMatchesSelector ||\n\t\tdocElem.mozMatchesSelector ||\n\t\tdocElem.oMatchesSelector ||\n\t\tdocElem.msMatchesSelector) )) ) {\n\n\t\tassert(function( el ) {\n\t\t\t// Check to see if it's possible to do matchesSelector\n\t\t\t// on a disconnected node (IE 9)\n\t\t\tsupport.disconnectedMatch = matches.call( el, \"*\" );\n\n\t\t\t// This should fail with an exception\n\t\t\t// Gecko does not error, returns false instead\n\t\t\tmatches.call( el, \"[s!='']:x\" );\n\t\t\trbuggyMatches.push( \"!=\", pseudos );\n\t\t});\n\t}\n\n\trbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join(\"|\") );\n\trbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join(\"|\") );\n\n\t/* Contains\n\t---------------------------------------------------------------------- */\n\thasCompare = rnative.test( docElem.compareDocumentPosition );\n\n\t// Element contains another\n\t// Purposefully self-exclusive\n\t// As in, an element does not contain itself\n\tcontains = hasCompare || rnative.test( docElem.contains ) ?\n\t\tfunction( a, b ) {\n\t\t\tvar adown = a.nodeType === 9 ? a.documentElement : a,\n\t\t\t\tbup = b && b.parentNode;\n\t\t\treturn a === bup || !!( bup && bup.nodeType === 1 && (\n\t\t\t\tadown.contains ?\n\t\t\t\t\tadown.contains( bup ) :\n\t\t\t\t\ta.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16\n\t\t\t));\n\t\t} :\n\t\tfunction( a, b ) {\n\t\t\tif ( b ) {\n\t\t\t\twhile ( (b = b.parentNode) ) {\n\t\t\t\t\tif ( b === a ) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t};\n\n\t/* Sorting\n\t---------------------------------------------------------------------- */\n\n\t// Document order sorting\n\tsortOrder = hasCompare ?\n\tfunction( a, b ) {\n\n\t\t// Flag for duplicate removal\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\t\t}\n\n\t\t// Sort on method existence if only one input has compareDocumentPosition\n\t\tvar compare = !a.compareDocumentPosition - !b.compareDocumentPosition;\n\t\tif ( compare ) {\n\t\t\treturn compare;\n\t\t}\n\n\t\t// Calculate position if both inputs belong to the same document\n\t\tcompare = ( a.ownerDocument || a ) === ( b.ownerDocument || b ) ?\n\t\t\ta.compareDocumentPosition( b ) :\n\n\t\t\t// Otherwise we know they are disconnected\n\t\t\t1;\n\n\t\t// Disconnected nodes\n\t\tif ( compare & 1 ||\n\t\t\t(!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) {\n\n\t\t\t// Choose the first element that is related to our preferred document\n\t\t\tif ( a === document || a.ownerDocument === preferredDoc && contains(preferredDoc, a) ) {\n\t\t\t\treturn -1;\n\t\t\t}\n\t\t\tif ( b === document || b.ownerDocument === preferredDoc && contains(preferredDoc, b) ) {\n\t\t\t\treturn 1;\n\t\t\t}\n\n\t\t\t// Maintain original order\n\t\t\treturn sortInput ?\n\t\t\t\t( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :\n\t\t\t\t0;\n\t\t}\n\n\t\treturn compare & 4 ? -1 : 1;\n\t} :\n\tfunction( a, b ) {\n\t\t// Exit early if the nodes are identical\n\t\tif ( a === b ) {\n\t\t\thasDuplicate = true;\n\t\t\treturn 0;\n\t\t}\n\n\t\tvar cur,\n\t\t\ti = 0,\n\t\t\taup = a.parentNode,\n\t\t\tbup = b.parentNode,\n\t\t\tap = [ a ],\n\t\t\tbp = [ b ];\n\n\t\t// Parentless nodes are either documents or disconnected\n\t\tif ( !aup || !bup ) {\n\t\t\treturn a === document ? -1 :\n\t\t\t\tb === document ? 1 :\n\t\t\t\taup ? -1 :\n\t\t\t\tbup ? 1 :\n\t\t\t\tsortInput ?\n\t\t\t\t( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :\n\t\t\t\t0;\n\n\t\t// If the nodes are siblings, we can do a quick check\n\t\t} else if ( aup === bup ) {\n\t\t\treturn siblingCheck( a, b );\n\t\t}\n\n\t\t// Otherwise we need full lists of their ancestors for comparison\n\t\tcur = a;\n\t\twhile ( (cur = cur.parentNode) ) {\n\t\t\tap.unshift( cur );\n\t\t}\n\t\tcur = b;\n\t\twhile ( (cur = cur.parentNode) ) {\n\t\t\tbp.unshift( cur );\n\t\t}\n\n\t\t// Walk down the tree looking for a discrepancy\n\t\twhile ( ap[i] === bp[i] ) {\n\t\t\ti++;\n\t\t}\n\n\t\treturn i ?\n\t\t\t// Do a sibling check if the nodes have a common ancestor\n\t\t\tsiblingCheck( ap[i], bp[i] ) :\n\n\t\t\t// Otherwise nodes in our document sort first\n\t\t\tap[i] === preferredDoc ? -1 :\n\t\t\tbp[i] === preferredDoc ? 1 :\n\t\t\t0;\n\t};\n\n\treturn document;\n};\n\nSizzle.matches = function( expr, elements ) {\n\treturn Sizzle( expr, null, null, elements );\n};\n\nSizzle.matchesSelector = function( elem, expr ) {\n\t// Set document vars if needed\n\tif ( ( elem.ownerDocument || elem ) !== document ) {\n\t\tsetDocument( elem );\n\t}\n\n\t// Make sure that attribute selectors are quoted\n\texpr = expr.replace( rattributeQuotes, \"='$1']\" );\n\n\tif ( support.matchesSelector && documentIsHTML &&\n\t\t!compilerCache[ expr + \" \" ] &&\n\t\t( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&\n\t\t( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) {\n\n\t\ttry {\n\t\t\tvar ret = matches.call( elem, expr );\n\n\t\t\t// IE 9's matchesSelector returns false on disconnected nodes\n\t\t\tif ( ret || support.disconnectedMatch ||\n\t\t\t\t\t// As well, disconnected nodes are said to be in a document\n\t\t\t\t\t// fragment in IE 9\n\t\t\t\t\telem.document && elem.document.nodeType !== 11 ) {\n\t\t\t\treturn ret;\n\t\t\t}\n\t\t} catch (e) {}\n\t}\n\n\treturn Sizzle( expr, document, null, [ elem ] ).length > 0;\n};\n\nSizzle.contains = function( context, elem ) {\n\t// Set document vars if needed\n\tif ( ( context.ownerDocument || context ) !== document ) {\n\t\tsetDocument( context );\n\t}\n\treturn contains( context, elem );\n};\n\nSizzle.attr = function( elem, name ) {\n\t// Set document vars if needed\n\tif ( ( elem.ownerDocument || elem ) !== document ) {\n\t\tsetDocument( elem );\n\t}\n\n\tvar fn = Expr.attrHandle[ name.toLowerCase() ],\n\t\t// Don't get fooled by Object.prototype properties (jQuery #13807)\n\t\tval = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?\n\t\t\tfn( elem, name, !documentIsHTML ) :\n\t\t\tundefined;\n\n\treturn val !== undefined ?\n\t\tval :\n\t\tsupport.attributes || !documentIsHTML ?\n\t\t\telem.getAttribute( name ) :\n\t\t\t(val = elem.getAttributeNode(name)) && val.specified ?\n\t\t\t\tval.value :\n\t\t\t\tnull;\n};\n\nSizzle.escape = function( sel ) {\n\treturn (sel + \"\").replace( rcssescape, fcssescape );\n};\n\nSizzle.error = function( msg ) {\n\tthrow new Error( \"Syntax error, unrecognized expression: \" + msg );\n};\n\n/**\n * Document sorting and removing duplicates\n * @param {ArrayLike} results\n */\nSizzle.uniqueSort = function( results ) {\n\tvar elem,\n\t\tduplicates = [],\n\t\tj = 0,\n\t\ti = 0;\n\n\t// Unless we *know* we can detect duplicates, assume their presence\n\thasDuplicate = !support.detectDuplicates;\n\tsortInput = !support.sortStable && results.slice( 0 );\n\tresults.sort( sortOrder );\n\n\tif ( hasDuplicate ) {\n\t\twhile ( (elem = results[i++]) ) {\n\t\t\tif ( elem === results[ i ] ) {\n\t\t\t\tj = duplicates.push( i );\n\t\t\t}\n\t\t}\n\t\twhile ( j-- ) {\n\t\t\tresults.splice( duplicates[ j ], 1 );\n\t\t}\n\t}\n\n\t// Clear input after sorting to release objects\n\t// See https://github.com/jquery/sizzle/pull/225\n\tsortInput = null;\n\n\treturn results;\n};\n\n/**\n * Utility function for retrieving the text value of an array of DOM nodes\n * @param {Array|Element} elem\n */\ngetText = Sizzle.getText = function( elem ) {\n\tvar node,\n\t\tret = \"\",\n\t\ti = 0,\n\t\tnodeType = elem.nodeType;\n\n\tif ( !nodeType ) {\n\t\t// If no nodeType, this is expected to be an array\n\t\twhile ( (node = elem[i++]) ) {\n\t\t\t// Do not traverse comment nodes\n\t\t\tret += getText( node );\n\t\t}\n\t} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {\n\t\t// Use textContent for elements\n\t\t// innerText usage removed for consistency of new lines (jQuery #11153)\n\t\tif ( typeof elem.textContent === \"string\" ) {\n\t\t\treturn elem.textContent;\n\t\t} else {\n\t\t\t// Traverse its children\n\t\t\tfor ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {\n\t\t\t\tret += getText( elem );\n\t\t\t}\n\t\t}\n\t} else if ( nodeType === 3 || nodeType === 4 ) {\n\t\treturn elem.nodeValue;\n\t}\n\t// Do not include comment or processing instruction nodes\n\n\treturn ret;\n};\n\nExpr = Sizzle.selectors = {\n\n\t// Can be adjusted by the user\n\tcacheLength: 50,\n\n\tcreatePseudo: markFunction,\n\n\tmatch: matchExpr,\n\n\tattrHandle: {},\n\n\tfind: {},\n\n\trelative: {\n\t\t\">\": { dir: \"parentNode\", first: true },\n\t\t\" \": { dir: \"parentNode\" },\n\t\t\"+\": { dir: \"previousSibling\", first: true },\n\t\t\"~\": { dir: \"previousSibling\" }\n\t},\n\n\tpreFilter: {\n\t\t\"ATTR\": function( match ) {\n\t\t\tmatch[1] = match[1].replace( runescape, funescape );\n\n\t\t\t// Move the given value to match[3] whether quoted or unquoted\n\t\t\tmatch[3] = ( match[3] || match[4] || match[5] || \"\" ).replace( runescape, funescape );\n\n\t\t\tif ( match[2] === \"~=\" ) {\n\t\t\t\tmatch[3] = \" \" + match[3] + \" \";\n\t\t\t}\n\n\t\t\treturn match.slice( 0, 4 );\n\t\t},\n\n\t\t\"CHILD\": function( match ) {\n\t\t\t/* matches from matchExpr[\"CHILD\"]\n\t\t\t\t1 type (only|nth|...)\n\t\t\t\t2 what (child|of-type)\n\t\t\t\t3 argument (even|odd|\\d*|\\d*n([+-]\\d+)?|...)\n\t\t\t\t4 xn-component of xn+y argument ([+-]?\\d*n|)\n\t\t\t\t5 sign of xn-component\n\t\t\t\t6 x of xn-component\n\t\t\t\t7 sign of y-component\n\t\t\t\t8 y of y-component\n\t\t\t*/\n\t\t\tmatch[1] = match[1].toLowerCase();\n\n\t\t\tif ( match[1].slice( 0, 3 ) === \"nth\" ) {\n\t\t\t\t// nth-* requires argument\n\t\t\t\tif ( !match[3] ) {\n\t\t\t\t\tSizzle.error( match[0] );\n\t\t\t\t}\n\n\t\t\t\t// numeric x and y parameters for Expr.filter.CHILD\n\t\t\t\t// remember that false/true cast respectively to 0/1\n\t\t\t\tmatch[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === \"even\" || match[3] === \"odd\" ) );\n\t\t\t\tmatch[5] = +( ( match[7] + match[8] ) || match[3] === \"odd\" );\n\n\t\t\t// other types prohibit arguments\n\t\t\t} else if ( match[3] ) {\n\t\t\t\tSizzle.error( match[0] );\n\t\t\t}\n\n\t\t\treturn match;\n\t\t},\n\n\t\t\"PSEUDO\": function( match ) {\n\t\t\tvar excess,\n\t\t\t\tunquoted = !match[6] && match[2];\n\n\t\t\tif ( matchExpr[\"CHILD\"].test( match[0] ) ) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\t// Accept quoted arguments as-is\n\t\t\tif ( match[3] ) {\n\t\t\t\tmatch[2] = match[4] || match[5] || \"\";\n\n\t\t\t// Strip excess characters from unquoted arguments\n\t\t\t} else if ( unquoted && rpseudo.test( unquoted ) &&\n\t\t\t\t// Get excess from tokenize (recursively)\n\t\t\t\t(excess = tokenize( unquoted, true )) &&\n\t\t\t\t// advance to the next closing parenthesis\n\t\t\t\t(excess = unquoted.indexOf( \")\", unquoted.length - excess ) - unquoted.length) ) {\n\n\t\t\t\t// excess is a negative index\n\t\t\t\tmatch[0] = match[0].slice( 0, excess );\n\t\t\t\tmatch[2] = unquoted.slice( 0, excess );\n\t\t\t}\n\n\t\t\t// Return only captures needed by the pseudo filter method (type and argument)\n\t\t\treturn match.slice( 0, 3 );\n\t\t}\n\t},\n\n\tfilter: {\n\n\t\t\"TAG\": function( nodeNameSelector ) {\n\t\t\tvar nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();\n\t\t\treturn nodeNameSelector === \"*\" ?\n\t\t\t\tfunction() { return true; } :\n\t\t\t\tfunction( elem ) {\n\t\t\t\t\treturn elem.nodeName && elem.nodeName.toLowerCase() === nodeName;\n\t\t\t\t};\n\t\t},\n\n\t\t\"CLASS\": function( className ) {\n\t\t\tvar pattern = classCache[ className + \" \" ];\n\n\t\t\treturn pattern ||\n\t\t\t\t(pattern = new RegExp( \"(^|\" + whitespace + \")\" + className + \"(\" + whitespace + \"|$)\" )) &&\n\t\t\t\tclassCache( className, function( elem ) {\n\t\t\t\t\treturn pattern.test( typeof elem.className === \"string\" && elem.className || typeof elem.getAttribute !== \"undefined\" && elem.getAttribute(\"class\") || \"\" );\n\t\t\t\t});\n\t\t},\n\n\t\t\"ATTR\": function( name, operator, check ) {\n\t\t\treturn function( elem ) {\n\t\t\t\tvar result = Sizzle.attr( elem, name );\n\n\t\t\t\tif ( result == null ) {\n\t\t\t\t\treturn operator === \"!=\";\n\t\t\t\t}\n\t\t\t\tif ( !operator ) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tresult += \"\";\n\n\t\t\t\treturn operator === \"=\" ? result === check :\n\t\t\t\t\toperator === \"!=\" ? result !== check :\n\t\t\t\t\toperator === \"^=\" ? check && result.indexOf( check ) === 0 :\n\t\t\t\t\toperator === \"*=\" ? check && result.indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"$=\" ? check && result.slice( -check.length ) === check :\n\t\t\t\t\toperator === \"~=\" ? ( \" \" + result.replace( rwhitespace, \" \" ) + \" \" ).indexOf( check ) > -1 :\n\t\t\t\t\toperator === \"|=\" ? result === check || result.slice( 0, check.length + 1 ) === check + \"-\" :\n\t\t\t\t\tfalse;\n\t\t\t};\n\t\t},\n\n\t\t\"CHILD\": function( type, what, argument, first, last ) {\n\t\t\tvar simple = type.slice( 0, 3 ) !== \"nth\",\n\t\t\t\tforward = type.slice( -4 ) !== \"last\",\n\t\t\t\tofType = what === \"of-type\";\n\n\t\t\treturn first === 1 && last === 0 ?\n\n\t\t\t\t// Shortcut for :nth-*(n)\n\t\t\t\tfunction( elem ) {\n\t\t\t\t\treturn !!elem.parentNode;\n\t\t\t\t} :\n\n\t\t\t\tfunction( elem, context, xml ) {\n\t\t\t\t\tvar cache, uniqueCache, outerCache, node, nodeIndex, start,\n\t\t\t\t\t\tdir = simple !== forward ? \"nextSibling\" : \"previousSibling\",\n\t\t\t\t\t\tparent = elem.parentNode,\n\t\t\t\t\t\tname = ofType && elem.nodeName.toLowerCase(),\n\t\t\t\t\t\tuseCache = !xml && !ofType,\n\t\t\t\t\t\tdiff = false;\n\n\t\t\t\t\tif ( parent ) {\n\n\t\t\t\t\t\t// :(first|last|only)-(child|of-type)\n\t\t\t\t\t\tif ( simple ) {\n\t\t\t\t\t\t\twhile ( dir ) {\n\t\t\t\t\t\t\t\tnode = elem;\n\t\t\t\t\t\t\t\twhile ( (node = node[ dir ]) ) {\n\t\t\t\t\t\t\t\t\tif ( ofType ?\n\t\t\t\t\t\t\t\t\t\tnode.nodeName.toLowerCase() === name :\n\t\t\t\t\t\t\t\t\t\tnode.nodeType === 1 ) {\n\n\t\t\t\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t// Reverse direction for :only-* (if we haven't yet done so)\n\t\t\t\t\t\t\t\tstart = dir = type === \"only\" && !start && \"nextSibling\";\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tstart = [ forward ? parent.firstChild : parent.lastChild ];\n\n\t\t\t\t\t\t// non-xml :nth-child(...) stores cache data on `parent`\n\t\t\t\t\t\tif ( forward && useCache ) {\n\n\t\t\t\t\t\t\t// Seek `elem` from a previously-cached index\n\n\t\t\t\t\t\t\t// ...in a gzip-friendly way\n\t\t\t\t\t\t\tnode = parent;\n\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\tcache = uniqueCache[ type ] || [];\n\t\t\t\t\t\t\tnodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];\n\t\t\t\t\t\t\tdiff = nodeIndex && cache[ 2 ];\n\t\t\t\t\t\t\tnode = nodeIndex && parent.childNodes[ nodeIndex ];\n\n\t\t\t\t\t\t\twhile ( (node = ++nodeIndex && node && node[ dir ] ||\n\n\t\t\t\t\t\t\t\t// Fallback to seeking `elem` from the start\n\t\t\t\t\t\t\t\t(diff = nodeIndex = 0) || start.pop()) ) {\n\n\t\t\t\t\t\t\t\t// When found, cache indexes on `parent` and break\n\t\t\t\t\t\t\t\tif ( node.nodeType === 1 && ++diff && node === elem ) {\n\t\t\t\t\t\t\t\t\tuniqueCache[ type ] = [ dirruns, nodeIndex, diff ];\n\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// Use previously-cached element index if available\n\t\t\t\t\t\t\tif ( useCache ) {\n\t\t\t\t\t\t\t\t// ...in a gzip-friendly way\n\t\t\t\t\t\t\t\tnode = elem;\n\t\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\t\tcache = uniqueCache[ type ] || [];\n\t\t\t\t\t\t\t\tnodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];\n\t\t\t\t\t\t\t\tdiff = nodeIndex;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// xml :nth-child(...)\n\t\t\t\t\t\t\t// or :nth-last-child(...) or :nth(-last)?-of-type(...)\n\t\t\t\t\t\t\tif ( diff === false ) {\n\t\t\t\t\t\t\t\t// Use the same loop as above to seek `elem` from the start\n\t\t\t\t\t\t\t\twhile ( (node = ++nodeIndex && node && node[ dir ] ||\n\t\t\t\t\t\t\t\t\t(diff = nodeIndex = 0) || start.pop()) ) {\n\n\t\t\t\t\t\t\t\t\tif ( ( ofType ?\n\t\t\t\t\t\t\t\t\t\tnode.nodeName.toLowerCase() === name :\n\t\t\t\t\t\t\t\t\t\tnode.nodeType === 1 ) &&\n\t\t\t\t\t\t\t\t\t\t++diff ) {\n\n\t\t\t\t\t\t\t\t\t\t// Cache the index of each encountered element\n\t\t\t\t\t\t\t\t\t\tif ( useCache ) {\n\t\t\t\t\t\t\t\t\t\t\touterCache = node[ expando ] || (node[ expando ] = {});\n\n\t\t\t\t\t\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\t\t\t\t\t\tuniqueCache = outerCache[ node.uniqueID ] ||\n\t\t\t\t\t\t\t\t\t\t\t\t(outerCache[ node.uniqueID ] = {});\n\n\t\t\t\t\t\t\t\t\t\t\tuniqueCache[ type ] = [ dirruns, diff ];\n\t\t\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\t\t\tif ( node === elem ) {\n\t\t\t\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Incorporate the offset, then check against cycle size\n\t\t\t\t\t\tdiff -= last;\n\t\t\t\t\t\treturn diff === first || ( diff % first === 0 && diff / first >= 0 );\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t},\n\n\t\t\"PSEUDO\": function( pseudo, argument ) {\n\t\t\t// pseudo-class names are case-insensitive\n\t\t\t// http://www.w3.org/TR/selectors/#pseudo-classes\n\t\t\t// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters\n\t\t\t// Remember that setFilters inherits from pseudos\n\t\t\tvar args,\n\t\t\t\tfn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||\n\t\t\t\t\tSizzle.error( \"unsupported pseudo: \" + pseudo );\n\n\t\t\t// The user may use createPseudo to indicate that\n\t\t\t// arguments are needed to create the filter function\n\t\t\t// just as Sizzle does\n\t\t\tif ( fn[ expando ] ) {\n\t\t\t\treturn fn( argument );\n\t\t\t}\n\n\t\t\t// But maintain support for old signatures\n\t\t\tif ( fn.length > 1 ) {\n\t\t\t\targs = [ pseudo, pseudo, \"\", argument ];\n\t\t\t\treturn Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?\n\t\t\t\t\tmarkFunction(function( seed, matches ) {\n\t\t\t\t\t\tvar idx,\n\t\t\t\t\t\t\tmatched = fn( seed, argument ),\n\t\t\t\t\t\t\ti = matched.length;\n\t\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\t\tidx = indexOf( seed, matched[i] );\n\t\t\t\t\t\t\tseed[ idx ] = !( matches[ idx ] = matched[i] );\n\t\t\t\t\t\t}\n\t\t\t\t\t}) :\n\t\t\t\t\tfunction( elem ) {\n\t\t\t\t\t\treturn fn( elem, 0, args );\n\t\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn fn;\n\t\t}\n\t},\n\n\tpseudos: {\n\t\t// Potentially complex pseudos\n\t\t\"not\": markFunction(function( selector ) {\n\t\t\t// Trim the selector passed to compile\n\t\t\t// to avoid treating leading and trailing\n\t\t\t// spaces as combinators\n\t\t\tvar input = [],\n\t\t\t\tresults = [],\n\t\t\t\tmatcher = compile( selector.replace( rtrim, \"$1\" ) );\n\n\t\t\treturn matcher[ expando ] ?\n\t\t\t\tmarkFunction(function( seed, matches, context, xml ) {\n\t\t\t\t\tvar elem,\n\t\t\t\t\t\tunmatched = matcher( seed, null, xml, [] ),\n\t\t\t\t\t\ti = seed.length;\n\n\t\t\t\t\t// Match elements unmatched by `matcher`\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = unmatched[i]) ) {\n\t\t\t\t\t\t\tseed[i] = !(matches[i] = elem);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}) :\n\t\t\t\tfunction( elem, context, xml ) {\n\t\t\t\t\tinput[0] = elem;\n\t\t\t\t\tmatcher( input, null, xml, results );\n\t\t\t\t\t// Don't keep the element (issue #299)\n\t\t\t\t\tinput[0] = null;\n\t\t\t\t\treturn !results.pop();\n\t\t\t\t};\n\t\t}),\n\n\t\t\"has\": markFunction(function( selector ) {\n\t\t\treturn function( elem ) {\n\t\t\t\treturn Sizzle( selector, elem ).length > 0;\n\t\t\t};\n\t\t}),\n\n\t\t\"contains\": markFunction(function( text ) {\n\t\t\ttext = text.replace( runescape, funescape );\n\t\t\treturn function( elem ) {\n\t\t\t\treturn ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1;\n\t\t\t};\n\t\t}),\n\n\t\t// \"Whether an element is represented by a :lang() selector\n\t\t// is based solely on the element's language value\n\t\t// being equal to the identifier C,\n\t\t// or beginning with the identifier C immediately followed by \"-\".\n\t\t// The matching of C against the element's language value is performed case-insensitively.\n\t\t// The identifier C does not have to be a valid language name.\"\n\t\t// http://www.w3.org/TR/selectors/#lang-pseudo\n\t\t\"lang\": markFunction( function( lang ) {\n\t\t\t// lang value must be a valid identifier\n\t\t\tif ( !ridentifier.test(lang || \"\") ) {\n\t\t\t\tSizzle.error( \"unsupported lang: \" + lang );\n\t\t\t}\n\t\t\tlang = lang.replace( runescape, funescape ).toLowerCase();\n\t\t\treturn function( elem ) {\n\t\t\t\tvar elemLang;\n\t\t\t\tdo {\n\t\t\t\t\tif ( (elemLang = documentIsHTML ?\n\t\t\t\t\t\telem.lang :\n\t\t\t\t\t\telem.getAttribute(\"xml:lang\") || elem.getAttribute(\"lang\")) ) {\n\n\t\t\t\t\t\telemLang = elemLang.toLowerCase();\n\t\t\t\t\t\treturn elemLang === lang || elemLang.indexOf( lang + \"-\" ) === 0;\n\t\t\t\t\t}\n\t\t\t\t} while ( (elem = elem.parentNode) && elem.nodeType === 1 );\n\t\t\t\treturn false;\n\t\t\t};\n\t\t}),\n\n\t\t// Miscellaneous\n\t\t\"target\": function( elem ) {\n\t\t\tvar hash = window.location && window.location.hash;\n\t\t\treturn hash && hash.slice( 1 ) === elem.id;\n\t\t},\n\n\t\t\"root\": function( elem ) {\n\t\t\treturn elem === docElem;\n\t\t},\n\n\t\t\"focus\": function( elem ) {\n\t\t\treturn elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex);\n\t\t},\n\n\t\t// Boolean properties\n\t\t\"enabled\": createDisabledPseudo( false ),\n\t\t\"disabled\": createDisabledPseudo( true ),\n\n\t\t\"checked\": function( elem ) {\n\t\t\t// In CSS3, :checked should return both checked and selected elements\n\t\t\t// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked\n\t\t\tvar nodeName = elem.nodeName.toLowerCase();\n\t\t\treturn (nodeName === \"input\" && !!elem.checked) || (nodeName === \"option\" && !!elem.selected);\n\t\t},\n\n\t\t\"selected\": function( elem ) {\n\t\t\t// Accessing this property makes selected-by-default\n\t\t\t// options in Safari work properly\n\t\t\tif ( elem.parentNode ) {\n\t\t\t\telem.parentNode.selectedIndex;\n\t\t\t}\n\n\t\t\treturn elem.selected === true;\n\t\t},\n\n\t\t// Contents\n\t\t\"empty\": function( elem ) {\n\t\t\t// http://www.w3.org/TR/selectors/#empty-pseudo\n\t\t\t// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),\n\t\t\t// but not by others (comment: 8; processing instruction: 7; etc.)\n\t\t\t// nodeType < 6 works because attributes (2) do not appear as children\n\t\t\tfor ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {\n\t\t\t\tif ( elem.nodeType < 6 ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn true;\n\t\t},\n\n\t\t\"parent\": function( elem ) {\n\t\t\treturn !Expr.pseudos[\"empty\"]( elem );\n\t\t},\n\n\t\t// Element/input types\n\t\t\"header\": function( elem ) {\n\t\t\treturn rheader.test( elem.nodeName );\n\t\t},\n\n\t\t\"input\": function( elem ) {\n\t\t\treturn rinputs.test( elem.nodeName );\n\t\t},\n\n\t\t\"button\": function( elem ) {\n\t\t\tvar name = elem.nodeName.toLowerCase();\n\t\t\treturn name === \"input\" && elem.type === \"button\" || name === \"button\";\n\t\t},\n\n\t\t\"text\": function( elem ) {\n\t\t\tvar attr;\n\t\t\treturn elem.nodeName.toLowerCase() === \"input\" &&\n\t\t\t\telem.type === \"text\" &&\n\n\t\t\t\t// Support: IE<8\n\t\t\t\t// New HTML5 attribute values (e.g., \"search\") appear with elem.type === \"text\"\n\t\t\t\t( (attr = elem.getAttribute(\"type\")) == null || attr.toLowerCase() === \"text\" );\n\t\t},\n\n\t\t// Position-in-collection\n\t\t\"first\": createPositionalPseudo(function() {\n\t\t\treturn [ 0 ];\n\t\t}),\n\n\t\t\"last\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\treturn [ length - 1 ];\n\t\t}),\n\n\t\t\"eq\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\treturn [ argument < 0 ? argument + length : argument ];\n\t\t}),\n\n\t\t\"even\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tvar i = 0;\n\t\t\tfor ( ; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"odd\": createPositionalPseudo(function( matchIndexes, length ) {\n\t\t\tvar i = 1;\n\t\t\tfor ( ; i < length; i += 2 ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"lt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tvar i = argument < 0 ? argument + length : argument;\n\t\t\tfor ( ; --i >= 0; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t}),\n\n\t\t\"gt\": createPositionalPseudo(function( matchIndexes, length, argument ) {\n\t\t\tvar i = argument < 0 ? argument + length : argument;\n\t\t\tfor ( ; ++i < length; ) {\n\t\t\t\tmatchIndexes.push( i );\n\t\t\t}\n\t\t\treturn matchIndexes;\n\t\t})\n\t}\n};\n\nExpr.pseudos[\"nth\"] = Expr.pseudos[\"eq\"];\n\n// Add button/input type pseudos\nfor ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {\n\tExpr.pseudos[ i ] = createInputPseudo( i );\n}\nfor ( i in { submit: true, reset: true } ) {\n\tExpr.pseudos[ i ] = createButtonPseudo( i );\n}\n\n// Easy API for creating new setFilters\nfunction setFilters() {}\nsetFilters.prototype = Expr.filters = Expr.pseudos;\nExpr.setFilters = new setFilters();\n\ntokenize = Sizzle.tokenize = function( selector, parseOnly ) {\n\tvar matched, match, tokens, type,\n\t\tsoFar, groups, preFilters,\n\t\tcached = tokenCache[ selector + \" \" ];\n\n\tif ( cached ) {\n\t\treturn parseOnly ? 0 : cached.slice( 0 );\n\t}\n\n\tsoFar = selector;\n\tgroups = [];\n\tpreFilters = Expr.preFilter;\n\n\twhile ( soFar ) {\n\n\t\t// Comma and first run\n\t\tif ( !matched || (match = rcomma.exec( soFar )) ) {\n\t\t\tif ( match ) {\n\t\t\t\t// Don't consume trailing commas as valid\n\t\t\t\tsoFar = soFar.slice( match[0].length ) || soFar;\n\t\t\t}\n\t\t\tgroups.push( (tokens = []) );\n\t\t}\n\n\t\tmatched = false;\n\n\t\t// Combinators\n\t\tif ( (match = rcombinators.exec( soFar )) ) {\n\t\t\tmatched = match.shift();\n\t\t\ttokens.push({\n\t\t\t\tvalue: matched,\n\t\t\t\t// Cast descendant combinators to space\n\t\t\t\ttype: match[0].replace( rtrim, \" \" )\n\t\t\t});\n\t\t\tsoFar = soFar.slice( matched.length );\n\t\t}\n\n\t\t// Filters\n\t\tfor ( type in Expr.filter ) {\n\t\t\tif ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] ||\n\t\t\t\t(match = preFilters[ type ]( match ))) ) {\n\t\t\t\tmatched = match.shift();\n\t\t\t\ttokens.push({\n\t\t\t\t\tvalue: matched,\n\t\t\t\t\ttype: type,\n\t\t\t\t\tmatches: match\n\t\t\t\t});\n\t\t\t\tsoFar = soFar.slice( matched.length );\n\t\t\t}\n\t\t}\n\n\t\tif ( !matched ) {\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Return the length of the invalid excess\n\t// if we're just parsing\n\t// Otherwise, throw an error or return tokens\n\treturn parseOnly ?\n\t\tsoFar.length :\n\t\tsoFar ?\n\t\t\tSizzle.error( selector ) :\n\t\t\t// Cache the tokens\n\t\t\ttokenCache( selector, groups ).slice( 0 );\n};\n\nfunction toSelector( tokens ) {\n\tvar i = 0,\n\t\tlen = tokens.length,\n\t\tselector = \"\";\n\tfor ( ; i < len; i++ ) {\n\t\tselector += tokens[i].value;\n\t}\n\treturn selector;\n}\n\nfunction addCombinator( matcher, combinator, base ) {\n\tvar dir = combinator.dir,\n\t\tskip = combinator.next,\n\t\tkey = skip || dir,\n\t\tcheckNonElements = base && key === \"parentNode\",\n\t\tdoneName = done++;\n\n\treturn combinator.first ?\n\t\t// Check against closest ancestor/preceding element\n\t\tfunction( elem, context, xml ) {\n\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\treturn matcher( elem, context, xml );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t} :\n\n\t\t// Check against all ancestor/preceding elements\n\t\tfunction( elem, context, xml ) {\n\t\t\tvar oldCache, uniqueCache, outerCache,\n\t\t\t\tnewCache = [ dirruns, doneName ];\n\n\t\t\t// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching\n\t\t\tif ( xml ) {\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\t\tif ( matcher( elem, context, xml ) ) {\n\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\twhile ( (elem = elem[ dir ]) ) {\n\t\t\t\t\tif ( elem.nodeType === 1 || checkNonElements ) {\n\t\t\t\t\t\touterCache = elem[ expando ] || (elem[ expando ] = {});\n\n\t\t\t\t\t\t// Support: IE <9 only\n\t\t\t\t\t\t// Defend against cloned attroperties (jQuery gh-1709)\n\t\t\t\t\t\tuniqueCache = outerCache[ elem.uniqueID ] || (outerCache[ elem.uniqueID ] = {});\n\n\t\t\t\t\t\tif ( skip && skip === elem.nodeName.toLowerCase() ) {\n\t\t\t\t\t\t\telem = elem[ dir ] || elem;\n\t\t\t\t\t\t} else if ( (oldCache = uniqueCache[ key ]) &&\n\t\t\t\t\t\t\toldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {\n\n\t\t\t\t\t\t\t// Assign to newCache so results back-propagate to previous elements\n\t\t\t\t\t\t\treturn (newCache[ 2 ] = oldCache[ 2 ]);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// Reuse newcache so results back-propagate to previous elements\n\t\t\t\t\t\t\tuniqueCache[ key ] = newCache;\n\n\t\t\t\t\t\t\t// A match means we're done; a fail means we have to keep checking\n\t\t\t\t\t\t\tif ( (newCache[ 2 ] = matcher( elem, context, xml )) ) {\n\t\t\t\t\t\t\t\treturn true;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false;\n\t\t};\n}\n\nfunction elementMatcher( matchers ) {\n\treturn matchers.length > 1 ?\n\t\tfunction( elem, context, xml ) {\n\t\t\tvar i = matchers.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( !matchers[i]( elem, context, xml ) ) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn true;\n\t\t} :\n\t\tmatchers[0];\n}\n\nfunction multipleContexts( selector, contexts, results ) {\n\tvar i = 0,\n\t\tlen = contexts.length;\n\tfor ( ; i < len; i++ ) {\n\t\tSizzle( selector, contexts[i], results );\n\t}\n\treturn results;\n}\n\nfunction condense( unmatched, map, filter, context, xml ) {\n\tvar elem,\n\t\tnewUnmatched = [],\n\t\ti = 0,\n\t\tlen = unmatched.length,\n\t\tmapped = map != null;\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (elem = unmatched[i]) ) {\n\t\t\tif ( !filter || filter( elem, context, xml ) ) {\n\t\t\t\tnewUnmatched.push( elem );\n\t\t\t\tif ( mapped ) {\n\t\t\t\t\tmap.push( i );\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\treturn newUnmatched;\n}\n\nfunction setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {\n\tif ( postFilter && !postFilter[ expando ] ) {\n\t\tpostFilter = setMatcher( postFilter );\n\t}\n\tif ( postFinder && !postFinder[ expando ] ) {\n\t\tpostFinder = setMatcher( postFinder, postSelector );\n\t}\n\treturn markFunction(function( seed, results, context, xml ) {\n\t\tvar temp, i, elem,\n\t\t\tpreMap = [],\n\t\t\tpostMap = [],\n\t\t\tpreexisting = results.length,\n\n\t\t\t// Get initial elements from seed or context\n\t\t\telems = seed || multipleContexts( selector || \"*\", context.nodeType ? [ context ] : context, [] ),\n\n\t\t\t// Prefilter to get matcher input, preserving a map for seed-results synchronization\n\t\t\tmatcherIn = preFilter && ( seed || !selector ) ?\n\t\t\t\tcondense( elems, preMap, preFilter, context, xml ) :\n\t\t\t\telems,\n\n\t\t\tmatcherOut = matcher ?\n\t\t\t\t// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,\n\t\t\t\tpostFinder || ( seed ? preFilter : preexisting || postFilter ) ?\n\n\t\t\t\t\t// ...intermediate processing is necessary\n\t\t\t\t\t[] :\n\n\t\t\t\t\t// ...otherwise use results directly\n\t\t\t\t\tresults :\n\t\t\t\tmatcherIn;\n\n\t\t// Find primary matches\n\t\tif ( matcher ) {\n\t\t\tmatcher( matcherIn, matcherOut, context, xml );\n\t\t}\n\n\t\t// Apply postFilter\n\t\tif ( postFilter ) {\n\t\t\ttemp = condense( matcherOut, postMap );\n\t\t\tpostFilter( temp, [], context, xml );\n\n\t\t\t// Un-match failing elements by moving them back to matcherIn\n\t\t\ti = temp.length;\n\t\t\twhile ( i-- ) {\n\t\t\t\tif ( (elem = temp[i]) ) {\n\t\t\t\t\tmatcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif ( seed ) {\n\t\t\tif ( postFinder || preFilter ) {\n\t\t\t\tif ( postFinder ) {\n\t\t\t\t\t// Get the final matcherOut by condensing this intermediate into postFinder contexts\n\t\t\t\t\ttemp = [];\n\t\t\t\t\ti = matcherOut.length;\n\t\t\t\t\twhile ( i-- ) {\n\t\t\t\t\t\tif ( (elem = matcherOut[i]) ) {\n\t\t\t\t\t\t\t// Restore matcherIn since elem is not yet a final match\n\t\t\t\t\t\t\ttemp.push( (matcherIn[i] = elem) );\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tpostFinder( null, (matcherOut = []), temp, xml );\n\t\t\t\t}\n\n\t\t\t\t// Move matched elements from seed to results to keep them synchronized\n\t\t\t\ti = matcherOut.length;\n\t\t\t\twhile ( i-- ) {\n\t\t\t\t\tif ( (elem = matcherOut[i]) &&\n\t\t\t\t\t\t(temp = postFinder ? indexOf( seed, elem ) : preMap[i]) > -1 ) {\n\n\t\t\t\t\t\tseed[temp] = !(results[temp] = elem);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t// Add elements to results, through postFinder if defined\n\t\t} else {\n\t\t\tmatcherOut = condense(\n\t\t\t\tmatcherOut === results ?\n\t\t\t\t\tmatcherOut.splice( preexisting, matcherOut.length ) :\n\t\t\t\t\tmatcherOut\n\t\t\t);\n\t\t\tif ( postFinder ) {\n\t\t\t\tpostFinder( null, results, matcherOut, xml );\n\t\t\t} else {\n\t\t\t\tpush.apply( results, matcherOut );\n\t\t\t}\n\t\t}\n\t});\n}\n\nfunction matcherFromTokens( tokens ) {\n\tvar checkContext, matcher, j,\n\t\tlen = tokens.length,\n\t\tleadingRelative = Expr.relative[ tokens[0].type ],\n\t\timplicitRelative = leadingRelative || Expr.relative[\" \"],\n\t\ti = leadingRelative ? 1 : 0,\n\n\t\t// The foundational matcher ensures that elements are reachable from top-level context(s)\n\t\tmatchContext = addCombinator( function( elem ) {\n\t\t\treturn elem === checkContext;\n\t\t}, implicitRelative, true ),\n\t\tmatchAnyContext = addCombinator( function( elem ) {\n\t\t\treturn indexOf( checkContext, elem ) > -1;\n\t\t}, implicitRelative, true ),\n\t\tmatchers = [ function( elem, context, xml ) {\n\t\t\tvar ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (\n\t\t\t\t(checkContext = context).nodeType ?\n\t\t\t\t\tmatchContext( elem, context, xml ) :\n\t\t\t\t\tmatchAnyContext( elem, context, xml ) );\n\t\t\t// Avoid hanging onto element (issue #299)\n\t\t\tcheckContext = null;\n\t\t\treturn ret;\n\t\t} ];\n\n\tfor ( ; i < len; i++ ) {\n\t\tif ( (matcher = Expr.relative[ tokens[i].type ]) ) {\n\t\t\tmatchers = [ addCombinator(elementMatcher( matchers ), matcher) ];\n\t\t} else {\n\t\t\tmatcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches );\n\n\t\t\t// Return special upon seeing a positional matcher\n\t\t\tif ( matcher[ expando ] ) {\n\t\t\t\t// Find the next relative operator (if any) for proper handling\n\t\t\t\tj = ++i;\n\t\t\t\tfor ( ; j < len; j++ ) {\n\t\t\t\t\tif ( Expr.relative[ tokens[j].type ] ) {\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn setMatcher(\n\t\t\t\t\ti > 1 && elementMatcher( matchers ),\n\t\t\t\t\ti > 1 && toSelector(\n\t\t\t\t\t\t// If the preceding token was a descendant combinator, insert an implicit any-element `*`\n\t\t\t\t\t\ttokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === \" \" ? \"*\" : \"\" })\n\t\t\t\t\t).replace( rtrim, \"$1\" ),\n\t\t\t\t\tmatcher,\n\t\t\t\t\ti < j && matcherFromTokens( tokens.slice( i, j ) ),\n\t\t\t\t\tj < len && matcherFromTokens( (tokens = tokens.slice( j )) ),\n\t\t\t\t\tj < len && toSelector( tokens )\n\t\t\t\t);\n\t\t\t}\n\t\t\tmatchers.push( matcher );\n\t\t}\n\t}\n\n\treturn elementMatcher( matchers );\n}\n\nfunction matcherFromGroupMatchers( elementMatchers, setMatchers ) {\n\tvar bySet = setMatchers.length > 0,\n\t\tbyElement = elementMatchers.length > 0,\n\t\tsuperMatcher = function( seed, context, xml, results, outermost ) {\n\t\t\tvar elem, j, matcher,\n\t\t\t\tmatchedCount = 0,\n\t\t\t\ti = \"0\",\n\t\t\t\tunmatched = seed && [],\n\t\t\t\tsetMatched = [],\n\t\t\t\tcontextBackup = outermostContext,\n\t\t\t\t// We must always have either seed elements or outermost context\n\t\t\t\telems = seed || byElement && Expr.find[\"TAG\"]( \"*\", outermost ),\n\t\t\t\t// Use integer dirruns iff this is the outermost matcher\n\t\t\t\tdirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1),\n\t\t\t\tlen = elems.length;\n\n\t\t\tif ( outermost ) {\n\t\t\t\toutermostContext = context === document || context || outermost;\n\t\t\t}\n\n\t\t\t// Add elements passing elementMatchers directly to results\n\t\t\t// Support: IE<9, Safari\n\t\t\t// Tolerate NodeList properties (IE: \"length\"; Safari: