pax_global_header00006660000000000000000000000064140476406170014523gustar00rootroot0000000000000052 comment=260e39cb9e360875337c9a86917370585dfeb4d6 sh-1.14.2/000077500000000000000000000000001404764061700122225ustar00rootroot00000000000000sh-1.14.2/.coveragerc000066400000000000000000000002071404764061700143420ustar00rootroot00000000000000[run] branch = True source = sh.py [report] exclude_lines = pragma: no cover if __name__ == .__main__.: def __repr__ sh-1.14.2/.github/000077500000000000000000000000001404764061700135625ustar00rootroot00000000000000sh-1.14.2/.github/FUNDING.yml000066400000000000000000000012031404764061700153730ustar00rootroot00000000000000# These are supported funding model platforms github: [amoffat] patreon: # Replace with a single Patreon username open_collective: # Replace with a single Open Collective username ko_fi: # Replace with a single Ko-fi username tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] sh-1.14.2/.gitignore000066400000000000000000000000451404764061700142110ustar00rootroot00000000000000__pycache__/ *.py[co] .tox .coverage sh-1.14.2/.travis.yml000066400000000000000000000010161404764061700143310ustar00rootroot00000000000000os: - linux language: python python: # - 2.6 No longer supported on Travis - 2.7 # - 3.3 No longer supported on Travis - 3.4 - 3.5 - 3.6 - 3.7 - 3.8 - pypy - pypy3.5 before_script: - pip install -r requirements-dev.txt script: - python sh.py travis - python -m flake8 sh.py test.py - if python -c 'import sys; sys.exit(int(not sys.version_info >= (3, 5)))' ; then python setup.py check --restructuredtext --metadata --strict ; fi after_success: - coveralls sh-1.14.2/CHANGELOG.md000066400000000000000000000366221404764061700140440ustar00rootroot00000000000000# Changelog ## 1.14.1 - 10/24/20 * bugfix where setting `_ok_code` to not include 0, but 0 was the exit code [#545](https://github.com/amoffat/sh/pull/545) ## 1.14.0 - 8/28/20 * `_env` now more lenient in accepting dictionary-like objects [#527](https://github.com/amoffat/sh/issues/527) * `None` and `False` arguments now do not pass through to underlying command [#525](https://github.com/amoffat/sh/pull/525) * Implemented `find_spec` on the fancy importer, which fixes some Python3.4+ issues [#536](https://github.com/amoffat/sh/pull/536) ## 1.13.1 - 4/28/20 * regression fix if `_fg=False` [#520](https://github.com/amoffat/sh/issues/520) ## 1.13.0 - 4/27/20 * minor Travis CI fixes [#492](https://github.com/amoffat/sh/pull/492) * bugfix for boolean long options not respecting `_long_prefix` [#488](https://github.com/amoffat/sh/pull/488) * fix deprecation warning on Python 3.6 regexes [#482](https://github.com/amoffat/sh/pull/482) * `_pass_fds` and `_close_fds` special kwargs for controlling file descriptor inheritance in child. * more efficiently closing inherited fds [#406](https://github.com/amoffat/sh/issues/406) * bugfix where passing invalid dictionary to `_env` will cause a mysterious child 255 exit code. [#497](https://github.com/amoffat/sh/pull/497) * bugfix where `_in` using 0 or `sys.stdin` wasn't behaving like a TTY, if it was in fact a TTY. [#514](https://github.com/amoffat/sh/issues/514) * bugfix where `help(sh)` raised an exception [#455](https://github.com/amoffat/sh/issues/455) * bugfix fixing broken interactive ssh tutorial from docs * change to automatic tty merging into a single pty if `_tty_in=True` and `_tty_out=True` * introducing `_unify_ttys`, default False, which allows explicit tty merging into single pty * contrib command for `ssh` connections requiring passwords * performance fix for polling output too fast when using `_iter` [#462](https://github.com/amoffat/sh/issues/462) * execution contexts can now be used in python shell [#466](https://github.com/amoffat/sh/pull/466) * bugfix `ErrorReturnCode` instances can now be pickled * bugfix passing empty string or `None` for `_in` hanged [#427](https://github.com/amoffat/sh/pull/427) * bugfix where passing a filename or file-like object to `_out` wasn't using os.dup2 [#449](https://github.com/amoffat/sh/issues/449) * regression make `_fg` work with `_cwd` again [#330](https://github.com/amoffat/sh/issues/330) * an invalid `_cwd` now raises a `ForkException` not an `OSError`. * AIX support [#477](https://github.com/amoffat/sh/issues/477) * added a `timeout=None` param to `RunningCommand.wait()` [#515](https://github.com/amoffat/sh/issues/515) ## 1.12.14 - 6/6/17 * bugfix for poor sleep performance [#378](https://github.com/amoffat/sh/issues/378) * allow passing raw integer file descriptors for `_out` and `_err` handlers * bugfix for when `_tee` and `_out` are used, and the `_out` is a tty or pipe [#384](https://github.com/amoffat/sh/issues/384) * bugfix where python 3.3+ detected different arg counts for bound method output callbacks [#380](https://github.com/amoffat/sh/issues/380) ## 1.12.12, 1.12.13 - 3/30/17 * pypi readme doc bugfix [PR#377](https://github.com/amoffat/sh/pull/377) ## 1.12.11 - 3/13/17 * bugfix for relative paths to `sh.Command` not expanding to absolute paths [#372](https://github.com/amoffat/sh/issues/372) * updated for python 3.6 * bugfix for SIGPIPE not being handled correctly on pipelined processes [#373](https://github.com/amoffat/sh/issues/373) ## 1.12.10 - 3/02/17 * bugfix for file descriptors over 1024 [#356](https://github.com/amoffat/sh/issues/356) * bugfix when `_err_to_out` is True and `_out` is pipe or tty [#365](https://github.com/amoffat/sh/issues/365) ## 1.12.9 - 1/04/17 * added `_bg_exc` for silencing exceptions in background threads [#350](https://github.com/amoffat/sh/pull/350) ## 1.12.8 - 12/16/16 * bugfix for patched glob.glob on python3.5 [#341](https://github.com/amoffat/sh/issues/341) ## 1.12.7 - 12/07/16 * added `_out` and `_out_bufsize` validator [#346](https://github.com/amoffat/sh/issues/346) * bugfix for internal stdout thread running when it shouldn't [#346](https://github.com/amoffat/sh/issues/346) ## 1.12.6 - 12/02/16 * regression bugfix on timeout [#344](https://github.com/amoffat/sh/issues/344) * regression bugfix on `_ok_code=None` ## 1.12.5 - 12/01/16 * further improvements on cpu usage ## 1.12.4 - 11/30/16 * regression in cpu usage [#339](https://github.com/amoffat/sh/issues/339) ## 1.12.3 - 11/29/16 * fd leak regression and fix for flawed fd leak detection test [#337](https://github.com/amoffat/sh/pull/337) ## 1.12.2 - 11/28/16 * support for `io.StringIO` in python2 ## 1.12.1 - 11/28/16 * added support for using raw file descriptors for `_in`, `_out`, and `_err` * removed `.close()`ing `_out` handler if FIFO detected ## 1.12.0 - 11/21/16 * composed commands no longer propagate `_bg` * better support for using `sys.stdin` and `sys.stdout` for `_in` and `_out` * bugfix where `which()` would not stop searching at the first valid executable found in PATH * added `_long_prefix` for programs whose long arguments start with something other than `--` [#278](https://github.com/amoffat/sh/pull/278) * added `_log_msg` for advanced configuration of log message [#311](https://github.com/amoffat/sh/pull/311) * added `sh.contrib.sudo` * added `_arg_preprocess` for advanced command wrapping * alter callable `_in` arguments to signify completion with falsy chunk * bugfix where pipes passed into `_out` or `_err` were not flushed on process end [#252](https://github.com/amoffat/sh/pull/252) * deprecated `with sh.args(**kwargs)` in favor of `sh2 = sh(**kwargs)` * made `sh.pushd` thread safe * added `.kill_group()` and `.signal_group()` methods for better process control [#237](https://github.com/amoffat/sh/pull/237) * added `new_session` special keyword argument for controlling spawned process session [#266](https://github.com/amoffat/sh/issues/266) * bugfix better handling for EINTR on system calls [#292](https://github.com/amoffat/sh/pull/292) * bugfix where with-contexts were not threadsafe [#247](https://github.com/amoffat/sh/issues/195) * `_uid` new special keyword param for specifying the user id of the process [#133](https://github.com/amoffat/sh/issues/133) * bugfix where exceptions were swallowed by processes that weren't waited on [#309](https://github.com/amoffat/sh/issues/309) * bugfix where processes that dupd their stdout/stderr to a long running child process would cause sh to hang [#310](https://github.com/amoffat/sh/issues/310) * improved logging output [#323](https://github.com/amoffat/sh/issues/323) * bugfix for python3+ where binary data was passed into a process's stdin [#325](https://github.com/amoffat/sh/issues/325) * Introduced execution contexts which allow baking of common special keyword arguments into all commands [#269](https://github.com/amoffat/sh/issues/269) * `Command` and `which` now can take an optional `paths` parameter which specifies the search paths [#226](https://github.com/amoffat/sh/issues/226) * `_preexec_fn` option for executing a function after the child process forks but before it execs [#260](https://github.com/amoffat/sh/issues/260) * `_fg` reintroduced, with limited functionality. hurrah! [#92](https://github.com/amoffat/sh/issues/92) * bugfix where a command would block if passed a fd for stdin that wasn't yet ready to read [#253](https://github.com/amoffat/sh/issues/253) * `_long_sep` can now take `None` which splits the long form arguments into individual arguments [#258](https://github.com/amoffat/sh/issues/258) * making `_piped` perform "direct" piping by default (linking fds together). this fixes memory problems [#270](https://github.com/amoffat/sh/issues/270) * bugfix where calling `next()` on an iterable process that has raised `StopIteration`, hangs [#273](https://github.com/amoffat/sh/issues/273) * `sh.cd` called with no arguments no changes into the user's home directory, like native `cd` [#275](https://github.com/amoffat/sh/issues/275) * `sh.glob` removed entirely. the rationale is correctness over hand-holding. [#279](https://github.com/amoffat/sh/issues/279) * added `_truncate_exc`, defaulting to `True`, which tells our exceptions to truncate output. * bugfix for exceptions whose messages contained unicode * `_done` callback no longer assumes you want your command put in the background. * `_done` callback is now called asynchronously in a separate thread. * `_done` callback is called regardless of exception, which is necessary in order to release held resources, for example a process pool ## 1.10 - 12/30/14 * partially applied functions with `functools.partial` have been fixed for `_out` and `_err` callbacks [#160](https://github.com/amoffat/sh/issues/160) * `_out` or `_err` being callables no longer puts the running command in the background. to achieve the previous behavior, pass `_bg=True` to your command. * deprecated `_with` contexts [#195](https://github.com/amoffat/sh/issues/195) * `_timeout_signal` allows you to specify your own signal to kill a timed-out process with. use a constant from the `signal` stdlib module. [#171](https://github.com/amoffat/sh/issues/171) * signal exceptions can now be caught by number or name. `SignalException_9 == SignalException_SIGKILL` * child processes that timeout via `_timeout` raise `sh.TimeoutException` instead of `sh.SignalExeception_9` [#172](https://github.com/amoffat/sh/issues/172) * fixed `help(sh)` from the python shell and `pydoc sh` from the command line. [#173](https://github.com/amoffat/sh/issues/173) * program names can no longer be shadowed by names that sh.py defines internally. removed the requirement of trailing underscores for programs that could have their names shadowed, like `id`. * memory optimization when a child process's stdin is a newline-delimted string and our bufsize is newlines * feature, `_done` special keyword argument that accepts a callback to be called when the command completes successfully [#185](https://github.com/amoffat/sh/issues/185) * bugfix for being unable to print a baked command in python3+ [#176](https://github.com/amoffat/sh/issues/176) * bugfix for cwd not existing and causing the child process to continue running parent process code [#202](https://github.com/amoffat/sh/issues/202) * child process is now guaranteed to exit on exception between fork and exec. * fix python2 deprecation warning when running with -3 [PR #165](https://github.com/amoffat/sh/pull/165) * bugfix where sh.py was attempting to execute directories [#196](https://github.com/amoffat/sh/issues/196), [PR #189](https://github.com/amoffat/sh/pull/189) * only backgrounded processes will ignore SIGHUP * allowed `ok_code` to take a `range` object. [#PR 210](https://github.com/amoffat/sh/pull/210/files) * added `sh.args` with context which allows overriding of all command defaults for the duration of that context. * added `sh.pushd` with context which takes a directory name and changes to that directory for the duration of that with context. [PR #206](https://github.com/amoffat/sh/pull/206) * tests now include python 3.4 if available. tests also stop on the first python that suite that fails. * SIGABRT, SIGBUS, SIGFPE, SIGILL, SIGPIPE, SIGSYS have been added to the list of signals that throw an exception [PR #201](https://github.com/amoffat/sh/pull/201) * "callable" builtin has been faked for python3.1, which lacks it. * "direct" option added to `_piped` special keyword argument, which allows sh to hand off a process's stdout fd directly to another process, instead of buffering its stdout internally, then handing it off. [#119](https://github.com/amoffat/sh/issues/119) ## 1.09 - 9/08/13 * Fixed encoding errors related to a system encoding "ascii". [#123](https://github.com/amoffat/sh/issues/123) * Added exit_code attribute to SignalException and ErrorReturnCode exception classes. [#127](https://github.com/amoffat/sh/issues/127) * Making the default behavior of spawned processes to not be explicitly killed when the parent python process ends. Also making the spawned process ignore SIGHUP. [#139](https://github.com/amoffat/sh/issues/139) * Made OSX sleep hack to apply to PY2 as well as PY3. ## 1.08 - 1/29/12 * Added SignalException class and made all commands that end terminate by a signal defined in SIGNALS_THAT_SHOULD_THROW_EXCEPTION raise it. [#91](https://github.com/amoffat/sh/issues/91) * Bugfix where CommandNotFound was not being raised if Command was created by instantiation. [#113](https://github.com/amoffat/sh/issues/113) * Bugfix for Commands that are wrapped with functools.wraps() [#121](https://github.com/amoffat/sh/issues/121] * Bugfix where input arguments were being assumed as ascii or unicode, but never as a string in a different encoding. * _long_sep keyword argument added joining together a dictionary of arguments passed in to a command * Commands can now be passed a dictionary of args, and the keys will be interpretted "raw", with no underscore-to-hyphen conversion * Reserved Python keywords can now be used as subcommands by appending an underscore `_` to them ## 1.07 - 11/21/12 * Bugfix for PyDev when `locale.getpreferredencoding()` is empty. * Fixes for IPython3 that involve `sh.` and `sh?` * Added `_tee` special keyword argument to force stdout/stderr to store internally and make available for piping data that is being redirected. * Added `_decode_errors` to be passed to all stdout/stderr decoding of a process. * Added `_no_out`, `_no_err`, and `_no_pipe` special keyword arguments. These are used for long-running processes with lots of output. * Changed custom loggers that were created for each process to fixed loggers, so there are no longer logger references laying around in the logging module after the process ends and it garbage collected. ## 1.06 - 11/10/12 * Removed old undocumented cruft of ARG1..ARGN and ARGV. * Bugfix where `logging_enabled` could not be set from the importing module. * Disabled garbage collection before fork to prevent garbage collection in child process. * Major bugfix where cyclical references were preventing process objects (and their associated stdout/stderr buffers) from being garbage collected. * Bugfix in RunningCommand and OProc loggers, which could get really huge if a command was called that had a large number of arguments. ## 1.05 - 10/20/12 * Changing status from alpha to beta. * Python 3.3 officially supported. * Documentation fix. The section on exceptions now references the fact that signals do not raise an exception, even for signals that might seem like they should, e.g. segfault. * Bugfix with Python 3.3 where importing commands from the sh namespace resulted in an error related to `__path__` * Long-form and short-form options to commands may now be given False to disable the option from being passed into the command. This is useful to pass in a boolean flag that you flip to either True or False to enable or disable some functionality at runtime. ## 1.04 - 10/07/12 * Making `Command` class resolve the `path` parameter with `which` by default instead of expecting it to be resolved before it is passed in. This change shouldn't affect backwards compatibility. * Fixing a bug when an exception is raised from a program, and the error output has non-ascii text. This didn't work in Python < 3.0, because .decode()'s default encoding is typically ascii. sh-1.14.2/LICENSE.txt000066400000000000000000000020511404764061700140430ustar00rootroot00000000000000Copyright (C) 2011-2012 by Andrew Moffat Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. sh-1.14.2/MANIFEST.in000066400000000000000000000001121404764061700137520ustar00rootroot00000000000000include CHANGELOG.md LICENSE.txt README.rst test.py global-exclude *.pyc sh-1.14.2/README.rst000066400000000000000000000050331404764061700137120ustar00rootroot00000000000000.. image:: https://raw.githubusercontent.com/amoffat/sh/master/logo-230.png :target: https://amoffat.github.com/sh :alt: Logo | .. image:: https://img.shields.io/pypi/v/sh.svg?style=flat-square :target: https://pypi.python.org/pypi/sh :alt: Version .. image:: https://img.shields.io/pypi/dm/sh.svg?style=flat-square :target: https://pypi.python.org/pypi/sh :alt: Downloads Status .. image:: https://img.shields.io/pypi/pyversions/sh.svg?style=flat-square :target: https://pypi.python.org/pypi/sh :alt: Python Versions .. image:: https://img.shields.io/travis/amoffat/sh/master.svg?style=flat-square :target: https://travis-ci.org/amoffat/sh :alt: Build Status .. image:: https://img.shields.io/coveralls/amoffat/sh.svg?style=flat-square :target: https://coveralls.io/r/amoffat/sh?branch=master :alt: Coverage Status | sh is a full-fledged subprocess replacement for Python 2.6 - 3.8, PyPy and PyPy3 that allows you to call *any* program as if it were a function: .. code:: python from sh import ifconfig print(ifconfig("eth0")) sh is *not* a collection of system commands implemented in Python. `Complete documentation here `_ Installation ============ :: $> pip install sh Support ======= * `Andrew Moffat `_ - author/maintainer * `Erik Cederstrand `_ - maintainer Developers ========== Updating the docs ----------------- Check out the `gh-pages `_ branch and follow the ``README.rst`` there. Testing ------- I've included a Docker test suite in the `docker_test_suit/` folder. To build the image, `cd` into that directory and run:: $> ./build.sh This will install ubuntu 18.04 LTS and all python versions from 2.6-3.8. Once it's done, stay in that directory and run:: $> ./run.sh This will mount your local code directory into the container and start the test suite, which will take a long time to run. If you wish to run a single test, you may pass that test to `./run.sh`:: $> ./run.sh FunctionalTests.test_unicode_arg To run a single test for a single environment:: $> ./run.sh -e 3.4 FunctionalTests.test_unicode_arg Coverage -------- First run all of the tests:: $> python sh.py test This will aggregate a ``.coverage``. You may then visualize the report with:: $> coverage report Or generate visual html files with:: $> coverage html Which will create ``./htmlcov/index.html`` that you may open in a web browser. sh-1.14.2/docker_test_suite/000077500000000000000000000000001404764061700157415ustar00rootroot00000000000000sh-1.14.2/docker_test_suite/Dockerfile000066400000000000000000000016341404764061700177370ustar00rootroot00000000000000FROM ubuntu:bionic ARG cache_bust RUN apt-get update RUN apt-get -y install locales RUN locale-gen en_US.UTF-8 ENV LANG en_US.UTF-8 ENV LANGUAGE en_US:en ENV LC_ALL en_US.UTF-8 RUN apt-get -y install\ software-properties-common\ curl\ sudo\ python\ lsof RUN add-apt-repository ppa:deadsnakes/ppa RUN apt-get update RUN apt-get -y install\ python2.6\ python2.7\ python3.1\ python3.2\ python3.3\ python3.4\ python3.5\ python3.6\ python3.7\ python3.8 RUN apt-get -y install python3-distutils\ && curl https://bootstrap.pypa.io/get-pip.py | python - ARG uid=1000 RUN groupadd -g $uid shtest\ && useradd -m -u $uid -g $uid shtest\ && gpasswd -a shtest sudo\ && echo "shtest:shtest" | chpasswd COPY requirements-dev.txt /tmp/ RUN pip install -r /tmp/requirements-dev.txt USER shtest WORKDIR /home/shtest/sh ENTRYPOINT ["python", "sh.py", "test"] sh-1.14.2/docker_test_suite/build.sh000077500000000000000000000001251404764061700173750ustar00rootroot00000000000000#!/bin/bash set -ex cp ../requirements-dev.txt . docker build -t amoffat/shtest $@ . sh-1.14.2/docker_test_suite/run.sh000077500000000000000000000001301404764061700170760ustar00rootroot00000000000000#!/bin/bash set -ex docker run -it --rm -v $(pwd)/../:/home/shtest/sh amoffat/shtest $@ sh-1.14.2/docker_test_suite/shell.sh000077500000000000000000000001571404764061700174120ustar00rootroot00000000000000#!/bin/bash set -ex docker run -it --rm -v $(pwd)/../:/home/shtest/sh --entrypoint=/bin/bash amoffat/shtest $@ sh-1.14.2/gitads.png000066400000000000000000001106271404764061700142120ustar00rootroot00000000000000PNG  IHDR,c pHYs  sRGBgAMA a,IDATx |U CI2Plk(-=o[(E{xGGVAu$` A eN ޕwkM^ӻ޵zyV}Q/B!x?I!B!qCM!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!ЄB!$4!B! @M!BHP@B!m$),,^R~5kJMMM:jZ/,,ۻK!B@,)Y'+/}i 7wz;%eee(s]y-Y mW^~lܰ^9.!Bi9N@OPW^#i;H1wIqwDG+]"~`q,D !BHUbU#~erm().9ަ5xUlڇX'^5kB!d7Y%gϾ9$jX,X`5a﫪:E~ mQO湯}(uQ' Dy !BH˒UX*%Kb?{O%^[id#b m,"=ؾ"i?K?۽ʕ2SB!YうD!: 2K.[\W="%%%a|mRe%  mW,}cI>l6qd!?6fk !&BI/&un,O7oޯjkM2׫"ڶȽ~uQPYB"+* _6jS}rB!2dMbd]XG!l-__`Ua#CD'9q7:~hB! k"撆+wUUe8vywuj-)IF7PcYCilWRK!BHzUڮ|ӴABI"8= C ~v+~˶1}4Sw07.X#Bv D+V6z 7!B J"DD4,2!W} Qac*X8Q6] 'L(YHݤ=ƌLdۈvw#BI* 0/WhSl܆E2sdcXQ>:[ɡ]74z1]M$1ǽiL !B҈V}Q/Y7T€@Ed7mkjk&ba*/mi 㲙 !BHQB!SuB!BB!&B!$( !BI hB!BB!]VV &'ށЀs]ׂ~4%pܸKgaCD0[ x@+p-1x_̓ry;mB!$ Q8}!aZv,36ј~4w=bݽд{X7K)J ݍpܸqZg8>$snM7lAˌ x8qHƂB!$h#Yت*UFJ6x;t[mW|BEnFq/?ͻ[Wc9tI?c Szܹ˲e%~ʕ ֪#S"T{q-úB,#ŒL'F|^]]nϿW/q0Exؼ%Y>7s490o=B!$7iժiF=*ǎB(y,aZ% TdRYAc:)Z%ZPqq|=5"8z8^-ZMzٲZHXx ^#l1Ne﨟EjKJXc9n0Mo߲sEq|"ݾ {@4kNh?;r䈜8qB.EmDZ$ ">{ǿJ+i%a]R[Gjkk-bsn5jXvq""RS[B!IOZ0lhݺ;N: H擕bX)"Kuhj5 DFJ\:(a0""%K ah,^"xA`LGKùV}nkmEQpJ,7q;~qc8v!@8o^I D.~ɴzB ^Md mo}l{1y/1/qk4!BRIl۶mU# hH4 B!qNL>j$&BHTsn׶N DM:HCM!OiF >t8h4IO( !,"xQՃhP@B!DbցЄBqs1k9t@M"BrEw LCl0:a ٫X2֝OK!BHNA n*iAA\v٥ҷo_پ}gc̰t֑t*(\kp%V֯[#B!99C8DG ?G u䣏>Z%Ix㆙?S/U7Lm[%Ma'BB!$W05R |WIn\FBwߓ6I]zӳD^9[ DGT$&B hcxA@!^ Ld*-_}yI( !l xunn`oIjڵGLT7GeJ[fBҩʠeB9чǏ i>q0h hB!$05ҡQGX?ܹK!Ys2]gZ$ if( !LF'K"䏆h \Y.hZ]F*BHb*k[ VTصkңx޲e@B%vPD˯Vdz^۠)P1% o#ЄBHa:ᕩx~_>ttsN?~菦B)A0[~~Ruk::thNG'o]Pt%`[4!c`&{ʎ;Ұ-?-sN/}()BIWJ:DȮ]J#A!$Mӕ&B D+⹨HGܽ9u[-ޞv>dA[p_[#MBI!A0QUK^|g8Ν;nWSS+۷o?: R~;]I?Bii-A0 g͚j%~Qj%b>z-۷Osahdt!):( !D vmV%K~q3f'zZ|0!]"ݻukq[G3,IHBi L#\:tl{𠁞ΡCȘz֭ӟ>tHvޭرc6c_|=vT>"A` bl}aQG %0h.ɇ_>Z#ЄBH3H*X0d7] p̚9w;Ԇ;壏?}?e?ڔ]8鏦Bir 1CfDxsE=X3S o_s~E:D]js|J_:( !ɵF(yyK/ D?c- H&"ɧښǏ׶Bept&]o+>hz !Ϲ}~{i&|8Fy:tS^gQS]F!l~h.4 Guu|٫Xnku9DH|}qZ/^hB!$ZAd"6JX rFz2udCj=}eکׁ!l۵kX.:pcLlXhZ8!T ^(%!܆*=Qgζ#Y1fƩ|,$ÖG_~͵ke hB!b`,Ν;可)LCHʠA}叾F +!ƺ#}kѾ}>{ܣ \СC9p&B3*Bgk=n:t}JLґX6nڤoW?Qm̧* tڮ_Vk}u?ڌKD;7>Ut$9qPHѴh Ɯw-AsP@B!IpεF(6 ~}eFܵKVL;9b;gDFh͛oТ+ 5ALQlhD!`4>sn+9Q6FC8OGrׯׇ nQ73xFTW^n"c9-kjF7;np`g'ܸ-2A$bu#| #7u8O=(Ivc]#ijbNSQ`0駟.;w֯>}xFuLR_[4 Zڵ^f2qǝo][zٟ^n*zA5#*-1j+AԬsd>%%z;sc]i7 K ̹M>~h.,nkGdfq!&B2D[VFl;9g/d%O k\ v^"Fpce\+Xq0Y`?_Eu>ow9!ن0 b_˄boEvov%Mݻw $e1lc0B)GWWoՑjwSNY3gD {Kg?MN~h|_ډ{$ȝ^Q#J;$=5IUbRfM("kXY?qeŇzDE/5O3znxr &GA!AkGh6u(7~% ەa 6`f10_a\8'#5zN8WX n1n0&헌kf un6s1DX2Ɂ ` }˽-*8ք%XkZX=1.0n|y?7oY3d{ܛs4W>{~0&5u" &6._I9iNbC/"ywscoܴQ|cqW{5DZ0NeKhŋ揆"]Z90Ys[|aq zW0$[>`5GX͌K@1΍?6d1>jZ|>w7?l6R: y`ngsNk `,?L.[q[&Ϻ& ƶ|+9|؟}qΧrt%,mшJ#e뀸 "ڴ?~GGH5lM=22BҟG//#$&]$CP]qe+A5"ٳ=kZx3>f #6~^p?K>7HW-MDqjB[l7](AÄuB"&;^c}啗dE WT&Jm>'"7Z^sH:;@Mvm%;wj:R !mě6mr*[ ;=LGa|v/Gҁ^h>n(u8̚=Gλh!ko!k`+H*m#qfv8asw^3n}[v/ >}qf58X1gy68)zqwWka.Xs|d j3$0Y)r՞ˍ?ڮl#J Qu΍dK] al%;v(EEEMn>9ku/?Oz5Z"uu}#ubUxhLa,|[# JlQtE⁆$;?/*ƋcUc5* KؕJ/5uMZ\ιVŲ%{0n|u@'V}OO+*n|v"%rn ;>sվ%.!ZݾwW!Əa3ޚ#w"[oγ0}Z=X+ML`5A &Y6w{?fI9S~ bT 1ƹy樢Bdюcw|]/z?Fٻ-ۇỆw^`?HseZGG̱Ub-r>ct ,}9B$ .txgm"^vo.]Wu1Tݑo_L{_Cwt3 Ńe2xRw9 }v"_O*O$іd71㲃`|@ "9A(  Qgƶ|5r@c@USA:0.]ʖ-_ "=z|Bھ}^h' 6m"ѦӡGa9g Y]nkD}Z ͎<}AfhHsW0lغ%%]qo3;~"9x|lKa,.H#|z8G$XsΕ&(X1]o>:a@T5dFh]W9YAWՖIlf;[^ST4NҘ'/4J;ԩ@ rյg~T(BQ'AnB{Tޒ`LN5Cx`"qN$-:y+Ua0bgcL/a`r@nܸI DwdYw)H/zƍz+'7`@]n׮Ie@]]v/8} ɉG3-A@Q+{H3;p(;ѪM9W\yZ#)pQ+Ze)nUH-vٹ+ZNFq;r~`'l[a}{m~_fUp{aWg>;BOlƛ4A%1"Zg_zah:^|ܵk9G"gLn A ϲ[rZ@L HM: lm!T <yv! K~Ee%͍)rTðiSNVڰ?˶t%yMM2OOa^\W\|9h'ef.xJ'k yl0~u<֖Il^5ATzKTN~I;` "u->[ϐOʿ~ : !44:FL@CdUC~1g7F2CZxSE"liߡL;iy٫!i~ Fm6n{߳|b*F lxY&F-fSZkN{U0qp>̾m.9.;oȝ5~睷hM. sp9O>gy-nj ~߄d#z Ĺ#ȴp6lA1>zA O>tȢ:..TQHBhgu=F$c<5] .pnזPDD?:c\~oNf4 baGܸ!=BS) & .JB2&7H"D2!VMMV]}ׁ L !m bO:9o u /%71TiBHcP8/Ψa*qDk۝(~躺:M^!os;wE$?^]-_,ЄBZsEZ/Գ>3@dDc bo{d ~zU(+k_( ! ӟh U*A/l8rϲmU7U4mcNITF$:;B!49o#";B:w _ܸq˓nݺEl[G߾}ի|e9rD݉ZzB{ɠA߾Zp{`={Dq5"ujSc;9 QI<0M!Y``zc| ">go~ Ԣ :^ r'ʵO,$Z8! 8#L.VDn e6hrai*$A{0[uMDrRԽ$ -Btdu`Aڭm_߾ֱzgw%Eʊ+ǏK* eDS'K^>*%wmh߱PN=ұ:uIrP@BI96-r<眳eϞI3f۷oo80ދ.H7!ݺuxb}M[)>G# t+W{G>I UޣGʉ'$Yg[m8*`|vu5$55ۓKާ:FIӠBHʀB+W:\G ?G î.\*Jq *^#SUݻWvءtSAEY3g.оˠas&hB!M'><-uHE (  b!NkX{˰mqqqH8@$ vs$^ d_}~=כ?^%UJ]pS2rd \ž++d!- KP cFewHe=^;wnyyd3`U€BϞ=e]Rw.sΝ;u8BHE! <~@\ :( DyvB0S%Q{Ih OxKQE)a{?K2}&^-}!D_{MgZ7+ q:}^СC_J{nBDGju- i.(3ٳo{dn˖//BIDSYY f%ݕ'(5B:Xz)+Jk{cR0`{$0'^E VT<ڱ'~tDQm4Bȅ4AO;p@L\aMjNlC.So!CY!>{D6Dq'\zojac7n/^eeR6\W2? D-j_?}.4ox_ϛwTY#^`q#%̱9Q}^2=U{v51s/{wL$œ&Dkb*z[Za&9x:y5eƈ5Gq*׬zN 0'IHF(x[sGXC^`kK K=E)K3 =}ȮcCBFsM6y*bnV M9 /7EmwFy92 MVh"cG%K^? Ǐ["RF@ߢĔ;k%; (lnR Q# _L%c(ҰnF,ƍJ>X! s0`Bvy0%z`̉Y%1vzN49.i_/l n0pgy3A`H4){^!wYl 1ƻq }D-$3}tLߛ BH7Jۧo_%kq[G"(˒1tQ~W 7b4/5+Q;8wI:tq}R!?@]o:$]r9ӮAZpjD$v9K蟈63"vd B"E 𲩮++>;HPU'R¾I0TV:bxƍ1kX *l4(7ss&8<\p@B -۵mF((oyg׷~?:A'J%!glcsnw{tׯ_MH*vQlK.!]#9*İ" Am ',gG61kTROAjkCAˈni*?qi~Ĝڦ؉WZZ9s~ozpޚ1;„&Q|DuISBx "~%l_:W6 s(^{,\>K%Mb(h^I{)#__J 6tM\-?k2{m>M4UX*Yk. DKa5tpcMHl9^XD Zˉp ) 1PE㝷ߊxAGmm;>+on0? 4$¼ywyـkbWNc{cv҆1adz$C k*5LaxAKDw(:eGZQF,n8~sE85bg- ر U80.{=>9- -*hqȑAm߀޼yoE Q}jc.JnQ<$p(4m,bDJqImp{P!R%,Rsh5}DOSyaaof㸉kx\CrQXP=|ƪQX . s_G{󲯵=|1s#dZwf/Rqljl b78uuu:*ƆcrJ?bbo43qN}0[e^78wX2G9&6$c0oآ $:h#KJz) >Ya 0 6K^Id*I{US/țj͂ӦYo͚k(IIu# lx񥴨m xQ]gTu!`ml@t7 Xo߾Diy,Aܻwo푎_À91p0}$cȺ:<%|g:(rm E}F۫#B;.rJxIEbm17:H q ¯Hݖ=w(ҥlU<ہtBK`T ioψ0aÆ0Afw7A{EF=zhL$N@;P2 v-jFץ.o>6؅SJ vHBZ^"IxKT^bWr1h#(J"~ HBlZ2A0UI{ 'K$5yN@yU, @M>A"2M^ nv' H _ .UVeuF1tidMLhW=FOw^㑮1>U$U#q<]r%m M {~1n;%Ƌ O* @_a:j41`yYYYv24Fd' L޻i k'V'EjK^wO>aI{2R 7T#1n &aTpclΈeuSg?Eg?ҟOv8i?.OL(s8c0,}IW@X@,s؍TǨ^w l|S\,|XWdqp5tGnuBHT$DFqx9rԷtsb"V^e{ B+H@DȦ²wcxMD+DD;ԨkSc{NF7T)B EDD8S!I]{{ѹ.t|/mi GDDvK'k@{ l{%UR͹6ϹB=g6_f7)~ڰ-Dle|:fչ!zw˃m7 9_[Z< 2m a 'M:?}Z:(EҞ_i:$"1m#CHٳlj4{:u`uDV`_?Hɀa$hէibE8b&BTOݍF8z}$$:"r1xc+Nda؀oQٞ5k.`/FwC|67 6^qd"* X[4CPVbNt@hQ"6] %nw~VORZ;ڀkl{`g LC}&$˨Z=#**,!-jd&kL,Q%b b0@۶o Kf7ɄvuA}6|5,KG@3!$[ȥAC,3B<Э[Έr,$tȁg㏆hO\LW7\#XQjJSzHߟ*dPȕD3BiipV/$JL2Y 'zZf b̃OVs>ɶ]D/X/◴J`P  {KFO:Y~Qyŗ$U`F]t|S%CG!$* Y2LxJLQdzfh߻S.1AG:Db3|"Acnj+\Wd׮ݒ,&iHGe}\uF|ۭsdJ@ z7ݠ) =k̙{}$J4ڽ:BH&ap`^Zy%!mOtiv,"Ǵ0.{c\K_7|SJ*1YWix ]s9S o_sﾼ5N?Pf2G=\A[w>/%ˀpjJ!;0F[ ;vt(l.Zq&m'/O8n> OlutZȲp&MTòѯ__OF"##uI\!cr3'7՜"n5[G{2LrЄu7Ƞuma=yJy C%^$^ U?]o8UN'"ƟZ-X!vذrިjU:ٯ)`s;$z\A8t GyGo_6nddԙ:ЄIZ&79;wb^O3k }a;׉{ ~ucmk"҈F G*<I>7[ڨau`>oVjl9Aց&L m^跞P%"]h/AѦ}5DZ!T@A$F?V`Ѿ-y%ص#΄DhBIwL`ys޹k?i3n 8ҫ].d؄?dшb}bAy?l FϞ="G#RT#+znDku`>g }΄@M!H.H6 d| bl$og"~hx/{WIIS>߶6ɇyҵEq9}9$rB@M! {55MlOp>$AlLd1n H^DTHIbֵ%eJp&Q71c‹҃#ǀ!åCQ7M!3"L @dIlw;/t<>gԄ6QZi6MGCPyt2:`N6l* XλhBIA%Wyy:j g:$y kF^>MX~jG <AODQ[:޶C! ~v%v۫EEa::t(]}z ! $BBI5A%B Q>rNk)儅!N~6 ښa֨QٽlMGcQϽgDgͼ)b"#F-[T?Qߔ]2|V= $4! أgxV2DfS::8Bݼ]!^0olNl }`2g/|oVLhU>ƲUj]?:QA|X|hʇ$=lnH>;vV:*!sLatI!C !%xN1|@4/Gj8ptA^>_72h%zd}>Nˑ l`Fd^>gc Wgf!$ih `!jnܴIrJ!+Mnݜ $LyM҃{.lhhB4#1%ٌ!v>8mT[W#RTȲ]Ύ,-8"ұ ۂC=vTn 9J2Dz՗S9}@!$#ЄF$t-gt>b'x!h/S (MN~-!"fk '|:j>ٶ*|D˶Ɇ)$FvEϿO{\?}L(/ 5ktb xwOIEEklu?GTfÆ BM.|GTsҥAAEE""n?o>Ֆ-ܦbw˃ŧD6G!v%,B鉆c&6Do v`\2vl۶-56֭щs?:.6~tՖ*H'yOm[ύ!$@C ,[,W/djϞ},W\y~Եqz‹cjV077ߛ,d!D')B>Jy36)))V/GSH:іg<'X!1O"sld7Nb$;DXz]h)x]Ș'nn;`~fIl |5]} vAa{mW.]JOTKükF봯>:{~zKx?eY(06=FC1&snn ?&+^@XOnq߻H2lVy2e+/ !ğ@>覙ѵ;KKKާ/!z `A yw!ұcɂEt,|a-4iTUWȲs>#<௔I?y^ >) c1`Dر ͱZ3<%CJ4qv8b^8\Y!+0^9͉{np=̻lHaATB̏}w~+t8%oQI„ke;Be%c̟z ^Y>͌q„ro:k#u񤾕:se1c5{]"e?sk,_\O7y\&z9Ek1}0sZ/6feA5Bi.Pcࠁ!4"ϫ?L-dNa^TCxU#~ #^ F[;.s'N,aC#W\-?yt.?꠺s9ag+Q1ZCC4K<2qc>ʫ xAt,-^n $!KKyS 3Ic n-z<4N<;}uuպ<)/NAϕ`x s!ZVVZgqrӌz9cfh;%K8|y>˕Hnz_ WV|s8-x<\+F/Ǽt$WZК=VGp.0^=g8%ko|p\s0c5wlkgѾ8WbNx2 >?c3@B~Qu-y IG-"Hw u]Q{ gŽ;#YxED!aݝ{ǿ'|6ZG2f1?O<sDУDOp)qTzBE hDPs=O< **r;YeJ'(..77@qSXThB(D DcJ{-o &(87ΣA؏-[.3w%6q\MmY",3t#7w38{0>|~djtNL%U^I,xN AhT_È:&BࡃI~& Qg0ضL ۶mi¾MU+Z{pl+m䐊ZcL,-{gѰ|UT9ӏ%x{{[_[Sx # SMhuC8Xnfrs 6 X+p|lxw.^Ge IFlA<%j*S=}2ES"+7 Yb롩 D&<h(%ĉѣBcFG;@ڄ!Q.(EkG]E-!b/;7Aǵ9һwu./?v]ҹ{R*ݽ_1yY"Å3J(]akHr}XG綯ؿʀ:j]^.~\n,f83-[ 0H̾'a{,cY\Tیk&wx0˗9Tc0Lɢ}Ӧ޻m'Hcnc$HAHN 0~^oݸ Č`gsA<{!﬙?i@/5Ұun qپ}*Zm pL!IB xݶӧ>7춿tlɜI\tAl07.E.k#m`d>vB9rJ@CܼeC U:^YbHDSv］Bsz})9^x łIcXl$)m<ؗx8x0ցǷA2ƇsöY׍{n^ye=I֣=&nmw-}M1paž'Ӷ\w7X?.|>!n1wn0^> #ێkH"r+!@Nn"w;wv Ļ|n~@Hqǝrz?zѢ߆ ~X T}W mOR$Aq"ldy ?:bVm]2G9' G#ZyC`ȳy5F{h/^/j"g1qk"}KG;F'ݔ[䅈e'޹776ɜO,֘tDg5Dp>:uVI(p*u ^>5!m44lG"Zg#b $+Mn#yjʹ^ -_V^{w9'I 3<֝uIctG9D2]㭋@ðn̜5CG@ӗ{6vhPbuD`Wx-y75/ԯ~?Uĉ"^+B{cn2mW2LT&9@}'wF5l̛PtRݰrMKHJ0!0*r}M]Z9+n@ʂ`9@:+q4Ǝ~yxPQfT֭[_zI{m$!zp7XED3KSi@xN$;qoEcbVZi3(b;橛[Աsn>7%o}Kna 8@۰aCT}-ӊ{JN]ԫܺG(OJ&#~L$C!C!C ;)vu1kT$ 'OED, YS:ysyJF;7/gS$(`譢ѧtB Z8!$n4pzb^n.5gX1q>WopIu6~:W؂7Xm~h >wp/t,<`熛? șʑE*d:H@ !V*%-Wq/yZ af<Ʀ2`%[$TBh ?XY!onD2)Ƴf$~8`|!$[>8p`Y--Qx7ց(Z lW1'g_ >7 ڹzܐD>7c]_Yv-_=PIF-KF !$1dm(DD|FTU >c`Ǝ,ĪQu6(O7F5V @Ģ͊v"ԍ"^Nܼ$Ï&S~IwKw8?44A~GGߧ"?hvDC?rR%޸i2=2TE d]!!}pkd=5)!zHzJ  i>| h44 89Ojga" syr_nW xhi_uvWR)~77n<ֱv?hn]"Bz!:HfBL}CF8? uIiŞvC/uD!?Զ DTDv6t3h| PGC}'Q#"MGL`IDKhD4!ag2mmm?sboo)xB7?XHM,Mێx]R@;K4\$i?-;&AV hݻ۠ө6}Ż,U?Ӣg523N+e~sD[t~!cNϨrIPm4 azgȎ1h@ULhDu>X#m[]M=E>;wPo[ Bڀ??hOX,X^^xg 6V6O^7"ģFvJVG8Gsus3lPYg; [o>_SK ?"i k,/(rȾH*U{<ʫϒbݬ4Q>idv޽[LkKm_߫x~^~M3[az̹-4NtW+G7nܯ>::+Jf5]&ywˢEOJ0KB}wO9XE*ߟ4EωȲ2- qX`p#g8R)I` .lBҋ}*n]U>@+ q\vES`웥F#ϱ2xqeX^ B Xd;ydv/h.YLpm=DDƁKKmksIq#Y:n~y`^qnBƀFhX;511נ|vZ1c9F,p˗.7Q>$$#r;Ig'$]~Jh҈T6@ ޳'"j@DFa8u+bҶht(0.KK{}z0hO+6p}|:q-h5D/Oh7NJV|qpB-?٦8iB|[];5g{kD߾T C7=:ڭJL 8C CE ݂5dž5k=׫j`)DqքgآG;ƈj̋{9 fcTUm\zz=nNⅮܠ"V?v6ʐo g7ycƌkb"1 x'@ps`]"/ntDt5x=V{ 1jTYeO/ʴP7%;檓Z'D: b7/:d]?bh,?V'E_,;[H*7;u@Ġۂ>g}ctY(g%'i 묬X!/W=`qx`w6ǃ=XzٹwP(84cթi[- y&$9zUagXuǍ:~'$ p G;U0h "D(k4%bS vj_L'sit<w vT;?}v?0bc;f.y#c^6O}ݪ1OISK1V'=zw'3c51j.lx5\?:-cUO"$Ε 0D^F,Ə Ju IQ榢±_e{ͺ9,H挶ߕeiBa^8.İ=&Eou#KjG(qI_SxT収}7=A: l*-FG;_nvDvwo1n[G؛޼Q+#5#u@HA4I%.kb,] j］B'`r\w ;om_Yb8`e%Ktb3N2AݜM$bӰ7H3w8PacsT//ys`}s C47rKw{LHn#ϼaa'p!>tIHS0ha㦨h]^"JC k"nsKb%5{=ʊVۂ ngϞ1xy4„iAmע޷%٬>*A[Y?z?h!!bw*c &A-Y&$, i \u{`o%ДM3f5Dū>ײxsxmݏn%^B!]Ϋĝ_U.V97DT!zX&܉6v=t))ݿ>C:ZMeAM{+k$@} T;"ڦp&஝%$pjZ۷%Ϲzk#xwa=!ѺNQ\$?C:ԏƱ!ba -ƍ׻ZwcʻxyfiԎh jӈj>Zy\?/>_8gF'>u7uTWom ~٩-ۂp`ؼOdCrQ0&4$mx{EL9nGg )2p$Nh.c7Zqy-N&Mv~ l[uDQXjT/#Є@ ;zL1D!3УGxD"ڊY5G`^u#Dte8F/4$ uBD]&W6O:7h3OؗU(ڏyQ "{s⚧Gkz!IvN$sNRG#17I`@e |RMM!iLU:NCQmb :ڶ BHCc ,ft gXF7߉⶿R)'t/v7S@BH[I֑ ܶXD4;7/l۾=.˄;"n~itHᜍp+y`b_F9${Ri"c^޻ωH]a >H[G6:u9"'&kpQ@BHE1G䴎R6IF^yJ|Bmt8ڂ^Y)1(Ky'oWC1g6˿-DGjeeiu4?:N1"I3hTk*ؽXB2t)a.2O43d]M BĉZ,U1$zH@y'2O;v씧|ɟ%YVzuKP9kXMZ!Gg9Ӥz1kA!"d7m"NK%T Q=9_3DeyJJJWS#o嫯N>qZ&A2Exs^|۩xsOx0M!YD:֏b.V]{FN.CT4xB̺AG7vD{ aɔs'0NuT:(vT8[h&lӭ]2p?$%JU.#j?vۇRг,вwG~0 Ch$ܞ:<) Ɗ}Ѡ&,$G#F!v8@VO9I~M2`RTTAw-վ,n4]?`mGO-x:3"Λ[ssЄŘ䏎& |UO~Bз.r*~݄;*Yc8_ٺ˥^)$Ph|ah4"G7Ϲ6NQ(z9GB:UZՏ'ѮFSFu!b4AI%vGXm!M&@o/uٻ G;YyuЩ6BY;$)( !$GHWbL^,E-9ѱ*^DeS $xLh t"%uvusZLmVl hB1?54Dt<_,&.K3KcvT?"Yhiôn_tz`BoGtѩôްy|Vy&Dsӵ-x۶m"G'C{|PhEA]ЄBb!Wd%/Duy}:?Ѵ bG*SB u ~7$1\wO"奯 x147)jhۻWFŏn^g*7_+T:qAG OW;:(Vɖ{d݋i <ٺɀ㏾ Gѽ{UV jG7ϫ|D O- 0emid7 hB! 1ն][9UdH%* ֦찡Cd t:u3Fs~2|8_]aaaԧw 7tP4F`Ļ9AM**|,@UV:":(m޲n9:jpBItux *2z@C -Pn˖-a6dI4oE0 I0#K2?Aa郲'Yn hvƵ$ٻylS_m !$@^mJH'[.Yu[ƛoJ:?7OEQ {AteP@skR'9G#7t;XQ8g қ+aD #]mɖK#[,b^vQDQQL/{!=ܰu8"q_>kרU)_U*^s4]3H~~B2O/eUBBm[O[x9VVqFi jjuԲw8VPe% N=Ȯ_V>ѰH7c Zi_tK' !5}6[p~=Ey_-KWQEOM@.t~"GQwYXl1+*P/-dOV?ڴKzGtZE owd0m! 8C G7hUNAՍni 34_{2kMrI=tr%,!Ap`ǧIfm7nMGpm!-xsؙ߮à0Su#k-;b<$tk ?:?OWɳ-vtQ{'HIIx$B{}%&Asv/>gp|^tYe|4@ö񵑷 NP|O!$3Ig~:;jc7XR!ǨH,"uEw@#*ǓX^~'шD{Nfvs~{;HyF}h$ LFak+FLƫuGye_eJ:mܸ)JŃi v?Omq~gAnlX[pDV-8#~{_DyoڷAx.3'vwk_"'Gwϗ1cG+`_O<6&[n6ЙЎ*S/?AoEsߩɖ]-KsmHs ¹p+@@|e:i6BSAr:ڟj@S5.{wmI [[K@3[0 MHhFy;$q3FE3 d;j[HPd{[p7}Hc9C8\.C7#}:-!şm~+˜w/1P݁M.#-͙.zU3o ﲨ=C !Y;~I||PύN]/{ذ!I_[5~JUUuD$; AO8wf?ZI0YRD¢"8QL09Ȏ{6.{}U?OF\3d$68m#۪#r^E_"12ZKlc_ ݋D&:wJ^vl/Q"}z* }Ź+!$;>~줓$ ф V~ʸU _2b9*}XjK iR{t>,nћ6;":hzix[*L猲tV/ 9ˋЧIvPT;E^Tw`oVH|J#|ZB\7hXe9u;1l ABr3|if e@K4t@A97@.&Lg#^E>ӈ:# RS]M俔/.N[D!oYdvLJ +18="X#ى"Òq1?㬏ea-FÜlMHNacNjEtGGCd{QNpQnRƍuݮ$0(_m  -'^ꔴ9GuR!*G,#f9vߞ"/V"#RjnvU;͉ZlBc~!!NכjC_a6(mU#fVGY.AVW(,(,{xx!Qt%Z?ko~@ۂ_-_>3вwIT|D{G_lٻhdQ]5ர%,F9?/G0 ^b [Ze zX.0l!Nqy*7 ! fBLClY JkmF.{o41رc"ZLw|PuҶ3 LH/}yGUNcPe_0O:qv5w/AƦh.̈"C\$!rID=JbG6_5򳷋쏣XziGs%8\Lb!$0L !!eH5ݻWG\oޭ?[bI*Vj̭~9o@w>T RinPRǧ p<'ҌFo:14y%RTr47HȃODr_"^l]wel ¶D^6[潉&olc7cagef;/<};F"mL~:BѨyud($' ɶ_nXelAOcSI}h0P=6!ez D!@t"H5*{U7 ng#K(dOh%A7'æg`݉!ۂg.v[pX1nTG~`۰!P4^o[!D?:sU#?ګ-8ѠwIo-m ;躃9o缥 vK* c3rԄ&TgBH#MX6S[G9d1 DE,_ʞ={$?:'߻3pyzdѸ+tY*'$31Xy&4q?miΣÈu wTm뵭#CH="ѳlRA`(#YU k[ e@$yg:˺$B/`=9KdxDۘ0Hi1 sMz& @H ^xlo‹KdOI$pN!>hP@B!M&[jL&MH?D;JL?ڴ޳u ,̾NBHsIJw ()]?e>]:jٻs>K9M6lhٻW߿# FW>7,:4!B\Gtmmm?z*!w;/~^v!A? AK)hB!$-xbG"=Gk 5%G o>e Mm$ ~7 5eF !?:I?+/O=|$w9#^.QDH! m "ʨ4<Έ\ҩA;#.( !ѹ6mPHg ɶcEm K7ߒ;wJ&aS =ЄBHsAtbx!q=vHFxsETdĈ`ѩY$F !$[QHg&ɶ5,?zB?òaI7r F !Tq`h]2vBHwK|3v@?ēQMpuZ:M (* h Py(Rx(*BWH+.:] kWU{~;OO*' ѧTATc ~.(V 8pmKYtٴzڪ<:|Ɋ@o6/z˷/Z{MV)!P޲/@{ai`E"BF߸eMm.4qwͪ"NFePBU6dUDAՠ\ NT@1-'#Fy,;}h Zc9" fmm&(&W0_`b[g_kx3\YU/jxLAysL}7#xtrabr}Xλ7\;† m<®.T5(Lk΢&sIOΓ>@W0g09>lۯH!͢ +l%2@ a"eE[c'Zpꝶj/L`*Л Lo|-sv'f}aVzW ri逯jP ҧLN&*X)>I(RR(Jh}\xeUª@9d;[\&sTBf[} afSG7^?%Gi&gUxyd*h@ :@ gP #ˠ@a~p+op\s>|9lHA3C%g4SCP=k8**fs%WȄuOŦ-ջo՞{`;HzLQ2 UuiX`4FpQrt@iW&X 7"M-\(*%ZKJ#x;=φ^`v{&j0gqH Dc~X`5y#|JUkhOsu:B1A*"I"?O5⫑Z CZ I2\3- pnY_{}[EpDX"S5oQFL~ު]3+D|ˉG{L,C$| mkR?u[6 &T,i !H񄵓7 >0 D\%.)q"TH%BX¢x x58,!eFq83|q\b !IJ `|d DPZZFGo{%|m')]fDžU`>KBg} FN,*B?&SK|o!^tV 7V$x UmTis%Z:\es177^9ޣ{ۮmjYh @,TQZNȦV`YOCq o9)URaEjPVH8/x_hj -*qBT>'HAHp g"< R 2В:sH@\f@Ƹ.e; ֵ-7:"P-7jW`b%GOs.fk}&t:߿'O299ɉ'brr)N8򚟟?1'xW_5mrC qu50xC6 yf843蛚dؠ!9@9P!>z@ 9VxB5_!U _"8lDLIcT(| 918MEp T2T4eNr Q6ĘG) sAIOL^?/ ^1}u&W* (afb}ٰv}/~}׻v*a~:>qe֫FشE==Z.sʳZ`){_`lvNT]z7hT91cQQP|Y`f4!u-\%dDoKJD*4x*b\ڏbI ]bcu%(%*XQgFj({&v922%\WW5Z_y^n[Mgbj5`R$£SG:5 asʼ#ki#%NrJT۔HUG grʷ}iЇ4:.{/ȫ@S-3K"]Di&1mDs/"H@J:k@Q䘹٢jsbRukx-v#A`ֵܴeN,Wz9B LN'o0f<;wn?? @ڵ06pߗC6o/% <~\}^Hps BY`Z"NC8bM gs,9J$VPfޓOm1>:غM(c{ٳ0Aw9TNX$1d 2RjCatkAL 9X 6E,b‡ jF%b.~/im041<`N8hrv2 kpUAvxСC|[n$I`&6!`b3cMR 1K |}, = (Hs\DrTr@A"9˜Q%.tX/p.`MI Z-8@cC#,vZg>ĺt\s,Т0Пp džc3tZaXk\OԲYc,u1Cb=L/2u)FלR_#OYt]iFIR#L&t .`DZDPX J)cXZ& ëE]zxc &JWF ?&Ԥk@uuJ¹s~^װy\q0M}9 FjP%K,Q+@+EmaqU/ *}_!RaP|[ PIqFcI #XJ0D1h0$ΐ9Jde}Z#RŠ@b4RmA.jQys_,gh?}<q\O^x \FNj0]䱻964֢%9 (T [ 2 eiR !@P|M~*(-RM#0k`#Q;l4ZX1ƢFPv655YvZ6o5QVgXR % k s1PaBAJcH E`0 \{@Z*I0& Nll gMN&w~S? <759ӺV#l\aTġ;eM\|ޕn㻙ט89McdT"P\%:PT " ԵY`PkSXۤ/Ti! b#V{`U1QXJXjn_שꬎٶmcccs(U5~$&GKRojFuq$`AM X%H "ᙸ7#Iqp$&!sN6{k_⑅Hg- idX7>Nf&t$adxͬyw'f<ɽK1ܴv ^G'8`=J8K^JpW)" F $qd-4 .twlZˬԬxĭYi'[s???c7?'vPր3J-+yQH!qV$1QJL1`SL"/ IJ*I)i@{;/[6=1,;zlh186#uB.&FD gDX|s)s|l+?r=Kgrdap x[ . 16c(|uM8Df%Y#w4-Y:R k =~QG#]fjW7oqx;`*;Ib]@d $֚H8KbۘLRaRbRhdq(YdPٔҀ`pA[h<A,S_xtoGqmU.4Q H3腍5%I2X`$ۖgY /媝&z3ٸK`isUTB8c(MMY+ Ʊh4$11IAQ&DaA ԭi?LOS3 篹w=c/UiF?}̍lf84B`"k43ڣPBgISH2%MT+q}]1I\Xc|ӰZ.9Wg>sǼoή"vH ${4tgfV8zjQ1XXb-$M }#0? a~1)F/ Q |-Ac$f vxWWl,0S6oQ.šahL[Q?k bb34T6\JReU|bHux &I6`-lH}J A *Nbs*l#Alh5Gi \W̱7T$O |,W?~e;w(w?Ï|ކuT^D_??A Xb9tly6Ncc ##%;91Fhdy#, ^EqF$3$ qh2PJJf ͭ7̍b֤k(!I i`eާ$I&@Fq i$&4;O]BKh^BY OzCba+4qTQJio̺^OX? H AXtBm8=~?HݻmD-,S:6sZCn0K21r-x>O1zի|IbTHj -^Ib+K'я}$ufiEUy[>16lc(xG4M{?09tЏl>z(gg?{/vzuX8 5Zۢ:4RUt:0H݌n[2.`2$ZjQz^e9*#~ODt ~ ٦m46+v|,Kh4R͌fIզldImĢI|-Rv(; ";T66R'#ì"F#*Xΐ) &Nٳ.E+X76D-~|="c$0֭n";v~_eYG[7?OW/\O>Yh4˞Ç|?*333\x||ֱgP((A IͲjGP|*O- dT%I ʺ4a+458ѸNSb{zƫ+ ;8Rih54m&YEH %,:"$Uhju({5R\3#)4Y8*92*5d4;ET0!K"8 b@}@8* |'R>V%.8BcWZA_-.{TcQAU1E dz3*?%/MozvbllfIczz￟??ѣ?EX{TѽS\) hpiw1m,)-w1&&K4v8FExL=h; .bG>ܸq#x9v{صk{ԧ>Ņ^so|g=򳯯oe~>XC/| iicx#%VqF"KDH]!LX*s0],D yMI 'QOJ &!Iu&wߙ|EHzҤ&.%v1YCj!iX0>Rb^h^L  Wfߓ%c75n%mUCϳK_~OnݻwӾ_9_Ysmkk?VP.W;ĔQG*N3Ik*ʃ43 #kpFW^|2cė`m4^e)Wy}G:e!:mP/Bb^ZPy:Xw+&Dv8C8^mLe|KKLLL3eY{{twu9?x/PU{1?> eS z[rqA&Fc% J(@bDq$.\֏͆F 1i̳Vdt1QƯjxbw:e7Ě0/żĹ:g\6Ahw qm61"y 3-x_B#LƼTj"&˓5YiO=fZ}׿uNO|:kz!>я>kʧ>)7[/b򕯰}[`'I a֣`\ԏJ=D5T%v{" [=.cz8DSj6\$igXt2;Ie j jRwD-|.J1u+]=OM|0tŻ>vwQ;55-֯_CeO)ַ$s688xn9f31̒S[i5*I"T L!^B^@9,qerԗQBXb෱"kRz3rkq[A\W% QWGfg,S^]gL4+a8NTj>PUUgnﺫX9s'|{,c] R HC]H@zX${Yt4>Lsm?}naa|#gnጿ[ֳEg3i7 el;7`[!8KL^A%мDuyw1ySز Y=wO:vdVhFJ-6@VoJM/ҚzyRJ`,+so㒟U-,{K]Q_}-!xʢtz]~Z;vAe)sS3[|ӋHGnI c9X[{F/ؗ<_$زɶ90{VU~_3 {};2ɳ1c V&&v:;sbj>{5:)Es4BvK p0z}L]K\uO)^T]L]4f1:taq5XZ['3R ,Ab$x Sv:q&pȆ ;/} Cyx^ɣTKB@9# TAQUT x."2ZDRGeeG:9A]|΁y6a'sv (=SU~7~׼5gǞtԝǓ9v⍸14:̵F1Uf^W IGG)Q=|^@5r4%l"X"S{uyMb$΂kґj]7Ik UOEAs>邑 b8y|#3;,ut7bum3hue/g-㴞3ΞOŸzfz؍.Xw;S)a:J#A xWA5K$ [6x-ʹR,KLEUglL?*40y\ BGԢ%,Գ\KzN\39jdLSȪJUOģ)Bbr2&ʗ\y){C$kh5@D!i%d&@X֐=691z&;v8cx[ʻnwizW,,,p]wqDm۶񲗽FqN:賿yO3,'B@yd6gsoap/[l+8@,Аg̓,s9wι$T2BAahh5`06aa~O#Z@ 0ЈJcͪ);a}nV)3Nޛyַi&n|=\"T<#_bT/A59Rň`D$1R1 >٩u hF#!Gʦ3iR8;0V`L&^x{@[` )pyE z9iO] /g|aԣ3כ*T>>`-tZDX*EЏOя~~-o//h6x+^#Yܱ/|Ύ?ΡC69L8βȉb&sci:h<%ӸFٙ!Ҿ'yi3l>Q҂!H 33,|ZQ%uVoą1IiєiO) 81kr0gAr\ma)aXرe q`n~c'YPC4i=Ihyn@)tmco~$77|o;Gtfϟ>{_k^6i2==OO?+MCxÜIcp,[wwhn7cm0y*Hpyiu9*" t>hK[d ߣI/GzP*IVb,z=r+@-SZ"TN&JIQX:qdY7`s\"r" 8:;O΁XIvG1?Fx y~kW1PdR^i#." gSoA/ ZFtY/BJ7Zʅ !zݛ 1"ؒC+϶߁e/{<ȏ}^zG/t~E:ҏ=o` ugB)h._vQ]k_ڦ6\q?}WM/mݻ؋' `MCu6m]XUybB7Ԣ\H4;̂"Ю>ya+0EHIDfAyHNS VG52R-5W%^1cA9*iJ*! !"oFOz 0YdRP$i4IL1=;+w'6dY?Q~׽u|+_%V|_g~~-[\tLF9(E/zjBeuȔJ 1∕bY%,Y@9Gd%k":`WplˑUt: =|*gSlCLF^d*V&5@{VqK EX]FːY c@9"a0Dn\C-"^U7)MT]\ᶅ>t(?1=*C'kLaַRmknmvp/ { &°M RAe* hIbB-e=PoW`H7oGfTt EA?*#1qP6a P~)[ȑG+ +J)Pp~/~g۞rGG>¡Cx_ѣG7Y_'iǞשּׂo{P6{X\\mo{`Ӛ IR X<@Jh#up~h5bv4/cwSd®fs*u:LE)2^JEQKZ29jba&]"Y450v8@ 3lP)*/[}ؼu}Svva@'ffގ0]nXaMN2'i%J ^.%2\@`O9jhD`=mP~[8z7s>wcSYb7;nȑ#f%I›%(+e(#\V9%8e)%N/ Y\^fIgyqSt:|ffp+Bt #(q4UGWhhҰ`jr\jqE쇜6c`]%"w)#A"AR )ǿ:_"qMZQɪf12kv2wi'fhQ!{ A\t =P厨r""8sk[5W?܌*ݭzqf^W3991b=L/nkZ_Շ??gvyvǙݴj:/JQ9WD&2(-rlq4˓jPmL-Z6ߘ.>̞ 7ʩ-H鼞RaKUD"ikF4$΁>b8Ә\ams 9A!H9LEI3D AM{9s;`_-]x񞃜x!gy屌<љ0< ^5 E~iJov*T=tJ0Ĭԙ-dZk{/뢃ww?|Qp u'?Mk/r7)YsMo< *`N,N^=K_Ƒ P0>qSH̱`v-Ł׿~=̪G}?ƮK!_9ÎjIbU>*]nv//=:?},>11 ev۹3\6 -RC@;MF}=01ٱStrJ©,i8;9te 7^F_GU]8a(gL+om/`yiG> <1SB<1^=1cpoF=A,oE"P$is=iu (B7Ř?g3^Ӱyi=y;yQfB3;;)ŞLO=;|+r7',YTVr w^#?\up7y Ig MTz uwCm111I23NybuЂݓI}m/溽70=sGVO|<:} &thg K=C; r6򈑳R5,:m`e{;_;mPQ+crv7/{ y%n_j9CZh49c|v}e'.ucw81xJ~SF~i!C!ncIRc ^[T6U> 8/z}m$wfrr_]]kQx)&' : kF iIUGl( r׾Iswrd^YcsG?CµSWq䵴]BAU[ 8ljwEؔ9&.<%t8Z*-.WNC Zg4Ht$$X]7uJ9JT8L*{w;bqWT)+n|QsMMy%*A- l6;6n}׼dvv-=_ :zS?ޝA&ׁh;JAtTBWydG&IlP"Y)r! VYXa$͊$X2H(lNbly7>`rD(򔺎y03Ir)m{BZK j6#_9ɣwC1j*a2In|)^L{w-:\DrH, *9W\v->kE@+Ct(e?@"1a6xqbH c) w)uHtA)9≘ɫ&h {> t:\5}kÌS{xn↫W9z>ĩsgo/wWmU{&1Y|g(⧶lgWwO_Q.19)G{v/vβe;2;*@ TdEB8aJD3bƃ-0+X O'{7} H}W~Wꪫ "!kkkM|wk;;^__X3;o).|gĈHW¯/IDTX ̱Mۖh[@20u:N2kdb^OHw sFKTjXʻNclET=w2w:B:,DB^@#5;oNLVҊsZRtVSsD@2)X ٕ%/Gu124s -[Jv=suy k B#dܒ~݋ dxk\O,@.^򒗜wI)W/L$h4|_%/yɦ=y:ujS]wuѾ_6߿'xԧx׻uk n#s2:S'>Ƨ1 s$a00\r=8cUm2u57XO}'?yA2x` 7.3*ut|xe5ʱht0%Kb|2fZr3Ej0V@]wSlt`o@B$Zv&Y~Kš{I/`^Ljb]C7hI}cٳ+-WWUXk9t'N`~~54EJI$4Mfffعs'{ƙN$HG1Jz{{N~aVVVHӔVŮ]ٱc3z;JKPiϡ(IdtT2p NauN5HߘC1?'VB,/܏PL)Ta"=EyE9b)՚7o励9snΟ?r;:gGkRԶ7z"c<2gi 30Srqۨ><}'ݣl\bH! `#\UF1JXJ!xgN(ͿpH7,2""\{O?WM7ݴ)+:0)pZO]ǔΐ dIJw_ +սYWXovƪ<,]R8OZ @jfw1eWlKR*S;X鞭%[N4I\A\Dӗ%9cCېGd+ӸFC%\a6aUoS sйdy7mpP`4\Bl18BhC! r? H,H]z?on%)=;t!m4)=D7 qNꎀJVJe zIS4ZokGV7LqxdQYWra(lBVX$*r8υK''ĝdW_]l+wNRtWh)\C-Օ(B` Ӂ+NuO1?>L3鮡̀ iTZY[]Hx4ub}VJ;B].Q,lVrj-Mm\:<Նy/h48s,>g~1 "C/ChJ`9AYzy,LG=Xv۸}4O`W; )~ ct\P#֠)W4YOqd@b`xAh`Gdx;pA5KAW6yeERA+&${v)L]z^ tCٶ'f0G2sg2񸢒:7R׼JxQI*0['x^ٗIJ)ө bV;xpib=N8EJ"ՉB :sfSmt~љ'Oni+ݒfojLp"8?Qd +K:#yu\' KjI֝yGγ#:E& ;^Ʊ{>J<:n_%LNWSBzֹ<_~)'18kVcpkTb}hS]nztYZ\acQqɉSu >߁1*ˠ8M8Wx0!@xP؀kDa'?PJORzn XB1GOY4OI^ej !~mhVxK.h` S)7`B5:Qgy``Xm;,oQ0"])_-B {pȑ»n94pXI 3DRrv0_e17Kq=r:&PxA󽡵.xf-IIok|9BV `r22vreUњQg`Ё-`1@˿kοt܉~!$DZXĖ-3NRLpy M`8D;2%1v=>`֏Kt WA֖Xp  BEῷ|@MN,G} ư""lrhHٳؒTӗJb&5\&:.$gɄr*Za q'qg=?0rBF:D}Tk 8ءt-Iۇ4W>k[fuT"OFB9/aI ^.r㍐8K$sr02 !@AʋX6 U_Y~NU5%iGVL ">T'Vn, D:_*u2 0! a0}[ ô` h~OX[ f&Sҗƕ Y aX|ʎ3E᳋$j5^U sj@= e6"IΖ&>dG G$:2nr&CG EUT5:UD %*t@$UMiP#yfIV7@YI7\p`-ia(L03 SGDR$F5 ш3Znn biיD P#F 3>ytuڽE\~2UyJCMhwtaGRlbE*8*!{z~&lw+8)G!/eNYJb%8g&"~h&i j GȪT@B RS ~Z'5^ʚ%ug'A#Ań"MY,ѩEy0)"FY LU ' 'c1|լJJ10Ł\VybF{]v܈"VMf@vzGX=@UWdM[TU0p $JiE3Q#TSSi*TSU*(vh-] @IB˥`|n2f=Ac:Cm q "=# WTBㆂ, brpiPKِLFG5{h£hR:&A yADI)?Wʓ@ p%u;uz>fNI>*E&$,YIDjU#+L5ҊETՆ$C WLRxhe8ty)XCS<%7)5|q_ o  (AıBU5Q!hin:v5HT!9*0Ǎ' Vgl}hfh[̠N2Ȯ\6bTFUI1\mOX'jD PH :fMGT#AQ*N"j27XVT+(*A,RSY/:DIzF<}^ J;5X#GW@/} VRՒJC) C2#V A$,24=KZiCۥгhi}nsKΖą*ӲN.@*L6ͷЃ>Z#TDr}$"48JSidMuBl*uIC]dqrerO)]ʖs}FaE) Щ`6$lg- jE>ݟ;|θBp)'. \[ -k騰uNv:OOlʮχLqmnvI<ǽ&0mgO1BĢ *$J}D%/Juk4 < p$׼&mx7%O i]U»׌+ײH5RZ8ݨ|?۾lW,CH! v7[gl-k\L$l%0Z5eRv&RS5,d座J!(fӢp' 3ĸa KV\3^_'ܨhKg\R{ҝh6D^3}Ͱ| ڈwDՍ.nF\Ƥ&6^l%zl{茽 H BWaS9+=MnnLHuw/$`Oq Nϩ4vN^f"U\QVxټ܃ :ɤ4l@)a ȁw[[MQMp9V>Di:v)]@8i{4֔8Y- Z8apR:=O[UO6h}+&|ـ ÉqwIV2So.O]Dho^O0ʼG3h,{ҁ6Oz혚Ta]unpsI_""pd %26*/mrh5(+ rV_u&h4dj1T91lɤ3()oz 1W, eK%{~J:ǬǕ a267cu*'::'*[ `4p/E͒"-eCYiRHmǴRk+Б6{yvEPӜe*QJ䓙ݎ@I2d?te"n|vh [fL-VWvS.9ݬr*\S[>ӯGc~xku 퓧 Bm)UWX.LK6KP6vJԫuX{АkE)F@virHOcOj@4S_4%H3Z(Y{EK#0ő8}ͪE@(Z-f" aI%R ݤ(~O))K DuHTj4t^YΦ'Y9,`RܔXΡa-")J_=\Y4bzJedTߧћEݠ9@1:(E%s/=rk0e?yELWZ`9DhBkԵQGN#aԌ*GR?)2Uڋ1ja'tXis)}VOvkuV` ;9fFjvoZ0nBZԊ9@݈[YX r?4@uQPvhF@ˉBb{SnM~X/Λ q9*mfvⲉ5Zv5M&YmHv E?UZ䁤:= N(b9sq$ִ!rʗ&LPY|qiInaG;S z aeo`B] > &EZ.rX%LQX컽ywU?,;./灮ۜns ]M1h?;+Q\ٰ@'H/OB& |InBvswb 'nxna@Amn;Q-uHӾZ:QfZR &'m)_SvqG6 [ }21;XkDܦ*u?H& Yx#HMT>Wr*҆h6N5%8wjɤMCu5Jcc32Qa~;"}ݒ\4r 3bv%Zws%viNlѲ4S jYiJP4h#Jhv92p$m |4v2 [0*i#xUK(E^^ijԊ)^̼+SG0*SB.cX/! `L%*(j#Rr;!u{rz:sy]m4` {dIa;g%44t`3 . Uhr6$S3v] c[2#<ʃi]{9\4.7Y9LV0Zf6~ ݠ 3 (?{y'/: ( VDP#ݎ7/rsz\mA쨬2 q^dZ3۝Ѥq5Q9lEl9ގ? c'Ab&J qOWb/d}^ [G작ߜ|nye:./|-ü=4~h~ς{ >o $$gW%vHl"*δ뜪{^{R""DD@Dp҂ҤDDDDDDD|) pNX-?.?0Mx^|m@oZŊ_gX+\s>cK8 zl;{qDDDDDDD$ƨJK>)ޭSGhX@Da8USw?ֽ!YP*㈈H#"~ ",fߟ2ܑ؄$M ( h0_̲;!AqDDDDDD$19mG Q=sڀV(n +"'9VVX|{;D;EDDDDDD$J8~ιؑV41hYoZM#{p;'A%dضdہE%p^,Q58" ˹+ IF(Ժ@x[M(p6b֞H;Y tKv^P!_y}@tH#"iaazZ-8y_0 MTݭy+N kpx˄d/FAc=iVNc45/淶Ϣ"""""""∈\TbW vkKj=Q<i=áC[#. Ybq"ޙ\[G4ܺ#͢"""""""∈L8'掇8XS&Lٕk"!/t CcV66x(o(hcY9VRsyA$GDa09mC~W%(PuЄsI{޷ m'`WXe$%^w~;ҔGDDDDDDBja9GT)IPzxi~a2CLwlkRZ,ϰl)0K  +,5+,;MᝆC:nH#~4:it֖*;\Q/9vakXbzLWV z ;op@U9eCT5_^L87u-LYȅ! YPԆ^—! ?WVn7a<'Q}ԉ@["6ǩVe[cv0V J歷3nHS7KDDDDDD$i89fy\x&|\߷x7y ^+]R:ۤN!v󶎖J .DHbG[ IkUbJo=TAbzŌ{/  i"""""""!uoV6ܻ3O15X]&?W). f'^6]B{U!zvl6vuTa&MG aHqxHS%Oxdys"""""""!uB>ZqvaxE+Fl{+)o\QFOPB ]}p+8DumDKtױk!ᶭ{n:IP~n'jCM?TFB| gL,}7R/Ο6nfFQ$qEDDDDDDBŬV|ƟdV#8.'%'pr1Jx0{7n):шy,Wu$K ܺ[ ˱k(09*FPNp>SG=Y./Hl O~2>Qh-Y |}D8""""""ҰV8Zg {b1:'Y>XXay^mԠr-ͫo,wp/# M$Y&? ˳:ϦOto=b AvmZÊEdh L+3τK)yT6 %mEUo;c"""""""!ADJK>RKG`Q% AlYC);Pf=7 ^irgfͭQWo鳵ўY4|9wWI1ẶP]d}!p:b\Pń錴T('- n?CMKЈ_x__bY%߯yo~k$fGDDDDDDBCDh*A'ߝC^A.O. ~0MUɮ lW%d6`%tlgu,e\(#ƞAݭwz )ښ;r:QוnuSn`<pPLWPd|Z3Js"'%HXsmB`EϑM62>X6x7B|S8EYA7 dB8 qυOp<ɊG?X"^bH2*u)9iMm t@۵%be K#I p8Mswh`P䤹 1g6uuUr%Sr%^T,KŒdv2\"ىZg!wx^mJX ^mN@e%%&e`UKSW YL8"lSdQMZjz?SJ̮ T7WtC/ YE}|NY6X\urmU `Bm<9SJ*!ll' %I5ډ6+BےѮE-Ev;&bH u\M[;=ΐ c"1"B] ǟU<XoP*:tK1X UKDKn^]MStcq <-t݂~vAQ+eFTpcA p}aY “ B1kJ'5g3vW%{ÂnAcͳ>!J&LėDA Dز9XP[aU֘~siΐw "EDDDDDDB[xӊwk'jMB$URkٮ\w@tQ`PkS:5kbQD-9V {vBj~fCnnor?Z:VlOpP9a:w++.**c8?rawp7#3klSlAy!=GMt["{vXU+x+PqDDDDDD$ĿVZ_ԒP &r4l5o :w}mYbܱDM@zһisa }@S:YI6>Y\Q<.RC͔ݜA('9)ZB:tl_hgcɩxfԊU0^gel L[ʋ!79 mu7s$^(cmG۴Tf@zWkQ͛Ҽ֐ݽ$8""""""TANyf;QWnVr!݈pi'n3%pC"hfkj!Z* j~bUx0)I9<3iN?\ Ʌ t.30SrCvr_rt']"|q!ka;ڹPҞ4P%򤷱].?:63ڢL˯ oSp^41"""""""_?s5󏅴z$F}x]NMX?f8IHhIvsɿ ֊۸vlz++>[/.WS@wSsNaVpef<<:V<ЌkR4R qÝ+:"Wׄ' ݶk_*Ӛgvʯl<ƶS`5-hB($ M*ַQ757-| IL8.ï>1;sy6mtY= K%V' @lI -Z%ZbF!|݌w@ɘ:a8 M/m&W< +yͭق{) mo-Qc'y' ]h$k3iA$ϵ֞jpҰ&P6 2{JcPւsB]5_}]7 N qįD'§ߵ-ÑdK/5h(W]>;*JHlj먚ol?ۦ+uH xZ B1(|0('OJ?8O5/Jv*˫/NIzZ}S+KwčV%:Lwe.E$6?rۤuM|a'?`((a77=G+EDDDDodpq/@+tº 7:ZsB'ZD+v 0RTd*B(Y ې9*H'ƀN=KsPqpC끵ͪ`G1t^oϏ!?Ri$EN*ŕ[uWS&̲91J6:(VlǛ!g8*l48ѠR^9' 4PoHr8:ܾϺZ&z93ېzǩOi۷ f܀R vLe5WomԚܶik9iej'Q8&"o*16Zog+@`AM! I]EogGp6Ա$yJ!OC. Uirϗ|W?KÜ+>I ('!aYXW9ofIBu "Ne0-O%<>)L夆v2iՙSˍW3{}GGDDDDF!z 9|j1?9B.$5cU;&Eì4hb!Kx7oBvR{#_#*_Sk;P Sv̉ =oC0: 7?A-2Ϲ=YѼwY'cV~4>- eo)wrvfb;5zV8wJ[tJ_;`Hk:ϭkRs+i[;(rt8|%frAo~,)U3DBorIJ^J,SDDDDDDB6%?ќ?\%29:d7)"WO-GeΣ^Bsp4J5xVs 2^3 {ן%-6]qncA NNJLbji& |yŭ&c+`.o?}dž_?GQTBps_OmCYv=ͽQ[7z9,g0*uY /8&WO. D]Nh b7EAZlmy5x a9ulSluh CQ[,Έ7Q>"""""~-u)I^Wn;)F : 1/_H\h/Ve{A;x_6X/ڡ֘4T-Hz>m< ӹ40V17JE b 0|ʁWՍԆ,&c5;~9<)kӆ%?8嵝  aNO'LswMԳxf\[`:;Kܾ&6lBlp{9C#CԞ8U 5)B=rΐ_񟔈H#:pNO>w,iB$'AIBB[V$Ѹ^pj8ɔGep1тd+(1;#JEVB'չ0ؖM .g3^Y"lRh⣳3^qvNV$D]+_!_Ҁښg6 t]'+[ T1)˹`9eP?fTMes.- Rz>bpҟ`8A`}QH4n 7ina9UR<.3_d|rZs>86|~Zђ3.xh^yy988J^Qa].!}B҄s⼥f^p9Z4y?Qџ΅=vţ7 F9EN4yu;˹EŃG5wnTܺho^Up1j͗uf+u^~(-$=GmL8P<k.*3Kqtή(vnZu~>Mllme^'xӲd-+'`ʉf)hF)$M&)g_8?}[;#ՉH "ԕpYHc}y&V]m.e#\o|"٪|JAjaFwH1=윋Sl%;  v |W]Ckm.*嘯cxt8[if7HfzC܌2e+v6XhmI-Z(4_[IADV+B*Pkh:1gl$&P_֔&KKz_L|"dR~ÍE(-'2lzLa P=!$30nUɤftbn`Yx SpiR*Ц-DQ?( fE%$QLFy{Fӄӟ7|ߏykw~w{hW ˙%Yf+HJ k{  q%7 9[A;ԥ^rp)%OR~f풃%;[9۽-)4z%E/ȠN)O4fnM)ɊdqvQ]2>U*ZpmLPTHpڠ(%ڑfD#R9' JF{p燾É#1 >^WH҄~Q𵣜z[/%E[ojBW\A!P6T=+0I8Q)CB'm4Q>_YK]/Ѡ3>+nߛ;9}upF;EDDDDD$ĿJhjazj9~~($SPejuV"KGU*xE ͵)x"╾ O\F!Ŋ R~GO +9<]1%2r`D%B Tq2J*!%!Z,4Y9@jE][TN# %FkTB5kA8 i\bhC;A+Jpbb:+R$8CoSyս(x~yʻg5|4.yzRqr^r֍~N/)$#q _MdBm“SœfRkVVܞ̹30<7``R&#j]kImrUbc9(Ϙ^eA-j,a:jo)O[4]7o3 'I"1 6]"4}^sahz!+Z  4$ydu9L:?ӥFj$ ܹ/Tē f'8][.j1fq^JvSsp98HqpS$4$ d!<9ӥa7$%EJHg}R!jr(%(q$R1>L+srufڡM F7k堜p{"_X<0_z=;uCb0&{Ӵ!É"Β&1&x輇s}ΗN5VS)Jwjn߂;S3F^ 4( <9S, 3)[Fg++gU"L![B⥽B3!n-~t_B +"Wlb`:YZXkѪWfݻ=\G;EDDDDDThmg4;ưS$j/t˕v :VpU4Ձ^IhI Q>+\ W֧U{·ֈJd:\{h~BxÇۖ57oܻr><|dclnސΦTi&l ,U ԶY';89 K+iЉB =J;\B' bW޿l<tuBE;- m+t]F=xzW^lqTrN3˃9dz>M)N-/]n1:%2M R}2Z&'U^MxEܫKZu6eaq6QKu?|۴rYYyh >qao;z &)""""""!"{ ٙ*06TvE/c̗{/)z# pyVC~k|U@g7՞B'y*\c)fUsk9ꌓJ;n(Kx?}h5cG4++C kk0"TKPA)/^)jGi'FH9(,R*iLm4J,8 źSTHE_De[ XoP +*18 6pRyuw}NV?|EtZ[l7?O2ʭ~ػ9/yi߰FAo7d\۔>it%YXua-d)xrt#E% yixܽseMex&N6KW 4d]D=&!X+Ff ; Iv+rsg= 'yYM i8܂|\8jqDDDDD$Ŀ8Dzr&lSm%8r^3qv#+BeT!. qx_ފ`B|VKP9 6$Zd*Fw*e ~W{,7 ^}j31tȃK'.門|(cW1nExݥ;$܆Kځ<9nُ82]E&%gS:䂻ϙ ,ItjZ\ApzHBPVDai x߯m$X&>2AjD؆%PgDZ+KqB) EMҮ&5@A վM$ Z v QJڢ݁pAi e4M٠W^%Fv2vRToJVwl<dw޹݂nFRPrI KfBtzx6}?#=(jcQ@#~XQvۻ`Z}8:TC{x \LŤTs^}aO[q逧f_JxwF b:EDDDDD$]"\O~'a'KL Zi;'U)+xˆY̓O3^73Aȵ+`wZSװ.ћlCeT !#ǽB"@/ϗpv'SMqZ]`)Μ %0aRj& '^Dap'읡 `i$I@jD@2ΖhqW]Z *IѪFjk@[(B۠Qi΢S:!1Em< ucɜ 4F1NS R5(8 R8XD jOf vdc7x^1YU<3>*xnaN6HPfӂ'+r S}vO8p&<|d+C-!:<EՄ+Z@vωhV8m妬p>i )b{a|(g5`Jʛ9}OQtRBc>qog=z$:a7  Hcbe·/f/&+~p2+r8qF3`s?k:qU/uvF^'FerI֛e!--9FNz`ƴ4֒M/@0+'UhA)T=8JZq׬@[Z@5$OƺqR$4X ZMP*נMɵv( VV(2vo"6(Z5 J+iP"4hyTM[0f}7V=>3Η5˺tV_xNNN}\_Ϋ}* Uס(U+6'4!:%IʺC:9N K%"Ƀ}> =%Ot)[1fjY- FkDIHV)L_Y>`?7wmtBԎ%pIa C§668N4Yع8<9'So}^ɣqŇ n=A=2j/9XuI5mkY' @j D T1^NW򘾜0GMd'Y tAc&hm q5Y h8V qJsK6h_.k Z46*Lɶ l5N2OB\TSeC(]JcBƆ5kVTEqiVc%!OmuhUѾ&PeAN0ʠADhke6l*AekSzɂɈ!oU{Gxp:oΗaG[;9Y5k±]WGE &荂lL EصDZoւJ=6@ UO>|pblZU Þ0g d2Bhr_7>'4+~E۱wvJ1~+Z{ Gpr{ysyx*+ x%Ġ8BQ}4p 'M((kʯ-9:rg?Z"2?kiH򌻌7㊯e@Lq8svY[r] |⊳ˉlxN>XO|ryG' ><]pza}׽yG_6w$ZX t4j<^[G'NskZ`YҎ|]3^˴ Ypu%Mj"B\'$*Δ )LlsR AǪ%'D]0R)NKPD}Hu1b,k,qp(hIC@Lms9CYFtl1b$T{]/qrLN BɁFmV-uC-V !4n(ed\-y<Mj癳՚_nyj͇'=ώut}C;~sօAnu;P';0/|MxYBzsյz[J9prqI?84&R\rZ?>kk施ڴojʛEwZv$D8D-ފ-=ni#g?bNqdCyxw2}ſpU7; m>UϏݸ ՜ަ ,[rWW㉳{g|iy|т=e"AKnKzOaS IDAT'sxy!F[ïp=N尀͈ϨݶJmm@(.{t ՈV΢ t A 2<ӄdZO$, nB A|XeK5| &-|DLP0b&丏 Kp A U!xP0<8**$̼j?Yy6"PbeKH 5an\tCwW{SYzbjˋӑ'7w4*YOřjX.3\+9uni46D   {ADq~LX+ u0V01@ AZ\@0C47a(-fHOjSrV<P[<xl\Hm@ $iMؘme6 Rf ܃Xa*&Y+8AF\2Mͅ)cF™\tV5wdhf-:տM^y[|3ݥz;;w,Nq}>9g>t^W=x[N;XĆ&*U }:qFx^^^o#"ci}Ł>/9Ю[PUg`U ZPsq5>b!ŁMesčä4P+t#BB c1 DiмԔK[u\PPc߄ 4;!؈1`:nsX"OW57G٤嵉svH4xLߗ)6oEHm2jNh{nR( q捦4O1y=|囉b?~?l8g*sg%mɿbY' 1rQښ۾!:-Ǘ_3^]zƋgM<|ذ=XЦ0W3lVp83NtIY=eAUi8x;~ E RSef) >qM7GHi5 !Tq1mxGtG#$-&V7[!DLc$3%-FCQ|3 f0C8>, uL7H3& U!P@IS"ĸEZ)Z/6I$J6 Z N"dP1P&ӌDHn ^]h v_;ny==zOG>x2{O ܿq躖-5^_/_ /95AGbՆ,ZA愈].̻0jNAq0ҁmys ~(C=nk5zWצ@ &GV9>)ۀyk o|{-)u~K8$s%eC82l[N !owBw{G?XRM#+d@1VX} t,.>5_[*g'^=r3Ijo@Mm;G DCLB9.k-Vb8Se$Gs .HXuIR3l1 +1@C|35AU*p# eMJ]Q5V\¤eJhbq+U/P Bgh !ljLD+{DC}1 j'#&'FJLڈO#"M9K䨔zL$Ņ0؈UWVT'$Ⱥ@m%$!3;i.+Bbej *HeaPɤ̹ ToV8`טt_c^HlQBDZT KB2"hmo{\'TGBӢGjZE͐ܡ]$D(Md.L3X[TkKڦT:z&ZqBUXvbSH)'19ZiyfKh LKN5|umy86E.ɟ*]>c]N|h#O9}wb&p[n!y+; ; *sY6!:v_A9e ssd6u۬#=4g_xk~7#=g?h[ןhC`SvO>m$U<ɗ + UvWc!x Pf&U0sopW"ٳ o'ć}FsVhq1ju ]sg-6v$hL@Qzj9 $nE3UF;@"g.?w"D`PjL2rU .=hMƙv BH|ZMRdDq1 pL3`٠%cE5E'L& 2)R@5C)HxDgDbx%aшmOl[(cIHNO`<)&zŀCq'ٶn͋S Fȓ2KIfM+u'%M!BjA- US B)P:|tɋ]Lys"wmzqL|6>mH,Fo2wlc&sǼ33o}sƽٸ&EBdPb%`!hn(j)]w-Ahjؒ<)cϙU& !*FF5 c4L]m U?A VZb4L+siQTB9S!Fd#& 3]I˃%{~8LySO?碹Ͽ*?]rYD#;(w׬ƍa-2Gn'/[|(`^so36/^wj\\ڝ*bra."ԫyt'u-{sOaxspƳs_ߛ=^9IU^;0|/V7_᳖svQs~*_b[w!wfo#gn;uB {V. .:iQ_x(o.9\4uFoV5Āa6_L5g#boR n8x&-*$1Be AH%A0g$8Ūij.ږb="/1 "[5(E$FdT[Vhl͉ &ui||j#)JM Z,(c$D eHHe1BXLBJ\X.7[(=h54HHԬ1$XeLVHYK+ W%AIA09>C&7o***" R7'*(43لm)&|tr-ȳ'_e> l⃟~q˯|ӎ![{Z ~m綺ؽq=OkƦ2ūwuTC!22k}~,cS'<' ίx,s|ߒ~~www?Wsѩj'.Ɖ]ng-v$;E;ɰ7o.Qjggv S7sZA?7q5\\uWK&~{lK`aSs4<[-b@GD 'gD Ub 6`*kD7` SMg 's3CEkE\ `e^K(#I\)[eCЂ$VrA"+q XS,J'l%-1"hes5`](Vc;AhC`SSm0 cK'LHe. 1M|!@'aW9joڹ6ɣ<f?3?@̳K| yn.G67#)s^󓫁/[Oz?i];_'a } 㙙apv[l RW=`ue ^sԌ ?؇[,R|fC52 2 s ݧ*DBHp„ӄHѡICZL`Z ;DڢHXLbePbylxXؠTk!J-E1+Zlp?5o ߆ CM )Q 8`  jWW& 18H)$!!+k-n{$4D,R5m{kH(M]4c71"D2–UI)ʼn&uu>Y@Q%xWvQ@dJAiE1"Zߗiq T4F Ps6{_zo-?d.ljq>dï=ӞzD,h,KQv zͅ;ϭ27jf'Ǫ)vgpjhn_^ϻo{O+(Fx.j\;J)끐_7<99fU vOn1?'dJrS7o.{L[#ۉ7Wv_yQi"s?,˻_'w"8w<~S<Y蝾[.3Lp^] \+y5!%KN4kcZ)/M}q5k1-DgĹ].6 FG4g\"jBB$Vͭ8BD2`q`ج)hU01q(rkp&CuKZc)T=F"&+.ҦW%\.+dkpl_velOstՌ6*/FD1`%Ec]՞Ĩx p\{\"m$AXcY *"28#+/n!@4xRB5jAZCHVCf*bxj19ΐ>jCY.]B .||rGX6|wh0z9z.&;Ӗ_~Ru IDATƊlhʕv;+p ;Dl]z;ck4'}@QtN5 o] 'j 7+j팫BYIEÓ5N<~x?E=;|;VVΝ@5"kx:⡧DEwxLVCD/J5m -(6q2LLqf 83RgB)H -!QfEAΥ"+C"Om@:"Da*ڹhk06ZI{B\$(vg!-\4rY,uHr8ʼ<85_?G:Djf7߿̀ h !;RxuFWc9p%z91I+5׫QfVwdV7 ʐꈯ90Gu"Q` RU Ġ  H3oFJ9jMVsp*-٠i.Q/#"xlK1Wb 4 ) ½D21_PsB$3jpۢ13] /#!!CoАP66htL@30T34vMqDhq3ffm̴Hԍxm:"M@{0d VĦ{QX0 HTȡŪ,X+ An1U;Le$L䉸8˞_=jp6 i`y=qk>:^ϣ!@%.BdO{e۶jFE& x%łZ{9 8b@at- Huz"MP$)m%P|I!&Yi.Yڐlh&UJBD6@##v4b9 fct[*3hAܐx熮]OXslE+OD4Z7xt JLLÖ ׊ZTE Ƽ 9gҎD1)Uѫ(P9~TG56ц2@u6(ڼ%Dcr'Z]RM y3,`ķOt_ <y:iO<=yzڦf- ruWfLߕx1X56\wiw^B}}щszRÇyj^nyH+X.[bZ4uI+ɈΞ!~~f/ܻwo j@EhɉQ$AHVDdlͺ͛喗 .Fg.e.m: v,!;߈m0Ғ/HXp8UuN]2+o֊9~7R=Ν;cXbĘmAF#"cGbPgBVʢҐ1)kک`8Cv,=U:9 gB)`\|=G⦱?x$ ow?}uM1s`SB,d}à 9Ae/t vSo e$asʸ@b>̉:A6W$}m7!Z&ذO:BC Ur( .st+!ї a-OH.@P"fӻQDZ}k%oä1H{L9`wf>>手}'G=yg#N7Jc??WϏ>ųʛ)(#9LI;âPEp+a&cH\lw1'g n ^XEtF mbs ɛkva(ϕM)cfcLa&"x+j9!Ȑ*XQz"*=X æa %!&Bݪѻ#i%5Hkъ }IARI+$U\iGd//|pt/|< 3 wNgz|݁{'vi$iuN`MtB4:¹8<*g ؾWgvׇͦ< @ɍuDּ1t)]v}룏>n_ۂ+!SMp-1F;zض9|n;.^||睙o,\=xq6pgN39tE?+%+NaV0ϟF,u SvH=8e]9>%:㽃+,ne-|7O!@^0^b6Z Ul!nH)9SR#7*=f0t;ek]#wk EҰgWL2Y& hhmIZ3v摡VZ^H֌%! 2]S6-\UEk~rڡ/^Oe9d~q;ģ3o?yȅ 3ju+6mp&7.bJ\7ai]W[ݦ1`ү R-!0uE}LFѶF+|AqB 59UvJ/@vt 4MVJm(J\ -֔ &IAM1W@q$Ou" EeYsab,Dgvyb #Iw{8ĶokmJ`҆Zh;IyDK_ubN7.H˜' z)=$orYTC[*&Z*ΐѽhʶ@[&6$D6-dw jKKP0q 9^7h2LƒIBtt+H]Hew#z.4S'#Da#i\NOx*:493.N?vL9Y/g.]L|3sΑ#''#$&\bQgE!?x<}OULh>g7<e)\]S[N`!=.A&tZ~ۑ]۰~u}6MfFzpaRn7ZZSN>*px{|62v I9fP// O/W5qtΎ_ WcNƗ dl:^)XWVl&rFq̔w#:>7!{I*ڏ[pjSu @FV7ծ'$Q0PCպ#,UIV ("e֙ęU{*%>vAgFuXakdt :N$,+4R둲UXSv!BH>نjC9{\wϥ3Gt&ejd.,x_8,/sqۡ'FYT:,o OZek!i B42^W>C+;e(`:7 I 9j#c<\ח4,!P -cB8zВAZj_ R))wZo2efh/&!ʲXC<-qš{0ێ/;<Ŏ3>?#?ro=yӁnðu;Ov'_/bwg҅oПp8nqq:ez<Gt]MwDھy6#l&QL{n-~'ooϟGķ*o,Q%/ae["Jα G%:Ë ^faԘ7N:%)Әswwt .&>O|狅߭½{wlhf\O/+L&dpu`XK_r=)9:#}Ȯ(>Q`S-9T7QЙ#QYผgq̕bSltGբe3*-H ,D1ŤMpª/]gŴΈu eY[^a{*hQ(B7poU+G4/A?p ˀx`,VhXT.g;PCm70Ҳ1}==>##xZ/w,TX&u%:#grRFk8F>%$rDp M68`ͱ>G  k:Q32 BIa Z)"_!tނ㶡Ж"#Ű.hqm`Fcs p-.EwdI ׅdoFGr( FRNǁ<"NaK) $673vB;V&3f}{`~g\|vx~ᔹ//·L;({%×5<]Kg $7=: >)CHq0FLP;Q{! PNPa~olfzۄY:BCteЂPMu,3%˄ Tr4- _NA,b nwEE#ޱ\SR1_,B J ҆'ҍcjYCb3ؓq;ynO~W~??ww~b~n'o bP0Ոl3wa(p:FyNQB@iQsb<͔{)?9ɳ=/^MTGc&KQWn^)zN[ιSE\I6#)\"&a_rA &BND.%+_!RI^ﴚVt-:I3}PzX we|!zm_9F'ZF(m^c ^|FeؒdK_:8nNNsGPE;J֛9!r$K!鄢QDNEqrW udh*|1OG|u}I99w_gw1/ ?}gpQ?bwqs.r9 *@j$첒((7y`L3ePVpM*R ib:S ύr"j+!ov36TʪN CVI[4kq,ˎF꺋 vP:v[,Fo4q IDATvZ=À9cl3yE/R䡄DLJ0gn+ϟrϞw{;_~8_l\1gi;y#!nlk~ŪF (h?`%0{ ZCUdݮu~ooGGO1o;K^aȡ#vsXls¸u%:q #"S(1daFB3g݇Ǒ^#w3{Rgl e~Q9nX^,}pO]Ն~Blv;GwHfr:sSHzRM*d?|CJ!+F?)u%4+ 9ʂ&#*[G^RUsـKY{٠tBIP#9Po+ #(׽s«/}Ƨm^oLfLuONo?K ?<_=zdW%x)/yx/9n]lsdFWptRN:1`Gqg=D)іЎJ= !| YbU˺=v5b]~i _|ۂDgRָmFβFveKTえp:+$\ -U2}vrϠG;R,+CYicɱn(t#*")7 ;~r/vg[{; Ͽ#NϜawťDg!u#ɊS5Кx q9%p?q]{ܮS~~??O>8~'/#,}%NtK1Ga{g\,"I}9oa6řjh^ݝ!9Y3¦TJeNO2gX+y[P3>):gw܅䎛D%VQ;b V)|]qp0!c: ]ZY012 79ݹal,(=={& G J`% l;}Ei}͈YD)]|9jԴG"RJ+'}ԎWsKSkm~vxHw69Nx3W÷^M9h|> N쯸ʕ6s:BG5ź8% 5LdI#c*d]h=Y@:mRyHT9dsZt$i[I=d*F!UdbnlN%h$(S [ޙ,UpW-\rqv3B*-$Jwk\Ea5sSԱ,fA1l<9(PUB >kn˦%{;>^F8K|O؝H uHڊhk``DB谯(!)e_h\v!˭vݮ%"|{˿˼', t-jh#P{܅֝! swN(U\10O !73s3PQhS# ʛ g"U?8|Q jAHh-]1jJ~ʑ5 ޘQ //ĺ$7Y#l@#18T)$YHjT[%F?x"7]z\v߼uýQ0=bkt~ιt‹ZlK;4Ĺ{zمAN1 LhdĊZP8񞀎S" bֶ;&32Fkiw(vV3p|8EmmtsK4adzYߨD-e+d@P[dai(cނ[ 1Dn7B FXS̝uMo!v|;?yt` `anN:l(G)CB:v -O%"E&9I 9 l@7y)Omf)~\ % FO19o-AǀۆKuD|cW)id.Y|de " |p$A9㽲_fcW.xMe^>}eU.'/q_Z^"9ڮ8%}~I'-;2+OW̓G!PyLJ+-OH?11Yd"Ц\NEVjsk:&F.h'`.} g=! j:n[ +|8AG`Z@7+( a@!-ak30QN'yya+#"[(SxExJt;5 ٝ.:) G@t1]v/,3goX3s}'v8g /K/x9鐰 =y˿\㧜~~a99۾4lYY]"Fч`fŵ=4zV0{PیS*$C4!x HXS4E'ǰ=TUId<%S=*T0Xi$-v.Fq: bX%dL6QB_;i ce :Lvu1+%vY ¾i;T,aݣs7O+NMkqksD@*vmYc~#+;<њ[JZDKtEhMokvgϞ}?i] jla7D\;U- iU$=j'HB1p֛z[ s8R붪^袨y["YEp7gQ#:~mz Ӥ%:WabN1\ Qɨ%Rfr:%ˁC7 [;قHDA"mO׭1)gD2N+/1FZ#5İJS:B:%J[n-Rخ/{^^_?3V}O*wۜ&>ZNl`

ism3]:_=W߾C}Yʴ0 x,yKLGz=Ӌ|p_ƝF_p"[7,30#''\&^_i9sN6Zև][sd.ke8kGh00q2V3K-pji(Tpq8zB8EѼe-G|Â`hlOӚOXh F|m*thL"b$!m4&rteUaDrΝB*BDz&xlv3;0E&+.yEEm눣нF^w~XMv7!uV„߮u~*__|/Ŀ7D} D ]sJa7)ܒs"fq rEIBkΎ1cWHJ, ²=Qv@٢vI7h.$PO(;g+Aum/y`c!y@k+2)X$ +cb֝^ZK5N#e2lm)+K9aVTf9NQ& Ht@~\9ų&7Z<#zbӮ)es>'o飇 wɛ;X:ۆ:e:P _p*g&1jfֺ͊gȍS(f@tzb~W>޹>'w8G(gswww_\}?k6n>'ݝ6r;qL Rj# FS -H&-Q]X˨iG T:L T S^DƐVќi!: 7tOJ)9޷t1zmr:-)mABc$DF:MX5GRaE0 dȨ5[sCm6]nA}@#/A$b?4|ؚI7Yl9xofo\5/[}kUR߮1q52XZ䂑@ш",{ $aLN?7e/u'-)ضγmv+n gY%yG $.CUpswvv8b>1u)=l2EW5ibB(Ҥ1 ,fa3卵aH4 Zhs o(2hOV1'xrRt39tƀ*F053fPٽ>~ofKٞb8^]1_qq=O~q Ge@wvR)]o>Ž3~uZ{3:3}b'?N<^OCrvrI>ovL6p9!pzx~1ۋy7^__tr}=3[w~ӑ6lT45c"!/@6el8-cmb؜F^ 3PhU4Ia 3vd,tIxi,&x21IF(vDF\Z͙xȂ0H[VG-䢴6Dɜ*6X-QM/:״JLYNY3kUƉ?"sxU,^$["RqP_o]?U>4}6.-*}u@noJ׹^w^,Xn1gi-|{,%klTؖﱢn5bX{7.d" 'Ė{&JۧG@ 3_˦dU,ch2Me&5hh&35d=5F^DHh63x:-u[jN<5+V jr)[lhtemxaxeꐈ,|fb1S-2n6`9+?xiM9\GzS&1z-TY ܈XV;o%,yV|egtZNTX)UDZ)yʗ';;;]²bu8Kor͋{gukn67߇|n|nt0St7a,Qq⸶:RawC7q^ۃ8dQ;CVfaG_T eEnߢtusE7szvG=JPc#3j`n7~.T<jHٿqŕwq s,;!R88bQ+l Wڰ6.NV|||o7fwb5|9nv|3v 7r|f}6g)OElI]@~L08ûFl\c58mF؅Ҍw(#=1a1QΣ4U($е%9/$*Nu0 DuR<;,#kdZf(VBRlA y8V-֪F%ŀDx_qd$ &qV;'x>-AD&BnQk`lF0kl[/KɳDWꄅi!h*:OGZZ*@TY#Z`6Rƞ2_>cwq>/3ZӼ;܂SR?1a:dugrWx4nE9]pD5bw;m əeLR#/E٥X4mhϳôbeӒR9)B #)a.@Wdɗ5}_ŕؿΕ>;©m8K|O~p7z`x],+P4B bZX5"9N(Z&H) 6LBZC5bh(6y]32-DmohM7H]0{5Qc H ֮ecLd8DJT@┊9F$ T|Di$"9 f>z|i~6 -IBBxp?lE8GBY:;E b39l7ۑfy( G6B=黎?X(ˬHH %7 ;mCE!"ZYvG3Mw q/= KNyZiL 4bcmAyPebOk>`k,ib]GVˆn?Wm}=wy:$ L P?!vm#-V3I4,| &z%lHA53HJFblXO΍ j7r!?;AƒS}ferH11sD@JأK:Z@?@=:rNԎIz14\J -⑛6ͤhgC,Y,`rM Z 13%6Jha!Zhp˩ DƑt99;&ٵ0Zc ϛ`sBy +~f  :瑝_ :{M"*v.n,U^t]wy^'A 3b4,%<0Vqm׋;jn&Pty+V]rݝn`O~ȍ_/~[ o,2S;[,8n:6L,(Vh 2B𓀡' yV+~LCљ\T(X蘦_n3%tQpֹJx̧VB  a 6 1؈ĖE Ml駂B)y {bShrA$:"(f:qT-)<& ^G$<0&sBW7}5V-]Ʒǿ|d _ V'ϘbL< W%);o!!e~ $b(6AR)(@rzVh>MaEu (5(:{ƀFqa@J`@d )PQjLH)3F^SMD#'έoZ']iDTB jnZ0*BsYĖĄYHKbSyTHNXL$ 5dfSQy9x?e1ؙ{)px[t_Ưr?}3FLZYYº(\k>mWrFC%B"Y,Xvr4M&D!&؈ bD,4$9 1L^bK-).X]c 5A ԉvPb3Haa^CeC_l+-n1+.7Ǎ >(\`7:+76'Vx9+#B e ѰP&l  (U*II)6ICZFRHLɓ}Č~P)fLDb\!4G%w}+k6 eo I*,JJ̉S 2F0}^͇`'NA;+32ӯ80bglE\뻲^p z b_1Bx"N𕝹zy9-UX$fܔs)J3hdA1#aw;S.fb 11" - (f ! 3 ёcF-b:%A0YZ1lC ;$9;&KDzB(6 wdiEc 9 u:&UCE Dd ٓ<O+B{?}'7IW"Y{?G?}׿ZS:eϾ_yx7|ǁ3Ru3XO6Tʆ/ ﶅ6L^ L !uĘ[QCG@tHHtJa 1 8 $uJUA,yA%Dw9CKtA@he$H',h*<{xTbsI,Qmd N&qm=޾qȳ@s?fǵGWO'!?CS(@2k]rXG TeRc+Ц16gl(Sf04=ZL}39a MѺ #zFߐXh X .luR$9?V&2eR6Bn]CM{ Z5m}cnd1"&[_E\H͎|;!yvF1 .,E3 \:<<'?kB8E'9D]v_KjFdS)@4M.z61'͂<;`1bI)P'!6i2e!DT]Ts0)(@DG*mme ٠ZHu"\bj4¹$XH:.yVeWbw7יq״]^W%gciX_M>mg?%zްs>t˸` ՜:`bPEJPe %?Fq]gLwVaK\1L(ڴ5udQ)Jlh[ 1N#9CA)Tr@%47B)imV̹0$t,T?5G aLR$Y\_ 7$[윽&_8ɗ\ߕ77eb뺌KFkjtx9ۯG&rrs[̄d(Y $.]gn'Ycwln{=+z.D`6a"*Vb^PJO::)b!F L%ΌTcUo/H5  esAHJr4*Oa ÝϸQG]ҏ;[ *FsyqBc=8{qC=O<8~g)zg,}YDt TF@ɇRd;Rꐸ ȢYBB 1Ajt&s>C!8W|FH+Z'JȄ9>Ìڒ8o_1Rcb0RY4i9qØ$coYySx/Ɓop#"LϕFiOs{''Ͽ!|;x}ۖh4-W >f[4?'^;=KKn؋ ]X"&,Z8:$'Ř""h]ɉu6?}c@ R"M-l -e3A|H@+GB:AS Kn9)ed`$L~dDy/_jB ^@vm:"Qyf!̤c3n6en 8qK\r}7qy^GA\L'/ࢸ* 䑇6mȜۤyK.ӴZCe L'`)n8Ao ]:؊{s[ *r!zRړBT7$!'ySZYRŇ&bĘ)fd59 } PMP ϊVh,A I""}h8/7 Zi?m+dlk͊Gy|9秧G,k {~٣ SO6X")zJЁ:v"4 1/hsIu)s-b3"5=wEy栈*4iYɨ:d%̸95[τ@0d"DoY0Z {ȂW7-įO+Ge`e0P!<t+9_y\{ﲛ,5sNrNw&sP*eQ=thw@ktk6 SDc[J` -Б5jB0/F Ӝm͈#Cb&&#fMɠuAsXI1:o9eG@L+`Vif.)x XO^G3Yiߏ>">$ ىAl\ߑUJyOzqP' 3wVv63ǵtPs>.t;W|.r1mc,a{[*>ܳg ۬a!HAI d$F"SX‡yDк&bG!R|ʟisяZ-:#7E? c(.E91!қ ejdz7)M㏙_rc9mO9=}WiwwvxMvʤ4@w1SGH"-mn6G$$(Q0>͆kdc;d0EXN\eF*k8;{/\?>awZ#ÊgsNb s 8NYt-7w׹@@#bH#]LH#ゔR\LDdΨI JF[ZKS.rj1@% F(sκZE,x4 1:㲊*1)^D"!D&8`!PsZSOwE(Z/Jح y/z3h$ʼn@ua3z^{?byp+ 7҂ԴE0QTD/~l~4SmDLKi[IQ iHYIM"$!$ȍ 0n**f-x~ܡ60G^2L`v9\C]`nlbfFy{/xC|!?.E\__֏rz]Xt :pOPFcg.ܜq2#|aUcѺ`f; g{Bh>9mI$ V1kBg Tl?2muNg&)@#C "0cҁ(oLi eNMvnEFyx:&#n?%o gt{5CKH+,O6i!/yr9UURU2X µ09WMܽr>D(miS ǛbYg~% AYȪ2L3OBSwÌKyj 󬬫ubBT7p VX"ږm) f 8Clv 5!q:E)Ը)k6qRLHVݎ7_MZ21ZG {*3>~%^}7w^y/ _ō!w=7HɂX6#$bN4gkg*-A 6x ONR#4KhшMCl)Eĉ!(FBYaƙA/V uy0NN۬1۲Y^ l\0ۼyx-̄9\D䭿NswcK..\LI|P( #Bj(&DP Y2#BBbja+$f20@37ǪaSDČ(8=GcLB)^֑IIJVpF5LSbZUuIsc&U/E (P9RIenjAZ0]pOǨԢM0h;b1w= VX#f|Nĩqt3nUf&E,J^wo|qs&ז s_7W\<%? ?qsuʁᘓMF&#āS}6 BQi;QB4b[dBN!'B=FR97:2dDYL dcyc\c[>'M^|M=e ve\3BVhW}t7_p/\ *GU\Ԧ{w1eÂ4MS]mɛf>ZvG2 S1Cc6oFYp<#bG1b€P*Ym+"$*1D',m`*2a>^[H9jH5r<(G/o`oHYW,c㫜҉'k'/H [sr=:=xRz5VTWl2Q1 ubb\[DK!s훌)ȥe % ̬HYtQ 4b:AM öy^E$V*ZI "hlZdΝLϨ".ZBACW:P-3y~E2|ۖ9vF\3ERZlB ,\î\e>` G"ڳ5}a )g>;?ৼ{Cn{8{_.'?W3&#NuׯCUj1&40#JO1)%*1U["R"/3M)HMh<]mDB붬EqD̙/{ocY}kǘ9g\$Z% l6P.8z] Е5 (b9᳟aftav<PD&p?q߿|%T4Y]6*G ̱ivw[y:v536`(шºIAd^ׂ_|꫼;7,P5!ʘ`u` O -SV2YiBL926D!X.@@>y̧3GƖ bu\āDv5rs>;-^+bKz.Y%۳ q6Ʒ':=E>tH Q8[eTaF Hr,*TBb2<[I,f$1bJ%;8Ů\ 4^f_苤$h jVKv164gDE /͐MF; I֟*1K7$ ݝ!d-e/#X yXwcI{pI.3b@?dh1&˼Ԕ 'e Jk|H 8g%j-"0qY_UؽQUaX!CGz4$%GgF.8_â'}`6Q?{7 u?Y}~nwN\^_<<9_>YHQ{Ԡu%T7^5yAHNh0[3LgL=. 5hY!@P@WץddC)! w !fA~0- 8*Q"$зK1)I"NRq7V@"2:jټꄘS_B՜ߔ:6wFn{h{Eh ۻmZD ;Ѱi2Ncb5:୧Oyswb{eL8՜ƃx` ;l}cx gYǍͽnœTHJrj7'5:4?*3˛Cs@f(yiKC7OH" M)͆!9*qaRq-fڜD ]B: 1WB\0WtCz]y_]}_u\p*7w#:^p.Co.f|$ ٻQWY ##&!DČʮfr Sy!h* DjC~,?(BE"I*$GK4"Yy˼iB 04*r~?[)%F]";?zзo9G;?i/H N/>8{EXH !ƞYN|gEl\KՌ*v ]k07AWIgTW5ŴFR M\Vx+ Nfg.]U#dDR*'@eVt@,Nj.{HCdRQkU͆7J)NPz[Wê0 Y`X mf !`N18T&UOlOaH%i"V8*YT:[̄zPY˄g" {O-޼.;/q~ypx+|&wIO~˖? n"͔j\lo& j\-R^F%d!.'YƤWB8}Rn*gaWhvE4ȕL,=$%va"AE.yU~wl>)fhw\;nm:F}˷G ^hCcƲ{Y<4U\p1K׷\H8NZcym2ͭC^j]"MM5 mF}`UUvWUHRAJK‰5Ed̓HR5"*T3!Ww Pr^LcV QiORƅ>49,Z#0 YER RrRZ!ƒu_܆(4;rHfCTv@Bm"{Sdj8ErLGlEj,79u=kn7sM;7xw:~#_s:+lw_~ ۳)t;Lg;a4nWSYz2ťW 2VӜXB:mΗa|PbMy3")]@N٭/M7σm4eVj.YX>|yCP-%˨jG3U^~EhFbz]u>?ggFuM#7c69OU'{Tɏ|+"E9%^qEFmc*q3XwtLro@ 􊖴4HELhd $ bX8WRHX(.(ј|i0[ְ8Qh=w8zwp%>ؾ8cҝg _pv>V BhSt7wxkv-Ƨ3 "0[*MUN$$#xT+К$li y4F$۔dx* ybuu[sQk %#,DBGq,p|`5tcHMuQ ʙ(Iv0P#]ٕF4cL;1K~"EPK6_.i#BXahM{)(mv4#eo /zg?=Z "!^VG zI&,YԕXB]goS_a`٘res#nkRLJ[0n^J *dϳ%+,Zyj*2 Y8J PJW&á2쏹-=}O片ᥭῥ}[i1K|wgO.y.Bx_9B\yX/5sޘ5L+aNqաM=A6bcԏh\aM1_")B -28QBΎG$毕rq>&<`@%[9 Q70,`J\\){jx)C C7?p"$T=b%V9C,vD)1,:A*pmE#h|KHp|'~25gݡN3u닧o̷ww^cgw1#;zM.oat6i:f\+R$KHfGK w.3m*-+ci"F,eK`UfV*!6'>M^XtXT0s A/j9 ѫEs!\\iq=Z1cISٿu׿%~_ߨA`9ǀ|d`H>y6nsWeC~9}^Tx#Y|Ī[ %zvVRF.HU#cF.HR8I$u.PQbN"'6.E)y,&CԱ Ĥ9O-Q$ʐظF|EbMr"Ƀk*y535i5P;r)e̓$ N(sS^zvU&]ti͝#M;?Kr#-̓SƧOϞy!i|@ IDAT)obX\pqM\*fB {EPq|j1G[!e,[q*瑨ƹȃ\e7T S(&p+J 2{\w@%<ޫ+U}z=.w^ߨAocxڱ+ҭ9qf{=g )Ѫ,}u`qv{º˱u1:ؚ(ݐhzRDu>J;T }I*,c9V, X,ty$u-i99f2{-Y߮|MX,FQs8?ɳY|y/!bH\!qiiS@J=3/4lƘ$4dQ15N U m1 ':4Dhj1#XEaU8`Zq7Ļ\FT!ju.BՑ$V"=RZ@ʎ`F4;!{ TPHR>PgHY91ӂXuJ /ZԂyՊE<2sO  "ɟdU 58Ҍʭٌ]")2 "Q߈mpBu LcFX-8a矰ww=e97B\._bKf9h?GC{qQn͔:1"7Vqy]AJC\vfb̛!*ڥ1P&;eqwK!q T37-T"WJ40Y3VOf"ek{|^[O|.;wn1Lٙy.nȈTXg ck* -ad'ȧT4bp'ؚkv̞di TXW9 (Pc; pziQ[#{zj ӾzZ`~&_c+jQ;פ6c%IiR$HOJ;.2V/fnj-Fʌ纡in⫚ܐG.2놌>ivKs[]/ }wF{,M@Ime@-K!f ZO8=7X Yظ,ՈZ^VG͐#25)%V%Xy/%TU u|r3RN 1|&fc &|# YTk`=ArZ2V#'s=Viez5?}g;7g}̇S7cgo9aWopk]I0sWX`qsb<QU[s;씋YΖsE!:|A9L 1_UK+M,0N $ p]4Rw{O}s|"gnh`9{iZNQ^/rj]?Ooԋ ͌:ݼ?x쨧Y}dkw%Gq?0qWyל,UX|Z$(+Q2&Q rCJ`\aEf {,HNNBJjS}t0|?aK_n{orqoB;B߱w~Y8빌|:0 ĘE*0+BXD[ 6`pWύFiS<^"Z9jDGTDJGŒ̮X, Acgs;=Ș7vILR΀ I-JFآ2YxS+QqAhn>bvԃT&JKF_D72p \Q,8CbD)ojgL b1Q*r`pMfZJ Fu=PԄ>:DJ@仳3q7K+f:V2V:8!b\rIuv87Rs0pyɭ94,ńO{po{S'ia7o`;g<kuY1AbߛIB dj\ќE.ϋ|6yMw8?3E$u-T"TH_}Fpۯ.y:X\gc&c?"mrz]f}?Q/C,@89ؾلxkF80T;z<ѿ 7{0XXvJK?Am?%hjdq쀡 R!/j0U€IdԮC5rvՇz{۴obqf vݞ34~7=8 9_ h1M+ތv٧JD[RGq6*ͨaQ7@2- 'T CF,8&JJ1gqqq&P!#x,5)F6R *mF{bX)Ԧu5TU|:a(6UN7i`3*Z1@77 ,vqIYZ*bͼ\vʝJ1Ʉ K=LgЙ&4\mpJ,C2F J%#0B[N;|Eňgl.5IÒT 4jooNјO]H2#`YA2 Nb~ǣ=n׸c?zK:j֘FS%S*N1d#1z UFͰ]P6itERJ >9/!7K'#;S2X@3j}ʸ9c6 U'/_?`zV_5?Oxq4Hhhi'{[nUxpRk&uj:Ƨ |j>x;;g#Ig|Wn~ȎL7@S,!Z̸&6mc,)Nb+ S[D'P-k+׶YA2[,9\4IDHIbX\"KS F7!Mc>d9NQ&xsRYOpU.f+m^k͂ٓ43eJfӑT-',,`F2NRJ|i21gvVg8utdp*NH}8F=}7\fz)凬xL{lJ=5ICn341R?&mR~Nn$J}<ߑÕ8ڐ)6{\y׹ p)=VGSdrt)msjkb4T_u^\^^~_u~)eňm$\*a\1ufV|yW)9?\\#|)xˎ71Ted+dyD<|<1kݟЍ!v9)n8vV2gTFOY)% i*~JT3Qw&~> >>0|2 lrq/oͣ.!P ʈhK֐*WfTl qxM!DT{" $Wa.kI 0叢#7$zRuvPHC,e8r䠄Yf3'A x2"T")x`0k$8THqBQeFDBj,&&i )w_gܜ๤?W˾ꀭ !ϑLc1HbJ?URc{ #Յ⟘Kou%'ON@XMwL#y#kK0쪛SN{+,Z9CZj\Eb-O!"*Uˈ>^!z{+dmna][0_2:g<8?e{^1ctG6pzϯoԋ$A*D2y;݁bij)53Yӌ[w:0ag7<}҄Z8_(NH fIÖ*XL㖲4`)7$,yTi%,h[ҙc<{ο53z`~t~ʄ?W'JrFgO*%p'"nCN0aQﲛHΥJUcUM=Qf|=#.htt9^ V!b1\]4d]f$K%0#*cH,Sa(b=! D!:vJ}e!桼6fN%\EU r#bw^bnM>C@-Q'j!vTާ٤b6S»<̘ ,ǁAO4Ln Y󚇩j/1G.?|Bxr@nؙKU#FOOyS;eSy8/T u4qKz)_l>G{!4DLL'kzBJs "F2:d;c9Mmc#7Ғ'e)z$R uk[@շ$%pBtTí[9B8J$"b XvY+Y.'Qϐj jP>2AˈB6Pk5VxH:c56TΣR3fSy-7#G$U꺢@S C0qΣ֐BO& ="$E]@TђA: :#7 $Uxt!*ʰ@J<زC&Y"SnycPJ+85h0=yYWIÚ>iHׯւ4#VB"e&I6pv31KRzÊ[ӊ{O>o1L8eg2w17.>lnghg&sUDI.qߔB*B,zWuDH#t4z{ oV$3F #]/z%%M\ cه\^^/z(PXRh'4FV*f۞51;Ζ+ܚez!ܙ.Ҝ 7uAU 8-&KhaE1\44{LP= =~[᭛4F.⟝?e^RH|"°\i'.\BJDMb0|x> +*2JU ;߀GH Kƀ8G $Q[@&:FTJ.DR pBHZuPԣZ0I Zj쨛瘈WĹ̈Ajݹx Z㪄xHiwuvuN-)hAuz8:,Vh)H=GRaXȑ0DSj' 1W$KdDJQG{7oOW/Zv5^jNheFe<RQkF2El}"AHjQܹS> |O[޾-;cKx9*0 "d`|9I%eM'ߤ{};j9`j.hv=iO4db.ߧsvs^Ky.,3r d cAJPiU 2IJ>& ȭIOI>E 6DnpH mӫ*S!vx X RQRCx^ 9C#J9\H:F]9WUs(@]HA؀DLkbP]Gk˃֓c|0K& Uc:f8X$WI7;}v)񫛻ڷ ,#=ͭpG?}Lw1nV'+-­}랑D(R "h??oXc&c&-M۴ݘu3#o!R՞ K\e,\ i-v^EY5'?k> /O/KNNN~)4Mt:e>+ꫯo?`6O+Cn4.שh3|*=qFz v8dRqk1Y^<>X/ٮ[:5اK.~b=v=|vJч9<ˋ:'蛯ݟ2le_s9f6Z$?BUI@rRlha(Rj)66YB̙B0@J=f]&%g8fhgrZu5dt˷ >d,ו IDATVPϐKuuu$qyHMȔDI@#N3WؖQDMrCr\<8W#67 W++''7--?k}ιvC37 ~D%! v(b"E%FS&JbH%1%1 ]?21ƀрnh'* agtW ;CG)Ox Wuާ;yz?;>RZ;ʅC~z2GHFE2()A2C|ycG>pwp}q{\pj5gZQJaX\.翯*ZZ:'<'< t]wy1wZ/`%N<;N>}|#Vǹ;[6$i:V/J9$;ۇb%jm39qeB@$l -iYN:m:2C~@I nTÒ3wX,V"Gl3ѫHW\?zQ3@Xv4+4nev-4RaDIR˔ fW14XOP1EﺨIPSqhY&EC.SnA$ZHeA$}X`X퓖=VפeAt88}cLaXСDW(Mz8M]ª*n* .TEB7,)ELb$?#ymr17ܥɠ9izE{[T5F.TмO_Ͱ7OV0O;_~jT/צ.M@7-X aÊV,/xK%O woq5%]qcGđ{Ν;][p5aQBbyڹ3tAfx^yͪRΟgYdk{ +aΞ+G7zsEAަlEms]kTv$1DH㸼}5mO7~7G?ʭʭ8W@zG.\0엟Dg??4 #G.?vwvvxszmo{;~?<|;|?Mu>Z- oh*,16gӮG804t%;wdg!N㺽=>B8mt"D[_C3OR[+i,'Y\=Hb$H|"Hx&iJ?INOi :31Ftm(NPY6wAq0xy$`9~2GSϝF; 6ѭآ. +qj3EutTSȐQ/(^霻FD Rgt`H<-'NɝO-q9it݈lQiց.7L;0Rp֠TjRFq)}ɯws}oI6V`dD2f,Gpo?v>U.S4$-pPc8hso8 VWhO<5u<[,SJ'o 0WfkK|9c-`TYQʂG^G-ym>6{[qrŗ']'^cIcC<mN/3l{>r@b=.YvuE,1KEH+Sɾ0MQ5Yˈaow}cNx<[k;;_K,B?|~+m7~7e=/`X|K3>?8uԃnWtMiT~^ Fcv5%+eѧ )N 5V%)t>Sw\wuf<͙sK>{_<5yy䒧,/(HXAث,Ocl/βu(A> $ m'1qyzD;} )Ca\vnYE,`zd4U"df<_+?g9k ݃xl "ƪt^XtV *ݾc2ݱ%g/8~fW._}#{ Nײ8ZX\^c[akkt(-\.A:k 3pQ@vؐe%-M&V@ 49`Ќ0zsZhsE= h"UhCv8vʣciO2>E5/𔎑 t9Ѻ$K@=mw,XJ*\&9RJOJ*RKPPr%oj'-5)Si/h!f`hc%2j%mZG **hn mk8RHJ);$y }uݮv] Ve :.غrcHW]KV5ޣDR&֒R׈K:VTl~Fmw=YyQ]QQR5:J8c!Ik7I y^QE/XaLC[ -:DOi\m>[\:,N]`K8[9*b R0Q,1 aCS%%OH.ɗQÈ=o7v𖷼G_oͿɟS_ qk7xWt#?#]ﺨ>>뾎WU%/y4p6W5E*X5V w d8Át,_3a'X+l%c=6 t{0;Ï_|63gGg;.GY"W &`DK 1%C`b, LVHA+MijOf_&ujfoM } NQkǛ&& è"XZ TtAum6tIytSv#a"%r}N:)YJ#8fb$w6gkFj# ڸFj:R6 Mn N9{̺GH84Vrҍez^KȌUw@>FhH;tN(ir]J=8o+5HxthZ+A҉O[ԠC-JHˤ.9N\VcJFҘD4[\q}Df¢ͯ%za5 ,%O~{tGv} ;K=c=\;,aV mէ"Hƥ ŎwnJ5.^u$a37~y3gp7oͿs곝>}׿}.c۾ˊ =nyԣ~noh?j/})Y.@l[ Fev/'vo Dez4)꽕%'qjt&tUeƹsn !p  -w,6ޜ Ԕ*scSzg f6X55:aPg$[ٳV+}`,ҊUqE8<%z7D+5Ze;E shG]l/#nnF%/XG>tKWHrY@18(ej&1j.(R!L dRzrv䂥D.(%'MkSҚ4ґZcə:d.:"yjiBuAr舶pS]n3HMwG^d`G($kASKXTS)n_d<- :G+)6'8Lyk:} Y\#3.ȫ|^g%lI(> e - m2/ R]#SW2UQoB97֫=9q+'S;Kv ɝSkѢ gL/tFD*Nw2˕w2Qr%k/]xT yG*9; K!lH%GyG"w\BzQB:ϕS.C["YiRrZVZ*ցXq }L HK5ViFJgHH$% *i.Kڸ&81rRڜ[Bbq\w5M4_̚VUb`U\]qUnM쉳>5YQ-jA H _;#, Yg&e9ƌKA,a;!A 2],^#{U~g!9 k J,\)KUl[+W,`ZV-bKI47EE hæBN^N&sڄ($РMMsKʴ<9W{_QW~+^zn4@mHʑɜ0Ukh k0du#aJ^bl /cKl{K^ί}~yl2)kw*!pM&@Iw7uz6`~DԙS͑ÖB#Xqr ^3l4\IP=ѺCmp짹߻gb-p?"i%UG?)'أXY+Afz\G!E7"6"c&Ƀ %)kL R"bmP璋Dm3@!'GZ7)Z= ϵ>Giv'ȕxQ5Bֵ"f 8PnXh$c0!>8*5rS3"U}/+"kթJëE8vsHfpwy),`7 0#pRH3eI#S6&"0At!?s^W<(.vD)hVчw图雸+.-@İ$aFXD. j"m)/0h^3c=8D5sx9 C$0I0εM`X6Y,%qxWJ,@ƛ9u.hnbA8U2d[oS*lgP-b +H)i*bVOS0 |LJ6cU/%6穑Lg0&$~G47|89vܧ;kҹ5Ǩkr/ЪDLh"O].A͚9-2$юWՍ|B+Ie^0 NI^Y-dg72霕5RcLd>b$%׸׷`?+e3],$6U~x_gg>g>s-p>hկ~5_rs7=9Ca^7>{ｗOԥ:싃.{DSS^khkXWAA=`}eVƕB{1VrvEƘn-y6i3K8M:TN quX3$1t3҆қg ^3!Bcұ6{{,Ymi$Jk21S9Ð7^6j8:Ì(LHۜee='d].v%p|,<: 7\r(넽ثBgI<en3f |(TK|N?UI6QHk Ʈ{E2\+qf#I:KkJ#:)8ec&f8Zs ׹\O7jg\ncc Yꚕ6;vѶ֚O@-N/2cӈ6dU3AD)'ĴQ|YB|QmՊEo~}W_;;xSb[z~:x;_?ÿf'>]wuQ?\ԩStM_?R2?'@WD<9 *6i5;$H2=D\4M'y`ըȰ]F1T*1JBA^N%3\}ebYJV`r3ynZy/ K'İfmD >j2)zab+'Zkκ>шO0Y!q^XkF"TmIg`5aUɽ3&=;WNW6.19Y?b{T\Ξ m^F&<$#Uq㘌cP7s8̈89aH -20or?DI6ԙM 6]- hf$)fI!W_K_R뻾n+"STԧ}}u]կu{,y oG/忼ωK_q_58Uⵯ}W>Po: %Cfs\a-V09Wl}0:ӗ#xm&q:1Q| hf&`~Z1:U( e[ԃx~jhTH6I64CG%偪{df(Yf2Ej봦AcT5Us\hlь!4gN9."go[9_/߾͵ùs-&@rH'"`jny¿q p|OYp)E_J\qP[at]iS mIQET9L23cC07|y,ٶJւQnTHnu!|Q li_sYO` ucɵEo+6L'f[YL&XӯBR4 FRsXu5 vb!|`Tqy{G 9r9wy'??ÿ>}/Gy@_''R+]r'=I<)OG>Ÿ3 \;wM= 9CY`g/Pn/o}5fnKƍ xbFi$nr>6bU#fo:u37yH}029ݧx6LGkٻtI4+Ķjn(멑FnF/`8`N 3٬gs6P"@B\Bd1h~sֲ ;j4S= >x]z>u=?hԝ OmR䉉NkJa5#MP3b5#^а&Q~FĒUrr :@Rͣftc믫s ؁Z۪6"(8\`X+<#\ yA5\>%Xi`&5|b&X ?b՚~wUFl:&SJM>A.!){%o&lsIL_s?sk/;/R(ppo~|%[i} _/|ᗕo6* dOoy[.@k={*x__+\89}W C"@mNmQ}.n`ek1kSwװVjsyD/H c̙b v̛&UDR*%G 'RhT!~),ZLs(IX aSfynqң9@ nzb")պU,MT\bԭ:mZRcTR[4'cr@uVMv: ^߽kI|5Agd;I%2ں)|z<Y"HpD”1 *>,Ry䔌|A8&_E39G %RgT.9?4h/eFtHUaEB=2eZV?ZsF Cj OQ4bۂoIi Z #֌Y;sd"@/+.fK0ӱ9?i1txd1sÞvfXjx!>===z[n gr˃:~W~;7.vCxs}[o囿9yW+}JjlAfn2׌uu;TguSbD -ë!:FW3SY6niBBIrZH,ƨ(M%:icIZuHWDk)s) H&gXEUrzD9mܨ%1vYgoP][-IYJB%'Er.B=C)t!A3|tB8׌_{Oq~יT9 HwK$poٌu3+y< RpL"6kd$gc*!X#MҐo)b,v6RmkқW?Γ x~Vna`7S,̬6r'Hg5YάQ[/mQs醛}Y5&IfyF2a"d81m kS<ZQfL+͝U(7sldĽL x4J7@f@M=˒l_ٳozӛs=… Ѓz/{.yFR6*!x3X9^lUvяbl" :r N@Nh#F6uV*ŀ&Qܠi g75@֌*'3¨Fr+Nu-h6X2=~gxN[sL9~ɽNx>ZFCM4ޤv0;Yc@`}JdɔsF9jF%b֪/*dma‹ғIt,]M]Yr "(j@J1#4)\İվ„WB/!JYf#sK'h*֘^2>Μ9sQ+y=ij>gyEpc쭝Eݕ಑E2D]m8:l`'nȰ(.ߠ{gKZn&:djh.m!%xywc-.a[gElVIr)9BNR=dzˣ ,y*Tְhd fSedj!$o KIbrYƄ3g}[Dh e_Lz̕qy@I.-n<GOs׽+Vk}flƪ*wx]~<|9׀Gs'o mW-qf^"hr?#B3)ebtS,ԷY"jd#YI'yhɝ&zs'8FH46s R)}b} /ݭ!rpYu8v lia^5V@0<蜵ի-:Тºhꫮkhj&:V&#H`<{3a>SBJӒhو:X01!xۃ?~/Ńz{x^vQ|gg׽/R[u]<r)ZN\7$0SMyփK~e?MZU45U^;Gub`ccY [b)SHyXSfTz$CZP:&@)iADC?n|n-%OҰ̨T\ރ(L-zS̽v,#kTlz>zx7w^M^?{@"(>}=$9s+??.oo|$ϟ/|!sW也gc?c//sM77EϤ2T#߽UQk3փKV&1ųyp#,Z}sqzWm'Vpٛ}Hw7MRRB.17ľ@ri|*`”|UOg)SJiSr>U`o9Gy".g=$ۧ?i^?h=J={nj0 oE~|哟E'D9oַ}ooE|ź} 8 vlml냓wE@)Mw3iH*[ȷwܫ9Ŝ]^v.X_\:'%h#b^KmjGj֦)g[DVD6@0:$9٦G~@j>OdHgЄ0ɹL`ÙMWpYڐ6x 6bmiDJE,AR~!/cHВՙ\`g5e$Ǎ-zGd%)?ƪxIDv"^3xo{Wϓ5tܜ J80 ?G!4/d4%7%ARRФ"w#/:Jߑr 'Tz q$#Vrk St5 ե 15±pXM=بX+Z#A)V=o6fBm 14ɴi IDATq%&i'g5E7QQE/Hqe4f71`np9)w|>E.ij`kΧ\ۃ5yP ^/~/ vbaa!o{cG:Wַp¥E粅.;\F;PI 99X_{09|h%čglSQ#ij8,coesd)/ђfP-@oA;Kǚ'?$KdVdgޕöFڨt$h9*r[҄*,Z^o+,p^b'7GY᪄U򎪠I'rfqDY"kd2KJ&MHK k؇1RH=YWJ9bo,bS.B/2*mA3/q LHvV?xh?eTT&QCԇ6vH(`BV Hΰ\)nkp)*B3fQ (^㑘YWtoi 5$-uԛVk&ʚ°V2ϭ8Ƈ-5CҚW/d5 ; X \Z\2A2lG`ę4#bR~ HmjH!.Iw))$RtxͰi6Q}hifd .AΈDR,7\JH)z-DФVN]P)=>۵1ol= c`#b ťzgnUI33rCy^ɝ7da"XYHy!]84eVY׏w\ ckcG㨗Eyt]w_h{jFuG FmW&n])(bfKV.'YVtMl7#8gNsl&<#LJlNIm_7ufKU2x0/N 2;ėX:|f4S$U'FӞ^Yh$)ikOM-Ҩep56qUjbqކBeUܚ$]lmP3+̀M֒ @{ւ+m%Ru|ҋ ەFalne)F67|V80@lcsy(EF 8UDnmD•\se| ҜCjDZ5ZH]-%K@ 5 zŻDbӈB$䢇cjkɲI%ΔT|YR,ّthIW !yY!Dp.a Pvܰ YtJ!+VbmAi\ˊ͸"HG3/-e _R~:g?2|=x;rGLŋ5Ho_e~~N /aU*!&`4m7uKJD7ng\&,±]iϳsrJ ,#9cN(gQPI8U =r9% M_:0s7d愒єqd\倮1_2urT RKL )ɍqƄf6_#piQ,[(K)[ͅWR*mSsy( Mvڢsי)틸\^Z9XvV@sRˮ 7j8noQjh-5^ATW(.+N-H:uUE k<ae4! iA"r{]""BlU) I.鐶"/ Qu r'숾AF5s4#.[rۑsnDv2Wa]u]TB^~ڕZUŃƦBF<Z5 YlI*gՀ'jHԑڼZxҮYle TZ*ɊҢb[WqbܕY:_?q~N:u]buG9_+}|9''/k'?yd+bU*8[޲Į&6F3*a03ۯ9äт2a PU7B(vCn6pԄQ0/Q3k"H1JU.))Z]`P 7UM"'s3gE:KM%,/Q-2A="==U @M_*yUmFW53*(s8Yr2!8B-t$0jF` ՞ČEhȂ7CEeɤ.eZ <3XEXZA ~rr_`a{FT.hRY=#up\SRg ?ʫ2DoϖmާR-5+j' R"+$h v. ]K{#w?Bϵ'v;Ni۫׉:bI)[5!φP/$;P"Y3& =9 u_KVէ\<.tkf=״  zXйC.z@osbWbS+JCO}5{WgϞ=??^bt8x_^?ʂiJ؄̤0ZUv2W׾; GI0n46~aMz% <>P [vJ$oB0qGmg)~26>T;foDL{T,l&P1u@W\L>'YƐv_ZT.[^8ExUPqmqJ WLfud0ru-u]))KA V06~Eփ LHxkc#Cߪ|hqe?ko}[~|gΜ9#!.9D7ͼ%/bq]w]_1oٯP\!?\ZQ#gLv}Ĺri ¸芳YEL>J%"-,hJvWՈNq\*f*Ŷj*l+Uoͨj9b1vXd&0pxrnav t>"ll"Mdh7&4\5yo'UeR>*]Omel("jy]Yee>[.eTN-/܋M0.ܕ?Bmல07%#Wj+te0/X2J!|I/%'x2d: o3XD_lUZĕRU!*Pnpfm@M[7$6tТB(:LSF7н1CػO;t=r'TlDKgUʂGuQr >G)}Q-9lv6VJh2ѹ+;6G '!DS.&@XcQσmC>xʂY >Cyw(jQ+lJCAXLÐq|S< tMGs8JAWT ّٟ}'O|8MBضwTo9}ބORkz%"d2r>ԥ`W-Vl2c%&sWs4 'E ֢^p1:%2)x\ >"Yp>R"A 䤈eJrI5"%6%5ѧHLiP\-T$_ӎLϑA6RMOW`/"0c+j@8hgڌ‹R1YA逗XBWz'蓙zҐV˂zA8] mAՍ5bҶ=&z{{]E0G+ml火lЭ\?YyK)Ô@29j˃&yGQSO&y2{~,29Fl@|0Vk0f 27Ty0v4Ć, r}42$4\P[fZ2!&.rz{LWZ ciWF.4j,R279m V{ZĎCtxh SV#C5`m.l(\ a.껍$Qd9Ԝ (n)QHTޕtY̕> UhSyDAܢ?8I:y mhv03&1O;|8w~߈fd1vVSb0DUrV<kRȿfB4,ʄIE .[O=~>1 )Rq.S\])!}Ǐ QG0ݿ_E~g?;#}.7 ⍉x:+XXe27n&hh۵M) losם[,e+,[6@GsnJJlyxɤ"ףR5PG|DnFc Zt&+pQP ݔ\%KsOJ2&Lxw_n*b>ft]^jjԛO= loӌ\xO<*Y]*i؜K*Dth 5B wkEM<:1fŽ'aRfцds^9.! )in. & `Ia@"$q9fBaS?o$"kp/N#6* fN;'C5Q18*Z&6`SZ&--1;d52 H {9'T5Ṧ4č)rL^=>778Nq2샑≏wϰ7<t='891) 0K:I( w]izd_B`/րυNw1mjTMFHiV|2 4Q[ի!rOYKsge -^s ㎫{7^U_Uלw|%~~WWwin9+tJԖU&\KZl9 \yEgFeonCs]Y 5? 2d۩Ųl24m8934#ňH@T#1xk0pIRgwU]IŇǧp̃ĸ_qy}'MGiƄ℔ Cyr-aqʷlOWDBl.j6(,+=TgDp'e,ri l\c+5е".1َCozHALx ũ2ƮdeEuj\U6d]nEO mgSNmZԄoZ6za2NbB\qcY>+){k(}G׶HGSF4mT-1)y };6fzs ]PrG̤䩜0; 4(9L+.ԑ!M4S⏁Ta8d;ZG :*6_WW?_C&/~Xţm[O+Zo~,wvvxdb7q<xbܘ Xijk|e{NRAFQ=hXJ4JYU²oDzJ*ht=h6{Fn <ٞM=4TNf4k<Rڶ=p?r3. #{%&QǏmBh THɿg}{R,11CT4E/'$φFT>Ҏ2.6Y$#)~R|YJt!뗬;dhv-+k).P;KK؄mJ*A`ٖ(0 +qh;asbnXR4M-,[U(B(sd]3q'KD=*Ds=Qp~BF#jM30F@Gdg"(:4p EE9ɻYBNן}&i:Ž?13we~Fۍ9^".H˖Zm>/X%0%AtH&("Ҹq1Y=r6)^鳘XmJgAhmfRWRPEξY~<gx:d֮!YvC RJ8$PFTF0qKį(a`Ѿ ~qU"vW7qs=l`?8SԲ E͉ Fa{'UU|5ǹq8>y3wen{}_ uC̅09X'O J*N^HqC#P9ŢnEk$:sT|%DNф!Q_WrZumCدkP $8B5Mܰzr9_?4{]CU_%߿*lަi_uc:k+%.q)w]vx[rWW_tW/#)I{w ?̱Sg&0!n7ǮI"ƺn.5ֻ}Kz)[ӂJ{׳j_\6O bc9.VHCޙ4f$ \쐾 z|7]@O?|'/~ =>{?w$OOLI̷=#$|f(>e [9izURZHP-"+Zװm \{Tvs|y@uuq&eD\wTALSjI]vc ͖G a e;4_J9RWxZCߌjf[,8$\c6|^O&[f\T%S$%kuKWΦ]w%1l25#aOWbYs&DJ=_ m9wYl1'q<9Oa'>i~'67pYsζl,>}v޹GSFh=&rmeUe1IzDC jyZa}!0 yYzHЁ4QVzX0KqM&I`+*۟}rG xD^]{{ۯگZ^WBUy׻moq{U{_HfrE=ֈeh;O!2d`R+Y9X+"MX+Ej+⒊1Rs=!eb E{ly[[u8Tz^e]K3%=B9x=:K.ۓS_X|rMX>@;ڼ=9'ĐlT-UBeIhAp*E+LF$VA{.#ɐbmV$8Z-rG IbÝΰZDBXfe}:o&"2UwWu̺,kD g8mbW]z9ASr%DQ&ƨo GJZ.J%up\"H);˃̨dZ27'= V6Og$O}aYn= t/36o}ӄc'-1p'28Swh+,䞜2^MGs{_wY5 !câXW, qέ]wwmS*G]; ndKl~4S/4ٜ9-%9+}\+v?u{yssozӛxsý{Uӧyh4:s#~k^sՑvo{ۮj?r?~{+?R$<ɬ]sw/Oq7=,b8fKGa6C6WW\W޶sP3jLpYqYSK׆@ swDVjP,] TNR@7k@;=/}tcXv-Ҷ-F-\3E;%p"$\ D4{@ ,^ҔW1A@18īWV<],>vjji>O{DZ|7Ӵ'*:] Gr&ȿw;;yի^|\xSwɋ_+F߸?HG n#}n^\ǽ"XUٟQ4+.S/i%1Oߢ>K<''>N|Ig! qkl{-8M@!;sT9ːHI"ꦨ7ʄ>0A{}4N𾵺ޮE} `HˀkjAn{-S:xxzwl;4wNb܂/dMkIod-7`UNaIqVE cA1ܙgpOw&'CD=0r~u>8#x/| y+_z8vAR}<3Ow7=ӟAwnD?4v<{Q&11\4z Gww<)OyK_x<,}1җ__ooǻ[y_K^}k^:'_>qx|Wn.A&]KqE]sɊ/h/ #Ƅz29MKwυGM7r6e91YU8;2g]kbj*]Qh=@]5dlݍQxquDXA݃H)5~F#hny}TΣQ99>ƢKuΏSEqUH+!;W>ZP$#r﫦a8Nm SjY}P;*'T˄|n#nzr'+.W2h5_1zsuAo8>򗿜GGqn/qEۿ˿K~w~;３z,<[E|U^.^]G?>#}~n+6yEqe"eby_Gl*OyF8_Kh21";&ǰ}76q&c`+.沥% =S <8{D2 e/R'h{@ROtzY'm-MFU>1?Xw&raŪ;+\ΐSFr`jE?CbLh(-l&`ԁYK\"޲+֯sX6@tВi༒cF\U\Ԃӡ]N X]!o釪fm$)ƶZiL!;=bBP1f"yUt37֯XPW*. *a K9CjMACWP2kS8*0m3cw'ΰwgYo@ٻp5 tZSk>q $ZÎs_BP+יMWP;|p(a7"~{SO >tLyjgyL6gTe|9flI /IU9nV><Dž _~~򕯼,UooGU>__p=sy%O̙3={=i|7}esR=y#8{,;sbVG+x&zeFڎ.xfFYK={ ixLh&6Nhn|9NlM8w&paGwԕmi̧9mQ-#'s {Tޙi=.|C$Sgћ|䔾V02nP7AGl "je[cZxUBJ 19 %kF 2.X۞+XdEZ%/n`\NCsO`[Ո3lϫ ۹澃eCҢxaЋRyK2WH"!u©}*fXӳ9CWK(XWee)$kL>a]ac^%YK8RvTqh$T*ehϊ=(98Jv[VC_Yk _Hӕ`MGJ04)H{b5\#&![ΙI*k]"Dt40T<1b{a>`wwΔ>y[ƅڻD*zyb` #rPO+4BS kծe"!Xe|3gB]_Mzn5B#a"?3?÷}۷ܗ_ "6G҆Zq;T,#jh=&#uU / /w:raK|?}|#KZ.ExڌBfNUa=ڕ|FVO#gg~Vʼck{Nz:s+“Ǽoǯyӓ}!޴ a=vQPCl զ^]^9ڎltOs)wns[W9}i?˟b}&'Ö:yuggk!O{fHއnWq%䳆~.c|Ӥފo߈rm1l?3O=>c>-ӼApzNq+{IՓpW߯8;}}|~/O>'KD?Osxoo})y;:ە3Ws89SayIۑkW /.;su71+Ӥܯ~W?1/۟uKi}Akb9F<\gvsN]|\-tp뱷3c(Ҍ:rW$WflQcN`b͠ւq]"E/H468DZ! V ׮nzu~w;ܽsWodw}ssu;pޔ))ӽ s+Z3V#vyo}o1]'kw`zrւJu 7ٮ~JJ[>0S#SDVh#Ѧ(C:-ȏ|8Ô݌De -VwK$ 9WK;]4KAc>05H2TD pv |3'' Q UGba6TDB{kHNhCwGkeT STWw>e{ቧs)=7_9o7\V/?Eg98or|R*.-$v1n/a5&cvӖR/z/cא/f/rAzvz]{ܸqw^K~ ?'|w}k|nǯگ=Txz^k*Yz^-jQ$!tea X7)wUa;N\6z/İ펧N u~;71gx}1\\e7|+cCvqf$*:;|¦ qAh[x n%4rlvk/{ƫԇU'BSܤQ&w3ʐ@?y›'h ՑP< aFRi@\Z7^5C Χx`?3g|"O3l0wSv5D{$h/n kK\za1@m~E >[DDsDXn3fζgB:XzvXj$!{]uj1D)ګA[X x*pQI-乡G!qig3Q]U3l³+9GTpƂO2[zof+]p WN<3޼[׬vg|Ϡ/~/1}{ԧFru{]68oKԳ.9n4ƀeJ9)y&\1Og̏,oo~Ǿí[n~8\__a|~~v:==图^Azy7ίY1t]lV3Vc{YMs<1lGgگ Ow\;Y;|esnP9]N3kqr)َcLR=i"Clʘȴj o"h9&L)4Tgs`.!tSHgqQ+kIia4wz fޝ$)]'k84!JDoӨэ^+Q00uTSck6dzDw!##/q!z ir|X0:T":a=s5­Fw>w.Ų?xnuEHHGvY2s0%5\rApzX8 /,Z0D NqEr5&C9"Dc!XhQYpC3Kt!;+ގ)@b%[5T2ٔ&wCzTdLk a܃~XiB=oF׮q'zr/RܽD^w'?}(Ͼyv9FJG[/PSIcwܿp(Z/{A;C??o5?>'C\[[X 0©wĮ-KptV0M+RM8Sxz$l3Z1phE1+|o+3ڎq+Oi9&O'M>gL+ʴ+خ hH^>D`H1nAZ-en ں٣=)H6PGsgL)ekq n$o+#43E!K3]2½ļ4S tzs󌻃i PL8"jlQ%t ajOp )6NRs $Q -GgukdW5|j\ ֳzĵafHw\J3c C+:pB JPFF,1d^dp# ܹ3VW9z Ok7wo+{jWy|ǫkG{vy֫*s=fatn1!3 /\%XpS :P!ď{|~-Gh?~ɟIw~P }}/7Bϔ+/reRԛOkJ[c:O:Zp5GQ2@V<|䰿u!޷޴(B=JL ~>%s3C?ٟ{ԟz؇rNWf07x,gtH99'zQZuO8Z+v9q)G#~zͳ5>7_7oT}سU|7]5E[Ϡ$4GFKW[r"8^v^pâI!aS-Q`)pgdpA(z"KF1kN$,шϕ_V>i!HN&*$S <^թz#1K{_Yt,H`ryި vZr;J]T)<Hu|؄Ԃ@Y؍%yr&bx  Pv]o-2YM_|vbkJ+{ړ'o:_xuEeuV4M}1aKo[4=__Uf IWgegEg eMv۷}??bwv;{^xx ?).~ aK}{!봻Nȅ6sYvJfqd1]6$8 OzLK׈*IrC/͝QrG^Jޓm7ϋ"/󸇭ShfR0 IDATՁ*^y6l6U 4Jit ڔV :…}Ӊa 9c-Z3T qgъ:憶:= TC'VZR𹐥aU18Bԓ[ZLq4j3f'I9/ʑâ%x=D%:j/{.!g|ɯoPH3<ÿх==a>I<_G?P?q.?3?_MspUa=RC!ގ\]=f[A>s[aڔb[`n~v>sɣMb\=Zj/j65FRZ@' =3(s֐ڠ6h3Lss_ ͬWr~ȶsz}'\k\p=H^MP zA,pUkGio [cZZpm" 1&Caˑqf wufj]yɟ{)c11i E1T]Uv8ADFF9kGv-ڇF/C{1t7-!")<2fwwHqUaBkl-J֐V6!ֺp7L 43 9q$VW.y/ؼMiӄsWq>Eq-qϵ.t;.n6U)mo񤶊9~F/hܴZQ7/!3>8 ٟ˕/-CE&ۿG8>O?4B7<4?S?_l6_+-bYqwd+Rds(-Zpg36? VZ}r Q*u2 6Z CaX+uE4H>p-Rw$U+ $+ ӊ/:{ph'EZdmNvee&bF AZhu&1JmkAt_-A(VH) b1%yl^klggHJDE}]vy,xq HșTJdωLb3@D%)`+F 7?dwb֑lzur,'DM};2yԎcH6P]6N3Q|Y,A9Df+ o kk K,jx5CTɵ`̶ec3kpnG>!TEe}x^&~0Z=h-ZjnUcW"+b-p-Xi;7JXh9DHe1b,#C_,S!C4hB:bPtW1ƒv҃{.{zaK=s/~_u~ٿ0f9kw@Hj(Y zߚlf\L^˯l Yhw=`-B;h"IKqZi٢ܢA۬# #p pͼ-PlH3t`1 74[9TEsm&ytJWpk-܅hQC =Jւ9&M8+T6=`uP%CXVZ`6C" vNo .؎íc'o\uAdSwTZ_z9VS4:-uAu,/G;^&F<ڌ5Z΅BiHL"ϓP*S96 kJ:"ʧ>ks1UL!N|%}0* V*4¦f[Vb9VNEU2 v e#x[GI<e`ã~&>c}$]hǂGu\züo~t1~W_O?K/P)Ϳ70L7|Mki9bG$lUܝbȣV`^:MTYSdsh9Ĵw"">d58ʫ!cg{ 䤸a31uĤt8) Uu&{O\ɘO s/P(! ŰpM 0m?z  eEFGK4$lqc)`H~)el*U͑$rS6S/K]t@iH͔^2bYZFbQ-yx40ðZW tvzaGR/ CT$QLӉӛ2썳/3I8]E={jtŤhJ7s |o\ܝ~w|wK!N);E`#*#JsJ]=v}q%"v"0p>c;)|Ո[@|l=DC8'C3aE2T.3bAZA4Z&Ta=Uju3sE䰂VQQk" 0SZ:\+G9" dIQe׳p )ș 6Zְ}%YiΨStRS(A ӵ* ̣dEcqrtQj p4K$IN;b!t Y,"[*.Ӄ1YC>{G@3]Lg;cy% )$E”l-6⼈xO==]k=0mGԧ>_;. bpxhS ww=˷"'%8 N6V8ʝ&ѳcDk7XPNpĄjǥ7YeI>myN,r4ʹ2J:qFAG'ʶ6imFDhs @Ǩ<ș!ZJnw)/FL2!'so?3E3)gyՆ)|UeJH#S m3RN Ր0Q#ɺNp'z+ Vq%5+tScv5JD|954[ι*n+'@2o|U.3‹ (qs^'0Idh1ӊFU\Fg'\Z mcʎ mz<"( th.͍a>IH 1=sCҬbCFcz*X%X!u1:Zu¼-r\"fBi1J[ V{5(1!69$&Xeޥxs׹Ȝ#HH)wtu:ĴwLZQA9x׻Ż/A q8nHAk$oG+ZǯEBdQ*^2hE$na=nV+fsYE M:^VDmJ R iq keJݥ.uTTeLGuϘ7[)~ξ0Ukd1);Zm$fN$ SˌM;o?gM!ˌ£sԊ17Ą;Û`͒>2#FQ `xZ/`1wF9bWމ]m9lVI 8K+u!   ؕJg!,,>c(ac⹲nkN\N} ֋9^,iDir U&V9VfP1[0@ĉdf\EizI-)d,^23V'hh#EEia+hNhh<ъ؍ȩsif V ^ѽ!!$KF+_Ye}%ݒw0E. ܡYzf|p=*xЎ?=瓟Cq's.\@K}C;FD^Sj8U(.`ucs?YxCk&W)$z zp]9cdSF\9H9IdQq"8ے"M+G-ӎhh[ݴbDms$%5XFijY4ͨsA]wMhA)êv Fk>TV-׍l{mV^WҚcVBCXͰuml>It2{ [iv 7@<ɩ)!Tuej69:)sl#y'uvy3xDGF[/;K9a[<-m"7PEr1xh mP1'uV@ah;+[}demcm[Ϻusε~9=T |A DFK|bb0rB|&DB$F 6ԗh|SOB!t֜s/u=1UyzN}Zsαk\=TDAp™t| >jLb 7r6+WrD$E]Gm~ű?O[N ]kCTA:L/X$̩mPkLf%8`(>lW8 IVYh>P7}9ݺUEsyt>b9U uxU!Sz7VAR jč?7?wޫd=>S?S73Ƹ֭[|۷}ۍ9}r_k:s 7kN"acBymP] sٔMӔ*Uz}FrA{a ::I7 xdȅ 1|Kеcè ima⽣K\齁5zk0 Tյ?G8j^${G`e8:VZlWmdpY3ϣ6xdDlH픤qSC}T~0e,ч #Aat7e0sz;b3{J2q$hrXFrtEG P[1wQ~R(osmpr53C\I:V{w{GT>H1uգA*˘ 8YJ 8ְziD]Q";x xFguZ*fi@-m4>r3s/rF ({H%"F vGT-qGe9YEjj8X2؞NŽI;~̛2G1\+OnAkJVg9ǢeOl:5Ƨ?4Kğ3 ?C?tcoP-“O>P0 \(SB9suRѰISW-Nrmyي}JYzPP:7^(^/q %Wq-fcaic Zo\-010$xĚ%ib*fۻbxJfJn X4/Hi&)] Cq7F cyC04N;Q *hs["O^Q̔ܢm<u1hMAj69+("Qח>Lj׌3eK=RCy{#r]u#.G_;D2piO-p',3革/vA٫ IDATш;= /ܸ23Ϳ77ݤ /p_eY`;En#{z#P$cXŖ£ .1 [1ܢ:?2d ,.vH3y2sJбgF*+<  Mu`ј}klimI$O$1Ԩ8Y?Xl֝?:$uP]$"\S`7^j*_f駟#??W~W?Pk}U>>;qU5I41;Cpwp9Etb 7d}RzƷʉB[XF))R&An7!L”sbeDe,>_yؔK3W #ǖ9,  20REDv.3lSxZgmDC‚$ƺǴc)Ma֏lAZOTyr# =HZ)yxL$zE֎ՇȨi'31͘$$IyK6Ph.h9cv#[vTQ[@ !5|.?\ي #mtzE=7uZ:r+jOq#+sNHqLgHP2e Ȋ_4euԎ$ura[? JQ'S5 ,{iK):ök,وU_w(v2oz|^vO?3<~c_c3ܘM>k__?7>{'#䏼ϻ!zsEW0xxlf!g#D)q2rvS.y<\-B x6NGduAd( QsÑRob,)؄$GIY1MhΔ,oH\%朝MԶSzc :٤#JıwXУTTÍB[ L<"G0$L&ЮI0Le=9C,ܕ@aXd$Mdږ4A0!(Δ;*M&rF֎$dezWRI I%Fw$fۙ ,Μ$z`#'1RNߊYsȦ5m!gC q)i<ȅ30mȶn?@.+ 3jZi0h.Hi%55F,ќf 6H &a\]nqh܍PLq04gdJ쏕]2!ͷH !>Q$!\ K̉<́ X; nNe DH?Ƣd{A<>E-BPfGۼ~ˣ]RWZSԧ{ꩧx'l6/koy[x[¯گwGGoaׯ+mmL>g~7w,`.\Pې񉹄PNQ2O?/vwm!Jؚݔ:_k,aMbX67RIG5,3öd=MZg4@9{+˹.l҆d2W=T QQq+*K%-!%AcvnyԩpG6A}0dǪcǨ>%яGE˄1rIIV`s@-1BIis&iƳb%&3i$ZvL0 - ;I EM0D6.s6N MUb1ԅl{ĄhqO\}d!#9*Fc :d8FlrQfV4-:@S٦\QdGI: soFk")àKgC ݸLKSnQхm8ڎ?+M+SS i69 䴥Hf1ϱ@ʈ ѺAA1$MHIM%:E[n,Qw=WWD$b]LM.'I$׃{qtۼT_Fggy>~~M Moo;w?7M}>nz\BDnT3<c/G\oŻn~7x;[f_ qSx'ů)Z ru@.İE{m'<Asm5g/FF*Ko1nZ(m>HzT2%0 .e:#M9VYr@k X6" !RSJt: vrs>}Hϓ!a1"0tF muUĔ>/QFJdClwXkK q쏄l8<>ĒQٱ5p]_GNOdG;]zuw|ٗ}A(̌oCDz,/y==wַ5~~˿|#x|S+k{ x) - u6fl3Mgby֔Tf߲DGՐyftýҏc]e|Z2syӱf8`!9N%U> >>XNSm?a I m+!OLJ~5CRy{*}c:O?4ozӛ^᛾_|~/O<+ߔ8p<ozvcodK}oI?0癉=Y/IH~fEs(;nso>cy@(db[ \WKf/)"nD'29Ϩ+(n@Iұ ?r[nD& ÎFܢqA[)n޵ume]+˺(CqZ3O IZX\*V+C+:[T} n6ʌۈq1T9xF1*=GFG3Z!kuBk\1{#*Vx;Ǘl"O8 iہQQKA<]Cs8lN"@Ar`b3*/feRHg'HFʝבɅvy`9th"S w[:4<4f*Eh-#'਎Sl]Hɐ,!DJ,+=`!-Any&gal&P3-I2}.\=% 27I̼Vla}UMaxr)[H.$h5VNa 2b%c&r^p*h#+X\C O=Rh1uq!s=#R$آhN[b͔r;͉+Gː2> S4s[aTHLř,p4fO0zD`Tך:C  X}d3FV!3ڧX#dՂoBDyBB.Ϭ.A$Aƛ",|$v%?GU m^4_ ;`G߿@9<gWUcfwg7'.<_7\/tَζlҎmްۜ3 |׎&GhOiR4!>(s2 8^6r4;rMь*[W۽ZI)G,(aۙG5jlX;O$|#VhFs>O_yg"77|#'䟼"HnC37\Tzw; |~__j1zj IDATDaskn q==cO\#>7x;,έsh]";'gh@**N%n31_llGT[֩ fuR*+229Hd]&RIx?|!e67pVPe4m2̈́}9KlCBOtcJ퉺!lIu62s.Ls\UXwrhL#jB&%sEm#8$c%{K&/kMLsAuD>[|fx&%d6c`sATydfbA'd%SL-#m\"`>@VШ+:pӜr7E|Z\*!ԟS%M/_]/ſ_=7{QJ+q?3?'?}D%\_]]񶷽tn/ >E&zi֥ =ng[[&9Z$0'lkU)͕nHFnyb$hP\;y*4`\R"<+.F%j_ζ"gKΕ64@ӖHlv .m,/ yAħ9*OEgy8ƌgyI|Ih֍xEi{0oX', 92:͆sHy Sb3}ň so >:]r4$(3,3 4BLE8J"$,"tcٞea0o e0o2 TM<%D23grlR!%e3E2.ad IC:窈FsTق(W\pk|C@*B5ceT E 2S0d쉌x"Y^Ř7 [:Е<|jU852۰tg WiΩ"|C>яg^:]ߵ92>rm\?|w}ky{+`ܹ _U_=Ɯ+!.MM oxv~W~sz_kgeO\Saʱ||m|p y3Vl3L[<"3hH+u=rk,]å^N.[% Ok5WZRȨwr>Gc2ٖh|%ȼ#Pĭ3vnΙ;S\^]Q)W~7'?.^xjq!3y䂧˯wc%nNI!|؊q PV$rBցXpe<)QK!li9YYERP ]IʆDjxf(Md$̒(S2 rhDׄZ#YAͣx؊=> !-cژa )6(XI͝saW`^(Yׂ!E7\@HhCPWaJpłOa(ƈHP DC.{T><,sCeg8gɹF ӟ=xO񙽳,_r.f[ZS3ih aF:`dkQ&ޮ`̋433|Or i{?IHܒD‹/xן{g8bgV,n ,'0bQD@!0֞@ X'͐imL9q-TWr5)GtA&L"`[sbi[癳yfv eI9e\v YIK19^rkd5̮doNw8;E8[dZ[0t,x>"bՕe:vķL3e]@ޮ+@d"ќ| *:X:|vCZ}ᤓY״z?[ ?V򵐎Lp_@n+ϊeU8O'"v/T>s??y}{?|9 ~߲B7)?ofßy>O?y=)r-<\CDx!faDuݚZDgBly \)$sLW*m˲FNΑ:QMd) `Y"=H"/$ R#!`t}"e#lqBHN3Յ V-,+/qn-+GU.}h\8"ƙ$vk;_niCvގ-]W@G-]"2悡:#{NX2C r$U)̱FUHs›1%'0O&\l@Jf%mwcnl%r)6ٝg59H`||u^x7k"nu}&fA!YY{ִ5\b;qB0M$CpZ9!i. H\DAbDB( jH:9 !q38w՞7C_kMڜ+YV^~ߵZ(݇p3QT8Sx|PȌ՛:UVu@T$Gl>C]+ J3/>8#1HU5fTq\y[ҫ6c#4lOiwgPΡ!1@xMp567TMF `QX!a}956Ĩq(q34\al*@ jV9%|9I,'a9oxVA~ypzg;c,QFc3M8$} W~w)"ﰲ//%VWWyGy>>-hm>m]~|ݫݬ`/CdN;I4~K8B1Ux-ZFF4TWVA]%qle)̅AiED"hbND7ƋƐ&R3qsRRѡĠ"DbC=m ZwT^hcpmQ{Xj<}/*׮F~eb# G45tbhg:&yZcysNq)F%%hC!4I ؗ!$UDH,U˼#Ġ|yAЉ,'k*$zHxIIDi!n#$S͌:U {}H~@ K,$FbMD4tZnl;|vbJď>J`/z2X<醾LY#L÷?FCr|b mDmIӧcbz,fdqiPˡA| 8Ą@Cn4m*J0$<$s!:Eݭ4|+* %Mlɾ%jLwU_Lcs/N}BiEVjr K*T8߰,%^ׯ#'#ȑ7T#cwek W8PP9bi1&˓pOx& MDny&%+>Յe>2 1qVC[>CR6D!R%dpD]ݔ Z&"F X-*7\sji4"CY?reއv}s,c 8Y9CGCbēl] r8%"hw;*Ns2lf1b E^:q."*;X "BY;A@Vp"xAEQȨBcsUKh<,OLY0(lą@ !shZYlA9k"IEG#3\DI*4 tw8p}ƐX3aIg,Wv1| =n<}M徂/}#qcXD?>~}ȷwoaEة,!('lTVV C躚]ݞEBd %R!d$+Ê8pLU֎SeΛV3 ʓnݥ>}UY8j3kw|j:eo}bX."hd!.Q5!̒c  H֣uLDgiPJt`tD< E+37z%f92,wJce:ʭ;AkA)!}a:!`a<ڥu{c^듟9˝y[[= >v(#s:wy~_r?qw_{ <~{kc,.p g,݃HG2M*1,_xn&šH(Yt5!.%E i"L PIzxbPcH nqsJr;!E&f{|iU0w\IsCp~VN&>n FuHCbc[1.,g.c&.ZQг/Q3#"&G\R:К´ H =E^N+! >zsX"G˭bb#|yCT(~%G㫃Nehn>PS%H:¢($D Ig-x  BRcHV7ٓHHD+ܬuS|vm/ttΓaD(E#L9ȴf?mF-d7+ؘԈH( \q NUƗs &򷌙ThbGUMhDhuF&d'm6ܨt09F#1^tZ6H 蔜(YLe![YM2gFG j+J`sM@OSW(`w^8Nw<_X>wg/O5U$Ƭ& HR{`D3Om=^MВQJ#'cEK_8ΩcgXm S-m&&gq,LʎyjZ!w m3ܹ߾_i;:;kn byuF 1DؐDpEzG~~Kռoe G2G}ȜeooHTKkee￭kcG>{#*ҍ=[ENxl2)eΑT[?~_~cʼn{O8dҌ+aR+O '~'n;o7 я~ӧOW뉇nNaα%[0ݒz?Ɠ7{"K-3\9h9jW3Qa\fg$ εABVPV2Oxg=|;AO+,Ђw#T* G4ϱ$fa\}IDVMH22.SDt~> l0%[>w˜꿕72?X+4l+Xn.pʍynNooi‹G&SA)椣3>W["sY<;i\ZO @M$=L@Q DY+S 55$PJ&51ΒDpM2>I6 8DMd9*LRC8t.W!B3ˉ(HDLj)“&FBZ DɒYr)>ďAJL8@>jo ^hg}-BC͜@OYJ7<4?S-`0P# iwl]|'^ O5X6%ez%"c޼Ev?G(WNl{q dQhHbq& lRuAKf;"CuIe FVk? >~8Dž w2p%7r̙#%z{{[}ӟW~Wn{__~ǽ*Tbe58;gF%inɤ6S=l@ٽ+_d܀=w3wl,=HUK{eY]FX]MU#mfڥ֓KMbG !Jwo|Eł)Hڣ(('@C>F8M>b=9F ^[vyNUWٞȵznGOƌ !I)cBhi4<P6x`qVX^Ú$ht_&#@;&j E?$L}I>V bf kMBuE!tm!@!Jh4i L)Yde %PqJ@ #1"*j`J16*K>qqDIiMhQΡ"(xGL'ޱrn[\znndPb (`C' 8R`ycypPr'V--Pz۬_|ֿf='4gd\ȑOQG\V`>Fr<0[ͧi7^^ 9PwM$~־??oo~S}( xhA?#Yil4͔^^z}؅TlVa,<҉Js0*tFwHH2W<737\FK9>`pc:{Xn;bbC@pdm訂FEOo-^ }T0yGyc{&yn%Ppz#Eod),(mPJZ E|0tMsT0F\ud2DZ(̈!$tLXp,'UK"5M9!j4$Ě7DeӣD!Jхh2 ߪmBi֏i]ֶ/q`[bqD:T BO'BȢ6\?1s+Yo#P%ݸc&k_gѦW٬qG6*B2TF e{enC!4s 5Ətpz=3ȎY^ž ]{YSmc)1u3Fg=!dZzX]"ΡZ2%3_aL^q_;ԥj&Elܨn'L+9dL6) Amd_l(N]8a5+Z=,?ZepɁ韾c{򓟼cݯ WgO俈:y~8ӧOя~׼/`f3gUcPO6m֢n-ͤmد,B^}ngv:ϱ_1\L*E&2Bz|RZ'C*Ocjpx MA -c: -&B/c=Gvn_Bg=|l1~o5.Ƙj0Jt@% H)lH3?o #1G t\8/9r73n,[W٘\gfxbQ1Ҡ!v)XylgYܵpE5BI 3uxPd`f0I f EWE6). M TE[;iZ uW&>2n|"˜0%`S( C0ǎR$Pj\)C9AV*FQWLOO۴2bF"L%5DIUL5:pUO-S Qvcn׌ʍ/PZX+)EKsb< h Ͱbh cJPSyӶ{tO=+թ7Q^Z 'ѻ2ظ]8j;ڽ-4[ë* a4JdYYM◥Ƚ"{2r+OTx})T>Y$x j0{j2&=ѴK4TuJ!$3k? #q;e{G.w}w3u+ew˗/~ZuY^%A?F;g).Rȃ*XgL'=~7> ӄ WV4ϱtiW{t^"vN(CwE-1$U &V%Bޛc>^^@pzyk/<ߧ4=;{h#,K;:5Fj*l^ %.~}4hX[b=֒>2+(Tc4*Ѕֶx?}<1wsnaFh"T547.GT` hR0CQ8hiQ\ok7ga7=zK.)yzE>6&4R4b!0D]'ԝT 4U¬5ň8AaҴ@>ĝ$R`-,>X( C F,)&Bxei|1Ǔ% <;?˗ cW'ϯǝ-q=E}p.p |8sBf6SW 0mQ3y zBJ֛&>somO{/~=bk}_>Σf8Gͬ}Q>^{_W|ݫG1BJ&I*NbYS%nR{g3 K\Ω3vzLj)+bcnqD19A3G*7Ņ3,fP՚5*D@rcz54@2+ȗ(/#;uGLBuu 7.Ǝ~9ČV@hd+ J'/V{IAFHldG@TZe@. .f,u2m 799;~>uY.q|{{83v}15=R5.jt\`gwyf{3K}~{e܏R׸LHg_7I0Ѝ\LHԭ i PCaqYJO?3d:!r*Y_b`4-0cZ"L(ءGġ" ,FZN&JbQ)5HLD%,$ZN܅:8O=?D1C HZ-KSkptCp1Ռ 4OMrFQzD1M7=#G ^@!D#N#3yM>O|_EΝ;wǞQKcL?Rxmmߤr[)?m_5Af"u0W&(1,Buk=[ 20jJVYɼ hv[)m|V[N,b׹u2˯%/,/'1#񦥪S=Yi=17,ɏEyy% @ K_CD'7=^$ 1 S tj}6 &  4j,J@FE .$9{d1C ;2PEFZ39sEjէxŌA~?'c~i"#v>8]_c`*׫]k"tZrHEHDso^w=İ< w(mN,.$^#F; xNPҫ 7 W61jlZh)*[aVVF! QCO KK J[CMlyl^ (Vѓ&"x1hF5s^xisgfi"-=!쳵,Ə~8UhCf\G`e:WG4*vXm) J0Y(4U2L (Dd&f<GKZ)zs4sKĻ_>BD8<}rgvnn/`\8x39]Q#jᯌl\7'aɀDK`NfJOFB5a>a­R e5+Z}G{?#|[\YY>FG\MS??WU3??g0ΫvLQX3py)&qIqLw;F3sKX6)&}vzd~hu*O|AdMsj,iAGqiƓM YFdgft)}B4ĝ=W]z3٣0ݟC+1ej1 S*E*I6 f7I*kRm d=C Gi!vcY6)0c&҈DtH" xrqM$84?I~͟"/ CSW89lNq`kUG׵t)AB=&ol}7]1 N<:(B'4Jdq{$Z/DܤlauķB" qf8p(LYGbP2&E_>18$&g|XcĈ#\Mi6O\SןME!0TP e)#@n ǵ G]~z.$TVWG&?q CaB?T] PD\ѱ4_u9W{kS5+%/{ok[V1V^;}ST`,:4͛`HJm(1b &(A$  x* TQ-w߭9h1.5WSI>uj9W37RloS}=?x#~q6$s8{(N.-$)]erA] M,I!:1HPTh IDAT_(A 81FC~* 9Bk$x< O2KUxb&hA9BhhGt#1ݫJ+UJe8UͰ> g(=L9Vtϲ0ZU^cn[OUcjy$8}PxZpzf#>^2NPnFQT ADҁ$VP &uuNʘ\8qxUѠ<>hi"!p#C `_.G+EI,Ϩ._`zܑ%ӷc7P_U:n=fyzٳ vP'Ρo]I@;#RA+B (a(E4[SS"!.=A hf<^^߭|3(ߎ'x|O9_=5O}S:=Lt:.]=ewqD|sS}HKLQ1!Y :0*R+'TӈoS"hУd* U))k GzfZ9zA]`9dM/^2;Z'ou$-!Î(\ƈxycBH 0 |lqM3*j9<(.bZOA+/  l$3@w TIIUd C'&X@b .AI}eL*x䝻#u3ԆtLv9Huʗ^COK&X4alܼA;iqG8G2ۙƉ P[Z!rbӝR`I](C qI" {fר~*xnF)vvu]Y瑽&D 4sdJѡ%%52 0N,r$S,lҔh";Jmv#ZdG':TEW9ÉRǚ8 <(LɴT cU@)GP59D{b˝*)Djg Dlz~7i}K___>cDǼ}ZG?E]on;maa` 󒗼:h7׽;>Mn=&K7 oŌJ-H6`te=ޕ"Sf$=ôaeR5YlMnݯ;E:j5YB5Nfm3%Zgш8GW+@^#*~B@(^.Yp~XzOih)+H$E U]CۨH9AT{|h(cGgZtg:gs~`O-)dHXRjk⩂6틜̳кct6Aeta+DQD_1*3 iJȔ bJoTyPBAe$DD"x],ք67Vേ ֑`hbAXu8H1T2ȓ7XYV9LOH%è.G(Q XԴ0!Ix eCkPP:6C7 jxQ c` kU;1x nbx_)$[mL%$gP?akn;p<h@uXEqM3y),hҡvD,D%*}.F I|AQ}M9.*Ν=Gt]Y :K]9M+EEO  Gc\\R @ecl% e\$&% mmYF)NF`؛vݝnyyG:W+MܕG657@Fl8ыFT, A@i+TfE&&ęW`ͤTb[(:*%iT@,HvяT v9P\BQX(v2sfڊa1B|T[LLA[m^/!FD"9̜XKĎeIӈ)nb~nL>;xvn>p=|~Z[[|_g?COJxk^shaUow}׎gn#4*Z Dށ´ƕPQ=V&`] Qx^}"hԔi^03}e3SΦ .¿^fkccGpGYel gGr4l"2sM&hEQ";Wo8C@˾5B@=~"DڀڶTSMk-u4 T B%}ꕏjwNPE2D%+Q$J,蝝w t}st2?E.e|\sQjUVӠ!W{XҠ{2%0uWydQ?Y|"-RL"ZuAl $q"39GƋAcq_vwp(t}%;WxA<6XFR(,F(`<͝YͰ?BL29so82k_4_OI~) `&'0ۛv](0bqhI4AebDu< e!DVB^S&$UM:G Q!!E#"kl;}O?&-DY%KO3O9Hb{%2wt`'-Kg=B=NV@޷D@XQ(QmSTG8ώ8< ?zм檪xy~(ރns=}!5y ]2ՈF;Ke!M#' ?'xhw=ţ$EJ)+EPѦ2B%L +EbpC%Dict@& 6Wחyϲ[Y bTp5 #`~YKz_Xb;i-AJw_]fpEEX ȸ]3^Z=7Oowu%jIA4!*`b!!z Zv81(oB5KcbQx(GEHGq^bwFX3C@xcq+Q }8ܼʐG Ҿaf rASr\3GN2& AǝPTCh<"q!+ aב&, s8 #8!fD]wy{?ŋo9/Ww}3B8^*΂煠4΃ ."Q\ >C6"G"#"j,Āc,d0sf|$Kv5+#.?xW7(b\?DJ,J37s #`zL|NљY_gḭ Wcƕv -)򂍲!F[VW{rZ;Oq:YH2P vJh9ăFC (WҲrwcWW|G6Mb"!!iLTJiŞEN /9QfȺg8V»o->#ŢÔ/Y{6$ QM6eG2zm:3w;Aok{CljCE[Btȼ7 'HJ7X4EiPbLB `2yq?@G҂RG;Jç#1q'ģnPxZ&J]PJEo܉̜cgk+pU{(u2}%xDqc4+ j("UQ:#$9Bl Q FNs,n??G~GnZ[^nhxO^>Gy .k0!F} Zw75.5)P֐(huȒro $>H1j&UƃB<B$B{@H Ё Zu.76 MѨR!m6 8|HP:b˼d19/-&zMSs1u (bbwI"A*{Sz|PTe`i-mhݸ@{ڳs*xeˤ'IOǠsv CZdα0Qv+ W7bo:r O:6Pyj*Qgj I :ULVd ^Z!)ހRГ1['+_ag1"c2 ''<^P$h˝ , ћ?i߂Ӌ: l,?W6/pZ&m)*#" (" w!{CwPt%1jl0;9F{t݊Zpp{D;ãt禈DO%%(F8I;Z)T߿5Ml ,B(=@-x iV])t<)V-n䊊@=PTVeB1>؄D9h#=~'V?yTe!wMI0CVu6&R _=2…XH%[O͍K9sϞԑTUHVДu>hT4sdFco<O~EF&ū%U]AR#pyg1?w>}.c\{[-V΃ 2[iђ4mӣ,;=T;+r ^Z&UEe*n# fm})UTi܃2bU2z Jml"Uqa&JP2Ż"Z`AxQp!4[i3lϱ>('zܬg[BMY,(}j fAFէ,?Eƍipmh\oW7"Ivώd/2.]M9?y7鄫X]]Gu~yvhaKs==k\W??(vGD+hBlG6PdQ4Ft~Q"q*NP :0qo1 7!ň"EPEhtp$&![MmbDx}@Y`c;c'VPWA>|M‹&I3:ڃ(gtXmDKGC5rBG$ &yCLW1FB:'7IC^}"Jb 1kq|Cد ;X}t]fWL Mx<T]Glnnя~css~x^_r4B… ?3g>]M};cff}c3o6xn{_{Cw|O~߄` !W`'Ӧ8m\'T66؅&c`$5Jc}hا)e`Ha}L8JrxP}vˁN3%L,$V$"ly԰&O)dʠ8sv׻HErM=V'ւ ~݄,C@`ZU IDAT4i&AC)HdHs蟘Gg9k&#a3BF5&'nOp_[1T<^ rB=C;V{uEH,1;#Wm/du'^ "oMA~SwY΄Fˆs(ص6  dx&>)Vϟ,="y{CC-˲/9sSN1 hZERb{{u/}/}Kloo?݋^">яrC~{=߃>]w=q\zoi v|'|<CFӘ^U֍zSC9$ QB 9ra@'BUC;: ',dG)L H¸0֨$2RƨLٙ=12,R-X.U쮧]{RAQq6?Yx=ՈJp>@yE|bqBu B(EkA3{k;hAea4j1He01r*ncehːe E  4¬ REi-򌃧H{xUe0y~G}^,_G?E^e{%2;w.hjq|d^ܑM&c\X}Wo1rD DN.Vh:2Q&6ϝqΓoGuN3{aZ.E~NsedzIDHPI@DR<DeGBJTC5C־N?A5(2je=&TNsne<:_ÈkOT;ja|!9RD{|#*0Ta6AY0,܎-na#XO:v*dH yJ J%Զx/o>񠒦qU!T4ehR\%H BhS i&&R w@?E(V7n(;ƯtFqY|ss{e|;y[rvvę3gxs=8qw]7{t<~Wx_WIDTe@CF>Z6WQ x-G:O#e`ߣ\"B5j*Ob!ʒ[ *KH[)n6%% )O 2fjth|FR]DǤ:1)uPb0M 5v1qhj*#$ڠDZt f9,YuP1)ꪋ%fk +X=g-AFldzg7i]3EHnbG}BҔG/xCeQ$%cSj6yq zۣties9q |2_`kdھb\; LF16wgʓ7рUE.Ž(rV4R4-8xLY:;1%6mjF-Q]y'W NjYf'S5Hff|3!*ڱoeYg)7coE/zwW^} w};P?O}OO~ov'x ^ĉirXٵ.`t@P",Dbj} i:|F[D`4mlǥhheR$fc@O&P$ݖ8f:>TGC[U"hCJ+ NaN5hM'ק, ')6I9e22^]\٠61jU;X 4-:*Af0uǂh E߰tőfd-ZX[)'=\I6q+OEBCEs1`|נD+xWxQqKۂIhwā\,:X*[cmtJ:+[Gf`k\ӡof]bp6N⮕\_0<]H w"GV"WPuR(殢_8ѹsH ,+yB*aJi\P* P$th׊JDPgSrѹc\miⱝ";Qn?jf.~B̀Swwl^' FÊݩc\b]{!HMUZMK C3J%gz]^43Ϝ!khFl/_aʗ.Zm]J[hU# Uqa} '>&Ry&%4Ej?2bZĭcsd}1%MA:5F9+ 1 ΗX_3-Uag\yb*:VX[%`RO]T"sx?af@ڿ:?r>r;c+zP{#RJRt&(c<{㔪!L""-cv0а%M-ܨUD 944<y>a45VFBSL7*t"7V}׳M??ӟ4o~y[KKKggozwsvDx5q>Oc?c~1 }{ox1Eĩ$:C,03 m|*"Qp]aZEQx[S*p,c '"  ǡ4>6M`3Z!!~(2΁ȔA5>ZE%-2uɔ)Aħ-ɔ 7'*N.iz)'&3llђMl9Dg[B8-RQ5"9n5=Y3Tfk/2gAyk:46eOhxRהvA\TYizի׿VܹsMo矱qwwwO{ｗ},--=Q&>y~MBiy 夑jC8^BcQ<:EDDf\y[£{8JɟisxP*7Kxi4aϓ)mCAXԋL`1=LUOO8:p,5{6ء\TQqѝwzf1ΰ3\`\" 7.5,C`$/@)6 I[e/&5XȎSu.(VV3E B/T: =e]c ǔgŝfneԚe,yЦW[l>ɓO<߼vؚ*Mw'۞iZ'q#[aUm{16w+'/$$5F|ä!xCOb0F"h|MA "OPPhQHOƮR 3i!`tD}U)& fؖ&-i @ yYlo"ZR,䭔,Il~bky̰uG<yKgUWw5dSj g ` 4;0do44䝁 MxdY$)^VUYyw9缳xY2 (232"#"m.늬31Џ3r.a}ݩ(h,R?MYW[saGXx'Jʲj&nJ3r9j b2]ٰD(gV[>YuRb ~K޹Lyroo?;&t~W@D#K>ǟ[[_3| ~;ïگ}jp7Aį/Ti8*V1vJ*N$CjoQ1Q3U; JB78xXwd+C~Ѷ ~/SNJC23Jw7Ċ*yȕXj `CeD]UgkҐ#~f3F.1,{ξW:CӚ`g[s|j].wrM앝%)Oй .)3k\{Dꜹ߾攪 1|ނ]FRx8cɎ dX#19THZبZ0LH7n7oޟ׿} }~ޛ<w>C=O9be];6"S ̯hq!lan&E$9^6D5!'ЄӖJ!eOM5Ǖd [C6|8Pm`Ż|^lhqLȘvH,[,qx&6:x +S rlѲ{pj 1! u`-bП1 =U|@?Sc'-")nI\ʰ0Y8¬,W|f(ίl6tT+pW*;!\ݩXc[si.!o(o!vV9'ۿ~'#ˎz<yx06kĹ-E@J!UxFb28#? rqk^ UҢ'KSB OdIНKO(gQM$ٕV:v—! ^wG!5__+__o]ggg\__js_/{_~~ss |_iO!/ sWǂIapcbO΢n076&#SxgyduuޛeU-j0d߯*Cvo Ὧ{8y]cb5QjzxCҭ \y!&KS7.ht q:Ԭ+ 1kwv<|>c&.> gﳹc&Ɖ%ԡDǙ gMΜ7q򋀭+#&^5Tp zcQYYb>  .!g1dM4+~/=w ^KͿa0 Y2?fxh;gTuw{w=U-ӝExܡjXJ^$%G#A3#UJ@CلlhʐggO*yZ_D'319cd*aDuh(;,wpW{|SvmM{b(.x4K=)anex˥7@fl*yOs)6JOr*l1"8Uf^9wB-(=Mq IDATUHd%:Ec& Ǒo_|kGy{|:y}Y?<, 2{8Kޜڛ{)#Ngc u-= )D*:d-/mHn$p>ӈ*Di(#1ڠ)r߾ȨVS^Ppޢ}"H74\L66nX{|Sqk'|^frr CwKxk*2UuV^XDl$"&" 9f4 SQ\rH- !X<7ZMqijf!|r\5B7%g(x=vΏqp0o||?B~pU pF<_g8x!G%aFju ɽ e ' p^T@#QZKT8 Σ6mٵBd Emdj"'Ѩ w-YG*s%/l^!mp,eTT[Dg;G<߯Y{8}|m1\'G4Ș0 lQf%T/)3=h/2s&ozSL4;_DlOz!F9/`|>SXąC)-3* BI9֓`Cw:kPlLl j=ѣGOvP>}nQaZWAhU("0 3o7em.4]}ee)2+`ьY# 6B΂fwxZ.x66'ީ EMe\`Z1@BSi|..қު7}nMigY0(U,/yur$> ;aj0\ҭB 3l!ƌ,EѨ:e3cvք@R2J; l)3up )gZ'lDNQ٩%V^#{t_W<~!;:Py^[qٝ_j[񂣝xU٩Wtglt9b{IQ/Dۄ \h"h?Cs^75^)46(f&܈N8A= тO%FTPc8ٽ*ۄx]$]pɣg,mgg7;L+/3ʃM6ʐsa5>qKnU{"vzJٸӉ6[yM c 4e'Et/I bh*4JunMqg92 "4F!X D鬶jԈ1*ln@NJ]xcega Jjdqh_0'X0=&oN+ӵO*M62ctR&cdIx;GM5qEzEuǮx+ Ñ}e#Hg59B $Mܱw *MԔlをՐJ#TE{x~#6q9JFyw?OE{lbݶgD=;QǸ;yiٝv)M|>گpM@g/Z7\ٞCJ:$ i&B6x4E)*óZIX7+yãTWqW ~9:&ҰFROȱd E|c I n$U-! (T[DWɣB\oCjm 3ygXqx&¦όWtg4 M{MD[dm-36ensAl 9giUCMflt{m@mO4-5Yw)_#RL-vSn&|].3 9nPolgK7Yh'!^/KhN$7F=U^an]]B1 e fwe13VbE#,{ݺ. N R,(s 6dE4T854wr! 4FCz3eBBX4 rXDbBB꒥iB 䲑 4nS545Ojr}sw<]u<̩YTsڃf'9>Ɍ:\mj@1:D,.Yo*}N!2yrV&TQ> G%<*u+@[;<~G]\-g'ՆS'pvԭ8zOS t93j0kMò I?|Yzg4^ެcwVbA=)T3AD& &r"#L aE -f_$FsUxhרv$>rg&pЭq!Sv]ߐ՗;s|%DRqGp%FeMƖ(zg+vf0/t۪d[-gϰe=}] O8~r1JD,;^lfc{*7a~( =unvbYݺR`acUZJ67D R&cCjuds8sR.8l=?iG_#Lq]BPUb j0JNلeW*d6я&Dnպ]x!'`-JM[VUs3.Ła,5n^yjY_\-;. ˞;:-%y [KWPH: d˥߄q=)94aS!Na*~"}ʅ}xjqGx~y\/TXFSo\a4Ĥw.+stF_#N ,ZNɚKspsy}뚃<{E[{ܢ5쒆NUQɥyʢC|ɮda&fks5*JTG\jN>8\΄jlz1{|hxuD6kBzN8"]-XzAX$~Ҏ"I,RF]mpUH.H2BahpJ6Dt: ױRLܦw&n ۢuߥpo*dCLnaj{Q@F&F\!5)cD\&dyPG<7_-z\m#GL9<2wv1csj51]kN9Ë6KYvg@!c5)9NE~ h4UYreDB|lLՒ!VXFX$%9݋e$ą[$Zn{Rc*XJ9Id1܈e\2] e)5Z9b)Q藆N(?]vݮC,5)Y̦3禭M6SY]?yI(Zm?gXxMmV+DkJv{uhG)g+pEPh&Xp`Hʬ!\،i¼y#6ǪBS0BS߈a4„sC&5E7(hUc᳘!fvya]_pzb\yyz1pxxGmk#y}I^/.@2!qH~rxCLP+43;^{c{^0قeŹz6C˞9ճ9?'%'YP'"fR;S[dˎčQ;GBuCĪ i v+iּ9) {ǫ9'/{*A.0I#`́RNFQ @հn.gM3gga]{gO 'W=~sNN5ϩHK?2pj_W\N͹P1xpidÑ/9ƾUL$2](6l~/QFZ I\hF+9%Gl#E:Дpο_jr, 7p8ϥc2Kf5vf&n]V0VlV- u0Dh+z )ʺ+ǟP0RJ%sὢDjc"9 kLL`$śQTVݚmuD6 yƪk(cLIz"@,SZǵ`ٱEAM-[^2 цprdR|1`-eEǫwwRXixԭ<;%_]%XEqc""P9|T; 6@s(<~mkd^e<铖>p4+>Ew8K,vD0Usop֦r:ؓQ9G `h T D#V'$Tc){?h<\?f3zǟW)Q#xuSVцNIR3E*Vf4XeBe6B0\kZ^8ᤵf:W#Ɍ$.xf;99vxsg^8weC{Xo2˥g4䕇uw2)1sh`]DX9';ī_-)bxՌJMB47(D?:]\mWtXX֥B]Yݼ'4@-s5]Q+JC&QwCy3ZyDT)@rɊn1yBMύ<@:َޮuna"EK}sp6X5faB iޙ#m& VU0 KX۔gaEh}Pr6ۣ斩EPXȊzk/irqxὤFXYc-%,#ЍV'-b6ȶ o3p ϥYTl*63V'O6іg>y8*r.Y>{t=ѓ* o|oA$XIF< .aoydDpXG5޸[7t!"vePg:,WM=nR%zu ~ FBs4:8[6b"IRXB&sbRq67e ba:v898vݮunC _x#;nkʙlk0څ 7Y:!)NCkk _fgH0q򁕑hkIti:b-C|brŸF qS.ЫĄ/!@?dvfM4M:güP^6 nGMjݘu .GBkҬbX̹Z<نuWU] MsEYmvƵ*Tf!Ǹ I%E؀9E%0_*`bB}]h WHOE D l.me IxHA9ge։g9>sgJ<ĄPa vxP7wmvݮu~ѡ?ÿ#/z^֝ T*UǶ7M(nǤ- 1zRDj?NlB(H7i^Ԝڱ3T@oΕUg0aA rIղc4A2h.&UB[\r648lE$CxR2KE-&R!\.5 ]fErtPU[~5t|[8~вӧG\9+ud6YI@rP*fPe]Tfg=&vc"K (`( 4fzq$5%:4![t{F Sa1qk Hs59 T #9tg7\~t̓3^u<=3A")M2 8U;,3]06T&WϔuK!hrΈ)_Ƅ輅چG,G Ar>y17XH&xwjwImL}L*U\zKC_]*@ʺ荣9߳qu)p /axewV;mC<oO25AX\D?~!wDIҞJS U 2䤉'BUٱ0( =-']# q%'jIU)2Bp䋂k @4FœSET5WK@Б81fw%@ր/wBŠD|.ųWϕ3`aA.nb'?ST}PC]A2Dm@2JgR%S-!kE!^ZÓƵK]r7u+n«Xľ|m~I5n b#bu._  (qg$a^CLx[b܈婙Εk-'b׎v؝ ` nvݮu+my/ybn3gs~I=ϗ5{hԕOA?>XXB[]E,F9]/,Z%T۹t-"Z!8ĤsJBS)ΜЪ<[Sw& ^woG嗿J:ۯyO3;@[>Ƿt6!s"@FC$B$BIuږ4  !m/ i g!y%x׺LkaP1ڥK0CڀEG3Hsc:V V'4ZiIf5k_!/f1#}ͯ_^An&ő\n؟̥sC[6-jSo]MgR3INZZP/ bT<֏5Wo+x PEJ!g2 :YLV]Axof /"Wqb eŌƩI@qqIQQgjl*"\ g7b𕠨$ ų`E^3 "ڂJ+2YT3-!ж4ѹ|A$ v(k]Jf`9iD7av JRQqqPS$4'"n z&UW|\28B^EZ~nÑG~xf3iM8Iḱ|r>VVyYJ![#%)prXYd pV6{"u ?'#'$YcM<ֈim]AݬFDAQ6 <vIxsp ُkKOB4Vz* {KHEWw -Sbٗc7Mb7rA4_3[3m` F LEYh[8I#mX3J@fk#mjX%I%OxM @74ħCC"Dd(a&ʆdl6 msc^1\~y03@,!\sm{iˁ!]N$%BHpBi,*Y,ZfB5IDI93ٵ`r9o XZ8XWM3Ɂg˧`U[@jG4q _HQQc=[r6>b @mp srv|j VWCoD1{Lд m՝VEq\2@fc _%H|׿?<F3`8(@ . njLJ_JDԢΒ%d-ai`I875 ,nmgUG;ѵƝ޹#`qwV{%cچ3z=WuӜJ6&l{ jo[uykS6#$U4s6Ԑ3<ņCˇw7ǑvUE߰n_ TFBNv'(R״&r0]qqY.yDa*BR|_ S\f9BhuB-Ć&%6qr}I_7/xv|h"Y9=#Myæ=ݻSK -˲fAf@Kxz4x%xF3*Ռz;@ۘ3a8Z; &Cwd /ȵZXVyo1VQJKy. {NӺ fRF>p^^ݕ\2 |\2@/%Bwyyy=8r~o1sX(n W@ֶ75g!H9"EIMIBХ K 0J6Zfe4Mc7fWF4 mk`F)iж|1e WMK[91}=%3 jYhS:xMSyw yQmn4~mYٶL &cbƾ ^vpm4tqćqu7b[xyؼ+_1=<0?N<=(4YfD3΢TXJ ¬I 6n -Ig1@Hh?L$VzΈ R-5~~uDz-_D5]ݺ%Y-!l$b;.2e._ePvğU~{@$t~גkȩgR̤wG616 PQ0#7js=!m(l[W3 &w( s}cdeZE߸!sj²&1}t-@ ,x|@1`"e憙 Zv-َ=##7̫̳떛 [n~ | : >!jt!݀M"d&,#2XrPD ]4U˻+61ƞ񾍼axʔ@^i^mmKa)10DTg,_EjeDHS$fn+aӌ_cO֢R j燒e-,5Ҭ8V7iXů*PO~6]~X*c*ۈߒ-+d =v%.gYdز gyb&mۍn뫵}e.s\$@Y6 v|xㇿ{?xxǧ *hZDq}nj8iH`1i vh, $Qʬ\Lp*+;OJY+_3d#%a }V~V Dk.1c4uCJ†oHQIa 4@UM2 nM%[Y跑 !6-Tȩa5hluM )Bj/`kn^}y:Nědž7"&8B l{/`{J ?كXZsǗe.s` c i7_wy|=_MXx+8Lqm GȳB+^\6 fcdU7IRɦYf3wB94~V:I9MVqfc:pql3 Nۦj qZW hsa0,":OI9ʬ1` ֧Lg#sL6-/^6<&>y<ȗ/2_6ݳ-Ͽw_=?Gv EX]rhH&TU.ŀD"b`b>p{W;6y<<%9rP4*q ڮAc+"w64Djw:;3['R-U$WT H aK9 yM5YO, P[VjPZQ*("^m O 걩PIpa}{'BT\gc0m}j&p/< f< ?ͧǢO_2aԛOKh~e{|8rdk#%08A- *L\c,0 Okhr)[4 MI\`litgnopw3^e)JENj:[7ПAxc2cB5 rI n--FKvZE-j5wm0T1o;ЧL3Wȴoxmɷ͎wO=vx0g_|=\=kϟ;߿>P"]Ӡ1R@BCDln#׻W_n{Ӧ1]>0 }<ьoR12r_ƷĬYa]8.##i7Y㜮ƺ [_ʲbmv & ;WwI(4cvW@RzV5׶8:`C'0dkD1.͵vFSd {x3u/zj Ɵ,2i8]e.s\17 >o?LW Mr\sdz//4>~0£ly3m4q-UoO3:{F7LٞE8LZ7]tbP0v0VnКR-tцN(;FbV4K3 }2 'aM'ܷ”mcqiyT6Ѣ.7vɢN-vl1¶XjYu<xi̞u9 U{AX'{2?N4Oطem8{z8w~É^⛁W/gnoϮ6;Nǯxwo?r8Rcf:1Y3ێor}Q4c^#cÉvzKߍ0<zܘ>(%:#Z "P- K2LP# ynqB΅%Yo$lxM.[ ^AϨ3h@:D-nl/-ҋKZ53qXAP, k1fpk&/nnaĚVah Ɲ59߱vUxH4.~. eIX ΃T#mMon7mϊ HA[5lRplj39k"/p_2̿g@@O,r ud[t2j=rlq~?OW{T*&ۍYz<);Oh'4Θ>,ެkra28> LfuMx{h"NbȲEm?ӅB+fkEZ4ha6`4MpSɶd54xY,y.ŊCƎ&RI=  Getp=`3p6Ub'gӧz ;-GmؘbaLJoGx>՗#_}y5~w0q<4m 1g1X+ Y/'Yog%!1m1Z}wng;~滫gԙ?DDӖ7nݍiw=tS&JXc>g tQjwENq\2OM? @8Hq k#PtD$% ! ] O[I9"c!E+&m laXiG ˜=9d`IffPKFKU`մ  @6 GL)3Yogu`𖺼LgowFz/ZnZ'}Ļۧ}D;|oԓq˔;E_+e2A4$59?D댳K1#ݰ咄2-~?qekH*XNԟ[4Ȧ;M]V]Qݫ,tHdeAKÞziuzrPb`_+6Nʜ+4Kܴ+N<=WKpUbiA 5Yv<-:NGUƮA9dw3LjZ}L'@G*V'틅'Jl[8)]%E e7w~8%e8xМ@?h7-ca<7'ۑ˙K8W+m$PNt^imH1_Gfg2=kD3<) dT.ZV|]klqt\E: ggLߪQ3O$^,p^3)xXj [#, @}B tɩXY"ȶnnU mreB_[MgM`zvcMM8C?%fXVA]/s\l@-sy Mgtd{`lږm^xsN<<*77~A>5m?3Xޔ<չ%/V%48 &7`̮@`v5ūP43^9]ApvYERj8ܚu8K-+֚~f|;kPUK~&j[rݜWJj 8x|ZkH ] w̮ \}[SJc]*׫T=C;dg`:k5]Ta;c?er Xe.s\_?s6'ce;f-zS!&#XWT)E;P\o)F6/=~mF/?Soˆ2MfH+Em Nvcwx0yC=ntFN1Y8ي`La;.ibzzSqhx4MoݴXr\] {jc :gꭱaŒP)i7<s6 Pc-"f_&Wty)Zc |We]2 q=΁i_ 6jlZ\^vapٌ^xXK5%,u"*c*aYko2^J5*&`,/ AL %4B*>d‹gtжR {ũV0R482Kc51Zwꢱv i--p ?l|'=pIe.se@@XzۄUQfF~<hsV9)g3\љQj 0kBس@#͆C/oNȏشlJc)(cBM/$ZŒ |1l,s(Ya2l}&k+5XZ^5f3Ǥ p{I&LBմ}PN~BS2ٽqp>uQFahIM>P,"`ob@5P51SN'n_}-6SbcI3Ə-o[0]o zձ c2eZ~C`!qyFZ9Ykm i=!P+# SEC.- KqX?@j3toB-%BK]]3Ih7~#l[̍wf䌮%Q]KB ~ʬMt zIes^%:dmg?Wwi+ c|1]2̿ 9 ]TŁp,-qnU0H$,mLd%jb\3ty^+b+N٤m_$^?D\h2{X BVѵg15Y,0v5ӶUR(Hl<l&槔Lqa I\.)&7O2ELQ[sNip]gM.Vv<?FqW7McҌMc0ͅ Z4\M]ЦBJyL0VDu=gKDm5ָ|s)k{,( QWqRk1e]`8Y N q(`4x*;׭T2-Kyvd 1 ]- -/)[B< ZMR8v Mrҋq|6@0Nʨ&e8DS/0#qߑht. >-,y !?lA 7@! KC9{9YmdIkcCc>/j\2̟kOkZɓ"u V`ۙOb_Ut[AojTO3d u ,gLP 5Y8.p&#֤O^$}Y[ݭ+c2@qMg?) 2e.Ros1W%WwvA ]95R < IDATL[آg ;ǘO7f{aVE`N!~Lӆ?}Yx"I$&Pa1bѥYa*J?6BuاId'hҝfKB(OW J {+XqILV&&qs3L+YOӚ1?"0Ǜ.^Xk3&. EI3_VūkqY񋻂e=dAXk+4O d%&њQSHI~M>1CDZNM6 3w(J ]lD$$]9hF7W|s9l3sTΠ/ΞKQa, ~S#EƥUP~~c?o2_2̟ aE/ݩ=zOL+t+W3b+.Ր@2+ݓ-H(i҃Q%-O/&N/3~œ0*O]pv ?cdM&Lp8 cqQlff.zbx10ٹ\li{a2n` Th;K ${yJL܌aVg&:x:bajt3S7ىx$Y)]]31VWX4$,ӢQi>^8gX!g 68*g%bM{X 9mY[Eʱu]ȴP"j1m`Mx|b;p-k`[)4:,a5V>41}6W<δ=r8>E J1dEIF8a\ccXz [ L󪽍~5nKjSrF,ɢ&,s`V`}ve\Oŗe.sX5<@P֛M<-{(s.p$'w =גl۰9fL. dQ -08+de mTNQc1#׿l2<۾fnVcd@IJVH3n?N-BI%F*b7pwoZh;9۝iqE`Q7i{qVK5@nkE^hL2L&(~LaN z$ۆ6M_Mk rLg[?1Xֺ%a\8r&!u(U5-m\}-\h1nook xb)f373f3G6C._`yw;Q?Bsb2e-+;*79R+,93Da-s2/g ^: H̰&+<[U?0ni Xӱa8(e.qw/&w_Fӟ&c %iG7)9JHΤF SBH] B|4;n,jWZ_87&)]c%ѓ9p^sE=Nz̫ܰbV?YcX[b&n1F&e.s;U'g`xVQ-R +k,gW߸PoV֛nv؞3ō.HݐX¤XXPBA2D@"aW^8=epMgw %P{K ?q@4R2>ol"voj,pmDwɁYvX`M:ȜfZJ 1ؕ,)a[l٘Z"~:i-d p`dMŎoz+ekghNievg4 vZY$b|`9KqB~Λꪬ"p}>5bMC5Tܥx( @<H7T ;0_JdB| H '&ЗH px)D1yRF(h e8 E8Y]x>@j12: r8 $gϤU{o$[re}{)";ՀH4d҃^[;h2I/2F#hQ@խ;}aP| fm]73os/_[sxE'yDj["{"gȯ|뺮뺮]w/a3Vm=nǵnܩmmJk BW>ʚ:,w#Ϋya٪iI6M6~{8dʜV0yLg 6)`KB:Şg,mh?]x~>qa3ї.C,m_+]iS>rZ\LI $S5qꚗx!zatq1\pf4Гds4,gs-Sߺ"srz8]:+Is"0t;V1ة~kq*fMsddKyulS+_bwkjUop/Vj.N*ȷ=5wD[%XA}s =jm[QJ/n"ZcTnBaN~=</,M)Oc9dF ih: '!M^i3@ڐhJ3r_2[rRȹBg*ZtQAgeNuK=H@]$*뺮뺮L 0uKc@FS|HFɘ?ln0S`kη9HEYÏ.v dRʼnxd*,<1n鄬t.& ]$4T"[xY_i(b6`Hߒ/g~o7̫e(<RZ6V7kc|׸iTɣwpל,(Jvj4^ o^]8dj/*-z: !w盛Kkt^1t.Twƿ/*-8B>HUTu|ZqjXZBuW+Lk@bKk4:~wx,W*O)A&am,4l~)?L ;މp2lm}|o[:mZc>F& 틈25s>Qq{fwym/Ca|( 3@\ 7Bm8Q Q  ^or+S*Q2pюOc\6ek]9G֪gYЫ^뺮g" 'ԙYjTlŝYԨ']y-hdw+eUV-VAܑ4sa`FI[&U\(,(9lNcm!c ꬧Tm@2(RrI̋`Cd::5҇Lݦ9QR B=g{`ϟYx/={/U5vG}Z^·vc3*Koa],]F|n%B:R1^f=![P Gf:#9z-g؉+hP$C)'=v™X ]0V]⪎NR󼹺j7+6Zs RJXqAUݙT`-Au*upn-P!o}'bZxgOx},JR>h&tBL6sJ}dS0ȘYc!eME)+c&,$Aɋ1Fadbɥe.Q&? !u`1ɇF*{ %#ws )k@]WpjWa> b'7Ȏ5!LVk  K0Sj1ӒiVǖBRe&bDnBӂ,Fր(ڀ∩}IcuU(Md (/tIMc9ش Oxκ~^4;~qs_L(?9yȋ-[Y쑄PZJdw9#kF8;m`ɳrqz 8x 5i>n4nش06gC:Fqa l7>?ux&'e>U`I4Gv>ȉTJd(u0ʚVwWjk>8Ԝ_Ӹ9h z|0/A*,OBi [لE%}.RB]iܚ2B mfs^!c`iJhb/LLn᠅.(qMD邑r%cbH?T^ewCR`Ve>vj+NEtUQp ģPu %PgLa1W53䟞f4/8&;9rK,b6K<6o^?_ԥ+r:&֐ewOR)ge&<ʌSc\9!F&PV˜kϬĭ\e: ^s EtJ &wB_(~s} MlJ"G.UiӡPRv с~2* vp5`4x>_Car㛡 H4UƜx LiҶR2R^!09nfA@|uLXBRk¹֙%/w=v]u],iNּ]B1|=1C0;e3-%#VvqR7BBbV t 6 X( |k7Bv`#l`i6u)ea2b6dK!%R;#4ؼZ0hq S2Q,8sf0N&#\_>2|9eM7t۶]KPk΃I]nrJF[ʉ\Jo~ݔ`Gm:`מ3sdA\w.+VxZWwr 1trb ģ{AԲRkVON5F\Gj^c4XXmd]a~ZhnD ox 7aaI4. Oc1hB\lnvBj: 3 -Rh n%(0DX|("$zt! *E k!$sDPCJT3b; }U8| &QW+C}u]u]CV>lXxl$500tl 2<w?7޿a<na]$ȦN[qٲ!̏.;wb)MF]暏\QW9[dN:0vSb/g+N,\lkcj#y]uEUAFj3/"\E[g>)ٽ32V6/O`(89pti">A9~P6-x둏=+n6Qfb ǠHix}RxIZd>śrlelPHFYBL.$ZP䃩0Ҩfn#&ìJ]/ IDAT[Ʉ$h@[t\)֍}XVWOsY-܊nFЋhJ8S,{u]u]Âx^ROsma8xb)@2lXC4+q" }0v#t 4]}:5k5KbF|\8@ F"B$ 蛂cr14!̔i4+%sbÒ\PqJ%"V9t0|Phɥ0K␕»Nشx:S;}~ti &F s+yI^ܵފ7ΆDxrҖӰY&gB5ecVk "ӢN7P UWyxTQVp񡘾S=f?l*ZdBB'70?bٰh4(MxR8wKH,GhDD -m0kLtOb>A?`îa(0wF3O}D̋)3nۢ *Eٶg-^hH4.47;yG>tG}S|7㡐sp.PGQch$ ,yV360cFTo6x>GڮřZ2.K7Vl\)vv.Ͼ+c˰#p@_+g Ѫ,oqR ;Q'ʷଲ-k,w1G5omY1?}i7,iaІ29B'nrd If1$|$IQJ.t|<#}^96%!4 %B>cDs^4am9+pBjY җ^(mu+N-Q oV3Ü *}hE'+-Ty*F4X#Lo;H~C~.N[뺮~1e;:q7GhwoH*jԷ4 ,cJpVaf#@Brs9䃀eE׼*D ̈Rh8JD)F&ap \)oZ4X;9Tⶁ.-< ؄cN1Х,[J2*|aϟx-?<[1ƔX>;]ćWՕ[Y!q(*ٸ:9b7B]vAȹǛZӜs Ntkv֩5Cv`EγBm%AҨ1xUZIm+v|kD;:{\j5tvox[]XXoRڮ"Wh)6KDÞ7\A/f9ֲ ܵ[,XRwdykٍ>9XMlK9d6mD< 0'Ʀp&!):@bX0DBc,Ձ:i lw׼T#$6B} b:sfΉ+O>)goHkE9ZWk9CJ{oU(_u]u87v9EY4K:dcQ 8 1rrf+M`ΰ8i #<-ڕPW\x pXr@ 1Ww~.,m v ,ĢnqV6ir$F8oпjaSJ?e4K<"!e8N[-, [6SazZxgys~o_7*CxC]]'0IdJm|Z84k1#RZdAܷʩT7¶ vm{`Z\ w[!%g ^1^VB0Ut(\,Tq o[c>'U8y\B. "y*eMt^lg\*G턮6К1Lϟ-|y}{MHg,0<퉢09 0޶76)+Mtfu <1q 6Һn xG￷90D)uE,uS]/ΰ&*m @AFܪy:a̧,Oqw;)뺮뺮)qՉzD"?~r'p)B2هBSv:ԳNMnSQm`.r4 _4Lɏvg"j1t)(=ϳq N Y@,N940#dcgLiP XG /<K' |dn:4J̸|,3Tc=!2pDY&Sz&L[~6F^W ᧼O^>|4FaﯭYTT۩!EC"zNZ|}b]uGWDNϙa4<ý2b^kۦf/Yz;u̬" X S[ r>!YPTJmb*팆( SD(V 6z,_;/hoh-b/03&E>YYJXzfCISny}S텠;m]G8fP[* }9{ pF4hfc̢"Tin#cg#Cp޶6+_zN ak^ߜZ4cdw}e9vrFZjͳA\_=*~뺮~ot8W4s{T1wtG6јJG>4pN<*B.RF ́sbtnr˯ ߼7no 4,gxc\[l7=2qk=7i#h}oxe7>< pthcE(n;; SkmǩF|o5K%[,&8G/>=S+8­o̩0%-ux;-j=Q:wA.5g|BIXu|1f 5faѐ3/Kǹхp 7i7a̻? =6EDMF؄ xnx~ʄom&tw147#l?X+bl7B5<]6YEh)Am %FHhhG  4+lB@ X7-(~J;r!N.8AK|\bFQ@}aʙ5׊ „ߠ^B@CWQ|]u]%ݍExz1A8;USu#0ᘌ!zԡC?A)xS*|x) Mx>VBA]TS|4b 57.XgKtr}+<>+!t!JRfS2Oȧ{`_1l'$ޛ~剜;~ņ #af7|o=A3?k~?}Á m!!Vj0*Iź<6vkCkJ.qxT=RoҒݕkAf1Rڦ2̣Bdij$|Z=S^N`#e+FoQ:@3íE1hn6/˅{~/ؖGiu30f۲؎ȋDyx@Щ`ǧI5B> ߹< D^fQHl\( n7$ !^s4^(ŔAeʛK3Z) 7QX*7X<b]>mt*LyP/kpX^)R~竭ZPzxh{f:\p?/֮nu]u] ߠW:\zY-Lh.A"z,SdLC=g\%v*>q>`r*o.x o*o#qV8KFSV~ݼ"{ Pxwܼ# bP‡%i2V^Bi!pBH OOB6!Day02 3Ғ<`dgaφ'>O|1|/n8g[=>yP^ڑ/?|_?@CϳtMd ;w);.0BZ\Tun\mp6-ƶJ1y1^ɩmrIܮ1rp/W\E)q1I(Vl8qTm8OW~?S/ <nndk;im䆑cvN»v; !qUcrmHd, ݆i?#ȃp%0I}Z# O DeT?Y 5|h3ƻ gLȥ a r*؂geukICs5.phTظ8ANu\;S(1냢rZSvQlr\#tx.zr.5FV,I[H%4y@}26 O@k"LqdP !IA0EiAWv@BK, 1*]3P V|dWFn2>/͈e}fy[r(2w¼ |a# oaLzlhcbLm 4B<=(yQ"f8/ˆ??ͧxfj7ȉ[]mT ?Lp;㏮sF4 FNEf+~jJuB-z+]̚Yng_??C3lx^z㑛mt5{S^ݷO5le73|rBf>ؼ8<$*O|Pt'pgtb2DdS-<3_y1n {BFf>̅~W *|)61M><ս?rvA7h/%dM> #}<9.>mvH58DlNħIxw%:A"Q"xMi>0tJ oFiдM#H) 4Blo 5vp! J Mݴ.[G5#ܴqGzYɕ1"m`+>H|"]bN r; 63 ?Wf4JP8tBuCDO3}Ysp!n_ 8-|lÍRs1/t2ġ)ؚ>p~=?>x<'qoGC1웑qqD?M yU"Pq*H ớZR7=fجrѵ{BrZccu($V7xejp1JӺ:A˙//G܎(8H%{Dz]0m- lSSHB7-čfF24b,C&͌Ga=EXb5>p2Hf4"}Q*|GiBF(>҄(2Np״t|?/~7?ϸO[t, rF o? ̓'\<*rnp188æ<)WnWQk`lbNju2ZV4f~hx vOl;E)JCB7D:MqᖯGaf.>0I~hy.-QM  mSyqu6p/cq~1:+q#( 7ʫ.+a } Jn "Xu'KAa7uk*"cݪp߸cOŇxz:0-!wwq,l0́^h4*sʔ]a`hyyŧ7ش6n,e3a\C毊'B{&ْJۮ9R{t79c o,_JF9 Lw|p?q Ճz 6KK"3"|%gf|_ _ d~#YONyb`g׬exOK~>|ﵷ\=^UzO2!uM+ =j{c)MtF2{Fwx[OѺ_*1ªI*wH<*؍e* T2P zr O_?|S>}~5_q(LJ˘M,y- SՋZW$!iM89+TۢcNXa 2?xׯ IgGCKaO[#^f61OȎ b{e}r :}K n1bNQj{u36k90×e.{Arzqxbt떭f\@ q=Z[4þ =ES&Ֆ^| 7. _?UbqkMh+o3cCǡփsV!z6~kϸUׁqLf$e˕3L.p!ڡNkfa4㽅<-yMuS: "Ŕ_)[z2R[!'z Hڙrb1|,,`V *[۪`L0ǩh3UgoElfͰ|[]~/2e1Mp,0{) 4jUiS)za #;' ¼Ug Bx[uM{D!kZ1@:-f1.tCPu=lsw<*\qdb_N) ^Qam2w{e`;Z~eR*dz#ZWd~7ŗ|5+ΙjZdA HzQKOwts9|M9>\V7$R5z7ֳ#{\a! \2=@>6g:ɧE+ROF9v`i c٧ )䎮V:xUbaK҄U!EEj (Nc+K[W: 'qI8dHIȢxSq+vvtU6C;Wt SPVC<ƌ8TX4p|,A.cDp5gik[4f|Wm$5M4Xr?~"D6 zM٪ Dt͂Eg9|xb{śnhc<6i|peiO&:8,=-lO[dkz]D53p' k:²7O9~k@C'F2ֱn,_3/1YFJ.Qk}fa2q2P ClTƔ*tS4)>Ԧ=[b[{$+@4Y 3;^sJ r 8iݕAY--FN'=z"mG}rscst&7(롅ofP|Ɨe. =fF7.+҃x)Oo;>zQxFS%e9V 5ΰQiP&F8CB FI^O|_p *f(o'3kv0FVNA- S˘ _|wNي}T@2&p],Z&gysw#\2.e.{9߉f&=W@h}[oΩ\T)ϱ08R TXRq$) Ԡ%?T]k}Ӥr;vS1ku^xKlL$8x=(@03W}B8DW<] !˶z%~_77I#y%n(!.rK[$hQQ&*8 9U釉CV~/!ݘt!p%k/FJTazYGV ;]v븡{{]lqVFn?Xt<4~ܲZweܗZ竕?`Z~7V3V4"`_ݏ5t<=jz𸋈kI,o ax>& ; ~**G:CUr<67`f3j O* ` 7t9Ǡ:yު&X584 o8Ԛe_%f`9+^3m9uۙi"5b61LK?3W.~,8ṵ8ia?cxfM<csZwssb9xL ߞPqa/s\_ COzA )XfT 3 ˂V t:TMTN9FXk֫ uMo{ (uӂCFyqcsr\hͅw LeoPݨ\!))*fKaLZ [{e)>4qS= 1*O$z3l#|yi^x 6y> f ص8 ~tĒcicv^O߿Fc/2USdZB (OY____ wuK}Jde$3j8%lt)%} Xr&a! O|m|b?%)Ezc1jBj: ^Ep%9Ku֒m)pF KG}4-0o+ =5]jD p*_87)٪.d뛓%fÚTAn)SgXeq&'0KNr;kk湚ӂwGq}NO\20Ĺ2Y M 1&xJgq: e2^[/_^XcIu0ZMS֝E(/N)C]ǩܾ},۽rv*|X?̉ZT9!lXK\9e_5laٖW߇r྇T>ܚvJb2R XH)"FQQyxHXH>g}Ds&eT'#Wv*Iٱ'F"b4K|',9%C0zVJ*c]˛ÞBGbd+=zRx)36O>q|'HhO>>is?MËזZM䋿/_ioit|\%!MmiT,>e>ZMv.'[D4txmգ7p?E! 7G2WV9.(AI ,,hkqNX4)Š魠[S6mJsZ2bxÔ$C,Mm]oZJHuJ1QR cEdxVZ福kS*Ɯ&p}wS>fX")g|m`ok[ %i2e~ߚy(;9[ٜ)2TU}q] [V1#.Zd##U8(MAJ6^y9f!M1EU/e-Qq|d+ג"t,S*a*VHo|M-zWfX TXzn*C*<˰< IDATV=#1ʐ Q)!)6L +b戊e7Nd;Qx#3}' 4XόICb,L=x#H >F6tg3SLzhX۳ {_C9?5}֫X:I64c|߿'SdĖ6<wDy#km:r#t M.ziTs?0F]]vBgjY d-`HJj;m O'&g+4ޡva0bZFobkCXX2B=҈ʦ eTSW,'6ɼ)"*>{'zL#G0'pXHF()./ff IZk)U=*N'ͰܬOi.C |\2 LS:i"UHgqS;X.4Q`)Wμ(- $P>uaϹTN$J FJU,bUS~P3[=yC1l'؉{ב=Mrvx`LDoZtwǦJvQw{<|=jG޼|7;nÊÖ6+l" [G嶵2{3LƑa'U2dɘVxg1/ S0 XxWQxCf[T2(w煏ZGݨK0GP,̦SɆ9']ZN2e$X틜dd;1BIu֍5QBpJ-CRP>hjB^(QYR8޸nXZW\- "k} ,ĺY--{.S5,j֖lW mWxcDZ~*ZeL*Ɯq( eol 39YmCKruX԰I7ܮ9F4&>Zx,rK`- 7+B::(Aq`}广۱ "Y~+p&ĒNn3:6+Vb:1V=>:6p'ηk3^zrގ ֳWq,W?*R;.&lxVB0xWLoXhZC`̺PʬF+-AY;M*/E Ë(R!%L4Wn3 לczD5Е5yE甪16Wc߹%|tٖ*ᘋ'p+]~-A4|/m5-Y0C\à!fPnGEV! a+ < bk\!yQ.g)=zfZw6ֶQ!9aai,F*nˮ @!xE }f;FnH&4 iMgbx,M ­O3%CʎW[ҮY۵p3cS6/Uv 3W=<- gKϯGk[6 Iy}iYb7D]QRvl|u6AE<]Z&3Mە4S'L^"n[ǽx "֑n 8n,÷E#dgX,]Kph(Pd,j}.ɩZcC,=ˬ=k\:b;Ϙfvjʃ?qVg,M. !H "0g|PD:Y"|sw3g/|1i s'Ih}8t5K*f}~GU/ke.sNw!>2'YZI2ޫc.,HadX4@0/í)G)lZSx'4(;~xJzWs^jQ͡`Aa Ӽ>6RvEkES׺Eɱ41a,I4@"X跡aNޢŠ\UYknqS] q%+I8T2YKf>bS?(2&^'U]a[֍!#+`"v٫ɳFI.| 㠙dҾ̣LۈqĊOۉ3O2ִ,\k2غnI'dc|QdMq`;/}b;F Ͻder,(%["啱\u8I È%K, ]0/4Y+Wp;gw%3x_ ;UUmo}Sn)ҐUnNNPrL>B0a9o#po"Z!(88{H&$ŜksvߩB=FU?,r~qI4ߵd;&/s\272̀x q~`7Œ*c-fj#nSSL`b'C3gbXhk.8SG#mW_9%8baruC_#ɲh/7yTq 2^.0*c, |C5 ZsʖCV6UTܣ8[:/ZsK,[qLYir3)iT,Lcn*1&s]mHE'õبUa'Aq-BʞY0^`2`9ເ ” Ғi iuB۔&91E37Z; gsğ$Y:Q$jK QMQc*0.s E&jS9YUY"ÚfF)F =Md =O̱Nkkzlޝs7O濥o;Xal䵰V?˷^e.s|-mkr;s`;)S4U -,T-|Mf^cdԐ4Ki"ZScg W" m-?FE00aT#AURas.o@i},"2\F$[I1l:_ȾǚjU M,Xc_`$;5&qb?~Nދl`5`ON%@vXD2z;Ò㽲XA_{ x1g+&r(O6ܴc<؉H9CKg zJIѲX(^h$<(ÕF3$c 5͈tksWecPijXkmo3sy-soZ*puc jgC3HmXY9JxrF+ֹ0ԥ6U{]֟AIJ72sTPL1%gx~Iz{3h'})_ٜP3]YŬi<0痹e.s 7/$粉cD>%O2}. wL) .fa^kB!JKW]=b,! SVvFKdc>Agoia'E2a*0k&pDt*r}N&]C/e;~H%m@,q0 mr]BirO YQqZY:-1332(1&y*$M,JY 1eSd-^cv#y3M72˘ڎv"[S[S`#Qmja 9:eOl14C3?i wֲ(bgQi"8Ǻ\[>%u%ZReao`Y;EheT li9[2V=C`FN`X*pha\s|smV6VC9y 9Yjc>]Rgd)|1άF嘥K><^Ѭk N zsg=+䰧.1K!-]b~Ke.s+f|ĉoN]hruTZq!IT["Cœ\R 4fv);FƗl,Tͥ4{TȔثMPt* /5UC7ՐZ9Tm!k*WT*X\kArm1[X(׶n@̲+D  % `Z5NpFXr{5 x?m("3 Z4[81dAY },h_a`n?fQƎ+|ͲbLu1M|[>va!K3xzdc{kNj̣oAO$̳U!CTtaha\4p24^} bfKA~"/Ns{k$HgqE=KS( P@9SD30ȳ>X95%S2Hj>.ҎUj%s'h>#eUgtQ zfLyfg泛|ǑܠN?/s\2om>[,XTNlS>B: eŒ9Ti>,Ӛ*Z@6֘3YZS,MtF*eh Єz2d["X&d]VVATxMR|m; kKM0uH8Ix( T%Sx :Sa\eIB+҉e#duP#U7,(4lg-Y!4B;$ς%k1 F6+ˉ,جlc䦳ɰ)s۲Pf>.U$Ca@b 2T@fE_;'M̱meq/>*%2⌰:-\,2.,Wtsfp@Z#hq*[)ZT˫p)RQAzÏ[Ut+;/{UşAvZRۂ IDATm{_.E`!\7?=W(Qwu|"xf\ V視[% i>dW>k-`_a!l6(JI 58~p{l(~vďEc6Lv s5*El&hj4d"m0eUfN=}%$5?lm;Bykqs@F鲤i60B!!=BO,Z(MZHUݓ%pwĮCR=rog#`x c /O CDErDEGS/Dlk2m3Hw(!!4jtn.%ykW3y >^#Qo507DPp (O//fh?|'ج 64yþ7/ ;ǧ[W\};~ubgj'Slwx~{Zk1wOPE;]XAB *TPE.ﮂkQQk@TO)!qb_ԁn vkEɽ^EZ2Uz__2/W"|u"U ]f̱PBZwpk{Cv,;(edK{I@ݺE E70C^2e`mlN(\JD&d;.88ǯR6]Nyt{Q)`6qy-._H@[̼hc wg:cQv%og/qѐZJt>w@V'wRVAq7ݎ;|I\Zk[ ws%7VߦAK ?$..KȈ7Zo C$͵f7}Ўdh{ǽW1lVۮjXw_T7 w7O5^7+rbx2P?4SpW7 U;wUEՂӉ/W&gEQlef9+/͈%d( p9Ǩ#Y[H1h$H(ohݭq.'nvP?N7p[(e! 2[#~XAnT#ϛ=\Sl2>; nBƶ-<{wDQIGᏭ淔?hk̺F/a:89q(bhO=bUkY%\%Lo*ip=tpg_At*H}M5_M j̫洶.*N;ah76T>`k_k;AU>[sF.[s^\~|Hqm[/o75]fs iXZWl 7\fv|;fP3Ԇ?VwE ;*|) QM\׋w溗]"Ί[KQ|ZMq*tU\lOZ)!}Z\? cejv$Хd#8di Wq.2XmIagVmS!dg%8RGdqs7.q4l -^ @LdX퓥*Q9+qI}.j Oc~l˖LS8H\p) AKb,Л J{R;+q D_+PR 9y绹n>xxmpܜ-`"l{K,T)תּ #`{oS1\U]:D;65|u* ~c?n 6݇ ? x}5ɀ.[@ry_nRj p)x?(TQW Ku5"j$lpP&8ӼqI ֟nnn2 1P'!tXXVYlok)ftbn# yO [c3+xd UkCB8'\@d $ȈIF?_c)'9H:[Zʗlo>9q2C|`Tt.{r2]-Llɚ6HiSZHnp@J稅[o45|pYm jaLuT7KѠ{3^В')DIfqk1ΉLNt%z9USY|sbc($
:nJA.S&Vbc: }nY\C|o;7z [  Hv]=cܛY%*38(T].7×6O(>5[|Vߣ|4nϨ|_/U? DI)n\6R\~2R60Um433hԟ$"7gwDIr^5{;0jjldW~ E'WxSLHwC/ n݆ae"=*|{l?/X + ŭ'Q.s׊/ x4[]0+%J1YX31_GCzu0,jHyLQ-ϛT.NvfF3)H-12IV9*-0 1QKrAiLIdϹ"H:iOŘd3i$ɴ nLp V|c,$89~̀ɹ, R*3{8u}_wZ2sSk7u y9+fcvVj^ YS>mD>Tߟ{>O%1x >h!&47%P?h]dQ]*j`Ϸn{yWX]כQqWxɈ@Z%sI*?ښwCԮQ(&hեE`UYVHTsFؒR1Yut%6:jVubl@N, HRՌ+NVA fa` }v/4iYWqǂdɔN|y P5~n$*eEKpW#=q4]AB8Q_Ï89q 'C;Id!%h{!z^=tLnoaދ|Jq'˾ŵ̗`Mߚ68K"9[Ĝ̖5G5zp/jkJ ]R}b)5҈\նx؅&@$3IÐQu݆h5c>u{s1,v3ԥT 7q1w|]NP}@vowrS|/" 9:Cne /f(UB@ɨ@+k%&a;{OL!EV<PgN8AOe(^` C7@Y'+>WZ ajK&,yɈ<4hl:K$XR ü>rY\ oOua âǍthqs ⣹ıOR&C05=o!mওmVsB 57%%oX#LgœuGW} jlr;I6r9FoE Ak.L 15.ܸL];MXXN<>q5#LLց*5Zՙހ?5 p{ c7|_7xjpoOW\&ϐ iD 0zeQuiСY蠀] 5%V(S㝟cq>X׬/FdJBWOkpߞuAA 55f< IҁHK6@qasӨ3aVEVƳDNeݓ4$d. vMY`Ը1-`"kNp $<=i"B4VO,f h-c6ssW8<{ (KGZzS_Qߒif_ Y67*ҫ؎ e):N P ^NB089qۡaYDuXOF)7ҨMnAɀqeJW \DT fN&N'%e:YՒ2 UKICgKϮ]%Z6x4؛yVC2]qo^CrCj#«OpfS ZYbǬ~"?cn%juqV7͙84Do?w`1ȓA ^Mzwf$rEa&3mspR n0o"i*%$>DB3e ЙebLx̱T R8Z EܜWe.v׵q #PikE&PՌW!Qu] v{w),a,-w<2~vx6}A qsfd(,0Qe-4Q}pXp0JE,̐-[k nݛ*\:!G:BFryخ{r`}9?.CsW{[k'[Ds vg1*pJ Yɻ"cќ*k ½b4-nh{d܊9%5R {} -z14n.@^23cK6Iр&2,vdH&",T$Lb\L$E&I cfEJ!pۧk\0'^GySb^<,'+9#A{\~+U8tsj恧tH^kiLH bUBÔ+:zI]-'\jA$.5_ zO9qs/cSz8ϔG :F+]ar,VIS?o2 -4d8f/TA -J8(ΎQ*XFs̾ K>L?\R.<"{LH"ݢuvs>>V|2kU2w಑Vfŧg/a."=^ҴzL[Dy)SCo';rwgSk 68dܪ3C8ŜVV7iQDRƵ4_dL.yV0iҵbSGoɸ)9ө1 2"= DCXbB(45s=v}oedj0t&٧ LQGN6dtE\b{B[wTPؔlqDUþ']|s' ~?yY Tl2zeNR&XNLk]4Sd{ۜfZBS(ia:3/pl{5EkSmp*#_\{)0xWn5?\ްe rgS_K*8R|lH^.&\\\_@vĿk.@K}pi%̅1yr YݴI wթ5ȼvBf5Ye:ܬ&6& oVIٷQ@{j!MX z%,)PfH##nYLlh5IF\k[ ll$oCs4Uyդц&VI&X]mV\[?tÔK9ye!p F֚/'<BeNbAHPMlLPsɭпk$L~9Q5Ji29} i;2jϰ$烹LlteDY B2IHtOB(oA wx8h uY[Tܹ=̅Guw/x.SS_V(o57ˡ;ha9mW/so,ۨXﾷ 8v?GF.k]$㞓&##YZ9%&#D  LfRe*WM3cߥ4'hq`Ys6#0Lfʉ͘C47!kW]h !"30'`ig|hT*Q(w{c^ ӳ02yr us3_9Ww|('P`Pq;݅ZJE>t}x@ounWfĥ6VPD EZ")bj&Ud]"w5sR5=7 QhԈrlfTY(*CnQl^'hdtsk 1s0[?4)@v8o! 5$&ͲmpNƳQ3=X@׺.a> qNd^)葠VDC`&\"2w֯GLjyG.t #lJr a; %Ǵ%c| 6 h$#c3$s=4Y4\$L0J&D!ާԡRe&Hv,dbƃ])F:PRR[]f3CXA_mFIPwra4č DFaLpK 2:&3Qp)E%Eܒ0p0'dlV's :{ys.y_y37=%WL["͠BhT3Û$$SӜ.JJud"Mt.ccK^KŤ{Hhe "n^w Zaї+Ɠ{$@sTxu@ hC_0ǔdui#e\knb./0dmNJLIn4@(j͛NtN$ -aU>[#F>̟5ԖǓcn/XRm~''M|sI@,r0 4 ߫|"C @c}%LP@/ت/ws]ݮ*&-I᪗, o]1{_K_KM/}-z=Xѻv6&SɨLg3<7m7>smD]!.Y.3Z,_/ĺOg^6e\nR05 Rp|w_bOP}s @,?$N>!ƕCk.K;u >2zd .QBiU&zƭ";Y4Hi!p܎FEl%?tTb8.RH "S9Fى>[4JDyLvO2kcak*@YM&P*`Or=&Iu.wΉPكd+xSbYÚP7|#2&^c[ ԉ%pfQ@sdS[ ;jd5r Z7%DEu3!%McUCu=ô{<e*? %YE6!D`^r1YZ 9qsHT3Ú8tj}&70Ae,ARВzh[ e<i@J ysiی[a6u3X e[߉> s&X>m! H޸PIj3M.e>_{*9L 0/ǟnqY)"ż^:rLZ2>K!,kY f4Yk\-&N I6h_kdW0v #^LvfJS>q`KV̑I.%d>>ı/i LáF jLnnT5?Yx\}Ns;O0NXͣqsb@Ky˗#~x yL)n@RR 9DHVaT 3Y ?s$2e26A)6L% os4YG쨖gb)q=eؐ~)sA =YKBdNg:7N1pH0,%W5%Уpɉ8*}ឦ;N89bWx1g 0+ֈ5.ZQѬmu4#~*si;WG,X+R b͘a W=y$@[&>x<Vf,h?5-#+%8֬9#E#D`2S҃N$%rn@Zg\eK-y"̏[_KVyM휁;LvB(I(A6Bf~x;R/,N2!EW25ٞ9Ero\a+;-nv 30و j\q9ib׈ BgmDw>d:kr""XsI١=^ ɣۯ1/89~ ;,_f0uF҅2NA˞ 9z9?d6$ЭNQ 0iÿꬭ ;cmK)E)pciHXٯd0(N;l[3{r(zv2897LkrȒCU&C012 j̐R@|7в'3}|W%69^_AKXWk< uϜC;ue0ݹ/|C"Xq#>>_!=6.b]r^aJZHg'9|sqxIN2TNvSg{\-;#;gx0v Rm'iez 6PB!r%-`5k #TfSҋ.@j^?Za1ͥ os %( `պ"BCU sY0wEAfhU.Up)SDE `q I's2aS_h2x$r\tjKN زU jk6MBUؕ͌ctepɒt'bׂ-mEq7: frSºiu 6Vc2{[lbJj߿dDet72t7p̛ߘU4{pGfVءUV3x\:j#]RVI##6'DXc!m1nod`˨; CV\ނاϻ * ^[$R%}'im%*HCcL"Q2\Q=b*V*%d3e"?om2=xeerD ` >p r!#5V]RXLhF. JD3Щelr^j5Y+F2duY8o?2ˁfaˬJiF U9: 0D^552QNyIJ>,gCS/K 1eJqrP]   mk\4\bW# #`~/= 5jNVqϒx5ue)-KmK_DPQnn%@6n-{ocokSz+7&%XOnLLYj^SiS[q-AGLlxC 4T ;^u>,f(  L fgcu-g6rQftA:-J7҇Sщ[/'|s5@,!QȺTHO`+vX2Ceb IDAT8#zl:w F>blicqn:5B"339YC1@*~l9+0 lm4ZI25ߏ+ޓ>9q(C5"W 7J8t0tb9;vzcDgFn) ɐ"T2 Qz`b%~ #V'ճQmQOg6^0DzBE r\0ٵk:V}5}yy4a-+1Ie%lZH'OYh8n0jo3MUC)4ry%fΐS ulsF5߸pL&=zdIǚ6':~e!J6%u|,+N*|R89+u<`Zy\^7=髬m/K'ɒ #m-뀽/\#+H={l aTt'Ƒ=f˞k KEuSJ)Npg0-`,I\ܖlC2p=mT 3Qg1q4^K0tG<dWY~4!yIR'wL249Qt,|E%'I+9 }_\lߧ%%R%,R ?Pb&Q̥8O]A„FB;]#|M}Da8I(e.2V :d`ۓ:>9q_) Kpy Ʋ& )`}>[ͱxh֔<0q^@mQma ^UD[l'KV35)=Hf2JĶfK>N ͱR0O1fv4@n%0(:uy*lR.=:?+´U X̘E@v Vd`c gy.ȡnXCR~PZH78ukAF5")dıc$M/@s<|1z n bE,Өj}>'E =L qs?6 vLJ#+;J {t>`&>c i}Ɇ zt0Y,;VI1A`;aƟ1*^1,pnUWfdv4#kJȇSˬنͪY﹉K.2C>g5Fb3*!LRx@R!mX*yeV],d VE ]Lv?( Z-J`rZ9LxW~W89~M=*2=,+#LUA 3S-2/y@$:/LrűN&3qtU*Hf8b+UYG`NRmNtHObSS[6ZT$̀*iyswq &M`L*I;Xš[>dwI(FfY %0x,ne2zC[_?l߻*`J`RW}upm2skܸd}F~l4|pOy9>9qs }nK2 H+kةKyL7ZOpջ`ϛWDQ,u&M0e 9HoNqZ:r:F%3;Nl.1r lZϚmf%~X}DjNXuAISbNh&Y[$;>2?q(בC dYRw 325a; oTR';VjΫLdQ}} |sw7{?.{oVcVj,oKaڱ>34vjȎfmSzPNL,7d}0?98Ɍ9.HfQT_**1gm6%+&*6=w77na\s[DU͔=q%^r3{Mm2M(1,92)PbJ87;te%߸{-~Z&Q.'x+, ,#>VHL5 y;^ۖ'ag“"+nؗVs8ǿCOÁ3`AcFh.3/cs|\ w6zGM@ b!ǮzXxN]3wbkY'-TD JkA&% (Dh0`sY>߻FVEIqr0bnpr롋fȎ%L ɗ۾%V3zL8:e!ϖYCV54%|F<8QobRNt򸲡GT+!dD W 5GVp<0D ]kÒ qx@Bugi=_>Nz&IL]`#(z`iPf.P[ǩ7午4e-fdY!2+e)@&o4:)*e̥.B3W,9paUb:ue&'3cr{V0 6)X dY Q|b 69},fRnT'?^\Jdy{Ͳ,OO{sEo|Gln-qB-D=~Fn3[\r-5;>M3X>66y\(k̜ >j7Z-lQ0#uJkt>pfR.mqW]'!uܝ$/rHHT#yLQzB ZmMDTW&5.e cgбI&ci( H#ӞOs\mN.>9a~dg-7`ΰ_t,=^-)9YsM2>fcj[N_[`vhcl#bFAyP6LC12̀٭Ͳf᪭251 Q%L#jS:iپf*G%zf&}( V1;QPoUrF%oֺTRPZ"G[!Jb׌Ɂ}W3{l`;`}捎O 蝤=*IPY11+a֧\~|8O`J~aJr ^m8v֟q>៭p9qsZ=؀ţ<~xl9nÙtKG|V'C^9=ђ|CSGP"fWĦoz-,+Lo9oK m uv(OY;0b żqzÒSd<& ~-MTρRFXs*+)jNg8$d 1B(tx*8":x(d#Pr1|t>6FGfw;}ϼZ)=qYV-i9qsWn?۪N~xCk﫩)F`C0vx A3HFBɞp)tX{ɬPkܛ#BV&cJ9nQƱƾ(<[qh zcq"aېtG=3#;7AӋ@b2 Zy"rd"٨`/ơap1z23] 9s9WF&D !Vtn=!6Ohbdljȃ\Arsw;$Myǜ0?TFc9\ a5- uy:)b`kӛ8[€9U\e m#{qcKD؄U,:Rt7fR ǦЄe)`B,u `&D% ˜ Zwlu;X/N+UF^`Gx|., SRXǽLBeeMޛޖט)iC^9l;Y$ibemq?6C>^[9qsC'e7~}f.qG !CXu5OĴn!?=R 4dr)ñEXYLVRd.JC.}JV2 np&Qh;V 1r4TՄ9* k _8J,e"*l]9~kya6ub㮝>N.;K.;t(MFyԟ 89~C$K~XdpQZl!΍YV;DWsߢDh%=38ATXfK 56S8C&4pXʗ;ɩy_1e:*)߻ |\8bN J͜enr{J1~,(zË0Y&K1t.f /D2S 1Umq]בʜSs?!JxN8cU0F8䌼R+hyQց RN%iwx?TAxyB|O鸌v k% B/k}䇤s%G7G5`@\hpblPmlа3*,Xڸrh 5m!5ra%#XuZl|o Xekz2\+p5E9=l61IXV7$Yض?^4 =#1.2;@Y3IԀĒ뜾3Xa4ëyr,1x+϶ЮeA\WjhitzҿZ4>t0"m;bo:.F; l8)Ax:<"~4b(F?5j9\N_PY'F$kՖ.Ԙc;7rMؾ k Y7D4wE:.گ ps0cg:C T+y/U|WUvuhX_Xp)b%FCnʄ-ŖZxs ߃A1<4SLk#Gv  ?zm^¹vn|bnVIAA@5߮Mb˂A2-u VSmC̏Z)\%rɩ̨BhkjP9~6>^ƴ7vky˶(BuI IDAT@U$%F7nzkՠIbX9P#ޖ8f&Iv0RbuרH+8R&:ʰFvRgMS&Ӂ}~1Zj5GW9gTyXnX7X^B.|/uNy+_KbV{k^/f6T!APxU8rQD6_l&c,8<j+[HJW@R"VҫMhL{Jת 6u5i1,D^HRoתcpQ\f k:XZ&=45QJJR{FVq!yrcJEN0CcRJ7sE߬kzH2}VU56Kl^ϸjxq$-}NnS*?0 F-W<dC8Hr*Y☑dyQY :z,/Yɗt׉³,_::0uu.9ugYYQ%fI*uhLafުS&zDA$wR܋ ˖s-'Ӱ!a1ʩe("w1 nґ#GU.dZxZf] E]-qцD=("} K9J: 7Q:A__A$3:dKS܊*m.o#KZQQBD/Bi#"|V$(iUzgIP܅tZ>gWC De/g: +t, ÅW+ǐ%D&EjfxHե$v7[[|79 h-SpepjdV7bfAeu H"MA ZqE`b6|!^U?6Rkc mF[k'ӤGSe֩ŠUڷrB1tЅnj*X=N:G*r.#23J W̻:rUNQW A{+fE$SCZiŅh?|ձd|[eYǜ1 w, Ц],خ Q"n\IkI V<4¹aM^ 5Ulơd8m[N^Hͨ`rJcb=ӽV1v;%1.xmq+i |AAqCMUNeE% -wVn{\U"i7 X6Ո wXɸ]"+DW'@OtIv;/Ƃ WDO 4:8Af#}CEaM1nM_'[noF˩*Ub!,W '\9 Gj>_̈wҏ[aUguYR少%yh{@ZxhǕȆķ&^WmV)^ ,J ҵŀA\=A+ذf/PFݭД/h\4Kgp8 9^WcɩnG$ڮ\Ax%nR2PYVxŶޱ &TfY *Io\1,ϳ}X/,~qU&4m?:_Dίa|y͟;1niBT֮:\RK"Ry1~֭'Kc,zQz@lQ#brdٮ ]Bl^;侈Q&p%#(Yj U{\u,GU`N3Cb02m'O 6xx3I?|FO#^4WЬ"bZ`TMu18nyZ;Q^ᘉǧpa;Y,SF)jzbC;%9/ tɲvuAB8 B^vN)xdkT$犱yW잷҅jV*" X`A;nIxq}b [Z;DvousYEgzj =GO+2Z}NvLl`vx1uXniyW}pܐP\_hޟ bKZotܜ=]]2j $$7"[Ґ=rjAx V!NU`+لQuxddU"`U8RժWfd,jm9򆪩M~+T1=5t-F1 {RAہp1WzUnd!vڀ$!Ax_B|!f:IOjAŠɬR1H_PU6,@UnVW#]>>L'X\D(4R j/?fǙI|`꫷ $ QhYvWR#E~ @okFBmˤ;}o|Ev`=T^M#pI(x;#!AxAB'~  It2JX[yՖo[8|_d-7ѬHgъh^4sU:'EQ5A nn93/Ai<+\'8K|_g#r#hc֧2Bis\]Ȉod彅 lWX 7;8`R2G:'¢̊ICL(뀵&۩Mƒ2!ifHr@|F%[*9>r* ]^o ,.BԨ"}bxEN0d 1bKdf\>I1db'CX!)۪Jyk-"Ϊj^aVEX6k+N^W"v\#f4خاeN!=/UO,4c]Ul3{%EcGQ3l.I'%H ;yS |WaUl6&W%DA/yV< F9 2TS5N+$Qy[s|#^+GVNlV lϪǼ^1) +?λy9>ZmaK}/^'_qmW:e I@ ЈXv*Z9%0Rue F ~8NѪ- i$;uwU{FGAzR+[Ub#5j :F5Ürב*, +XPt n["{ p0?[1*˵qr`a%dB QR\aƎV'9 Xԓ6>T8 zbBDf;~ٝVNv'wx+>4xs\Wdذy1o7Fc){J1^b1Dir'葆r5;!3Goɝ.[Gh|IY{?"sGr̯&1Ѳw^J ڭq_Nd SlcxUxoq[\5ԝ! !) ~&趀$y4mF qIpPf!&b}?"Ă N+ȅ"MhˁX_9P>bRqo=ow%̇G$a&x8W-Tyɖ2-vKe@#k1tcmDI'cMwn_bAS؟x@0fXg{ć l۞&6+ޙEw'~Ve0n]0)T&Gw_"N~&n9ZkvwcѬ*[]E)EB&q߳!AxaB|+)I~tǑ\ kb\io{g'W߆@D޸s9^toc> "\lD xP3>#[U݉8^+qhR# bẉ)fE"opV~ {1ݕ<{Me &E5~XX H>"$u2VwztMO%7ܗ3đ1p˸tc^6eÒ` a=3[͜hxqR"ށ u drabAHͦ8UZ9MO_Г2$ v(P㠦U&'>Qr|bcԢ uWH:0.H 5/q>hjy"Ă NL#۽G/6-dfM9Bov;GIR,ye»VUS#k1Q P -6 Vv[7nO1CcJ A'q1۳Hs$lH~G#&;*xCDCR hP lh{UU?x/a}rJۄ cb#1NlXXAxw?Babҝ3#e  Z9HUϰwC $1mwG+-/`Y;!<&GCJiu[4tAQ*&qO^WŴ $ţٞfrmg}Qم(8v'7 7cDްKoc2jSM).V(ӈv/ p;-$1Ίd:$~@xA#nR\X:Y1q؅!3ᆾ" -H.x㎻dq#,% 5 U C;7 '*_<#)B,#!]M}ZI`Af98̚XGU#8I, ,M1#\]+A>I1l^ UA>?ϞzFB3b9j1::Yު fxKG8s(ӈ"N1͝(r>384kufqqu؊׊ ?4ŘƮ#=^jF>vMgsW5tz*y)P\-hv VG`, aB R\>~ % S'D?bqb2anX3 đYw<+ |p̛"Ă "?B~}xBx9WN'='vUhA;6S8#lc[5|( "7<~gOzܷĈ?Gt3qK, qĝ{{AQ"_+,#ûCo '8A''& OqN篐_Wg+G$FNG;pٴUx"6vd^UF2,B,81 P^nB~jwyr #qD w+2=Ԓ w Ap!B,F$='oR#wWc<9N0i+ q .t6^dXXA؜O|FwNPW"G 6>6xﳕQ䌸"5;J< k| |*!ESo[ȐghdmborWdZGvoADoǟu8o5GGJ)c{ x7'4αxtN4f1Ok )!~'Rｍ1r<'ߓS̎'8'>2$vS׋'Q A'ćm&oJcGXʏW&¬'cFbAbbaᵤ7c*"}q {t%d~GbACE߃J!YLx@.LKرEAD7GuRO59 CdxJsƻ c,I)>Y1< n;ytIDATgY{A&?H5! |i <!RУK k{M WY, Yx1o<5$A!~Q$X1~A:%% ! X1,tEAo!U$X~k}`A!1~ܹ&Mx78} "?3a?aNԤ&XSWUAM&m4' -B_kE Ÿwh4Q  o c9~J¨ J~@J'5o / Q<7A},ׁ_o  "wR*ADuAx[bIu A 49Axe4]A~  '(2,dB_Ax>T!A^  rD1> "Ă   Ir,", B,3<AbA'b#  |<9A!AxyrlD#DA>ވe/#DvA4T!CDXoCIu     UܯO,IENDB`sh-1.14.2/requirements-dev.txt000066400000000000000000000001301404764061700162540ustar00rootroot00000000000000Pygments==2.1.3 coverage==4.2 coveralls==1.1 docopt==0.6.2 docutils==0.12 flake8==3.7.9 sh-1.14.2/requirements-docs.txt000066400000000000000000000003041404764061700164310ustar00rootroot00000000000000alabaster==0.7.9 Babel==2.3.4 docutils==0.12 imagesize==0.7.1 Jinja2==2.10.3 MarkupSafe==0.23 Pygments==2.1.3 pytz==2016.7 six==1.10.0 snowballstemmer==1.2.1 Sphinx==3.1.1 sphinx-rtd-theme==0.5.0 sh-1.14.2/setup.cfg000066400000000000000000000001431404764061700140410ustar00rootroot00000000000000[bdist_wheel] universal = 1 [metadata] license_file = LICENSE.txt [flake8] max-line-length = 120 sh-1.14.2/setup.py000066400000000000000000000036221404764061700137370ustar00rootroot00000000000000from __future__ import print_function import os from os.path import dirname, abspath, join import sys import sh import codecs from setuptools import setup HERE = dirname(abspath(__file__)) author = "Andrew Moffat" author_email = "arwmoffat@gmail.com" keywords = ["subprocess", "process", "shell", "launch", "program"] def read(*parts): with codecs.open(join(HERE, *parts), "rb", "utf-8") as f: return f.read() setup( name="sh", version=sh.__version__, description="Python subprocess replacement", long_description=read("README.rst"), author=author, author_email=author_email, maintainer=author, maintainer_email=author_email, keywords=keywords, url="https://github.com/amoffat/sh", license="MIT", py_modules=["sh"], classifiers=[ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.1", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Software Development :: Build Tools", "Topic :: Software Development :: Libraries :: Python Modules", ], ) sh-1.14.2/sh.py000066400000000000000000004043141404764061700132140ustar00rootroot00000000000000""" http://amoffat.github.io/sh/ """ # =============================================================================== # Copyright (C) 2011-2020 by Andrew Moffat # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # =============================================================================== __version__ = "1.14.2" __project_url__ = "https://github.com/amoffat/sh" from collections import deque try: from collections.abc import Mapping except ImportError: from collections import Mapping from contextlib import contextmanager from functools import partial from io import UnsupportedOperation, open as fdopen from locale import getpreferredencoding from types import ModuleType, GeneratorType import ast import errno import fcntl import gc import getpass import glob as glob_module import inspect import logging import os import platform import pty import pwd import re import select import signal import stat import struct import sys import termios import threading import time import traceback import tty import warnings import weakref IS_PY3 = sys.version_info[0] == 3 MINOR_VER = sys.version_info[1] IS_PY26 = sys.version_info[0] == 2 and MINOR_VER == 6 if IS_PY3: from io import StringIO ioStringIO = StringIO from io import BytesIO as cStringIO iocStringIO = cStringIO from queue import Queue, Empty # for some reason, python 3.1 removed the builtin "callable", wtf if not hasattr(__builtins__, "callable"): def callable(ob): return hasattr(ob, "__call__") else: from StringIO import StringIO from cStringIO import OutputType as cStringIO from io import StringIO as ioStringIO from io import BytesIO as iocStringIO from Queue import Queue, Empty try: from shlex import quote as shlex_quote # here from 3.3 onward except ImportError: from pipes import quote as shlex_quote # undocumented before 2.7 if "windows" in platform.system().lower(): # pragma: no cover raise ImportError("sh %s is currently only supported on linux and osx. \ please install pbs 0.110 (http://pypi.python.org/pypi/pbs) for windows \ support." % __version__) DEFAULT_ENCODING = getpreferredencoding() or "UTF-8" IS_MACOS = platform.system() in ("AIX", "Darwin") THIS_DIR = os.path.dirname(os.path.realpath(__file__)) SH_LOGGER_NAME = __name__ # normally i would hate this idea of using a global to signify whether we are # running tests, because it breaks the assumption that what is running in the # tests is what will run live, but we ONLY use this in a place that has no # serious side-effects that could change anything. as long as we do that, it # should be ok RUNNING_TESTS = bool(int(os.environ.get("SH_TESTS_RUNNING", "0"))) FORCE_USE_SELECT = bool(int(os.environ.get("SH_TESTS_USE_SELECT", "0"))) # a re-entrant lock for pushd. this way, multiple threads that happen to use # pushd will all see the current working directory for the duration of the # with-context PUSHD_LOCK = threading.RLock() if hasattr(inspect, "getfullargspec"): def get_num_args(fn): return len(inspect.getfullargspec(fn).args) else: def get_num_args(fn): return len(inspect.getargspec(fn).args) if IS_PY3: raw_input = input unicode = str basestring = str long = int _unicode_methods = set(dir(unicode())) HAS_POLL = hasattr(select, "poll") POLLER_EVENT_READ = 1 POLLER_EVENT_WRITE = 2 POLLER_EVENT_HUP = 4 POLLER_EVENT_ERROR = 8 # here we use an use a poller interface that transparently selects the most # capable poller (out of either select.select or select.poll). this was added # by zhangyafeikimi when he discovered that if the fds created internally by sh # numbered > 1024, select.select failed (a limitation of select.select). this # can happen if your script opens a lot of files if HAS_POLL and not FORCE_USE_SELECT: class Poller(object): def __init__(self): self._poll = select.poll() # file descriptor <-> file object bidirectional maps self.fd_lookup = {} self.fo_lookup = {} def __nonzero__(self): return len(self.fd_lookup) != 0 def __len__(self): return len(self.fd_lookup) def _set_fileobject(self, f): if hasattr(f, "fileno"): fd = f.fileno() self.fd_lookup[fd] = f self.fo_lookup[f] = fd else: self.fd_lookup[f] = f self.fo_lookup[f] = f def _remove_fileobject(self, f): if hasattr(f, "fileno"): fd = f.fileno() del self.fd_lookup[fd] del self.fo_lookup[f] else: del self.fd_lookup[f] del self.fo_lookup[f] def _get_file_descriptor(self, f): return self.fo_lookup.get(f) def _get_file_object(self, fd): return self.fd_lookup.get(fd) def _register(self, f, events): # f can be a file descriptor or file object self._set_fileobject(f) fd = self._get_file_descriptor(f) self._poll.register(fd, events) def register_read(self, f): self._register(f, select.POLLIN | select.POLLPRI) def register_write(self, f): self._register(f, select.POLLOUT) def register_error(self, f): self._register(f, select.POLLERR | select.POLLHUP | select.POLLNVAL) def unregister(self, f): fd = self._get_file_descriptor(f) self._poll.unregister(fd) self._remove_fileobject(f) def poll(self, timeout): if timeout is not None: # convert from seconds to milliseconds timeout *= 1000 changes = self._poll.poll(timeout) results = [] for fd, events in changes: f = self._get_file_object(fd) if events & (select.POLLIN | select.POLLPRI): results.append((f, POLLER_EVENT_READ)) elif events & select.POLLOUT: results.append((f, POLLER_EVENT_WRITE)) elif events & select.POLLHUP: results.append((f, POLLER_EVENT_HUP)) elif events & (select.POLLERR | select.POLLNVAL): results.append((f, POLLER_EVENT_ERROR)) return results else: class Poller(object): def __init__(self): self.rlist = [] self.wlist = [] self.xlist = [] def __nonzero__(self): return len(self.rlist) + len(self.wlist) + len(self.xlist) != 0 def __len__(self): return len(self.rlist) + len(self.wlist) + len(self.xlist) @staticmethod def _register(f, events): if f not in events: events.append(f) @staticmethod def _unregister(f, events): if f in events: events.remove(f) def register_read(self, f): self._register(f, self.rlist) def register_write(self, f): self._register(f, self.wlist) def register_error(self, f): self._register(f, self.xlist) def unregister(self, f): self._unregister(f, self.rlist) self._unregister(f, self.wlist) self._unregister(f, self.xlist) def poll(self, timeout): _in, _out, _err = select.select(self.rlist, self.wlist, self.xlist, timeout) results = [] for f in _in: results.append((f, POLLER_EVENT_READ)) for f in _out: results.append((f, POLLER_EVENT_WRITE)) for f in _err: results.append((f, POLLER_EVENT_ERROR)) return results def encode_to_py3bytes_or_py2str(s): """ takes anything and attempts to return a py2 string or py3 bytes. this is typically used when creating command + arguments to be executed via os.exec* """ fallback_encoding = "utf8" if IS_PY3: # if we're already bytes, do nothing if isinstance(s, bytes): pass else: s = str(s) try: s = bytes(s, DEFAULT_ENCODING) except UnicodeEncodeError: s = bytes(s, fallback_encoding) else: # attempt to convert the thing to unicode from the system's encoding try: s = unicode(s, DEFAULT_ENCODING) # if the thing is already unicode, or it's a number, it can't be # coerced to unicode with an encoding argument, but if we leave out # the encoding argument, it will convert it to a string, then to unicode except TypeError: s = unicode(s) # now that we have guaranteed unicode, encode to our system encoding, # but attempt to fall back to something try: s = s.encode(DEFAULT_ENCODING) except UnicodeEncodeError: s = s.encode(fallback_encoding, "replace") return s def _indent_text(text, num=4): lines = [] for line in text.split("\n"): line = (" " * num) + line lines.append(line) return "\n".join(lines) class ForkException(Exception): def __init__(self, orig_exc): tmpl = """ Original exception: =================== %s """ msg = tmpl % _indent_text(orig_exc) Exception.__init__(self, msg) class ErrorReturnCodeMeta(type): """ a metaclass which provides the ability for an ErrorReturnCode (or derived) instance, imported from one sh module, to be considered the subclass of ErrorReturnCode from another module. this is mostly necessary in the tests, where we do assertRaises, but the ErrorReturnCode that the program we're testing throws may not be the same class that we pass to assertRaises """ def __subclasscheck__(self, o): other_bases = set([b.__name__ for b in o.__bases__]) return self.__name__ in other_bases or o.__name__ == self.__name__ class ErrorReturnCode(Exception): __metaclass__ = ErrorReturnCodeMeta """ base class for all exceptions as a result of a command's exit status being deemed an error. this base class is dynamically subclassed into derived classes with the format: ErrorReturnCode_NNN where NNN is the exit code number. the reason for this is it reduces boiler plate code when testing error return codes: try: some_cmd() except ErrorReturnCode_12: print("couldn't do X") vs: try: some_cmd() except ErrorReturnCode as e: if e.exit_code == 12: print("couldn't do X") it's not much of a savings, but i believe it makes the code easier to read """ truncate_cap = 750 def __reduce__(self): return self.__class__, (self.full_cmd, self.stdout, self.stderr, self.truncate) def __init__(self, full_cmd, stdout, stderr, truncate=True): self.full_cmd = full_cmd self.stdout = stdout self.stderr = stderr self.truncate = truncate exc_stdout = self.stdout if truncate: exc_stdout = exc_stdout[:self.truncate_cap] out_delta = len(self.stdout) - len(exc_stdout) if out_delta: exc_stdout += ("... (%d more, please see e.stdout)" % out_delta).encode() exc_stderr = self.stderr if truncate: exc_stderr = exc_stderr[:self.truncate_cap] err_delta = len(self.stderr) - len(exc_stderr) if err_delta: exc_stderr += ("... (%d more, please see e.stderr)" % err_delta).encode() msg_tmpl = unicode("\n\n RAN: {cmd}\n\n STDOUT:\n{stdout}\n\n STDERR:\n{stderr}") msg = msg_tmpl.format( cmd=self.full_cmd, stdout=exc_stdout.decode(DEFAULT_ENCODING, "replace"), stderr=exc_stderr.decode(DEFAULT_ENCODING, "replace") ) if not IS_PY3: # Exception messages should be treated as an API which takes native str type on both # Python2 and Python3. (Meaning, it's a byte string on Python2 and a text string on # Python3) msg = encode_to_py3bytes_or_py2str(msg) super(ErrorReturnCode, self).__init__(msg) class SignalException(ErrorReturnCode): pass class TimeoutException(Exception): """ the exception thrown when a command is killed because a specified timeout (via _timeout or .wait(timeout)) was hit """ def __init__(self, exit_code, full_cmd): self.exit_code = exit_code self.full_cmd = full_cmd super(Exception, self).__init__() SIGNALS_THAT_SHOULD_THROW_EXCEPTION = set(( signal.SIGABRT, signal.SIGBUS, signal.SIGFPE, signal.SIGILL, signal.SIGINT, signal.SIGKILL, signal.SIGPIPE, signal.SIGQUIT, signal.SIGSEGV, signal.SIGTERM, signal.SIGSYS, )) # we subclass AttributeError because: # https://github.com/ipython/ipython/issues/2577 # https://github.com/amoffat/sh/issues/97#issuecomment-10610629 class CommandNotFound(AttributeError): pass rc_exc_regex = re.compile(r"(ErrorReturnCode|SignalException)_((\d+)|SIG[a-zA-Z]+)") rc_exc_cache = {} SIGNAL_MAPPING = dict([(v, k) for k, v in signal.__dict__.items() if re.match(r"SIG[a-zA-Z]+", k)]) def get_exc_from_name(name): """ takes an exception name, like: ErrorReturnCode_1 SignalException_9 SignalException_SIGHUP and returns the corresponding exception. this is primarily used for importing exceptions from sh into user code, for instance, to capture those exceptions """ exc = None try: return rc_exc_cache[name] except KeyError: m = rc_exc_regex.match(name) if m: base = m.group(1) rc_or_sig_name = m.group(2) if base == "SignalException": try: rc = -int(rc_or_sig_name) except ValueError: rc = -getattr(signal, rc_or_sig_name) else: rc = int(rc_or_sig_name) exc = get_rc_exc(rc) return exc def get_rc_exc(rc): """ takes a exit code or negative signal number and produces an exception that corresponds to that return code. positive return codes yield ErrorReturnCode exception, negative return codes yield SignalException we also cache the generated exception so that only one signal of that type exists, preserving identity """ try: return rc_exc_cache[rc] except KeyError: pass if rc >= 0: name = "ErrorReturnCode_%d" % rc base = ErrorReturnCode else: signame = SIGNAL_MAPPING[abs(rc)] name = "SignalException_" + signame base = SignalException exc = ErrorReturnCodeMeta(name, (base,), {"exit_code": rc}) rc_exc_cache[rc] = exc return exc # we monkey patch glob. i'm normally generally against monkey patching, but i # decided to do this really un-intrusive patch because we need a way to detect # if a list that we pass into an sh command was generated from glob. the reason # being that glob returns an empty list if a pattern is not found, and so # commands will treat the empty list as no arguments, which can be a problem, # ie: # # ls(glob("*.ojfawe")) # # ^ will show the contents of your home directory, because it's essentially # running ls([]) which, as a process, is just "ls". # # so we subclass list and monkey patch the glob function. nobody should be the # wiser, but we'll have results that we can make some determinations on _old_glob = glob_module.glob class GlobResults(list): def __init__(self, path, results): self.path = path list.__init__(self, results) def glob(path, *args, **kwargs): expanded = GlobResults(path, _old_glob(path, *args, **kwargs)) return expanded glob_module.glob = glob def canonicalize(path): return os.path.abspath(os.path.expanduser(path)) def which(program, paths=None): """ takes a program name or full path, plus an optional collection of search paths, and returns the full path of the requested executable. if paths is specified, it is the entire list of search paths, and the PATH env is not used at all. otherwise, PATH env is used to look for the program """ def is_exe(file_path): return (os.path.exists(file_path) and os.access(file_path, os.X_OK) and os.path.isfile(os.path.realpath(file_path))) found_path = None fpath, fname = os.path.split(program) # if there's a path component, then we've specified a path to the program, # and we should just test if that program is executable. if it is, return if fpath: program = canonicalize(program) if is_exe(program): found_path = program # otherwise, we've just passed in the program name, and we need to search # the paths to find where it actually lives else: paths_to_search = [] if isinstance(paths, (tuple, list)): paths_to_search.extend(paths) else: env_paths = os.environ.get("PATH", "").split(os.pathsep) paths_to_search.extend(env_paths) for path in paths_to_search: exe_file = os.path.join(canonicalize(path), program) if is_exe(exe_file): found_path = exe_file break return found_path def resolve_command_path(program): path = which(program) if not path: # our actual command might have a dash in it, but we can't call # that from python (we have to use underscores), so we'll check # if a dash version of our underscore command exists and use that # if it does if "_" in program: path = which(program.replace("_", "-")) if not path: return None return path def resolve_command(name, baked_args=None): path = resolve_command_path(name) cmd = None if path: cmd = Command(path) if baked_args: cmd = cmd.bake(**baked_args) return cmd class Logger(object): """ provides a memory-inexpensive logger. a gotcha about python's builtin logger is that logger objects are never garbage collected. if you create a thousand loggers with unique names, they'll sit there in memory until your script is done. with sh, it's easy to create loggers with unique names if we want our loggers to include our command arguments. for example, these are all unique loggers: ls -l ls -l /tmp ls /tmp so instead of creating unique loggers, and without sacrificing logging output, we use this class, which maintains as part of its state, the logging "context", which will be the very unique name. this allows us to get a logger with a very general name, eg: "command", and have a unique name appended to it via the context, eg: "ls -l /tmp" """ def __init__(self, name, context=None): self.name = name self.log = logging.getLogger("%s.%s" % (SH_LOGGER_NAME, name)) self.context = self.sanitize_context(context) def _format_msg(self, msg, *a): if self.context: msg = "%s: %s" % (self.context, msg) return msg % a @staticmethod def sanitize_context(context): if context: context = context.replace("%", "%%") return context or "" def get_child(self, name, context): new_name = self.name + "." + name new_context = self.context + "." + context return Logger(new_name, new_context) def info(self, msg, *a): self.log.info(self._format_msg(msg, *a)) def debug(self, msg, *a): self.log.debug(self._format_msg(msg, *a)) def error(self, msg, *a): self.log.error(self._format_msg(msg, *a)) def exception(self, msg, *a): self.log.exception(self._format_msg(msg, *a)) def default_logger_str(cmd, call_args, pid=None): if pid: s = "" % (cmd, pid) else: s = "" % cmd return s class RunningCommand(object): """ this represents an executing Command object. it is returned as the result of __call__() being executed on a Command instance. this creates a reference to a OProc instance, which is a low-level wrapper around the process that was exec'd this is the class that gets manipulated the most by user code, and so it implements various convenience methods and logical mechanisms for the underlying process. for example, if a user tries to access a backgrounded-process's stdout/err, the RunningCommand object is smart enough to know to wait() on the process to finish first. and when the process finishes, RunningCommand is smart enough to translate exit codes to exceptions. """ # these are attributes that we allow to pass through to OProc _OProc_attr_whitelist = set(( "signal", "terminate", "kill", "kill_group", "signal_group", "pid", "sid", "pgid", "ctty", "input_thread_exc", "output_thread_exc", "bg_thread_exc", )) def __init__(self, cmd, call_args, stdin, stdout, stderr): """ cmd is a list, where each element is encoded as bytes (PY3) or str (PY2) """ # self.ran is used for auditing what actually ran. for example, in # exceptions, or if you just want to know what was ran after the # command ran # # here we're making a consistent unicode string out if our cmd. # we're also assuming (correctly, i think) that the command and its # arguments are the encoding we pass into _encoding, which falls back to # the system's encoding enc = call_args["encoding"] self.ran = " ".join([shlex_quote(arg.decode(enc, "ignore")) for arg in cmd]) self.call_args = call_args self.cmd = cmd self.process = None self._waited_until_completion = False should_wait = True spawn_process = True # this is used to track if we've already raised StopIteration, and if we # have, raise it immediately again if the user tries to call next() on # us. https://github.com/amoffat/sh/issues/273 self._stopped_iteration = False # with contexts shouldn't run at all yet, they prepend # to every command in the context if call_args["with"]: spawn_process = False get_prepend_stack().append(self) if call_args["piped"] or call_args["iter"] or call_args["iter_noblock"]: should_wait = False # we're running in the background, return self and let us lazily # evaluate if call_args["bg"]: should_wait = False # redirection if call_args["err_to_out"]: stderr = OProc.STDOUT done_callback = call_args["done"] if done_callback: call_args["done"] = partial(done_callback, self) # set up which stream should write to the pipe # TODO, make pipe None by default and limit the size of the Queue # in oproc.OProc pipe = OProc.STDOUT if call_args["iter"] == "out" or call_args["iter"] is True: pipe = OProc.STDOUT elif call_args["iter"] == "err": pipe = OProc.STDERR if call_args["iter_noblock"] == "out" or call_args["iter_noblock"] is True: pipe = OProc.STDOUT elif call_args["iter_noblock"] == "err": pipe = OProc.STDERR # there's currently only one case where we wouldn't spawn a child # process, and that's if we're using a with-context with our command self._spawned_and_waited = False if spawn_process: log_str_factory = call_args["log_msg"] or default_logger_str logger_str = log_str_factory(self.ran, call_args) self.log = Logger("command", logger_str) self.log.debug("starting process") if should_wait: self._spawned_and_waited = True # this lock is needed because of a race condition where a background # thread, created in the OProc constructor, may try to access # self.process, but it has not been assigned yet process_assign_lock = threading.Lock() with process_assign_lock: self.process = OProc(self, self.log, cmd, stdin, stdout, stderr, self.call_args, pipe, process_assign_lock) logger_str = log_str_factory(self.ran, call_args, self.process.pid) self.log.context = self.log.sanitize_context(logger_str) self.log.info("process started") if should_wait: self.wait() def wait(self, timeout=None): """ waits for the running command to finish. this is called on all running commands, eventually, except for ones that run in the background if timeout is a number, it is the number of seconds to wait for the process to resolve. otherwise block on wait. this function can raise a TimeoutException, either because of a `_timeout` on the command itself as it was launched, or because of a timeout passed into this method. """ if not self._waited_until_completion: # if we've been given a timeout, we need to poll is_alive() if timeout is not None: waited_for = 0 sleep_amt = 0.1 alive = False exit_code = None if timeout < 0: raise RuntimeError("timeout cannot be negative") # while we still have time to wait, run this loop # notice that alive and exit_code are only defined in this loop, but the loop is also guaranteed to run, # defining them, given the constraints that timeout is non-negative while waited_for <= timeout: alive, exit_code = self.process.is_alive() # if we're alive, we need to wait some more, but let's sleep before we poll again if alive: time.sleep(sleep_amt) waited_for += sleep_amt # but if we're not alive, we're done waiting else: break # if we've made it this far, and we're still alive, then it means we timed out waiting if alive: raise TimeoutException(None, self.ran) # if we didn't time out, we fall through and let the rest of the code handle exit_code. # notice that we set _waited_until_completion here, only if we didn't time out. this allows us to # re-wait again on timeout, if we catch the TimeoutException in the parent frame self._waited_until_completion = True else: exit_code = self.process.wait() self._waited_until_completion = True if self.process.timed_out: # if we timed out, our exit code represents a signal, which is # negative, so let's make it positive to store in our # TimeoutException raise TimeoutException(-exit_code, self.ran) else: self.handle_command_exit_code(exit_code) # if an iterable command is using an instance of OProc for its stdin, # wait on it. the process is probably set to "piped", which means it # won't be waited on, which means exceptions won't propagate up to the # main thread. this allows them to bubble up if self.process._stdin_process: self.process._stdin_process.command.wait() self.log.debug("process completed") return self def is_alive(self): """ returns whether or not we're still alive. this call has side-effects on OProc """ return self.process.is_alive()[0] def handle_command_exit_code(self, code): """ here we determine if we had an exception, or an error code that we weren't expecting to see. if we did, we create and raise an exception """ ca = self.call_args exc_class = get_exc_exit_code_would_raise(code, ca["ok_code"], ca["piped"]) if exc_class: exc = exc_class(self.ran, self.process.stdout, self.process.stderr, ca["truncate_exc"]) raise exc @property def stdout(self): self.wait() return self.process.stdout @property def stderr(self): self.wait() return self.process.stderr @property def exit_code(self): self.wait() return self.process.exit_code def __len__(self): return len(str(self)) def __enter__(self): """ we don't actually do anything here because anything that should have been done would have been done in the Command.__call__ call. essentially all that has to happen is the command be pushed on the prepend stack. """ pass def __iter__(self): return self def next(self): """ allow us to iterate over the output of our command """ if self._stopped_iteration: raise StopIteration() # we do this because if get blocks, we can't catch a KeyboardInterrupt # so the slight timeout allows for that. while True: try: chunk = self.process._pipe_queue.get(True, self.call_args["iter_poll_time"]) except Empty: if self.call_args["iter_noblock"]: return errno.EWOULDBLOCK else: if chunk is None: self.wait() self._stopped_iteration = True raise StopIteration() try: return chunk.decode(self.call_args["encoding"], self.call_args["decode_errors"]) except UnicodeDecodeError: return chunk # python 3 __next__ = next def __exit__(self, exc_type, exc_val, exc_tb): if self.call_args["with"] and get_prepend_stack(): get_prepend_stack().pop() def __str__(self): """ in python3, should return unicode. in python2, should return a string of bytes """ if IS_PY3: return self.__unicode__() else: return unicode(self).encode(self.call_args["encoding"]) def __unicode__(self): """ a magic method defined for python2. calling unicode() on a RunningCommand object will call this """ if self.process and self.stdout: return self.stdout.decode(self.call_args["encoding"], self.call_args["decode_errors"]) elif IS_PY3: return "" else: return unicode("") def __eq__(self, other): return unicode(self) == unicode(other) __hash__ = None # Avoid DeprecationWarning in Python < 3 def __contains__(self, item): return item in str(self) def __getattr__(self, p): # let these three attributes pass through to the OProc object if p in self._OProc_attr_whitelist: if self.process: return getattr(self.process, p) else: raise AttributeError # see if strings have what we're looking for. we're looking at the # method names explicitly because we don't want to evaluate self unless # we absolutely have to, the reason being, in python2, hasattr swallows # exceptions, and if we try to run hasattr on a command that failed and # is being run with _iter=True, the command will be evaluated, throw an # exception, but hasattr will discard it if p in _unicode_methods: return getattr(unicode(self), p) raise AttributeError def __repr__(self): """ in python3, should return unicode. in python2, should return a string of bytes """ try: return str(self) except UnicodeDecodeError: if self.process: if self.stdout: return repr(self.stdout) return repr("") def __long__(self): return long(str(self).strip()) def __float__(self): return float(str(self).strip()) def __int__(self): return int(str(self).strip()) def output_redirect_is_filename(out): return isinstance(out, basestring) def get_prepend_stack(): tl = Command.thread_local if not hasattr(tl, "_prepend_stack"): tl._prepend_stack = [] return tl._prepend_stack def special_kwarg_validator(passed_kwargs, merged_kwargs, invalid_list): s1 = set(passed_kwargs.keys()) invalid_args = [] for elem in invalid_list: if callable(elem): fn = elem ret = fn(passed_kwargs, merged_kwargs) invalid_args.extend(ret) else: elem, error_msg = elem if s1.issuperset(elem): invalid_args.append((elem, error_msg)) return invalid_args def get_fileno(ob): # in py2, this will return None. in py3, it will return an method that # raises when called fileno_meth = getattr(ob, "fileno", None) fileno = None if fileno_meth: # py3 StringIO objects will report a fileno, but calling it will raise # an exception try: fileno = fileno_meth() except UnsupportedOperation: pass elif isinstance(ob, (int, long)) and ob >= 0: fileno = ob return fileno def ob_is_fd_based(ob): return get_fileno(ob) is not None def ob_is_tty(ob): """ checks if an object (like a file-like object) is a tty. """ fileno = get_fileno(ob) is_tty = False if fileno is not None: is_tty = os.isatty(fileno) return is_tty def ob_is_pipe(ob): fileno = get_fileno(ob) is_pipe = False if fileno: fd_stat = os.fstat(fileno) is_pipe = stat.S_ISFIFO(fd_stat.st_mode) return is_pipe def tty_in_validator(passed_kwargs, merged_kwargs): # here we'll validate that people aren't randomly shotgun-debugging different tty options and hoping that they'll # work, without understanding what they do pairs = (("tty_in", "in"), ("tty_out", "out")) invalid = [] for tty_type, std in pairs: if tty_type in passed_kwargs and ob_is_tty(passed_kwargs.get(std, None)): error = "`_%s` is a TTY already, so so it doesn't make sense to set up a TTY with `_%s`" % (std, tty_type) invalid.append(((tty_type, std), error)) # if unify_ttys is set, then both tty_in and tty_out must both be True if merged_kwargs["unify_ttys"] and not (merged_kwargs["tty_in"] and merged_kwargs["tty_out"]): invalid.append(( ("unify_ttys", "tty_in", "tty_out"), "`_tty_in` and `_tty_out` must both be True if `_unify_ttys` is True" )) return invalid def fg_validator(passed_kwargs, merged_kwargs): """ fg is not valid with basically every other option """ invalid = [] msg = """\ _fg is invalid with nearly every other option, see warning and workaround here: https://amoffat.github.io/sh/sections/special_arguments.html#fg""" whitelist = set(("env", "fg", "cwd")) offending = set(passed_kwargs.keys()) - whitelist if "fg" in passed_kwargs and passed_kwargs["fg"] and offending: invalid.append(("fg", msg)) return invalid def bufsize_validator(passed_kwargs, merged_kwargs): """ a validator to prevent a user from saying that they want custom buffering when they're using an in/out object that will be os.dup'ed to the process, and has its own buffering. an example is a pipe or a tty. it doesn't make sense to tell them to have a custom buffering, since the os controls this. """ invalid = [] in_ob = passed_kwargs.get("in", None) out_ob = passed_kwargs.get("out", None) in_buf = passed_kwargs.get("in_bufsize", None) out_buf = passed_kwargs.get("out_bufsize", None) in_no_buf = ob_is_fd_based(in_ob) out_no_buf = ob_is_fd_based(out_ob) err = "Can't specify an {target} bufsize if the {target} target is a pipe or TTY" if in_no_buf and in_buf is not None: invalid.append((("in", "in_bufsize"), err.format(target="in"))) if out_no_buf and out_buf is not None: invalid.append((("out", "out_bufsize"), err.format(target="out"))) return invalid def env_validator(passed_kwargs, merged_kwargs): """ a validator to check that env is a dictionary and that all environment variable keys and values are strings. Otherwise, we would exit with a confusing exit code 255. """ invalid = [] env = passed_kwargs.get("env", None) if env is None: return invalid if not isinstance(env, Mapping): invalid.append(("env", "env must be dict-like. Got {!r}".format(env))) return invalid for k, v in passed_kwargs["env"].items(): if not isinstance(k, str): invalid.append(("env", "env key {!r} must be a str".format(k))) if not isinstance(v, str): invalid.append(("env", "value {!r} of env key {!r} must be a str".format(v, k))) return invalid class Command(object): """ represents an un-run system program, like "ls" or "cd". because it represents the program itself (and not a running instance of it), it should hold very little state. in fact, the only state it does hold is baked arguments. when a Command object is called, the result that is returned is a RunningCommand object, which represents the Command put into an execution state. """ thread_local = threading.local() _call_args = { "fg": False, # run command in foreground # run a command in the background. commands run in the background # ignore SIGHUP and do not automatically exit when the parent process # ends "bg": False, # automatically report exceptions for background commands "bg_exc": True, "with": False, # prepend the command to every command after it "in": None, "out": None, # redirect STDOUT "err": None, # redirect STDERR "err_to_out": None, # redirect STDERR to STDOUT # stdin buffer size # 1 for line, 0 for unbuffered, any other number for that amount "in_bufsize": 0, # stdout buffer size, same values as above "out_bufsize": 1, "err_bufsize": 1, # this is how big the output buffers will be for stdout and stderr. # this is essentially how much output they will store from the process. # we use a deque, so if it overflows past this amount, the first items # get pushed off as each new item gets added. # # NOTICE # this is not a *BYTE* size, this is a *CHUNK* size...meaning, that if # you're buffering out/err at 1024 bytes, the internal buffer size will # be "internal_bufsize" CHUNKS of 1024 bytes "internal_bufsize": 3 * 1024 ** 2, "env": None, "piped": None, "iter": None, "iter_noblock": None, # the amount of time to sleep between polling for the iter output queue "iter_poll_time": 0.1, "ok_code": 0, "cwd": None, # the separator delimiting between a long-argument's name and its value # setting this to None will cause name and value to be two separate # arguments, like for short options # for example, --arg=derp, '=' is the long_sep "long_sep": "=", # the prefix used for long arguments "long_prefix": "--", # this is for programs that expect their input to be from a terminal. # ssh is one of those programs "tty_in": False, "tty_out": True, "unify_ttys": False, "encoding": DEFAULT_ENCODING, "decode_errors": "strict", # how long the process should run before it is auto-killed "timeout": None, "timeout_signal": signal.SIGKILL, # TODO write some docs on "long-running processes" # these control whether or not stdout/err will get aggregated together # as the process runs. this has memory usage implications, so sometimes # with long-running processes with a lot of data, it makes sense to # set these to true "no_out": False, "no_err": False, "no_pipe": False, # if any redirection is used for stdout or stderr, internal buffering # of that data is not stored. this forces it to be stored, as if # the output is being T'd to both the redirected destination and our # internal buffers "tee": None, # will be called when a process terminates regardless of exception "done": None, # a tuple (rows, columns) of the desired size of both the stdout and # stdin ttys, if ttys are being used "tty_size": (20, 80), # whether or not our exceptions should be truncated "truncate_exc": True, # a function to call after the child forks but before the process execs "preexec_fn": None, # UID to set after forking. Requires root privileges. Not supported on # Windows. "uid": None, # put the forked process in its own process session? "new_session": True, # pre-process args passed into __call__. only really useful when used # in .bake() "arg_preprocess": None, # a callable that produces a log message from an argument tuple of the # command and the args "log_msg": None, # whether or not to close all inherited fds. typically, this should be True, as inheriting fds can be a security # vulnerability "close_fds": True, # a whitelist of the integer fds to pass through to the child process. setting this forces close_fds to be True "pass_fds": set(), } # this is a collection of validators to make sure the special kwargs make # sense _kwarg_validators = ( (("err", "err_to_out"), "Stderr is already being redirected"), (("piped", "iter"), "You cannot iterate when this command is being piped"), (("piped", "no_pipe"), "Using a pipe doesn't make sense if you've disabled the pipe"), (("no_out", "iter"), "You cannot iterate over output if there is no output"), (("close_fds", "pass_fds"), "Passing `pass_fds` forces `close_fds` to be True"), tty_in_validator, bufsize_validator, env_validator, fg_validator, ) def __init__(self, path, search_paths=None): found = which(path, search_paths) self._path = encode_to_py3bytes_or_py2str("") # is the command baked (aka, partially applied)? self._partial = False self._partial_baked_args = [] self._partial_call_args = {} # bugfix for functools.wraps. issue #121 self.__name__ = str(self) if not found: raise CommandNotFound(path) # the reason why we set the values early in the constructor, and again # here, is for people who have tools that inspect the stack on # exception. if CommandNotFound is raised, we need self._path and the # other attributes to be set correctly, so repr() works when they're # inspecting the stack. issue #304 self._path = encode_to_py3bytes_or_py2str(found) self.__name__ = str(self) def __getattribute__(self, name): # convenience get_attr = partial(object.__getattribute__, self) val = None if name.startswith("_"): val = get_attr(name) elif name == "bake": val = get_attr("bake") # here we have a way of getting past shadowed subcommands. for example, # if "git bake" was a thing, we wouldn't be able to do `git.bake()` # because `.bake()` is already a method. so we allow `git.bake_()` elif name.endswith("_"): name = name[:-1] if val is None: val = get_attr("bake")(name) return val @staticmethod def _extract_call_args(kwargs): """ takes kwargs that were passed to a command's __call__ and extracts out the special keyword arguments, we return a tuple of special keyword args, and kwargs that will go to the exec'ed command """ kwargs = kwargs.copy() call_args = {} for parg, default in Command._call_args.items(): key = "_" + parg if key in kwargs: call_args[parg] = kwargs[key] del kwargs[key] merged_args = Command._call_args.copy() merged_args.update(call_args) invalid_kwargs = special_kwarg_validator(call_args, merged_args, Command._kwarg_validators) if invalid_kwargs: exc_msg = [] for kwarg, error_msg in invalid_kwargs: exc_msg.append(" %r: %s" % (kwarg, error_msg)) exc_msg = "\n".join(exc_msg) raise TypeError("Invalid special arguments:\n\n%s\n" % exc_msg) return call_args, kwargs # TODO needs documentation def bake(self, *args, **kwargs): fn = type(self)(self._path) fn._partial = True call_args, kwargs = self._extract_call_args(kwargs) pruned_call_args = call_args for k, v in Command._call_args.items(): try: if pruned_call_args[k] == v: del pruned_call_args[k] except KeyError: continue fn._partial_call_args.update(self._partial_call_args) fn._partial_call_args.update(pruned_call_args) fn._partial_baked_args.extend(self._partial_baked_args) sep = pruned_call_args.get("long_sep", self._call_args["long_sep"]) prefix = pruned_call_args.get("long_prefix", self._call_args["long_prefix"]) fn._partial_baked_args.extend(compile_args(args, kwargs, sep, prefix)) return fn def __str__(self): """ in python3, should return unicode. in python2, should return a string of bytes """ if IS_PY3: return self.__unicode__() else: return self.__unicode__().encode(DEFAULT_ENCODING) def __eq__(self, other): return str(self) == str(other) __hash__ = None # Avoid DeprecationWarning in Python < 3 def __repr__(self): """ in python3, should return unicode. in python2, should return a string of bytes """ return "" % str(self) def __unicode__(self): """ a magic method defined for python2. calling unicode() on a self will call this """ baked_args = " ".join(item.decode(DEFAULT_ENCODING) for item in self._partial_baked_args) if baked_args: baked_args = " " + baked_args return self._path.decode(DEFAULT_ENCODING) + baked_args def __enter__(self): self(_with=True) def __exit__(self, exc_type, exc_val, exc_tb): get_prepend_stack().pop() def __call__(self, *args, **kwargs): kwargs = kwargs.copy() args = list(args) # this will hold our final command, including arguments, that will be # exec'ed cmd = [] # this will hold a complete mapping of all our special keyword arguments # and their values call_args = Command._call_args.copy() # aggregate any 'with' contexts for prepend in get_prepend_stack(): pcall_args = prepend.call_args.copy() # don't pass the 'with' call arg pcall_args.pop("with", None) call_args.update(pcall_args) cmd.extend(prepend.cmd) cmd.append(self._path) # do we have an argument pre-processor? if so, run it. we need to do # this early, so that args, kwargs are accurate preprocessor = self._partial_call_args.get("arg_preprocess", None) if preprocessor: args, kwargs = preprocessor(args, kwargs) # here we extract the special kwargs and override any # special kwargs from the possibly baked command extracted_call_args, kwargs = self._extract_call_args(kwargs) call_args.update(self._partial_call_args) call_args.update(extracted_call_args) # handle a None. this is added back only to not break the api in the # 1.* version. TODO remove this in 2.0, as "ok_code", if specified, # should always be a definitive value or list of values, and None is # ambiguous if call_args["ok_code"] is None: call_args["ok_code"] = 0 if not getattr(call_args["ok_code"], "__iter__", None): call_args["ok_code"] = [call_args["ok_code"]] # check if we're piping via composition stdin = call_args["in"] if args: first_arg = args.pop(0) if isinstance(first_arg, RunningCommand): if first_arg.call_args["piped"]: stdin = first_arg.process else: stdin = first_arg.process._pipe_queue else: args.insert(0, first_arg) processed_args = compile_args(args, kwargs, call_args["long_sep"], call_args["long_prefix"]) # makes sure our arguments are broken up correctly split_args = self._partial_baked_args + processed_args final_args = split_args cmd.extend(final_args) # if we're running in foreground mode, we need to completely bypass # launching a RunningCommand and OProc and just do a spawn if call_args["fg"]: cwd = call_args["cwd"] or os.getcwd() with pushd(cwd): if call_args["env"] is None: exit_code = os.spawnv(os.P_WAIT, cmd[0], cmd) else: exit_code = os.spawnve(os.P_WAIT, cmd[0], cmd, call_args["env"]) exc_class = get_exc_exit_code_would_raise(exit_code, call_args["ok_code"], call_args["piped"]) if exc_class: if IS_PY3: ran = " ".join([arg.decode(DEFAULT_ENCODING, "ignore") for arg in cmd]) else: ran = " ".join(cmd) exc = exc_class(ran, b"", b"", call_args["truncate_exc"]) raise exc return None # stdout redirection stdout = call_args["out"] if output_redirect_is_filename(stdout): stdout = open(str(stdout), "wb") # stderr redirection stderr = call_args["err"] if output_redirect_is_filename(stderr): stderr = open(str(stderr), "wb") return RunningCommand(cmd, call_args, stdin, stdout, stderr) def compile_args(a, kwargs, sep, prefix): """ takes args and kwargs, as they were passed into the command instance being executed with __call__, and compose them into a flat list that will eventually be fed into exec. example: with this call: sh.ls("-l", "/tmp", color="never") this function receives args = ['-l', '/tmp'] kwargs = {'color': 'never'} and produces ['-l', '/tmp', '--color=never'] """ processed_args = [] encode = encode_to_py3bytes_or_py2str # aggregate positional args for arg in a: if isinstance(arg, (list, tuple)): if isinstance(arg, GlobResults) and not arg: arg = [arg.path] for sub_arg in arg: processed_args.append(encode(sub_arg)) elif isinstance(arg, dict): processed_args += aggregate_keywords(arg, sep, prefix, raw=True) # see https://github.com/amoffat/sh/issues/522 elif arg is None or arg is False: pass else: processed_args.append(encode(arg)) # aggregate the keyword arguments processed_args += aggregate_keywords(kwargs, sep, prefix) return processed_args def aggregate_keywords(keywords, sep, prefix, raw=False): """ take our keyword arguments, and a separator, and compose the list of flat long (and short) arguments. example {'color': 'never', 't': True, 'something': True} with sep '=' becomes ['--color=never', '-t', '--something'] the `raw` argument indicates whether or not we should leave the argument name alone, or whether we should replace "_" with "-". if we pass in a dictionary, like this: sh.command({"some_option": 12}) then `raw` gets set to True, because we want to leave the key as-is, to produce: ['--some_option=12'] but if we just use a command's kwargs, `raw` is False, which means this: sh.command(some_option=12) becomes: ['--some-option=12'] essentially, using kwargs is a convenience, but it lacks the ability to put a '-' in the name, so we do the replacement of '_' to '-' for you. but when you really don't want that to happen, you should use a dictionary instead with the exact names you want """ processed = [] encode = encode_to_py3bytes_or_py2str for k, v in keywords.items(): # we're passing a short arg as a kwarg, example: # cut(d="\t") if len(k) == 1: if v is not False: processed.append(encode("-" + k)) if v is not True: processed.append(encode(v)) # we're doing a long arg else: if not raw: k = k.replace("_", "-") if v is True: processed.append(encode(prefix + k)) elif v is False: pass elif sep is None or sep == " ": processed.append(encode(prefix + k)) processed.append(encode(v)) else: arg = encode("%s%s%s%s" % (prefix, k, sep, v)) processed.append(arg) return processed def _start_daemon_thread(fn, name, exc_queue, *a): def wrap(*rgs, **kwargs): try: fn(*rgs, **kwargs) except Exception as e: exc_queue.put(e) raise thread = threading.Thread(target=wrap, name=name, args=a) thread.daemon = True thread.start() return thread def setwinsize(fd, rows_cols): """ set the terminal size of a tty file descriptor. borrowed logic from pexpect.py """ rows, cols = rows_cols winsize = getattr(termios, 'TIOCSWINSZ', -2146929561) s = struct.pack('HHHH', rows, cols, 0, 0) fcntl.ioctl(fd, winsize, s) def construct_streamreader_callback(process, handler): """ here we're constructing a closure for our streamreader callback. this is used in the case that we pass a callback into _out or _err, meaning we want to our callback to handle each bit of output we construct the closure based on how many arguments it takes. the reason for this is to make it as easy as possible for people to use, without limiting them. a new user will assume the callback takes 1 argument (the data). as they get more advanced, they may want to terminate the process, or pass some stdin back, and will realize that they can pass a callback of more args """ # implied arg refers to the "self" that methods will pass in. we need to # account for this implied arg when figuring out what function the user # passed in based on number of args implied_arg = 0 partial_args = 0 handler_to_inspect = handler if isinstance(handler, partial): partial_args = len(handler.args) handler_to_inspect = handler.func if inspect.ismethod(handler_to_inspect): implied_arg = 1 num_args = get_num_args(handler_to_inspect) else: if inspect.isfunction(handler_to_inspect): num_args = get_num_args(handler_to_inspect) # is an object instance with __call__ method else: implied_arg = 1 num_args = get_num_args(handler_to_inspect.__call__) net_args = num_args - implied_arg - partial_args handler_args = () # just the chunk if net_args == 1: handler_args = () # chunk, stdin if net_args == 2: handler_args = (process.stdin,) # chunk, stdin, process elif net_args == 3: # notice we're only storing a weakref, to prevent cyclic references # (where the process holds a streamreader, and a streamreader holds a # handler-closure with a reference to the process handler_args = (process.stdin, weakref.ref(process)) def fn(chunk): # this is pretty ugly, but we're evaluating the process at call-time, # because it's a weakref a = handler_args if len(a) == 2: a = (handler_args[0], handler_args[1]()) return handler(chunk, *a) return fn def get_exc_exit_code_would_raise(exit_code, ok_codes, sigpipe_ok): exc = None success = exit_code in ok_codes bad_sig = -exit_code in SIGNALS_THAT_SHOULD_THROW_EXCEPTION # if this is a piped command, SIGPIPE must be ignored by us and not raise an # exception, since it's perfectly normal for the consumer of a process's # pipe to terminate early if sigpipe_ok and -exit_code == signal.SIGPIPE: bad_sig = False success = True if not success or bad_sig: exc = get_rc_exc(exit_code) return exc def handle_process_exit_code(exit_code): """ this should only ever be called once for each child process """ # if we exited from a signal, let our exit code reflect that if os.WIFSIGNALED(exit_code): exit_code = -os.WTERMSIG(exit_code) # otherwise just give us a normal exit code elif os.WIFEXITED(exit_code): exit_code = os.WEXITSTATUS(exit_code) else: raise RuntimeError("Unknown child exit status!") return exit_code def no_interrupt(syscall, *args, **kwargs): """ a helper for making system calls immune to EINTR """ ret = None while True: try: ret = syscall(*args, **kwargs) except OSError as e: if e.errno == errno.EINTR: continue else: raise else: break return ret class OProc(object): """ this class is instantiated by RunningCommand for a command to be exec'd. it handles all the nasty business involved with correctly setting up the input/output to the child process. it gets its name for subprocess.Popen (process open) but we're calling ours OProc (open process) """ _default_window_size = (24, 80) # used in redirecting STDOUT = -1 STDERR = -2 def __init__(self, command, parent_log, cmd, stdin, stdout, stderr, call_args, pipe, process_assign_lock): """ cmd is the full list of arguments that will be exec'd. it includes the program name and all its arguments. stdin, stdout, stderr are what the child will use for standard input/output/err. call_args is a mapping of all the special keyword arguments to apply to the child process. """ self.command = command self.call_args = call_args # convenience ca = self.call_args if ca["uid"] is not None: if os.getuid() != 0: raise RuntimeError("UID setting requires root privileges") target_uid = ca["uid"] pwrec = pwd.getpwuid(ca["uid"]) target_gid = pwrec.pw_gid else: target_uid, target_gid = None, None # I had issues with getting 'Input/Output error reading stdin' from dd, # until I set _tty_out=False if ca["piped"]: ca["tty_out"] = False self._stdin_process = None # if the objects that we are passing to the OProc happen to be a # file-like object that is a tty, for example `sys.stdin`, then, later # on in this constructor, we're going to skip out on setting up pipes # and pseudoterminals for those endpoints stdin_is_fd_based = ob_is_fd_based(stdin) stdout_is_fd_based = ob_is_fd_based(stdout) stderr_is_fd_based = ob_is_fd_based(stderr) tee_out = ca["tee"] in (True, "out") tee_err = ca["tee"] == "err" single_tty = ca["tty_in"] and ca["tty_out"] and ca["unify_ttys"] # this logic is a little convoluted, but basically this top-level # if/else is for consolidating input and output TTYs into a single # TTY. this is the only way some secure programs like ssh will # output correctly (is if stdout and stdin are both the same TTY) if single_tty: # master_fd, slave_fd = pty.openpty() # # Anything that is written on the master end is provided to the process on the slave end as though it was # input typed on a terminal. -"man 7 pty" # # later, in the child process, we're going to do this, so keep it in mind: # # os.dup2(self._stdin_child_fd, 0) # os.dup2(self._stdout_child_fd, 1) # os.dup2(self._stderr_child_fd, 2) self._stdin_parent_fd, self._stdin_child_fd = pty.openpty() # this makes our parent fds behave like a terminal. it says that the very same fd that we "type" to (for # stdin) is the same one that we see output printed to (for stdout) self._stdout_parent_fd = os.dup(self._stdin_parent_fd) # this line is what makes stdout and stdin attached to the same pty. in other words the process will write # to the same underlying fd as stdout as it uses to read from for stdin. this makes programs like ssh happy self._stdout_child_fd = os.dup(self._stdin_child_fd) self._stderr_parent_fd = os.dup(self._stdin_parent_fd) self._stderr_child_fd = os.dup(self._stdin_child_fd) # do not consolidate stdin and stdout. this is the most common use- # case else: # this check here is because we may be doing piping and so our stdin # might be an instance of OProc if isinstance(stdin, OProc) and stdin.call_args["piped"]: self._stdin_child_fd = stdin._pipe_fd self._stdin_parent_fd = None self._stdin_process = stdin elif stdin_is_fd_based: self._stdin_child_fd = os.dup(get_fileno(stdin)) self._stdin_parent_fd = None elif ca["tty_in"]: self._stdin_parent_fd, self._stdin_child_fd = pty.openpty() # tty_in=False is the default else: self._stdin_child_fd, self._stdin_parent_fd = os.pipe() if stdout_is_fd_based and not tee_out: self._stdout_child_fd = os.dup(get_fileno(stdout)) self._stdout_parent_fd = None # tty_out=True is the default elif ca["tty_out"]: self._stdout_parent_fd, self._stdout_child_fd = pty.openpty() else: self._stdout_parent_fd, self._stdout_child_fd = os.pipe() # unless STDERR is going to STDOUT, it ALWAYS needs to be a pipe, # and never a PTY. the reason for this is not totally clear to me, # but it has to do with the fact that if STDERR isn't set as the # CTTY (because STDOUT is), the STDERR buffer won't always flush # by the time the process exits, and the data will be lost. # i've only seen this on OSX. if stderr is OProc.STDOUT: # if stderr is going to stdout, but stdout is a tty or a pipe, # we should not specify a read_fd, because stdout is os.dup'ed # directly to the stdout fd (no pipe), and so stderr won't have # a slave end of a pipe either to dup if stdout_is_fd_based and not tee_out: self._stderr_parent_fd = None else: self._stderr_parent_fd = os.dup(self._stdout_parent_fd) self._stderr_child_fd = os.dup(self._stdout_child_fd) elif stderr_is_fd_based and not tee_err: self._stderr_child_fd = os.dup(get_fileno(stderr)) self._stderr_parent_fd = None else: self._stderr_parent_fd, self._stderr_child_fd = os.pipe() piped = ca["piped"] self._pipe_fd = None if piped: fd_to_use = self._stdout_parent_fd if piped == "err": fd_to_use = self._stderr_parent_fd self._pipe_fd = os.dup(fd_to_use) new_session = ca["new_session"] needs_ctty = ca["tty_in"] and new_session self.ctty = None if needs_ctty: self.ctty = os.ttyname(self._stdin_child_fd) gc_enabled = gc.isenabled() if gc_enabled: gc.disable() # for synchronizing session_pipe_read, session_pipe_write = os.pipe() exc_pipe_read, exc_pipe_write = os.pipe() # this pipe is for synchronizing with the child that the parent has # closed its in/out/err fds. this is a bug on OSX (but not linux), # where we can lose output sometimes, due to a race, if we do # os.close(self._stdout_child_fd) in the parent after the child starts # writing. if IS_MACOS: close_pipe_read, close_pipe_write = os.pipe() else: close_pipe_read, close_pipe_write = None, None # session id, group id, process id self.sid = None self.pgid = None self.pid = os.fork() # child if self.pid == 0: # pragma: no cover if IS_MACOS: os.read(close_pipe_read, 1) os.close(close_pipe_read) os.close(close_pipe_write) # this is critical # our exc_pipe_write must have CLOEXEC enabled. the reason for this is tricky: # if our child (the block we're in now), has an exception, we need to be able to write to exc_pipe_write, so # that when the parent does os.read(exc_pipe_read), it gets our traceback. however, os.read(exc_pipe_read) # in the parent blocks, so if our child *doesn't* have an exception, and doesn't close the writing end, it # hangs forever. not good! but obviously the child can't close the writing end until it knows it's not # going to have an exception, which is impossible to know because but what if os.execv has an exception? so # the answer is CLOEXEC, so that the writing end of the pipe gets closed upon successful exec, and the # parent reading the read end won't block (close breaks the block). flags = fcntl.fcntl(exc_pipe_write, fcntl.F_GETFD) flags |= fcntl.FD_CLOEXEC fcntl.fcntl(exc_pipe_write, fcntl.F_SETFD, flags) try: # ignoring SIGHUP lets us persist even after the parent process # exits. only ignore if we're backgrounded if ca["bg"] is True: signal.signal(signal.SIGHUP, signal.SIG_IGN) # python ignores SIGPIPE by default. we must make sure to put # this behavior back to the default for spawned processes, # otherwise SIGPIPE won't kill piped processes, which is what we # need, so that we can check the error code of the killed # process to see that SIGPIPE killed it signal.signal(signal.SIGPIPE, signal.SIG_DFL) # put our forked process in a new session? this will relinquish # any control of our inherited CTTY and also make our parent # process init if new_session: os.setsid() # if we're not going in a new session, we should go in a new # process group. this way, our process, and any children it # spawns, are alone, contained entirely in one group. if we # didn't do this, and didn't use a new session, then our exec'd # process *could* exist in the same group as our python process, # depending on how we launch the process (from a shell, or some # other way) else: os.setpgrp() sid = os.getsid(0) pgid = os.getpgid(0) payload = ("%d,%d" % (sid, pgid)).encode(DEFAULT_ENCODING) os.write(session_pipe_write, payload) if ca["tty_out"] and not stdout_is_fd_based and not single_tty: # set raw mode, so there isn't any weird translation of # newlines to \r\n and other oddities. we're not outputting # to a terminal anyways # # we HAVE to do this here, and not in the parent process, # because we have to guarantee that this is set before the # child process is run, and we can't do it twice. tty.setraw(self._stdout_child_fd) # if the parent-side fd for stdin exists, close it. the case # where it may not exist is if we're using piping if self._stdin_parent_fd: os.close(self._stdin_parent_fd) if self._stdout_parent_fd: os.close(self._stdout_parent_fd) if self._stderr_parent_fd: os.close(self._stderr_parent_fd) os.close(session_pipe_read) os.close(exc_pipe_read) cwd = ca["cwd"] if cwd: os.chdir(cwd) os.dup2(self._stdin_child_fd, 0) os.dup2(self._stdout_child_fd, 1) os.dup2(self._stderr_child_fd, 2) # set our controlling terminal, but only if we're using a tty # for stdin. it doesn't make sense to have a ctty otherwise if needs_ctty: tmp_fd = os.open(os.ttyname(0), os.O_RDWR) os.close(tmp_fd) if ca["tty_out"] and not stdout_is_fd_based: setwinsize(1, ca["tty_size"]) if ca["uid"] is not None: os.setgid(target_gid) os.setuid(target_uid) preexec_fn = ca["preexec_fn"] if callable(preexec_fn): preexec_fn() close_fds = ca["close_fds"] if ca["pass_fds"]: close_fds = True if close_fds: pass_fds = set((0, 1, 2, exc_pipe_write)) pass_fds.update(ca["pass_fds"]) # don't inherit file descriptors inherited_fds = os.listdir("/dev/fd") inherited_fds = set(int(fd) for fd in inherited_fds) - pass_fds for fd in inherited_fds: try: os.close(fd) except OSError: pass # actually execute the process if ca["env"] is None: os.execv(cmd[0], cmd) else: os.execve(cmd[0], cmd, ca["env"]) # we must ensure that we carefully exit the child process on # exception, otherwise the parent process code will be executed # twice on exception https://github.com/amoffat/sh/issues/202 # # if your parent process experiences an exit code 255, it is most # likely that an exception occurred between the fork of the child # and the exec. this should be reported. except: # noqa: E722 # some helpful debugging tb = traceback.format_exc().encode("utf8", "ignore") try: os.write(exc_pipe_write, tb) except Exception as e: # dump to stderr if we cannot save it to exc_pipe_write sys.stderr.write("\nFATAL SH ERROR: %s\n" % e) finally: os._exit(255) # parent else: if gc_enabled: gc.enable() os.close(self._stdin_child_fd) os.close(self._stdout_child_fd) os.close(self._stderr_child_fd) # tell our child process that we've closed our write_fds, so it is # ok to proceed towards exec. see the comment where this pipe is # opened, for why this is necessary if IS_MACOS: os.close(close_pipe_read) os.write(close_pipe_write, str(1).encode(DEFAULT_ENCODING)) os.close(close_pipe_write) os.close(exc_pipe_write) fork_exc = os.read(exc_pipe_read, 1024 ** 2) os.close(exc_pipe_read) if fork_exc: fork_exc = fork_exc.decode(DEFAULT_ENCODING) raise ForkException(fork_exc) os.close(session_pipe_write) sid, pgid = os.read(session_pipe_read, 1024).decode(DEFAULT_ENCODING).split(",") os.close(session_pipe_read) self.sid = int(sid) self.pgid = int(pgid) # used to determine what exception to raise. if our process was # killed via a timeout counter, we'll raise something different than # a SIGKILL exception self.timed_out = False self.started = time.time() self.cmd = cmd # exit code should only be manipulated from within self._wait_lock # to prevent race conditions self.exit_code = None self.stdin = stdin # this accounts for when _out is a callable that is passed stdin. in that case, if stdin is unspecified, we # must set it to a queue, so callbacks can put things on it if callable(ca["out"]) and self.stdin is None: self.stdin = Queue() # _pipe_queue is used internally to hand off stdout from one process # to another. by default, all stdout from a process gets dumped # into this pipe queue, to be consumed in real time (hence the # thread-safe Queue), or at a potentially later time self._pipe_queue = Queue() # this is used to prevent a race condition when we're waiting for # a process to end, and the OProc's internal threads are also checking # for the processes's end self._wait_lock = threading.Lock() # these are for aggregating the stdout and stderr. we use a deque # because we don't want to overflow self._stdout = deque(maxlen=ca["internal_bufsize"]) self._stderr = deque(maxlen=ca["internal_bufsize"]) if ca["tty_in"] and not stdin_is_fd_based: setwinsize(self._stdin_parent_fd, ca["tty_size"]) self.log = parent_log.get_child("process", repr(self)) self.log.debug("started process") # disable echoing, but only if it's a tty that we created ourselves if ca["tty_in"] and not stdin_is_fd_based: attr = termios.tcgetattr(self._stdin_parent_fd) attr[3] &= ~termios.ECHO termios.tcsetattr(self._stdin_parent_fd, termios.TCSANOW, attr) # this represents the connection from a Queue object (or whatever # we're using to feed STDIN) to the process's STDIN fd self._stdin_stream = None if self._stdin_parent_fd: log = self.log.get_child("streamwriter", "stdin") self._stdin_stream = StreamWriter(log, self._stdin_parent_fd, self.stdin, ca["in_bufsize"], ca["encoding"], ca["tty_in"]) stdout_pipe = None if pipe is OProc.STDOUT and not ca["no_pipe"]: stdout_pipe = self._pipe_queue # this represents the connection from a process's STDOUT fd to # wherever it has to go, sometimes a pipe Queue (that we will use # to pipe data to other processes), and also an internal deque # that we use to aggregate all the output save_stdout = not ca["no_out"] and (tee_out or stdout is None) pipe_out = ca["piped"] in ("out", True) pipe_err = ca["piped"] in ("err",) # if we're piping directly into another process's file descriptor, we # bypass reading from the stdout stream altogether, because we've # already hooked up this processes's stdout fd to the other # processes's stdin fd self._stdout_stream = None if not pipe_out and self._stdout_parent_fd: if callable(stdout): stdout = construct_streamreader_callback(self, stdout) self._stdout_stream = StreamReader( self.log.get_child("streamreader", "stdout"), self._stdout_parent_fd, stdout, self._stdout, ca["out_bufsize"], ca["encoding"], ca["decode_errors"], stdout_pipe, save_data=save_stdout ) elif self._stdout_parent_fd: os.close(self._stdout_parent_fd) # if stderr is going to one place (because it's grouped with stdout, # or we're dealing with a single tty), then we don't actually need a # stream reader for stderr, because we've already set one up for # stdout above self._stderr_stream = None if stderr is not OProc.STDOUT and not single_tty and not pipe_err and self._stderr_parent_fd: stderr_pipe = None if pipe is OProc.STDERR and not ca["no_pipe"]: stderr_pipe = self._pipe_queue save_stderr = not ca["no_err"] and (ca["tee"] in ("err",) or stderr is None) if callable(stderr): stderr = construct_streamreader_callback(self, stderr) self._stderr_stream = StreamReader( Logger("streamreader"), self._stderr_parent_fd, stderr, self._stderr, ca["err_bufsize"], ca["encoding"], ca["decode_errors"], stderr_pipe, save_data=save_stderr ) elif self._stderr_parent_fd: os.close(self._stderr_parent_fd) def timeout_fn(): self.timed_out = True self.signal(ca["timeout_signal"]) self._timeout_event = None self._timeout_timer = None if ca["timeout"]: self._timeout_event = threading.Event() self._timeout_timer = threading.Timer(ca["timeout"], self._timeout_event.set) self._timeout_timer.start() # this is for cases where we know that the RunningCommand that was # launched was not .wait()ed on to complete. in those unique cases, # we allow the thread that processes output to report exceptions in # that thread. it's important that we only allow reporting of the # exception, and nothing else (like the additional stuff that # RunningCommand.wait() does), because we want the exception to be # re-raised in the future, if we DO call .wait() handle_exit_code = None if not self.command._spawned_and_waited and ca["bg_exc"]: def fn(exit_code): with process_assign_lock: return self.command.handle_command_exit_code(exit_code) handle_exit_code = fn self._quit_threads = threading.Event() thread_name = "background thread for pid %d" % self.pid self._bg_thread_exc_queue = Queue(1) self._background_thread = _start_daemon_thread( background_thread, thread_name, self._bg_thread_exc_queue, timeout_fn, self._timeout_event, handle_exit_code, self.is_alive, self._quit_threads ) # start the main io threads. stdin thread is not needed if we are # connecting from another process's stdout pipe self._input_thread = None self._input_thread_exc_queue = Queue(1) if self._stdin_stream: close_before_term = not needs_ctty thread_name = "STDIN thread for pid %d" % self.pid self._input_thread = _start_daemon_thread( input_thread, thread_name, self._input_thread_exc_queue, self.log, self._stdin_stream, self.is_alive, self._quit_threads, close_before_term ) # this event is for cases where the subprocess that we launch # launches its OWN subprocess and os.dup's the stdout/stderr fds to that # new subprocess. in that case, stdout and stderr will never EOF, # so our output_thread will never finish and will hang. this event # prevents that hanging self._stop_output_event = threading.Event() self._output_thread_exc_queue = Queue(1) thread_name = "STDOUT/ERR thread for pid %d" % self.pid self._output_thread = _start_daemon_thread( output_thread, thread_name, self._output_thread_exc_queue, self.log, self._stdout_stream, self._stderr_stream, self._timeout_event, self.is_alive, self._quit_threads, self._stop_output_event ) def __repr__(self): return "" % (self.pid, self.cmd[:500]) # these next 3 properties are primary for tests @property def output_thread_exc(self): exc = None try: exc = self._output_thread_exc_queue.get(False) except Empty: pass return exc @property def input_thread_exc(self): exc = None try: exc = self._input_thread_exc_queue.get(False) except Empty: pass return exc @property def bg_thread_exc(self): exc = None try: exc = self._bg_thread_exc_queue.get(False) except Empty: pass return exc def change_in_bufsize(self, buf): self._stdin_stream.stream_bufferer.change_buffering(buf) def change_out_bufsize(self, buf): self._stdout_stream.stream_bufferer.change_buffering(buf) def change_err_bufsize(self, buf): self._stderr_stream.stream_bufferer.change_buffering(buf) @property def stdout(self): return "".encode(self.call_args["encoding"]).join(self._stdout) @property def stderr(self): return "".encode(self.call_args["encoding"]).join(self._stderr) def get_pgid(self): """ return the CURRENT group id of the process. this differs from self.pgid in that this reflects the current state of the process, where self.pgid is the group id at launch """ return os.getpgid(self.pid) def get_sid(self): """ return the CURRENT session id of the process. this differs from self.sid in that this reflects the current state of the process, where self.sid is the session id at launch """ return os.getsid(self.pid) def signal_group(self, sig): self.log.debug("sending signal %d to group", sig) os.killpg(self.get_pgid(), sig) def signal(self, sig): self.log.debug("sending signal %d", sig) os.kill(self.pid, sig) def kill_group(self): self.log.debug("killing group") self.signal_group(signal.SIGKILL) def kill(self): self.log.debug("killing") self.signal(signal.SIGKILL) def terminate(self): self.log.debug("terminating") self.signal(signal.SIGTERM) def is_alive(self): """ polls if our child process has completed, without blocking. this method has side-effects, such as setting our exit_code, if we happen to see our child exit while this is running """ if self.exit_code is not None: return False, self.exit_code # what we're doing here essentially is making sure that the main thread # (or another thread), isn't calling .wait() on the process. because # .wait() calls os.waitpid(self.pid, 0), we can't do an os.waitpid # here...because if we did, and the process exited while in this # thread, the main thread's os.waitpid(self.pid, 0) would raise OSError # (because the process ended in another thread). # # so essentially what we're doing is, using this lock, checking if # we're calling .wait(), and if we are, let .wait() get the exit code # and handle the status, otherwise let us do it. acquired = self._wait_lock.acquire(False) if not acquired: if self.exit_code is not None: return False, self.exit_code return True, self.exit_code try: # WNOHANG is just that...we're calling waitpid without hanging... # essentially polling the process. the return result is (0, 0) if # there's no process status, so we check that pid == self.pid below # in order to determine how to proceed pid, exit_code = no_interrupt(os.waitpid, self.pid, os.WNOHANG) if pid == self.pid: self.exit_code = handle_process_exit_code(exit_code) self._process_just_ended() return False, self.exit_code # no child process except OSError: return False, self.exit_code else: return True, self.exit_code finally: self._wait_lock.release() def _process_just_ended(self): if self._timeout_timer: self._timeout_timer.cancel() done_callback = self.call_args["done"] if done_callback: success = self.exit_code in self.call_args["ok_code"] done_callback(success, self.exit_code) # this can only be closed at the end of the process, because it might be # the CTTY, and closing it prematurely will send a SIGHUP. we also # don't want to close it if there's a self._stdin_stream, because that # is in charge of closing it also if self._stdin_parent_fd and not self._stdin_stream: os.close(self._stdin_parent_fd) def wait(self): """ waits for the process to complete, handles the exit code """ self.log.debug("acquiring wait lock to wait for completion") # using the lock in a with-context blocks, which is what we want if # we're running wait() with self._wait_lock: self.log.debug("got wait lock") witnessed_end = False if self.exit_code is None: self.log.debug("exit code not set, waiting on pid") pid, exit_code = no_interrupt(os.waitpid, self.pid, 0) # blocks self.exit_code = handle_process_exit_code(exit_code) witnessed_end = True else: self.log.debug("exit code already set (%d), no need to wait", self.exit_code) self._quit_threads.set() # we may not have a thread for stdin, if the pipe has been connected # via _piped="direct" if self._input_thread: self._input_thread.join() # wait, then signal to our output thread that the child process is # done, and we should have finished reading all the stdout/stderr # data that we can by now timer = threading.Timer(2.0, self._stop_output_event.set) timer.start() # wait for our stdout and stderr streamreaders to finish reading and # aggregating the process output self._output_thread.join() timer.cancel() self._background_thread.join() if witnessed_end: self._process_just_ended() return self.exit_code def input_thread(log, stdin, is_alive, quit_thread, close_before_term): """ this is run in a separate thread. it writes into our process's stdin (a streamwriter) and waits the process to end AND everything that can be written to be written """ closed = False alive = True poller = Poller() poller.register_write(stdin) while poller and alive: changed = poller.poll(1) for fd, events in changed: if events & (POLLER_EVENT_WRITE | POLLER_EVENT_HUP): log.debug("%r ready for more input", stdin) done = stdin.write() if done: poller.unregister(stdin) if close_before_term: stdin.close() closed = True alive, _ = is_alive() while alive: quit_thread.wait(1) alive, _ = is_alive() if not closed: stdin.close() def event_wait(ev, timeout=None): triggered = ev.wait(timeout) if IS_PY26: triggered = ev.is_set() return triggered def background_thread(timeout_fn, timeout_event, handle_exit_code, is_alive, quit_thread): """ handles the timeout logic """ # if there's a timeout event, loop if timeout_event: while not quit_thread.is_set(): timed_out = event_wait(timeout_event, 0.1) if timed_out: timeout_fn() break # handle_exit_code will be a function ONLY if our command was NOT waited on # as part of its spawning. in other words, it's probably a background # command # # this reports the exit code exception in our thread. it's purely for the # user's awareness, and cannot be caught or used in any way, so it's ok to # suppress this during the tests if handle_exit_code and not RUNNING_TESTS: # pragma: no cover alive = True exit_code = None while alive: quit_thread.wait(1) alive, exit_code = is_alive() handle_exit_code(exit_code) def output_thread(log, stdout, stderr, timeout_event, is_alive, quit_thread, stop_output_event): """ this function is run in a separate thread. it reads from the process's stdout stream (a streamreader), and waits for it to claim that its done """ poller = Poller() if stdout is not None: poller.register_read(stdout) if stderr is not None: poller.register_read(stderr) # this is our poll loop for polling stdout or stderr that is ready to # be read and processed. if one of those streamreaders indicate that it # is done altogether being read from, we remove it from our list of # things to poll. when no more things are left to poll, we leave this # loop and clean up while poller: changed = no_interrupt(poller.poll, 0.1) for f, events in changed: if events & (POLLER_EVENT_READ | POLLER_EVENT_HUP): log.debug("%r ready to be read from", f) done = f.read() if done: poller.unregister(f) elif events & POLLER_EVENT_ERROR: # for some reason, we have to just ignore streams that have had an # error. i'm not exactly sure why, but don't remove this until we # figure that out, and create a test for it pass if timeout_event and timeout_event.is_set(): break if stop_output_event.is_set(): break # we need to wait until the process is guaranteed dead before closing our # outputs, otherwise SIGPIPE alive, _ = is_alive() while alive: quit_thread.wait(1) alive, _ = is_alive() if stdout: stdout.close() if stderr: stderr.close() class DoneReadingForever(Exception): pass class NotYetReadyToRead(Exception): pass def determine_how_to_read_input(input_obj): """ given some kind of input object, return a function that knows how to read chunks of that input object. each reader function should return a chunk and raise a DoneReadingForever exception, or return None, when there's no more data to read NOTE: the function returned does not need to care much about the requested buffering type (eg, unbuffered vs newline-buffered). the StreamBufferer will take care of that. these functions just need to return a reasonably-sized chunk of data. """ if isinstance(input_obj, Queue): log_msg = "queue" get_chunk = get_queue_chunk_reader(input_obj) elif callable(input_obj): log_msg = "callable" get_chunk = get_callable_chunk_reader(input_obj) # also handles stringio elif hasattr(input_obj, "read"): log_msg = "file descriptor" get_chunk = get_file_chunk_reader(input_obj) elif isinstance(input_obj, basestring): log_msg = "string" get_chunk = get_iter_string_reader(input_obj) elif isinstance(input_obj, bytes): log_msg = "bytes" get_chunk = get_iter_string_reader(input_obj) elif isinstance(input_obj, GeneratorType): log_msg = "generator" get_chunk = get_iter_chunk_reader(iter(input_obj)) elif input_obj is None: log_msg = "None" def raise_(): raise DoneReadingForever get_chunk = raise_ else: try: it = iter(input_obj) except TypeError: raise Exception("unknown input object") else: log_msg = "general iterable" get_chunk = get_iter_chunk_reader(it) return get_chunk, log_msg def get_queue_chunk_reader(stdin): def fn(): try: chunk = stdin.get(True, 0.1) except Empty: raise NotYetReadyToRead if chunk is None: raise DoneReadingForever return chunk return fn def get_callable_chunk_reader(stdin): def fn(): try: data = stdin() except DoneReadingForever: raise if not data: raise DoneReadingForever return data return fn def get_iter_string_reader(stdin): """ return an iterator that returns a chunk of a string every time it is called. notice that even though bufsize_type might be line buffered, we're not doing any line buffering here. that's because our StreamBufferer handles all buffering. we just need to return a reasonable-sized chunk. """ bufsize = 1024 iter_str = (stdin[i:i + bufsize] for i in range(0, len(stdin), bufsize)) return get_iter_chunk_reader(iter_str) def get_iter_chunk_reader(stdin): def fn(): try: if IS_PY3: chunk = stdin.__next__() else: chunk = stdin.next() return chunk except StopIteration: raise DoneReadingForever return fn def get_file_chunk_reader(stdin): bufsize = 1024 def fn(): # python 3.* includes a fileno on stringios, but accessing it throws an # exception. that exception is how we'll know we can't do a poll on # stdin is_real_file = True if IS_PY3: try: stdin.fileno() except UnsupportedOperation: is_real_file = False # this poll is for files that may not yet be ready to read. we test # for fileno because StringIO/BytesIO cannot be used in a poll if is_real_file and hasattr(stdin, "fileno"): poller = Poller() poller.register_read(stdin) changed = poller.poll(0.1) ready = False for fd, events in changed: if events & (POLLER_EVENT_READ | POLLER_EVENT_HUP): ready = True if not ready: raise NotYetReadyToRead chunk = stdin.read(bufsize) if not chunk: raise DoneReadingForever else: return chunk return fn def bufsize_type_to_bufsize(bf_type): """ for a given bufsize type, return the actual bufsize we will read. notice that although 1 means "newline-buffered", we're reading a chunk size of 1024. this is because we have to read something. we let a StreamBufferer instance handle splitting our chunk on newlines """ # newlines if bf_type == 1: bufsize = 1024 # unbuffered elif bf_type == 0: bufsize = 1 # or buffered by specific amount else: bufsize = bf_type return bufsize class StreamWriter(object): """ StreamWriter reads from some input (the stdin param) and writes to a fd (the stream param). the stdin may be a Queue, a callable, something with the "read" method, a string, or an iterable """ def __init__(self, log, stream, stdin, bufsize_type, encoding, tty_in): self.stream = stream self.stdin = stdin self.log = log self.encoding = encoding self.tty_in = tty_in self.stream_bufferer = StreamBufferer(bufsize_type, self.encoding) self.get_chunk, log_msg = determine_how_to_read_input(stdin) self.log.debug("parsed stdin as a %s", log_msg) def fileno(self): """ defining this allows us to do poll on an instance of this class """ return self.stream def write(self): """ attempt to get a chunk of data to write to our child process's stdin, then write it. the return value answers the questions "are we done writing forever?" """ # get_chunk may sometimes return bytes, and sometimes return strings # because of the nature of the different types of STDIN objects we # support try: chunk = self.get_chunk() if chunk is None: raise DoneReadingForever except DoneReadingForever: self.log.debug("done reading") if self.tty_in: # EOF time try: char = termios.tcgetattr(self.stream)[6][termios.VEOF] except: # noqa: E722 char = chr(4).encode() # normally, one EOF should be enough to signal to an program # that is read()ing, to return 0 and be on your way. however, # some programs are misbehaved, like python3.1 and python3.2. # they don't stop reading sometimes after read() returns 0. # this can be demonstrated with the following program: # # import sys # sys.stdout.write(sys.stdin.read()) # # then type 'a' followed by ctrl-d 3 times. in python # 2.6,2.7,3.3,3.4,3.5,3.6, it only takes 2 ctrl-d to terminate. # however, in python 3.1 and 3.2, it takes all 3. # # so here we send an extra EOF along, just in case. i don't # believe it can hurt anything os.write(self.stream, char) os.write(self.stream, char) return True except NotYetReadyToRead: self.log.debug("received no data") return False # if we're not bytes, make us bytes if IS_PY3 and not isinstance(chunk, bytes): chunk = chunk.encode(self.encoding) for proc_chunk in self.stream_bufferer.process(chunk): self.log.debug("got chunk size %d: %r", len(proc_chunk), proc_chunk[:30]) self.log.debug("writing chunk to process") try: os.write(self.stream, proc_chunk) except OSError: self.log.debug("OSError writing stdin chunk") return True def close(self): self.log.debug("closing, but flushing first") chunk = self.stream_bufferer.flush() self.log.debug("got chunk size %d to flush: %r", len(chunk), chunk[:30]) try: if chunk: os.write(self.stream, chunk) except OSError: pass os.close(self.stream) def determine_how_to_feed_output(handler, encoding, decode_errors): if callable(handler): process, finish = get_callback_chunk_consumer(handler, encoding, decode_errors) # in py3, this is used for bytes elif isinstance(handler, (cStringIO, iocStringIO)): process, finish = get_cstringio_chunk_consumer(handler) # in py3, this is used for unicode elif isinstance(handler, (StringIO, ioStringIO)): process, finish = get_stringio_chunk_consumer(handler, encoding, decode_errors) elif hasattr(handler, "write"): process, finish = get_file_chunk_consumer(handler) else: try: handler = int(handler) except (ValueError, TypeError): def process(chunk): return False # noqa: E731 def finish(): return None # noqa: E731 else: process, finish = get_fd_chunk_consumer(handler) return process, finish def get_fd_chunk_consumer(handler): handler = fdopen(handler, "w", closefd=False) return get_file_chunk_consumer(handler) def get_file_chunk_consumer(handler): if getattr(handler, "encoding", None): def encode(chunk): return chunk.decode(handler.encoding) # noqa: E731 else: def encode(chunk): return chunk # noqa: E731 if hasattr(handler, "flush"): flush = handler.flush else: def flush(): return None # noqa: E731 def process(chunk): handler.write(encode(chunk)) # we should flush on an fd. chunk is already the correctly-buffered # size, so we don't need the fd buffering as well flush() return False def finish(): flush() return process, finish def get_callback_chunk_consumer(handler, encoding, decode_errors): def process(chunk): # try to use the encoding first, if that doesn't work, send # the bytes, because it might be binary try: chunk = chunk.decode(encoding, decode_errors) except UnicodeDecodeError: pass return handler(chunk) def finish(): pass return process, finish def get_cstringio_chunk_consumer(handler): def process(chunk): handler.write(chunk) return False def finish(): pass return process, finish def get_stringio_chunk_consumer(handler, encoding, decode_errors): def process(chunk): handler.write(chunk.decode(encoding, decode_errors)) return False def finish(): pass return process, finish class StreamReader(object): """ reads from some output (the stream) and sends what it just read to the handler. """ def __init__(self, log, stream, handler, buffer, bufsize_type, encoding, decode_errors, pipe_queue=None, save_data=True): self.stream = stream self.buffer = buffer self.save_data = save_data self.encoding = encoding self.decode_errors = decode_errors self.pipe_queue = None if pipe_queue: self.pipe_queue = weakref.ref(pipe_queue) self.log = log self.stream_bufferer = StreamBufferer(bufsize_type, self.encoding, self.decode_errors) self.bufsize = bufsize_type_to_bufsize(bufsize_type) self.process_chunk, self.finish_chunk_processor = \ determine_how_to_feed_output(handler, encoding, decode_errors) self.should_quit = False def fileno(self): """ defining this allows us to do poll on an instance of this class """ return self.stream def close(self): chunk = self.stream_bufferer.flush() self.log.debug("got chunk size %d to flush: %r", len(chunk), chunk[:30]) if chunk: self.write_chunk(chunk) self.finish_chunk_processor() if self.pipe_queue and self.save_data: self.pipe_queue().put(None) os.close(self.stream) def write_chunk(self, chunk): # in PY3, the chunk coming in will be bytes, so keep that in mind if not self.should_quit: self.should_quit = self.process_chunk(chunk) if self.save_data: self.buffer.append(chunk) if self.pipe_queue: self.log.debug("putting chunk onto pipe: %r", chunk[:30]) self.pipe_queue().put(chunk) def read(self): # if we're PY3, we're reading bytes, otherwise we're reading # str try: chunk = no_interrupt(os.read, self.stream, self.bufsize) except OSError as e: self.log.debug("got errno %d, done reading", e.errno) return True if not chunk: self.log.debug("got no chunk, done reading") return True self.log.debug("got chunk size %d: %r", len(chunk), chunk[:30]) for chunk in self.stream_bufferer.process(chunk): self.write_chunk(chunk) class StreamBufferer(object): """ this is used for feeding in chunks of stdout/stderr, and breaking it up into chunks that will actually be put into the internal buffers. for example, if you have two processes, one being piped to the other, and you want that, first process to feed lines of data (instead of the chunks however they come in), OProc will use an instance of this class to chop up the data and feed it as lines to be sent down the pipe """ def __init__(self, buffer_type, encoding=DEFAULT_ENCODING, decode_errors="strict"): # 0 for unbuffered, 1 for line, everything else for that amount self.type = buffer_type self.buffer = [] self.n_buffer_count = 0 self.encoding = encoding self.decode_errors = decode_errors # this is for if we change buffering types. if we change from line # buffered to unbuffered, its very possible that our self.buffer list # has data that was being saved up (while we searched for a newline). # we need to use that up, so we don't lose it self._use_up_buffer_first = False # the buffering lock is used because we might change the buffering # types from a different thread. for example, if we have a stdout # callback, we might use it to change the way stdin buffers. so we # lock self._buffering_lock = threading.RLock() self.log = Logger("stream_bufferer") def change_buffering(self, new_type): # TODO, when we stop supporting 2.6, make this a with context self.log.debug("acquiring buffering lock for changing buffering") self._buffering_lock.acquire() self.log.debug("got buffering lock for changing buffering") try: if new_type == 0: self._use_up_buffer_first = True self.type = new_type finally: self._buffering_lock.release() self.log.debug("released buffering lock for changing buffering") def process(self, chunk): # MAKE SURE THAT THE INPUT IS PY3 BYTES # THE OUTPUT IS ALWAYS PY3 BYTES # TODO, when we stop supporting 2.6, make this a with context self.log.debug("acquiring buffering lock to process chunk (buffering: %d)", self.type) self._buffering_lock.acquire() self.log.debug("got buffering lock to process chunk (buffering: %d)", self.type) try: # unbuffered if self.type == 0: if self._use_up_buffer_first: self._use_up_buffer_first = False to_write = self.buffer self.buffer = [] to_write.append(chunk) return to_write return [chunk] # line buffered elif self.type == 1: total_to_write = [] nl = "\n".encode(self.encoding) while True: newline = chunk.find(nl) if newline == -1: break chunk_to_write = chunk[:newline + 1] if self.buffer: chunk_to_write = b"".join(self.buffer) + chunk_to_write self.buffer = [] self.n_buffer_count = 0 chunk = chunk[newline + 1:] total_to_write.append(chunk_to_write) if chunk: self.buffer.append(chunk) self.n_buffer_count += len(chunk) return total_to_write # N size buffered else: total_to_write = [] while True: overage = self.n_buffer_count + len(chunk) - self.type if overage >= 0: ret = "".encode(self.encoding).join(self.buffer) + chunk chunk_to_write = ret[:self.type] chunk = ret[self.type:] total_to_write.append(chunk_to_write) self.buffer = [] self.n_buffer_count = 0 else: self.buffer.append(chunk) self.n_buffer_count += len(chunk) break return total_to_write finally: self._buffering_lock.release() self.log.debug("released buffering lock for processing chunk (buffering: %d)", self.type) def flush(self): self.log.debug("acquiring buffering lock for flushing buffer") self._buffering_lock.acquire() self.log.debug("got buffering lock for flushing buffer") try: ret = "".encode(self.encoding).join(self.buffer) self.buffer = [] return ret finally: self._buffering_lock.release() self.log.debug("released buffering lock for flushing buffer") def with_lock(lock): def wrapped(fn): fn = contextmanager(fn) @contextmanager def wrapped2(*args, **kwargs): with lock: with fn(*args, **kwargs): yield return wrapped2 return wrapped @with_lock(PUSHD_LOCK) def pushd(path): """ pushd changes the actual working directory for the duration of the context, unlike the _cwd arg this will work with other built-ins such as sh.glob correctly """ orig_path = os.getcwd() os.chdir(path) try: yield finally: os.chdir(orig_path) @contextmanager def _args(**kwargs): """ allows us to temporarily override all the special keyword parameters in a with context """ kwargs_str = ",".join(["%s=%r" % (k, v) for k, v in kwargs.items()]) raise DeprecationWarning(""" sh.args() has been deprecated because it was never thread safe. use the following instead: sh2 = sh({kwargs}) sh2.your_command() or sh2 = sh({kwargs}) from sh2 import your_command your_command() """.format(kwargs=kwargs_str)) class Environment(dict): """ this allows lookups to names that aren't found in the global scope to be searched for as a program name. for example, if "ls" isn't found in this module's scope, we consider it a system program and try to find it. we use a dict instead of just a regular object as the base class because the exec() statement used in the run_repl requires the "globals" argument to be a dictionary """ # this is a list of all of the names that the sh module exports that will # not resolve to functions. we don't want to accidentally shadow real # commands with functions/imports that we define in sh.py. for example, # "import time" may override the time system program whitelist = set(( "Command", "RunningCommand", "CommandNotFound", "DEFAULT_ENCODING", "DoneReadingForever", "ErrorReturnCode", "NotYetReadyToRead", "SignalException", "ForkException", "TimeoutException", "StreamBufferer", "__project_url__", "__version__", "__file__", "_args", "pushd", "glob", "contrib", )) def __init__(self, globs, baked_args=None): """ baked_args are defaults for the 'sh' execution context. for example: tmp = sh(_out=StringIO()) 'out' would end up in here as an entry in the baked_args dict """ super(dict, self).__init__() self.globs = globs self.baked_args = baked_args or {} def __getitem__(self, k): if k == 'args': # Let the deprecated '_args' context manager be imported as 'args' k = '_args' # if we're trying to import something real, see if it's in our global scope. # what defines "real" is that it's in our whitelist if k in self.whitelist: return self.globs[k] # somebody tried to be funny and do "from sh import *" if k == "__all__": warnings.warn("Cannot import * from sh. Please import sh or import programs individually.") return [] # check if we're naming a dynamically generated ReturnCode exception exc = get_exc_from_name(k) if exc: return exc # https://github.com/ipython/ipython/issues/2577 # https://github.com/amoffat/sh/issues/97#issuecomment-10610629 if k.startswith("__") and k.endswith("__"): raise AttributeError # is it a custom builtin? builtin = getattr(self, "b_" + k, None) if builtin: return builtin # is it a command? cmd = resolve_command(k, self.baked_args) if cmd: return cmd # how about an environment variable? # this check must come after testing if its a command, because on some # systems, there are an environment variables that can conflict with # command names. # https://github.com/amoffat/sh/issues/238 try: return os.environ[k] except KeyError: pass # nothing found, raise an exception raise CommandNotFound(k) # methods that begin with "b_" are custom builtins and will override any # program that exists in our path. this is useful for things like # common shell builtins that people are used to, but which aren't actually # full-fledged system binaries @staticmethod def b_cd(path=None): if path: os.chdir(path) else: os.chdir(os.path.expanduser('~')) @staticmethod def b_which(program, paths=None): return which(program, paths) class Contrib(ModuleType): # pragma: no cover @classmethod def __call__(cls, name): def wrapper1(fn): @property def cmd_getter(self): cmd = resolve_command(name) if not cmd: raise CommandNotFound(name) new_cmd = fn(cmd) return new_cmd setattr(cls, name, cmd_getter) return fn return wrapper1 mod_name = __name__ + ".contrib" contrib = Contrib(mod_name) sys.modules[mod_name] = contrib @contrib("git") def git(orig): # pragma: no cover """ most git commands play nicer without a TTY """ cmd = orig.bake(_tty_out=False) return cmd @contrib("sudo") def sudo(orig): # pragma: no cover """ a nicer version of sudo that uses getpass to ask for a password, or allows the first argument to be a string password """ prompt = "[sudo] password for %s: " % getpass.getuser() def stdin(): pw = getpass.getpass(prompt=prompt) + "\n" yield pw def process(a, kwargs): password = kwargs.pop("password", None) if password is None: pass_getter = stdin() else: pass_getter = password.rstrip("\n") + "\n" kwargs["_in"] = pass_getter return a, kwargs cmd = orig.bake("-S", _arg_preprocess=process) return cmd @contrib("ssh") def ssh(orig): # pragma: no cover """ An ssh command for automatic password login """ class SessionContent(object): def __init__(self): self.chars = deque(maxlen=50000) self.lines = deque(maxlen=5000) self.line_chars = [] self.last_line = "" self.cur_char = "" def append_char(self, char): if char == "\n": line = self.cur_line self.last_line = line self.lines.append(line) self.line_chars = [] else: self.line_chars.append(char) self.chars.append(char) self.cur_char = char @property def cur_line(self): line = "".join(self.line_chars) return line class SSHInteract(object): def __init__(self, prompt_match, pass_getter, out_handler, login_success): self.prompt_match = prompt_match self.pass_getter = pass_getter self.out_handler = out_handler self.login_success = login_success self.content = SessionContent() # some basic state self.pw_entered = False self.success = False def __call__(self, char, stdin): self.content.append_char(char) if self.pw_entered and not self.success: self.success = self.login_success(self.content) if self.success: return self.out_handler(self.content, stdin) if self.prompt_match(self.content): password = self.pass_getter() stdin.put(password + "\n") self.pw_entered = True def process(a, kwargs): real_out_handler = kwargs.pop("interact") password = kwargs.pop("password", None) login_success = kwargs.pop("login_success", None) prompt_match = kwargs.pop("prompt", None) prompt = "Please enter SSH password: " if prompt_match is None: def prompt_match(content): return content.cur_line.endswith("password: ") # noqa: E731 if password is None: def pass_getter(): return getpass.getpass(prompt=prompt) # noqa: E731 else: def pass_getter(): return password.rstrip("\n") # noqa: E731 if login_success is None: def login_success(content): return True # noqa: E731 kwargs["_out"] = SSHInteract(prompt_match, pass_getter, real_out_handler, login_success) return a, kwargs cmd = orig.bake(_out_bufsize=0, _tty_in=True, _unify_ttys=True, _arg_preprocess=process) return cmd def run_repl(env): # pragma: no cover banner = "\n>> sh v{version}\n>> https://github.com/amoffat/sh\n" print(banner.format(version=__version__)) while True: try: line = raw_input("sh> ") except (ValueError, EOFError): break try: exec(compile(line, "", "single"), env, env) except SystemExit: break except: # noqa: E722 print(traceback.format_exc()) # cleans up our last line print("") # this is a thin wrapper around THIS module (we patch sys.modules[__name__]). # this is in the case that the user does a "from sh import whatever" # in other words, they only want to import certain programs, not the whole # system PATH worth of commands. in this case, we just proxy the # import lookup to our Environment class class SelfWrapper(ModuleType): def __init__(self, self_module, baked_args=None): # this is super ugly to have to copy attributes like this, # but it seems to be the only way to make reload() behave # nicely. if i make these attributes dynamic lookups in # __getattr__, reload sometimes chokes in weird ways... super(SelfWrapper, self).__init__( name=getattr(self_module, '__name__', None), doc=getattr(self_module, '__doc__', None) ) for attr in ["__builtins__", "__file__", "__package__"]: setattr(self, attr, getattr(self_module, attr, None)) # python 3.2 (2.7 and 3.3 work fine) breaks on osx (not ubuntu) # if we set this to None. and 3.3 needs a value for __path__ self.__path__ = [] self.__self_module = self_module self.__env = Environment(globals(), baked_args=baked_args) def __getattr__(self, name): return self.__env[name] def __call__(self, **kwargs): """ returns a new SelfWrapper object, where all commands spawned from it have the baked_args kwargs set on them by default """ baked_args = self.__env.baked_args.copy() baked_args.update(kwargs) new_mod = self.__class__(self.__self_module, baked_args) # inspect the line in the parent frame that calls and assigns the new sh # variable, and get the name of the new variable we're assigning to. # this is very brittle and pretty much a sin. but it works in 99% of # the time and the tests pass # # the reason we need to do this is because we need to remove the old # cached module from sys.modules. if we don't, it gets re-used, and any # old baked params get used, which is not what we want parent = inspect.stack()[1] try: code = parent[4][0].strip() except TypeError: # On the REPL or from the commandline, we don't get the source code in the # top stack frame # Older versions of pypy don't set parent[1] the same way as CPython or newer versions # of Pypy so we have to special case that too. if parent[1] in ('', '') or ( parent[1] == '' and platform.python_implementation().lower() == 'pypy'): # This depends on things like Python's calling convention and the layout of stack # frames but it's a fix for a bug in a very cornery cornercase so.... module_name = parent[0].f_code.co_names[-1] else: raise else: parsed = ast.parse(code) try: module_name = parsed.body[0].targets[0].id except Exception: # Diagnose what went wrong if not isinstance(parsed.body[0], ast.Assign): raise RuntimeError("A new execution context must be assigned to a variable") raise if module_name == __name__: raise RuntimeError("Cannot use the name '%s' as an execution context" % __name__) sys.modules.pop(module_name, None) return new_mod def in_importlib(frame): """ helper for checking if a filename is in importlib guts """ return frame.f_code.co_filename == "" def register_importer(): """ registers our fancy importer that can let us import from a module name, like: import sh tmp = sh() from tmp import ls """ def test(importer_cls): try: return importer_cls.__class__.__name__ == ModuleImporterFromVariables.__name__ except AttributeError: # ran into importer which is not a class instance return False already_registered = any([True for i in sys.meta_path if test(i)]) if not already_registered: importer = ModuleImporterFromVariables(restrict_to=[SelfWrapper.__name__], ) sys.meta_path.insert(0, importer) return not already_registered def fetch_module_from_frame(name, frame): mod = frame.f_locals.get(name, frame.f_globals.get(name, None)) return mod class ModuleImporterFromVariables(object): """ a fancy importer that allows us to import from a variable that was recently set in either the local or global scope, like this: sh2 = sh(_timeout=3) from sh2 import ls """ def __init__(self, restrict_to=None): self.restrict_to = set(restrict_to or set()) def find_module(self, mod_fullname, path=None): """ mod_fullname doubles as the name of the VARIABLE holding our new sh context. for example: derp = sh() from derp import ls here, mod_fullname will be "derp". keep that in mind as we go through the rest of this function """ parent_frame = inspect.currentframe().f_back if parent_frame and parent_frame.f_code.co_name == "find_spec": parent_frame = parent_frame.f_back while parent_frame and in_importlib(parent_frame): parent_frame = parent_frame.f_back # Calling PyImport_ImportModule("some_module"); via the C API may not # have a parent frame. Early-out to avoid in_importlib() trying to # get f_code from None when looking for 'some_module'. # This also happens when using gevent apparently. if not parent_frame: return None # this line is saying "hey, does mod_fullname exist as a name we've # defined previously?" the purpose of this is to ensure that # mod_fullname is really a thing we've defined. if we haven't defined # it before, then we "can't" import from it module = fetch_module_from_frame(mod_fullname, parent_frame) if not module: return None # make sure it's a class we're allowed to import from if module.__class__.__name__ not in self.restrict_to: return None return self def find_spec(self, fullname, path=None, target=None): """ find_module() is deprecated since Python 3.4 in favor of find_spec() """ from importlib.machinery import ModuleSpec found = self.find_module(fullname, path) return ModuleSpec(fullname, found) if found is not None else None def load_module(self, mod_fullname): parent_frame = inspect.currentframe().f_back while in_importlib(parent_frame): parent_frame = parent_frame.f_back module = fetch_module_from_frame(mod_fullname, parent_frame) # we HAVE to include the module in sys.modules, per the import PEP. # older versions of python were more lenient about this being set, but # not in >= python3.3, unfortunately. this requirement necessitates the # ugly code in SelfWrapper.__call__ sys.modules[mod_fullname] = module module.__loader__ = self return module def run_tests(env, locale, a, version, force_select, **extra_env): # pragma: no cover py_version = "python" py_version += str(version) py_bin = which(py_version) return_code = None poller = "poll" if force_select: poller = "select" if py_bin: print("Testing %s, locale %r, poller: %s" % (py_version.capitalize(), locale, poller)) env["SH_TESTS_USE_SELECT"] = str(int(force_select)) env["LANG"] = locale for k, v in extra_env.items(): env[k] = str(v) cmd = [py_bin, "-W", "ignore", os.path.join(THIS_DIR, "test.py")] + a[1:] print("Running %r" % cmd) return_code = os.spawnve(os.P_WAIT, cmd[0], cmd, env) return return_code def main(): # pragma: no cover from optparse import OptionParser parser = OptionParser() parser.add_option("-e", "--envs", dest="envs", default=None, action="append") parser.add_option("-l", "--locales", dest="constrain_locales", default=None, action="append") options, parsed_args = parser.parse_args() # these are essentially restrictions on what envs/constrain_locales to restrict to for # the tests. if they're empty lists, it means use all available action = None if parsed_args: action = parsed_args[0] if action in ("test", "travis", "tox"): import test coverage = None if test.HAS_UNICODE_LITERAL: try: import coverage except ImportError: pass env = os.environ.copy() env["SH_TESTS_RUNNING"] = "1" if coverage: test.append_module_path(env, coverage) # if we're testing locally, run all versions of python on the system if action == "test": all_versions = ("2.6", "2.7", "3.1", "3.2", "3.3", "3.4", "3.5", "3.6", "3.7", "3.8") # if we're testing on travis or tox, just use the system's default python, since travis will spawn a vm per # python version in our .travis.yml file, and tox will run its matrix via tox.ini else: v = sys.version_info sys_ver = "%d.%d" % (v[0], v[1]) all_versions = (sys_ver,) all_force_select = [True] if HAS_POLL: all_force_select.append(False) all_locales = ("en_US.UTF-8", "C") i = 0 ran_versions = set() for locale in all_locales: # make sure this locale is allowed if options.constrain_locales and locale not in options.constrain_locales: continue for version in all_versions: # make sure this version is allowed if options.envs and version not in options.envs: continue for force_select in all_force_select: env_copy = env.copy() ran_versions.add(version) exit_code = run_tests(env_copy, locale, parsed_args, version, force_select, SH_TEST_RUN_IDX=i) if exit_code is None: print("Couldn't find %s, skipping" % version) elif exit_code != 0: print("Failed for %s, %s" % (version, locale)) exit(1) i += 1 print("Tested Python versions: %s" % ",".join(sorted(list(ran_versions)))) else: env = Environment(globals()) run_repl(env) if __name__ == "__main__": # pragma: no cover # we're being run as a stand-alone script main() else: # we're being imported from somewhere sys.modules[__name__] = SelfWrapper(sys.modules[__name__]) register_importer() sh-1.14.2/test.py000066400000000000000000002543351404764061700135670ustar00rootroot00000000000000# -*- coding: utf8 -*- from contextlib import contextmanager from functools import wraps from os.path import exists, join, realpath, dirname, split import errno import fcntl import inspect import logging import os import platform import pty import resource import sh import signal import stat import sys import tempfile import time import unittest import warnings IS_PY3 = sys.version_info[0] == 3 IS_PY2 = not IS_PY3 MINOR_VER = sys.version_info[1] # coverage doesn't work in python 3.1, 3.2 due to it just being a shit # python HAS_UNICODE_LITERAL = not (IS_PY3 and MINOR_VER in (1, 2)) cov = None if HAS_UNICODE_LITERAL: run_idx = int(os.environ.pop("SH_TEST_RUN_IDX", "0")) first_run = run_idx == 0 try: import coverage except ImportError: pass else: # for some reason, we can't run auto_data on the first run, or the coverage # numbers get really screwed up auto_data = True if first_run: auto_data = False cov = coverage.Coverage(auto_data=auto_data) if first_run: cov.erase() cov.start() try: import unittest.mock except ImportError: HAS_MOCK = False else: HAS_MOCK = True # we have to use the real path because on osx, /tmp is a symlink to # /private/tmp, and so assertions that gettempdir() == sh.pwd() will fail tempdir = realpath(tempfile.gettempdir()) IS_MACOS = platform.system() in ("AIX", "Darwin") # these 3 functions are helpers for modifying PYTHONPATH with a module's main # directory def append_pythonpath(env, path): key = "PYTHONPATH" pypath = [p for p in env.get(key, "").split(":") if p] pypath.insert(0, path) pypath = ":".join(pypath) env[key] = pypath def get_module_import_dir(m): mod_file = inspect.getsourcefile(m) is_package = mod_file.endswith("__init__.py") mod_dir = dirname(mod_file) if is_package: mod_dir, _ = split(mod_dir) return mod_dir def append_module_path(env, m): append_pythonpath(env, get_module_import_dir(m)) if IS_PY3: xrange = range unicode = str long = int from io import StringIO ioStringIO = StringIO from io import BytesIO as cStringIO iocStringIO = cStringIO else: from StringIO import StringIO from cStringIO import StringIO as cStringIO from io import StringIO as ioStringIO from io import BytesIO as iocStringIO THIS_DIR = dirname(os.path.abspath(__file__)) system_python = sh.Command(sys.executable) # this is to ensure that our `python` helper here is able to import our local sh # module, and not the system one baked_env = os.environ.copy() append_module_path(baked_env, sh) python = system_python.bake(_env=baked_env) if hasattr(logging, 'NullHandler'): NullHandler = logging.NullHandler else: class NullHandler(logging.Handler): def handle(self, record): pass def emit(self, record): pass def createLock(self): self.lock = None skipUnless = getattr(unittest, "skipUnless", None) if not skipUnless: # our stupid skipUnless wrapper for python2.6 def skipUnless(condition, reason): def wrapper(test): if condition: return test else: @wraps(test) def skip(*args, **kwargs): return return skip return wrapper skip_unless = skipUnless def requires_progs(*progs): missing = [] for prog in progs: try: sh.Command(prog) except sh.CommandNotFound: missing.append(prog) friendly_missing = ", ".join(missing) return skipUnless(len(missing) == 0, "Missing required system programs: %s" % friendly_missing) requires_posix = skipUnless(os.name == "posix", "Requires POSIX") requires_utf8 = skipUnless(sh.DEFAULT_ENCODING == "UTF-8", "System encoding must be UTF-8") not_macos = skipUnless(not IS_MACOS, "Doesn't work on MacOS") requires_py3 = skipUnless(IS_PY3, "Test only works on Python 3") requires_py35 = skipUnless(IS_PY3 and MINOR_VER >= 5, "Test only works on Python 3.5 or higher") def requires_poller(poller): use_select = bool(int(os.environ.get("SH_TESTS_USE_SELECT", "0"))) cur_poller = "select" if use_select else "poll" return skipUnless(cur_poller == poller, "Only enabled for select.%s" % cur_poller) @contextmanager def ulimit(key, new_soft): soft, hard = resource.getrlimit(key) resource.setrlimit(key, (new_soft, hard)) try: yield finally: resource.setrlimit(key, (soft, hard)) def create_tmp_test(code, prefix="tmp", delete=True, **kwargs): """ creates a temporary test file that lives on disk, on which we can run python with sh """ py = tempfile.NamedTemporaryFile(prefix=prefix, delete=delete) code = code.format(**kwargs) if IS_PY3: code = code.encode("UTF-8") py.write(code) py.flush() # make the file executable st = os.stat(py.name) os.chmod(py.name, st.st_mode | stat.S_IEXEC) # we don't explicitly close, because close will remove the file, and we # don't want that until the test case is done. so we let the gc close it # when it goes out of scope return py class BaseTests(unittest.TestCase): def assert_oserror(self, num, fn, *args, **kwargs): try: fn(*args, **kwargs) except OSError as e: self.assertEqual(e.errno, num) def assert_deprecated(self, fn, *args, **kwargs): with warnings.catch_warnings(record=True) as w: fn(*args, **kwargs) self.assertEqual(len(w), 1) self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) # python2.6 lacks this def assertIn(self, needle, haystack): s = super(BaseTests, self) if hasattr(s, "assertIn"): s.assertIn(needle, haystack) else: self.assertTrue(needle in haystack) # python2.6 lacks this def assertNotIn(self, needle, haystack): s = super(BaseTests, self) if hasattr(s, "assertNotIn"): s.assertNotIn(needle, haystack) else: self.assertTrue(needle not in haystack) # python2.6 lacks this def assertLess(self, a, b): s = super(BaseTests, self) if hasattr(s, "assertLess"): s.assertLess(a, b) else: self.assertTrue(a < b) # python2.6 lacks this def assertGreater(self, a, b): s = super(BaseTests, self) if hasattr(s, "assertGreater"): s.assertGreater(a, b) else: self.assertTrue(a > b) # python2.6 lacks this def skipTest(self, msg): s = super(BaseTests, self) if hasattr(s, "skipTest"): s.skipTest(msg) else: return @requires_posix class FunctionalTests(BaseTests): def setUp(self): self._environ = os.environ.copy() def tearDown(self): os.environ = self._environ def test_print_command(self): from sh import ls, which actual_location = which("ls") out = str(ls) self.assertEqual(out, actual_location) def test_unicode_arg(self): from sh import echo test = "漢字" if not IS_PY3: test = test.decode("utf8") p = echo(test, _encoding="utf8") output = p.strip() self.assertEqual(test, output) def test_unicode_exception(self): from sh import ErrorReturnCode py = create_tmp_test("exit(1)") arg = "漢字" native_arg = arg if not IS_PY3: arg = arg.decode("utf8") try: python(py.name, arg, _encoding="utf8") except ErrorReturnCode as e: self.assertIn(native_arg, str(e)) else: self.fail("exception wasn't raised") def test_pipe_fd(self): py = create_tmp_test("""print("hi world")""") read_fd, write_fd = os.pipe() python(py.name, _out=write_fd) out = os.read(read_fd, 10) self.assertEqual(out, b"hi world\n") def test_trunc_exc(self): py = create_tmp_test(""" import sys sys.stdout.write("a" * 1000) sys.stderr.write("b" * 1000) exit(1) """) self.assertRaises(sh.ErrorReturnCode_1, python, py.name) def test_number_arg(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() options, args = parser.parse_args() print(args[0]) """) out = python(py.name, 3).strip() self.assertEqual(out, "3") def test_empty_stdin_no_hang(self): py = create_tmp_test(""" import sys data = sys.stdin.read() sys.stdout.write("no hang") """) out = python(py.name, _in="", _timeout=2) self.assertEqual(out, "no hang") out = python(py.name, _in=None, _timeout=2) self.assertEqual(out, "no hang") def test_exit_code(self): from sh import ErrorReturnCode_3 py = create_tmp_test(""" exit(3) """) self.assertRaises(ErrorReturnCode_3, python, py.name) def test_patched_glob(self): from glob import glob py = create_tmp_test(""" import sys print(sys.argv[1:]) """) files = glob("*.faowjefoajweofj") out = python(py.name, files).strip() self.assertEqual(out, "['*.faowjefoajweofj']") @requires_py35 def test_patched_glob_with_recursive_argument(self): from glob import glob py = create_tmp_test(""" import sys print(sys.argv[1:]) """) files = glob("*.faowjefoajweofj", recursive=True) out = python(py.name, files).strip() self.assertEqual(out, "['*.faowjefoajweofj']") def test_exit_code_with_hasattr(self): from sh import ErrorReturnCode_3 py = create_tmp_test(""" exit(3) """) try: out = python(py.name, _iter=True) # hasattr can swallow exceptions hasattr(out, 'something_not_there') list(out) self.assertEqual(out.exit_code, 3) self.fail("Command exited with error, but no exception thrown") except ErrorReturnCode_3: pass def test_exit_code_from_exception(self): from sh import ErrorReturnCode_3 py = create_tmp_test(""" exit(3) """) self.assertRaises(ErrorReturnCode_3, python, py.name) try: python(py.name) except Exception as e: self.assertEqual(e.exit_code, 3) def test_stdin_from_string(self): from sh import sed self.assertEqual(sed(_in="one test three", e="s/test/two/").strip(), "one two three") def test_ok_code(self): from sh import ls, ErrorReturnCode_1, ErrorReturnCode_2 exc_to_test = ErrorReturnCode_2 code_to_pass = 2 if IS_MACOS: exc_to_test = ErrorReturnCode_1 code_to_pass = 1 self.assertRaises(exc_to_test, ls, "/aofwje/garogjao4a/eoan3on") ls("/aofwje/garogjao4a/eoan3on", _ok_code=code_to_pass) ls("/aofwje/garogjao4a/eoan3on", _ok_code=[code_to_pass]) ls("/aofwje/garogjao4a/eoan3on", _ok_code=range(code_to_pass + 1)) def test_ok_code_none(self): py = create_tmp_test("exit(0)") python(py.name, _ok_code=None) def test_ok_code_exception(self): from sh import ErrorReturnCode_0 py = create_tmp_test("exit(0)") self.assertRaises(ErrorReturnCode_0, python, py.name, _ok_code=2) def test_none_arg(self): py = create_tmp_test(""" import sys print(sys.argv[1:]) """) maybe_arg = "some" out = python(py.name, maybe_arg).strip() self.assertEqual(out, "['some']") maybe_arg = None out = python(py.name, maybe_arg).strip() self.assertEqual(out, "[]") def test_quote_escaping(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() options, args = parser.parse_args() print(args) """) out = python(py.name, "one two three").strip() self.assertEqual(out, "['one two three']") out = python(py.name, "one \"two three").strip() self.assertEqual(out, "['one \"two three']") out = python(py.name, "one", "two three").strip() self.assertEqual(out, "['one', 'two three']") out = python(py.name, "one", "two \"haha\" three").strip() self.assertEqual(out, "['one', 'two \"haha\" three']") out = python(py.name, "one two's three").strip() self.assertEqual(out, "[\"one two's three\"]") out = python(py.name, 'one two\'s three').strip() self.assertEqual(out, "[\"one two's three\"]") def test_multiple_pipes(self): import time py = create_tmp_test(""" import sys import os import time for l in "andrew": sys.stdout.write(l) time.sleep(.2) """) inc_py = create_tmp_test(""" import sys while True: letter = sys.stdin.read(1) if not letter: break sys.stdout.write(chr(ord(letter)+1)) """) def inc(proc, *args, **kwargs): return python(proc, "-u", inc_py.name, *args, **kwargs) class Derp(object): def __init__(self): self.times = [] self.stdout = [] self.last_received = None def agg(self, line): self.stdout.append(line.strip()) now = time.time() if self.last_received: self.times.append(now - self.last_received) self.last_received = now derp = Derp() p = inc( inc( inc( python("-u", py.name, _piped=True), _piped=True), _piped=True), _out=derp.agg) p.wait() self.assertEqual("".join(derp.stdout), "dqguhz") self.assertTrue(all([t > .15 for t in derp.times])) def test_manual_stdin_string(self): from sh import tr out = tr("[:lower:]", "[:upper:]", _in="andrew").strip() self.assertEqual(out, "ANDREW") def test_manual_stdin_iterable(self): from sh import tr test = ["testing\n", "herp\n", "derp\n"] out = tr("[:lower:]", "[:upper:]", _in=test) match = "".join([t.upper() for t in test]) self.assertEqual(out, match) def test_manual_stdin_file(self): from sh import tr import tempfile test_string = "testing\nherp\nderp\n" stdin = tempfile.NamedTemporaryFile() stdin.write(test_string.encode()) stdin.flush() stdin.seek(0) out = tr("[:lower:]", "[:upper:]", _in=stdin) self.assertEqual(out, test_string.upper()) def test_manual_stdin_queue(self): from sh import tr try: from Queue import Queue except ImportError: from queue import Queue test = ["testing\n", "herp\n", "derp\n"] q = Queue() for t in test: q.put(t) q.put(None) # EOF out = tr("[:lower:]", "[:upper:]", _in=q) match = "".join([t.upper() for t in test]) self.assertEqual(out, match) def test_environment(self): """ tests that environments variables that we pass into sh commands exist in the environment, and on the sh module """ import os # this is the environment we'll pass into our commands env = {"HERP": "DERP"} # first we test that the environment exists in our child process as # we've set it py = create_tmp_test(""" import os for key in list(os.environ.keys()): if key != "HERP": del os.environ[key] print(dict(os.environ)) """) out = python(py.name, _env=env).strip() self.assertEqual(out, "{'HERP': 'DERP'}") py = create_tmp_test(""" import os, sys sys.path.insert(0, os.getcwd()) import sh for key in list(os.environ.keys()): if key != "HERP": del os.environ[key] print(dict(HERP=sh.HERP)) """) out = python(py.name, _env=env, _cwd=THIS_DIR).strip() self.assertEqual(out, "{'HERP': 'DERP'}") # Test that _env also accepts os.environ which is a mpping but not a dict. os.environ["HERP"] = "DERP" out = python(py.name, _env=os.environ, _cwd=THIS_DIR).strip() self.assertEqual(out, "{'HERP': 'DERP'}") def test_which(self): from sh import which, ls self.assertEqual(which("fjoawjefojawe"), None) self.assertEqual(which("ls"), str(ls)) def test_which_paths(self): from sh import which py = create_tmp_test(""" print("hi") """) test_path = dirname(py.name) _, test_name = os.path.split(py.name) found_path = which(test_name) self.assertEqual(found_path, None) found_path = which(test_name, [test_path]) self.assertEqual(found_path, py.name) def test_no_close_fds(self): # guarantee some extra fds in our parent process that don't close on exec. we have to explicitly do this # because at some point (I believe python 3.4), python started being more stringent with closing fds to prevent # security vulnerabilities. python 2.7, for example, doesn't set CLOEXEC on tempfile.TemporaryFile()s # # https://www.python.org/dev/peps/pep-0446/ tmp = [tempfile.TemporaryFile() for i in range(10)] for t in tmp: flags = fcntl.fcntl(t.fileno(), fcntl.F_GETFD) flags &= ~fcntl.FD_CLOEXEC fcntl.fcntl(t.fileno(), fcntl.F_SETFD, flags) py = create_tmp_test(""" import os print(len(os.listdir("/dev/fd"))) """) out = python(py.name, _close_fds=False).strip() # pick some number greater than 4, since it's hard to know exactly how many fds will be open/inherted in the # child self.assertGreater(int(out), 7) for t in tmp: t.close() def test_close_fds(self): # guarantee some extra fds in our parent process that don't close on exec. we have to explicitly do this # because at some point (I believe python 3.4), python started being more stringent with closing fds to prevent # security vulnerabilities. python 2.7, for example, doesn't set CLOEXEC on tempfile.TemporaryFile()s # # https://www.python.org/dev/peps/pep-0446/ tmp = [tempfile.TemporaryFile() for i in range(10)] for t in tmp: flags = fcntl.fcntl(t.fileno(), fcntl.F_GETFD) flags &= ~fcntl.FD_CLOEXEC fcntl.fcntl(t.fileno(), fcntl.F_SETFD, flags) py = create_tmp_test(""" import os print(os.listdir("/dev/fd")) """) out = python(py.name).strip() self.assertEqual(out, "['0', '1', '2', '3']") for t in tmp: t.close() def test_pass_fds(self): # guarantee some extra fds in our parent process that don't close on exec. we have to explicitly do this # because at some point (I believe python 3.4), python started being more stringent with closing fds to prevent # security vulnerabilities. python 2.7, for example, doesn't set CLOEXEC on tempfile.TemporaryFile()s # # https://www.python.org/dev/peps/pep-0446/ tmp = [tempfile.TemporaryFile() for i in range(10)] for t in tmp: flags = fcntl.fcntl(t.fileno(), fcntl.F_GETFD) flags &= ~fcntl.FD_CLOEXEC fcntl.fcntl(t.fileno(), fcntl.F_SETFD, flags) last_fd = tmp[-1].fileno() py = create_tmp_test(""" import os print(os.listdir("/dev/fd")) """) out = python(py.name, _pass_fds=[last_fd]).strip() inherited = [0, 1, 2, 3, last_fd] inherited_str = [str(i) for i in inherited] self.assertEqual(out, str(inherited_str)) for t in tmp: t.close() def test_no_arg(self): import pwd from sh import whoami u1 = whoami().strip() u2 = pwd.getpwuid(os.geteuid())[0] self.assertEqual(u1, u2) def test_incompatible_special_args(self): from sh import ls self.assertRaises(TypeError, ls, _iter=True, _piped=True) def test_invalid_env(self): from sh import ls exc = TypeError if IS_PY2 and MINOR_VER == 6: exc = ValueError self.assertRaises(exc, ls, _env="XXX") self.assertRaises(exc, ls, _env={"foo": 123}) self.assertRaises(exc, ls, _env={123: "bar"}) def test_exception(self): from sh import ErrorReturnCode_2 py = create_tmp_test(""" exit(2) """) self.assertRaises(ErrorReturnCode_2, python, py.name) def test_piped_exception1(self): from sh import ErrorReturnCode_2 py = create_tmp_test(""" import sys sys.stdout.write("line1\\n") sys.stdout.write("line2\\n") exit(2) """) py2 = create_tmp_test("") def fn(): list(python(python(py.name, _piped=True), "-u", py2.name, _iter=True)) self.assertRaises(ErrorReturnCode_2, fn) def test_piped_exception2(self): from sh import ErrorReturnCode_2 py = create_tmp_test(""" import sys sys.stdout.write("line1\\n") sys.stdout.write("line2\\n") exit(2) """) py2 = create_tmp_test("") def fn(): python(python(py.name, _piped=True), "-u", py2.name) self.assertRaises(ErrorReturnCode_2, fn) def test_command_not_found(self): from sh import CommandNotFound def do_import(): from sh import aowjgoawjoeijaowjellll # noqa: F401 self.assertRaises(ImportError, do_import) def do_import(): import sh sh.awoefaowejfw self.assertRaises(CommandNotFound, do_import) def do_import(): import sh sh.Command("ofajweofjawoe") self.assertRaises(CommandNotFound, do_import) def test_command_wrapper_equivalence(self): from sh import Command, ls, which self.assertEqual(Command(which("ls")), ls) def test_doesnt_execute_directories(self): save_path = os.environ['PATH'] bin_dir1 = tempfile.mkdtemp() bin_dir2 = tempfile.mkdtemp() gcc_dir1 = os.path.join(bin_dir1, 'gcc') gcc_file2 = os.path.join(bin_dir2, 'gcc') try: os.environ['PATH'] = os.pathsep.join((bin_dir1, bin_dir2)) # a folder named 'gcc', its executable, but should not be # discovered by internal which(1)-clone os.makedirs(gcc_dir1) # an executable named gcc -- only this should be executed bunk_header = '#!/bin/sh\necho $*' with open(gcc_file2, "w") as h: h.write(bunk_header) os.chmod(gcc_file2, int(0o755)) import sh from sh import gcc if IS_PY3: self.assertEqual(gcc._path, gcc_file2.encode(sh.DEFAULT_ENCODING)) else: self.assertEqual(gcc._path, gcc_file2) self.assertEqual(gcc('no-error').stdout.strip(), 'no-error'.encode("ascii")) finally: os.environ['PATH'] = save_path if exists(gcc_file2): os.unlink(gcc_file2) if exists(gcc_dir1): os.rmdir(gcc_dir1) if exists(bin_dir1): os.rmdir(bin_dir1) if exists(bin_dir1): os.rmdir(bin_dir2) def test_multiple_args_short_option(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("-l", dest="long_option") options, args = parser.parse_args() print(len(options.long_option.split())) """) num_args = int(python(py.name, l="one two three")) # noqa: E741 self.assertEqual(num_args, 3) num_args = int(python(py.name, "-l", "one's two's three's")) self.assertEqual(num_args, 3) def test_multiple_args_long_option(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("-l", "--long-option", dest="long_option") options, args = parser.parse_args() print(len(options.long_option.split())) """) num_args = int(python(py.name, long_option="one two three", nothing=False)) self.assertEqual(num_args, 3) num_args = int(python(py.name, "--long-option", "one's two's three's")) self.assertEqual(num_args, 3) def test_short_bool_option(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("-s", action="store_true", default=False, dest="short_option") options, args = parser.parse_args() print(options.short_option) """) self.assertTrue(python(py.name, s=True).strip() == "True") self.assertTrue(python(py.name, s=False).strip() == "False") self.assertTrue(python(py.name).strip() == "False") def test_long_bool_option(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("-l", "--long-option", action="store_true", default=False, dest="long_option") options, args = parser.parse_args() print(options.long_option) """) self.assertTrue(python(py.name, long_option=True).strip() == "True") self.assertTrue(python(py.name).strip() == "False") def test_false_bool_ignore(self): py = create_tmp_test(""" import sys print(sys.argv[1:]) """) test = True self.assertEqual(python(py.name, test and "-n").strip(), "['-n']") test = False self.assertEqual(python(py.name, test and "-n").strip(), "[]") def test_composition(self): from sh import ls, wc c1 = int(wc(ls("-A1"), l=True)) # noqa: E741 c2 = len(os.listdir(".")) self.assertEqual(c1, c2) def test_incremental_composition(self): from sh import ls, wc c1 = int(wc(ls("-A1", _piped=True), l=True).strip()) # noqa: E741 c2 = len(os.listdir(".")) self.assertEqual(c1, c2) def test_short_option(self): from sh import sh s1 = sh(c="echo test").strip() s2 = "test" self.assertEqual(s1, s2) def test_long_option(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("-l", "--long-option", action="store", default="", dest="long_option") options, args = parser.parse_args() print(options.long_option.upper()) """) self.assertTrue(python(py.name, long_option="testing").strip() == "TESTING") self.assertTrue(python(py.name).strip() == "") def test_raw_args(self): py = create_tmp_test(""" from optparse import OptionParser parser = OptionParser() parser.add_option("--long_option", action="store", default=None, dest="long_option1") parser.add_option("--long-option", action="store", default=None, dest="long_option2") options, args = parser.parse_args() if options.long_option1: print(options.long_option1.upper()) else: print(options.long_option2.upper()) """) self.assertEqual(python(py.name, {"long_option": "underscore"}).strip(), "UNDERSCORE") self.assertEqual(python(py.name, long_option="hyphen").strip(), "HYPHEN") def test_custom_separator(self): py = create_tmp_test(""" import sys print(sys.argv[1]) """) opt = {"long-option": "underscore"} correct = "--long-option=custom=underscore" out = python(py.name, opt, _long_sep="=custom=").strip() self.assertEqual(out, correct) # test baking too correct = "--long-option=baked=underscore" python_baked = python.bake(py.name, opt, _long_sep="=baked=") out = python_baked().strip() self.assertEqual(out, correct) def test_custom_separator_space(self): py = create_tmp_test(""" import sys print(str(sys.argv[1:])) """) opt = {"long-option": "space"} correct = ["--long-option", "space"] out = python(py.name, opt, _long_sep=" ").strip() self.assertEqual(out, str(correct)) def test_custom_long_prefix(self): py = create_tmp_test(""" import sys print(sys.argv[1]) """) out = python(py.name, {"long-option": "underscore"}, _long_prefix="-custom-").strip() self.assertEqual(out, "-custom-long-option=underscore") out = python(py.name, {"long-option": True}, _long_prefix="-custom-").strip() self.assertEqual(out, "-custom-long-option") # test baking too out = python.bake(py.name, {"long-option": "underscore"}, _long_prefix="-baked-")().strip() self.assertEqual(out, "-baked-long-option=underscore") out = python.bake(py.name, {"long-option": True}, _long_prefix="-baked-")().strip() self.assertEqual(out, "-baked-long-option") def test_command_wrapper(self): from sh import Command, which ls = Command(which("ls")) wc = Command(which("wc")) c1 = int(wc(ls("-A1"), l=True)) # noqa: E741 c2 = len(os.listdir(".")) self.assertEqual(c1, c2) def test_background(self): from sh import sleep import time start = time.time() sleep_time = .5 p = sleep(sleep_time, _bg=True) now = time.time() self.assertLess(now - start, sleep_time) p.wait() now = time.time() self.assertGreater(now - start, sleep_time) def test_background_exception(self): from sh import ls, ErrorReturnCode_1, ErrorReturnCode_2 p = ls("/ofawjeofj", _bg=True, _bg_exc=False) # should not raise exc_to_test = ErrorReturnCode_2 if IS_MACOS: exc_to_test = ErrorReturnCode_1 self.assertRaises(exc_to_test, p.wait) # should raise def test_with_context(self): from sh import whoami import getpass py = create_tmp_test(""" import sys import os import subprocess print("with_context") subprocess.Popen(sys.argv[1:], shell=False).wait() """) cmd1 = python.bake(py.name, _with=True) with cmd1: out = whoami() self.assertIn("with_context", out) self.assertIn(getpass.getuser(), out) def test_with_context_args(self): from sh import whoami import getpass py = create_tmp_test(""" import sys import os import subprocess from optparse import OptionParser parser = OptionParser() parser.add_option("-o", "--opt", action="store_true", default=False, dest="opt") options, args = parser.parse_args() if options.opt: subprocess.Popen(args[0], shell=False).wait() """) with python(py.name, opt=True, _with=True): out = whoami() self.assertTrue(getpass.getuser() == out.strip()) with python(py.name, _with=True): out = whoami() self.assertTrue(out == "") def test_binary_input(self): py = create_tmp_test(""" import sys data = sys.stdin.read() sys.stdout.write(data) """) data = b'1234' out = python(py.name, _in=data) self.assertEqual(out, "1234") def test_err_to_out(self): py = create_tmp_test(""" import sys import os sys.stdout.write("stdout") sys.stdout.flush() sys.stderr.write("stderr") sys.stderr.flush() """) stdout = python(py.name, _err_to_out=True) self.assertEqual(stdout, "stdoutstderr") def test_err_to_out_and_sys_stdout(self): py = create_tmp_test(""" import sys import os sys.stdout.write("stdout") sys.stdout.flush() sys.stderr.write("stderr") sys.stderr.flush() """) master, slave = os.pipe() stdout = python(py.name, _err_to_out=True, _out=slave) self.assertEqual(stdout, "") self.assertEqual(os.read(master, 12), b"stdoutstderr") def test_err_piped(self): py = create_tmp_test(""" import sys sys.stderr.write("stderr") """) py2 = create_tmp_test(""" import sys while True: line = sys.stdin.read() if not line: break sys.stdout.write(line) """) out = python(python("-u", py.name, _piped="err"), "-u", py2.name) self.assertEqual(out, "stderr") def test_out_redirection(self): import tempfile py = create_tmp_test(""" import sys import os sys.stdout.write("stdout") sys.stderr.write("stderr") """) file_obj = tempfile.NamedTemporaryFile() out = python(py.name, _out=file_obj) self.assertEqual(len(out), 0) file_obj.seek(0) actual_out = file_obj.read() file_obj.close() self.assertNotEqual(len(actual_out), 0) # test with tee file_obj = tempfile.NamedTemporaryFile() out = python(py.name, _out=file_obj, _tee=True) self.assertGreater(len(out), 0) file_obj.seek(0) actual_out = file_obj.read() file_obj.close() self.assertGreater(len(actual_out), 0) def test_err_redirection(self): import tempfile py = create_tmp_test(""" import sys import os sys.stdout.write("stdout") sys.stderr.write("stderr") """) file_obj = tempfile.NamedTemporaryFile() p = python("-u", py.name, _err=file_obj) file_obj.seek(0) stderr = file_obj.read().decode() file_obj.close() self.assertEqual(p.stdout, b"stdout") self.assertEqual(stderr, "stderr") self.assertEqual(len(p.stderr), 0) # now with tee file_obj = tempfile.NamedTemporaryFile() p = python(py.name, _err=file_obj, _tee="err") file_obj.seek(0) stderr = file_obj.read().decode() file_obj.close() self.assertEqual(p.stdout, b"stdout") self.assertEqual(stderr, "stderr") self.assertGreater(len(p.stderr), 0) def test_tty_tee(self): py = create_tmp_test(""" import sys sys.stdout.write("stdout") """) read, write = pty.openpty() out = python("-u", py.name, _out=write).stdout tee = os.read(read, 6) self.assertEqual(out, b"") self.assertEqual(tee, b"stdout") os.close(write) os.close(read) read, write = pty.openpty() out = python("-u", py.name, _out=write, _tee=True).stdout tee = os.read(read, 6) self.assertEqual(out, b"stdout") self.assertEqual(tee, b"stdout") os.close(write) os.close(read) def test_err_redirection_actual_file(self): import tempfile file_obj = tempfile.NamedTemporaryFile() py = create_tmp_test(""" import sys import os sys.stdout.write("stdout") sys.stderr.write("stderr") """) stdout = python("-u", py.name, _err=file_obj.name).wait() file_obj.seek(0) stderr = file_obj.read().decode() file_obj.close() self.assertTrue(stdout == "stdout") self.assertTrue(stderr == "stderr") def test_subcommand_and_bake(self): import getpass py = create_tmp_test(""" import sys import os import subprocess print("subcommand") subprocess.Popen(sys.argv[1:], shell=False).wait() """) cmd1 = python.bake(py.name) out = cmd1.whoami() self.assertIn("subcommand", out) self.assertIn(getpass.getuser(), out) def test_multiple_bakes(self): py = create_tmp_test(""" import sys sys.stdout.write(str(sys.argv[1:])) """) out = python.bake(py.name).bake("bake1").bake("bake2")() self.assertEqual("['bake1', 'bake2']", out) def test_arg_preprocessor(self): py = create_tmp_test(""" import sys sys.stdout.write(str(sys.argv[1:])) """) def arg_preprocess(args, kwargs): args.insert(0, "preprocessed") kwargs["a-kwarg"] = 123 return args, kwargs cmd = python.bake(py.name, _arg_preprocess=arg_preprocess) out = cmd("arg") self.assertEqual("['preprocessed', 'arg', '--a-kwarg=123']", out) def test_bake_args_come_first(self): from sh import ls ls = ls.bake(h=True) ran = ls("-la").ran ft = ran.index("-h") self.assertIn("-la", ran[ft:]) def test_output_equivalence(self): from sh import whoami iam1 = whoami() iam2 = whoami() self.assertEqual(iam1, iam2) # https://github.com/amoffat/sh/pull/252 def test_stdout_pipe(self): py = create_tmp_test(r""" import sys sys.stdout.write("foobar\n") """) read_fd, write_fd = os.pipe() python(py.name, _out=write_fd, u=True) def alarm(sig, action): self.fail("Timeout while reading from pipe") import signal signal.signal(signal.SIGALRM, alarm) signal.alarm(3) data = os.read(read_fd, 100) self.assertEqual(b"foobar\n", data) signal.alarm(0) signal.signal(signal.SIGALRM, signal.SIG_DFL) def test_stdout_callback(self): py = create_tmp_test(""" import sys import os for i in range(5): print(i) """) stdout = [] def agg(line): stdout.append(line) p = python("-u", py.name, _out=agg) p.wait() self.assertEqual(len(stdout), 5) def test_stdout_callback_no_wait(self): import time py = create_tmp_test(""" import sys import os import time for i in range(5): print(i) time.sleep(.5) """) stdout = [] def agg(line): stdout.append(line) python("-u", py.name, _out=agg, _bg=True) # we give a little pause to make sure that the NamedTemporaryFile # exists when the python process actually starts time.sleep(.5) self.assertNotEqual(len(stdout), 5) def test_stdout_callback_line_buffered(self): py = create_tmp_test(""" import sys import os for i in range(5): print("herpderp") """) stdout = [] def agg(line): stdout.append(line) p = python("-u", py.name, _out=agg, _out_bufsize=1) p.wait() self.assertEqual(len(stdout), 5) def test_stdout_callback_line_unbuffered(self): py = create_tmp_test(""" import sys import os for i in range(5): print("herpderp") """) stdout = [] def agg(char): stdout.append(char) p = python("-u", py.name, _out=agg, _out_bufsize=0) p.wait() # + 5 newlines self.assertEqual(len(stdout), len("herpderp") * 5 + 5) def test_stdout_callback_buffered(self): py = create_tmp_test(""" import sys import os for i in range(5): sys.stdout.write("herpderp") """) stdout = [] def agg(chunk): stdout.append(chunk) p = python("-u", py.name, _out=agg, _out_bufsize=4) p.wait() self.assertEqual(len(stdout), len("herp") / 2 * 5) def test_stdout_callback_with_input(self): py = create_tmp_test(""" import sys import os IS_PY3 = sys.version_info[0] == 3 if IS_PY3: raw_input = input for i in range(5): print(str(i)) derp = raw_input("herp? ") print(derp) """) def agg(line, stdin): if line.strip() == "4": stdin.put("derp\n") p = python("-u", py.name, _out=agg, _tee=True) p.wait() self.assertIn("derp", p) def test_stdout_callback_exit(self): py = create_tmp_test(""" import sys import os for i in range(5): print(i) """) stdout = [] def agg(line): line = line.strip() stdout.append(line) if line == "2": return True p = python("-u", py.name, _out=agg, _tee=True) p.wait() self.assertIn("4", p) self.assertNotIn("4", stdout) def test_stdout_callback_terminate(self): import signal py = create_tmp_test(""" import sys import os import time for i in range(5): print(i) time.sleep(.5) """) stdout = [] def agg(line, stdin, process): line = line.strip() stdout.append(line) if line == "3": process.terminate() return True import sh caught_signal = False try: p = python("-u", py.name, _out=agg, _bg=True) p.wait() except sh.SignalException_SIGTERM: caught_signal = True self.assertTrue(caught_signal) self.assertEqual(p.process.exit_code, -signal.SIGTERM) self.assertNotIn("4", p) self.assertNotIn("4", stdout) def test_stdout_callback_kill(self): import signal py = create_tmp_test(""" import sys import os import time for i in range(5): print(i) time.sleep(.5) """) stdout = [] def agg(line, stdin, process): line = line.strip() stdout.append(line) if line == "3": process.kill() return True import sh caught_signal = False try: p = python("-u", py.name, _out=agg, _bg=True) p.wait() except sh.SignalException_SIGKILL: caught_signal = True self.assertTrue(caught_signal) self.assertEqual(p.process.exit_code, -signal.SIGKILL) self.assertNotIn("4", p) self.assertNotIn("4", stdout) def test_general_signal(self): from signal import SIGINT py = create_tmp_test(""" import sys import os import time import signal def sig_handler(sig, frame): print(10) exit(0) signal.signal(signal.SIGINT, sig_handler) for i in range(5): print(i) sys.stdout.flush() time.sleep(0.5) """) stdout = [] def agg(line, stdin, process): line = line.strip() stdout.append(line) if line == "3": process.signal(SIGINT) return True p = python(py.name, _out=agg, _tee=True) p.wait() self.assertEqual(p.process.exit_code, 0) self.assertEqual(p, "0\n1\n2\n3\n10\n") def test_iter_generator(self): py = create_tmp_test(""" import sys import os import time for i in range(42): print(i) sys.stdout.flush() """) out = [] for line in python(py.name, _iter=True): out.append(int(line.strip())) self.assertEqual(len(out), 42) self.assertEqual(sum(out), 861) def test_iter_unicode(self): # issue https://github.com/amoffat/sh/issues/224 test_string = "\xe4\xbd\x95\xe4\xbd\x95\n" * 150 # len > buffer_s txt = create_tmp_test(test_string) for line in sh.cat(txt.name, _iter=True): break self.assertLess(len(line), 1024) def test_nonblocking_iter(self): from errno import EWOULDBLOCK py = create_tmp_test(""" import time import sys time.sleep(1) sys.stdout.write("stdout") """) count = 0 value = None for line in python(py.name, _iter_noblock=True): if line == EWOULDBLOCK: count += 1 else: value = line self.assertGreater(count, 0) self.assertEqual(value, "stdout") py = create_tmp_test(""" import time import sys time.sleep(1) sys.stderr.write("stderr") """) count = 0 value = None for line in python(py.name, _iter_noblock="err"): if line == EWOULDBLOCK: count += 1 else: value = line self.assertGreater(count, 0) self.assertEqual(value, "stderr") def test_for_generator_to_err(self): py = create_tmp_test(""" import sys import os for i in range(42): sys.stderr.write(str(i)+"\\n") """) out = [] for line in python("-u", py.name, _iter="err"): out.append(line) self.assertEqual(len(out), 42) # verify that nothing is going to stdout out = [] for line in python("-u", py.name, _iter="out"): out.append(line) self.assertEqual(len(out), 0) def test_sigpipe(self): py1 = create_tmp_test(""" import sys import os import time import signal # by default, python disables SIGPIPE, in favor of using IOError exceptions, so # let's put that back to the system default where we terminate with a signal # exit code signal.signal(signal.SIGPIPE, signal.SIG_DFL) for letter in "andrew": time.sleep(0.6) print(letter) """) py2 = create_tmp_test(""" import sys import os import time while True: line = sys.stdin.readline() if not line: break print(line.strip().upper()) exit(0) """) p1 = python("-u", py1.name, _piped="out") p2 = python(p1, "-u", py2.name) # SIGPIPE should happen, but it shouldn't be an error, since _piped is # truthful self.assertEqual(-p1.exit_code, signal.SIGPIPE) self.assertEqual(p2.exit_code, 0) def test_piped_generator(self): import time py1 = create_tmp_test(""" import sys import os import time for letter in "andrew": time.sleep(0.6) print(letter) """) py2 = create_tmp_test(""" import sys import os import time while True: line = sys.stdin.readline() if not line: break print(line.strip().upper()) """) times = [] last_received = None letters = "" for line in python(python("-u", py1.name, _piped="out"), "-u", py2.name, _iter=True): letters += line.strip() now = time.time() if last_received: times.append(now - last_received) last_received = now self.assertEqual("ANDREW", letters) self.assertTrue(all([t > .3 for t in times])) def test_generator_and_callback(self): py = create_tmp_test(""" import sys import os for i in range(42): sys.stderr.write(str(i * 2)+"\\n") print(i) """) stderr = [] def agg(line): stderr.append(int(line.strip())) out = [] for line in python("-u", py.name, _iter=True, _err=agg): out.append(line) self.assertEqual(len(out), 42) self.assertEqual(sum(stderr), 1722) def test_cast_bg(self): py = create_tmp_test(""" import sys import time time.sleep(0.5) sys.stdout.write(sys.argv[1]) """) self.assertEqual(int(python(py.name, "123", _bg=True)), 123) self.assertEqual(long(python(py.name, "456", _bg=True)), 456) self.assertEqual(float(python(py.name, "789", _bg=True)), 789.0) def test_cmd_eq(self): py = create_tmp_test("") cmd1 = python.bake(py.name, "-u") cmd2 = python.bake(py.name, "-u") cmd3 = python.bake(py.name) self.assertEqual(cmd1, cmd2) self.assertNotEqual(cmd1, cmd3) def test_fg(self): py = create_tmp_test("exit(0)") # notice we're using `system_python`, and not `python`. this is because # `python` has an env baked into it, and we want `_env` to be None for # coverage system_python(py.name, _fg=True) def test_fg_false(self): """ https://github.com/amoffat/sh/issues/520 """ py = create_tmp_test("print('hello')") buf = StringIO() python(py.name, _fg=False, _out=buf) self.assertEqual(buf.getvalue(), "hello\n") def test_fg_true(self): """ https://github.com/amoffat/sh/issues/520 """ py = create_tmp_test("print('hello')") buf = StringIO() self.assertRaises(TypeError, python, py.name, _fg=True, _out=buf) def test_fg_env(self): py = create_tmp_test(""" import os code = int(os.environ.get("EXIT", "0")) exit(code) """) env = os.environ.copy() env["EXIT"] = "3" self.assertRaises(sh.ErrorReturnCode_3, python, py.name, _fg=True, _env=env) def test_fg_alternative(self): py = create_tmp_test("exit(0)") python(py.name, _in=sys.stdin, _out=sys.stdout, _err=sys.stderr) def test_fg_exc(self): py = create_tmp_test("exit(1)") self.assertRaises(sh.ErrorReturnCode_1, python, py.name, _fg=True) def test_out_filename(self): outfile = tempfile.NamedTemporaryFile() py = create_tmp_test("print('output')") python(py.name, _out=outfile.name) outfile.seek(0) self.assertEqual(b"output\n", outfile.read()) def test_bg_exit_code(self): py = create_tmp_test(""" import time time.sleep(1) exit(49) """) p = python(py.name, _ok_code=49, _bg=True) self.assertEqual(49, p.exit_code) def test_cwd(self): from sh import pwd from os.path import realpath self.assertEqual(str(pwd(_cwd="/tmp")), realpath("/tmp") + "\n") self.assertEqual(str(pwd(_cwd="/etc")), realpath("/etc") + "\n") def test_cwd_fg(self): td = realpath(tempfile.mkdtemp()) py = create_tmp_test(""" import sh import os from os.path import realpath orig = realpath(os.getcwd()) print(orig) sh.pwd(_cwd="{newdir}", _fg=True) print(realpath(os.getcwd())) """.format(newdir=td)) orig, newdir, restored = python(py.name).strip().split("\n") newdir = realpath(newdir) self.assertEqual(newdir, td) self.assertEqual(orig, restored) self.assertNotEqual(orig, newdir) os.rmdir(td) def test_huge_piped_data(self): from sh import tr stdin = tempfile.NamedTemporaryFile() data = "herpderp" * 4000 + "\n" stdin.write(data.encode()) stdin.flush() stdin.seek(0) out = tr(tr("[:lower:]", "[:upper:]", _in=data), "[:upper:]", "[:lower:]") self.assertTrue(out == data) def test_tty_input(self): py = create_tmp_test(""" import sys import os if os.isatty(sys.stdin.fileno()): sys.stdout.write("password?\\n") sys.stdout.flush() pw = sys.stdin.readline().strip() sys.stdout.write("%s\\n" % ("*" * len(pw))) sys.stdout.flush() else: sys.stdout.write("no tty attached!\\n") sys.stdout.flush() """) test_pw = "test123" expected_stars = "*" * len(test_pw) d = {} def password_enterer(line, stdin): line = line.strip() if not line: return if line == "password?": stdin.put(test_pw + "\n") elif line.startswith("*"): d["stars"] = line return True pw_stars = python(py.name, _tty_in=True, _out=password_enterer) pw_stars.wait() self.assertEqual(d["stars"], expected_stars) response = python(py.name) self.assertEqual(response, "no tty attached!\n") def test_tty_output(self): py = create_tmp_test(""" import sys import os if os.isatty(sys.stdout.fileno()): sys.stdout.write("tty attached") sys.stdout.flush() else: sys.stdout.write("no tty attached") sys.stdout.flush() """) out = python(py.name, _tty_out=True) self.assertEqual(out, "tty attached") out = python(py.name, _tty_out=False) self.assertEqual(out, "no tty attached") def test_stringio_output(self): from sh import echo out = StringIO() echo("-n", "testing 123", _out=out) self.assertEqual(out.getvalue(), "testing 123") out = cStringIO() echo("-n", "testing 123", _out=out) self.assertEqual(out.getvalue().decode(), "testing 123") out = ioStringIO() echo("-n", "testing 123", _out=out) self.assertEqual(out.getvalue(), "testing 123") out = iocStringIO() echo("-n", "testing 123", _out=out) self.assertEqual(out.getvalue().decode(), "testing 123") def test_stringio_input(self): from sh import cat input = StringIO() input.write("herpderp") input.seek(0) out = cat(_in=input) self.assertEqual(out, "herpderp") def test_internal_bufsize(self): from sh import cat output = cat(_in="a" * 1000, _internal_bufsize=100, _out_bufsize=0) self.assertEqual(len(output), 100) output = cat(_in="a" * 1000, _internal_bufsize=50, _out_bufsize=2) self.assertEqual(len(output), 100) def test_change_stdout_buffering(self): py = create_tmp_test(""" import sys import os # this proves that we won't get the output into our callback until we send # a newline sys.stdout.write("switch ") sys.stdout.flush() sys.stdout.write("buffering\\n") sys.stdout.flush() sys.stdin.read(1) sys.stdout.write("unbuffered") sys.stdout.flush() # this is to keep the output from being flushed by the process ending, which # would ruin our test. we want to make sure we get the string "unbuffered" # before the process ends, without writing a newline sys.stdin.read(1) """) d = { "newline_buffer_success": False, "unbuffered_success": False, } def interact(line, stdin, process): line = line.strip() if not line: return if line == "switch buffering": d["newline_buffer_success"] = True process.change_out_bufsize(0) stdin.put("a") elif line == "unbuffered": stdin.put("b") d["unbuffered_success"] = True return True # start with line buffered stdout pw_stars = python("-u", py.name, _out=interact, _out_bufsize=1) pw_stars.wait() self.assertTrue(d["newline_buffer_success"]) self.assertTrue(d["unbuffered_success"]) def test_callable_interact(self): py = create_tmp_test(""" import sys sys.stdout.write("line1") """) class Callable(object): def __init__(self): self.line = None def __call__(self, line): self.line = line cb = Callable() python(py.name, _out=cb) self.assertEqual(cb.line, "line1") def test_encoding(self): return self.skipTest("what's the best way to test a different '_encoding' special keyword argument?") def test_timeout(self): import sh from time import time sleep_for = 3 timeout = 1 started = time() try: sh.sleep(sleep_for, _timeout=timeout).wait() except sh.TimeoutException as e: assert 'sleep 3' in e.full_cmd else: self.fail("no timeout exception") elapsed = time() - started self.assertLess(abs(elapsed - timeout), 0.5) def test_timeout_overstep(self): started = time.time() sh.sleep(1, _timeout=5) elapsed = time.time() - started self.assertLess(abs(elapsed - 1), 0.5) def test_timeout_wait(self): p = sh.sleep(3, _bg=True) self.assertRaises(sh.TimeoutException, p.wait, timeout=1) def test_timeout_wait_overstep(self): p = sh.sleep(1, _bg=True) p.wait(timeout=5) def test_timeout_wait_negative(self): p = sh.sleep(3, _bg=True) self.assertRaises(RuntimeError, p.wait, timeout=-3) def test_binary_pipe(self): binary = b'\xec;\xedr\xdbF' py1 = create_tmp_test(""" import sys import os sys.stdout = os.fdopen(sys.stdout.fileno(), "wb", 0) sys.stdout.write(b'\\xec;\\xedr\\xdbF') """) py2 = create_tmp_test(""" import sys import os sys.stdin = os.fdopen(sys.stdin.fileno(), "rb", 0) sys.stdout = os.fdopen(sys.stdout.fileno(), "wb", 0) sys.stdout.write(sys.stdin.read()) """) out = python(python(py1.name), py2.name) self.assertEqual(out.stdout, binary) # designed to trigger the "... (%d more, please see e.stdout)" output # of the ErrorReturnCode class def test_failure_with_large_output(self): from sh import ErrorReturnCode_1 py = create_tmp_test(""" print("andrewmoffat" * 1000) exit(1) """) self.assertRaises(ErrorReturnCode_1, python, py.name) # designed to check if the ErrorReturnCode constructor does not raise # an UnicodeDecodeError def test_non_ascii_error(self): from sh import ls, ErrorReturnCode test = "/á" # coerce to unicode if IS_PY3: pass else: test = test.decode("utf8") self.assertRaises(ErrorReturnCode, ls, test) def test_no_out(self): py = create_tmp_test(""" import sys sys.stdout.write("stdout") sys.stderr.write("stderr") """) p = python(py.name, _no_out=True) self.assertEqual(p.stdout, b"") self.assertEqual(p.stderr, b"stderr") self.assertTrue(p.process._pipe_queue.empty()) def callback(line): pass p = python(py.name, _out=callback) self.assertEqual(p.stdout, b"") self.assertEqual(p.stderr, b"stderr") self.assertTrue(p.process._pipe_queue.empty()) p = python(py.name) self.assertEqual(p.stdout, b"stdout") self.assertEqual(p.stderr, b"stderr") self.assertFalse(p.process._pipe_queue.empty()) def test_tty_stdin(self): py = create_tmp_test(""" import sys sys.stdout.write(sys.stdin.read()) sys.stdout.flush() """) out = python(py.name, _in="test\n", _tty_in=True) self.assertEqual("test\n", out) def test_no_err(self): py = create_tmp_test(""" import sys sys.stdout.write("stdout") sys.stderr.write("stderr") """) p = python(py.name, _no_err=True) self.assertEqual(p.stderr, b"") self.assertEqual(p.stdout, b"stdout") self.assertFalse(p.process._pipe_queue.empty()) def callback(line): pass p = python(py.name, _err=callback) self.assertEqual(p.stderr, b"") self.assertEqual(p.stdout, b"stdout") self.assertFalse(p.process._pipe_queue.empty()) p = python(py.name) self.assertEqual(p.stderr, b"stderr") self.assertEqual(p.stdout, b"stdout") self.assertFalse(p.process._pipe_queue.empty()) def test_no_pipe(self): from sh import ls # calling a command regular should fill up the pipe_queue p = ls() self.assertFalse(p.process._pipe_queue.empty()) # calling a command with a callback should not def callback(line): pass p = ls(_out=callback) self.assertTrue(p.process._pipe_queue.empty()) # calling a command regular with no_pipe also should not p = ls(_no_pipe=True) self.assertTrue(p.process._pipe_queue.empty()) def test_decode_error_handling(self): from functools import partial py = create_tmp_test(""" # -*- coding: utf8 -*- import sys import os sys.stdout = os.fdopen(sys.stdout.fileno(), 'wb') IS_PY3 = sys.version_info[0] == 3 if IS_PY3: sys.stdout.write(bytes("te漢字st", "utf8")) else: sys.stdout.write("te漢字st") """) fn = partial(python, py.name, _encoding="ascii") def s(fn): str(fn()) self.assertRaises(UnicodeDecodeError, s, fn) p = python(py.name, _encoding="ascii", _decode_errors="ignore") self.assertEqual(p, "test") def test_signal_exception(self): from sh import SignalException_15 def throw_terminate_signal(): py = create_tmp_test(""" import time while True: time.sleep(1) """) to_kill = python(py.name, _bg=True) to_kill.terminate() to_kill.wait() self.assertRaises(SignalException_15, throw_terminate_signal) def test_signal_group(self): child = create_tmp_test(""" import time time.sleep(3) """) parent = create_tmp_test(""" import sys import sh python = sh.Command(sys.executable) p = python("{child_file}", _bg=True, _new_session=False) print(p.pid) print(p.process.pgid) p.wait() """, child_file=child.name) def launch(): p = python(parent.name, _bg=True, _iter=True) child_pid = int(next(p).strip()) child_pgid = int(next(p).strip()) parent_pid = p.pid parent_pgid = p.process.pgid return p, child_pid, child_pgid, parent_pid, parent_pgid def assert_alive(pid): os.kill(pid, 0) def assert_dead(pid): self.assert_oserror(errno.ESRCH, os.kill, pid, 0) # first let's prove that calling regular SIGKILL on the parent does # nothing to the child, since the child was launched in the same process # group (_new_session=False) and the parent is not a controlling process p, child_pid, child_pgid, parent_pid, parent_pgid = launch() assert_alive(parent_pid) assert_alive(child_pid) p.kill() time.sleep(0.1) assert_dead(parent_pid) assert_alive(child_pid) self.assertRaises(sh.SignalException_SIGKILL, p.wait) assert_dead(child_pid) # now let's prove that killing the process group kills both the parent # and the child p, child_pid, child_pgid, parent_pid, parent_pgid = launch() assert_alive(parent_pid) assert_alive(child_pid) p.kill_group() time.sleep(0.1) assert_dead(parent_pid) assert_dead(child_pid) def test_pushd(self): """ test basic pushd functionality """ old_wd1 = sh.pwd().strip() old_wd2 = os.getcwd() self.assertEqual(old_wd1, old_wd2) self.assertNotEqual(old_wd1, tempdir) with sh.pushd(tempdir): new_wd1 = sh.pwd().strip() new_wd2 = os.getcwd() old_wd3 = sh.pwd().strip() old_wd4 = os.getcwd() self.assertEqual(old_wd3, old_wd4) self.assertEqual(old_wd1, old_wd3) self.assertEqual(new_wd1, tempdir) self.assertEqual(new_wd2, tempdir) def test_pushd_cd(self): """ test that pushd works like pushd/popd with built-in cd correctly """ import sh child = realpath(tempfile.mkdtemp()) try: old_wd = os.getcwd() with sh.pushd(tempdir): self.assertEqual(tempdir, os.getcwd()) sh.cd(child) self.assertEqual(child, os.getcwd()) self.assertEqual(old_wd, os.getcwd()) finally: os.rmdir(child) def test_cd_homedir(self): orig = os.getcwd() my_dir = os.path.realpath(os.path.expanduser("~")) # Use realpath because homedir may be a symlink sh.cd() self.assertNotEqual(orig, os.getcwd()) self.assertEqual(my_dir, os.getcwd()) def test_non_existant_cwd(self): from sh import ls # sanity check non_exist_dir = join(tempdir, "aowjgoahewro") self.assertFalse(exists(non_exist_dir)) self.assertRaises(sh.ForkException, ls, _cwd=non_exist_dir) # https://github.com/amoffat/sh/issues/176 def test_baked_command_can_be_printed(self): from sh import ls ll = ls.bake("-l") self.assertTrue(str(ll).endswith("/ls -l")) # https://github.com/amoffat/sh/issues/185 def test_done_callback(self): import time class Callback(object): def __init__(self): self.called = False self.exit_code = None self.success = None def __call__(self, p, success, exit_code): self.called = True self.exit_code = exit_code self.success = success py = create_tmp_test(""" from time import time, sleep sleep(1) print(time()) """) callback = Callback() p = python(py.name, _done=callback, _bg=True) # do a little setup to prove that a command with a _done callback is run # in the background wait_start = time.time() p.wait() wait_elapsed = time.time() - wait_start self.assertTrue(callback.called) self.assertLess(abs(wait_elapsed - 1.0), 1.0) self.assertEqual(callback.exit_code, 0) self.assertTrue(callback.success) def test_fork_exc(self): from sh import ForkException py = create_tmp_test("") def fail(): raise RuntimeError("nooo") self.assertRaises(ForkException, python, py.name, _preexec_fn=fail) def test_new_session(self): from threading import Event py = create_tmp_test(""" import os import time pid = os.getpid() pgid = os.getpgid(pid) sid = os.getsid(pid) stuff = [pid, pgid, sid] print(",".join([str(el) for el in stuff])) time.sleep(0.5) """) event = Event() def handle(line, stdin, p): pid, pgid, sid = line.strip().split(",") pid = int(pid) pgid = int(pgid) sid = int(sid) self.assertEqual(p.pid, pid) self.assertEqual(pid, pgid) self.assertEqual(p.pgid, pgid) self.assertEqual(pgid, p.get_pgid()) self.assertEqual(pid, sid) self.assertEqual(sid, pgid) self.assertEqual(p.sid, sid) self.assertEqual(sid, p.get_sid()) event.set() # new session p = python(py.name, _out=handle) p.wait() self.assertTrue(event.is_set()) event.clear() def handle(line, stdin, p): pid, pgid, sid = line.strip().split(",") pid = int(pid) pgid = int(pgid) sid = int(sid) test_pid = os.getpgid(os.getpid()) self.assertEqual(p.pid, pid) self.assertNotEqual(test_pid, pgid) self.assertEqual(p.pgid, pgid) self.assertEqual(pgid, p.get_pgid()) self.assertNotEqual(pid, sid) self.assertNotEqual(sid, pgid) self.assertEqual(p.sid, sid) self.assertEqual(sid, p.get_sid()) event.set() # no new session p = python(py.name, _out=handle, _new_session=False) p.wait() self.assertTrue(event.is_set()) def test_done_cb_exc(self): from sh import ErrorReturnCode class Callback(object): def __init__(self): self.called = False self.success = None def __call__(self, p, success, exit_code): self.success = success self.called = True py = create_tmp_test("exit(1)") callback = Callback() try: p = python(py.name, _done=callback, _bg=True) p.wait() except ErrorReturnCode: self.assertTrue(callback.called) self.assertFalse(callback.success) else: self.fail("command should've thrown an exception") def test_callable_stdin(self): py = create_tmp_test(""" import sys sys.stdout.write(sys.stdin.read()) """) def create_stdin(): state = {"count": 0} def stdin(): count = state["count"] if count == 4: return None state["count"] += 1 return str(count) return stdin out = python(py.name, _in=create_stdin()) self.assertEqual("0123", out) def test_stdin_unbuffered_bufsize(self): from time import sleep # this tries to receive some known data and measures the time it takes # to receive it. since we're flushing by newline, we should only be # able to receive the data when a newline is fed in py = create_tmp_test(""" import sys from time import time started = time() data = sys.stdin.read(len("testing")) waited = time() - started sys.stdout.write(data + "\\n") sys.stdout.write(str(waited) + "\\n") started = time() data = sys.stdin.read(len("done")) waited = time() - started sys.stdout.write(data + "\\n") sys.stdout.write(str(waited) + "\\n") sys.stdout.flush() """) def create_stdin(): yield "test" sleep(1) yield "ing" sleep(1) yield "done" out = python(py.name, _in=create_stdin(), _in_bufsize=0) word1, time1, word2, time2, _ = out.split("\n") time1 = float(time1) time2 = float(time2) self.assertEqual(word1, "testing") self.assertLess(abs(1 - time1), 0.5) self.assertEqual(word2, "done") self.assertLess(abs(1 - time2), 0.5) def test_stdin_newline_bufsize(self): from time import sleep # this tries to receive some known data and measures the time it takes # to receive it. since we're flushing by newline, we should only be # able to receive the data when a newline is fed in py = create_tmp_test(""" import sys from time import time started = time() data = sys.stdin.read(len("testing\\n")) waited = time() - started sys.stdout.write(data) sys.stdout.write(str(waited) + "\\n") started = time() data = sys.stdin.read(len("done\\n")) waited = time() - started sys.stdout.write(data) sys.stdout.write(str(waited) + "\\n") sys.stdout.flush() """) # we'll feed in text incrementally, sleeping strategically before # sending a newline. we then measure the amount that we slept # indirectly in the child process def create_stdin(): yield "test" sleep(1) yield "ing\n" sleep(1) yield "done\n" out = python(py.name, _in=create_stdin(), _in_bufsize=1) word1, time1, word2, time2, _ = out.split("\n") time1 = float(time1) time2 = float(time2) self.assertEqual(word1, "testing") self.assertLess(abs(1 - time1), 0.5) self.assertEqual(word2, "done") self.assertLess(abs(1 - time2), 0.5) def test_custom_timeout_signal(self): from sh import TimeoutException import signal py = create_tmp_test(""" import time time.sleep(3) """) try: python(py.name, _timeout=1, _timeout_signal=signal.SIGQUIT) except TimeoutException as e: self.assertEqual(e.exit_code, signal.SIGQUIT) else: self.fail("we should have handled a TimeoutException") def test_append_stdout(self): py = create_tmp_test(""" import sys num = sys.stdin.read() sys.stdout.write(num) """) append_file = tempfile.NamedTemporaryFile(mode="a+b") python(py.name, _in="1", _out=append_file) python(py.name, _in="2", _out=append_file) append_file.seek(0) output = append_file.read() self.assertEqual(b"12", output) def test_shadowed_subcommand(self): py = create_tmp_test(""" import sys sys.stdout.write(sys.argv[1]) """) out = python.bake(py.name).bake_() self.assertEqual("bake", out) def test_no_proc_no_attr(self): py = create_tmp_test("") with python(py.name) as p: self.assertRaises(AttributeError, getattr, p, "exit_code") def test_partially_applied_callback(self): from functools import partial py = create_tmp_test(""" for i in range(10): print(i) """) output = [] def fn(foo, line): output.append((foo, int(line.strip()))) log_line = partial(fn, "hello") python(py.name, _out=log_line) self.assertEqual(output, [("hello", i) for i in range(10)]) output = [] def fn(foo, line, stdin, proc): output.append((foo, int(line.strip()))) log_line = partial(fn, "hello") python(py.name, _out=log_line) self.assertEqual(output, [("hello", i) for i in range(10)]) # https://github.com/amoffat/sh/issues/266 def test_grandchild_no_sighup(self): import time # child process that will write to a file if it receives a SIGHUP child = create_tmp_test(""" import signal import sys import time output_file = sys.argv[1] with open(output_file, "w") as f: def handle_sighup(signum, frame): f.write("got signal %d" % signum) sys.exit(signum) signal.signal(signal.SIGHUP, handle_sighup) time.sleep(2) f.write("made it!\\n") """) # the parent that will terminate before the child writes to the output # file, potentially causing a SIGHUP parent = create_tmp_test(""" import os import time import sys child_file = sys.argv[1] output_file = sys.argv[2] python_name = os.path.basename(sys.executable) os.spawnlp(os.P_NOWAIT, python_name, python_name, child_file, output_file) time.sleep(1) # give child a chance to set up """) output_file = tempfile.NamedTemporaryFile(delete=True) python(parent.name, child.name, output_file.name) time.sleep(3) out = output_file.readlines()[0] self.assertEqual(out, b"made it!\n") def test_unchecked_producer_failure(self): from sh import ErrorReturnCode_2 producer = create_tmp_test(""" import sys for i in range(10): print(i) sys.exit(2) """) consumer = create_tmp_test(""" import sys for line in sys.stdin: pass """) direct_pipe = python(producer.name, _piped=True) self.assertRaises(ErrorReturnCode_2, python, direct_pipe, consumer.name) def test_unchecked_pipeline_failure(self): # similar to test_unchecked_producer_failure, but this # tests a multi-stage pipeline from sh import ErrorReturnCode_2 producer = create_tmp_test(""" import sys for i in range(10): print(i) sys.exit(2) """) middleman = create_tmp_test(""" import sys for line in sys.stdin: print("> " + line) """) consumer = create_tmp_test(""" import sys for line in sys.stdin: pass """) producer_normal_pipe = python(producer.name, _piped=True) middleman_normal_pipe = python(producer_normal_pipe, middleman.name, _piped=True) self.assertRaises(ErrorReturnCode_2, python, middleman_normal_pipe, consumer.name) @skip_unless(HAS_MOCK, "requires unittest.mock") class MockTests(BaseTests): def test_patch_command_cls(self): def fn(): cmd = sh.Command("afowejfow") return cmd() @unittest.mock.patch("sh.Command") def test(Command): Command().return_value = "some output" return fn() self.assertEqual(test(), "some output") self.assertRaises(sh.CommandNotFound, fn) def test_patch_command(self): def fn(): return sh.afowejfow() @unittest.mock.patch("sh.afowejfow", create=True) def test(cmd): cmd.return_value = "some output" return fn() self.assertEqual(test(), "some output") self.assertRaises(sh.CommandNotFound, fn) class MiscTests(BaseTests): def test_pickling(self): import pickle py = create_tmp_test(""" import sys sys.stdout.write("some output") sys.stderr.write("some error") exit(1) """) try: python(py.name) except sh.ErrorReturnCode as e: restored = pickle.loads(pickle.dumps(e)) self.assertEqual(restored.stdout, b"some output") self.assertEqual(restored.stderr, b"some error") self.assertEqual(restored.exit_code, 1) else: self.fail("Didn't get an exception") @requires_poller("poll") def test_fd_over_1024(self): py = create_tmp_test("""print("hi world")""") with ulimit(resource.RLIMIT_NOFILE, 2048): cutoff_fd = 1024 pipes = [] for i in xrange(cutoff_fd): master, slave = os.pipe() pipes.append((master, slave)) if slave >= cutoff_fd: break python(py.name) for master, slave in pipes: os.close(master) os.close(slave) def test_args_deprecated(self): self.assertRaises(DeprecationWarning, sh.args, _env={}) def test_percent_doesnt_fail_logging(self): """ test that a command name doesn't interfere with string formatting in the internal loggers """ py = create_tmp_test(""" print("cool") """) python(py.name, "%") python(py.name, "%%") python(py.name, "%%%") # TODO # for some reason, i can't get a good stable baseline measured in this test # on osx. so skip it for now if osx @not_macos @requires_progs("lsof") def test_no_fd_leak(self): import sh import os from itertools import product # options whose combinations can possibly cause fd leaks kwargs = { "_tty_out": (True, False), "_tty_in": (True, False), "_err_to_out": (True, False), } def get_opts(possible_values): all_opts = [] for opt, values in possible_values.items(): opt_collection = [] all_opts.append(opt_collection) for val in values: pair = (opt, val) opt_collection.append(pair) for combo in product(*all_opts): opt_dict = {} for key, val in combo: opt_dict[key] = val yield opt_dict test_pid = os.getpid() def get_num_fds(): lines = sh.lsof(p=test_pid).strip().split("\n") def test(line): line = line.upper() return "CHR" in line or "PIPE" in line lines = [line for line in lines if test(line)] return len(lines) - 1 py = create_tmp_test("") def test_command(**opts): python(py.name, **opts) # make sure our baseline is stable.. we can remove this test_command() baseline = get_num_fds() for i in xrange(10): test_command() num_fds = get_num_fds() self.assertEqual(baseline, num_fds) for opts in get_opts(kwargs): for i in xrange(2): test_command(**opts) num_fds = get_num_fds() self.assertEqual(baseline, num_fds, (baseline, num_fds, opts)) def test_pushd_thread_safety(self): import threading import time temp1 = realpath(tempfile.mkdtemp()) temp2 = realpath(tempfile.mkdtemp()) try: results = [None, None] def fn1(): with sh.pushd(temp1): time.sleep(0.2) results[0] = realpath(os.getcwd()) def fn2(): time.sleep(0.1) with sh.pushd(temp2): results[1] = realpath(os.getcwd()) time.sleep(0.3) t1 = threading.Thread(name="t1", target=fn1) t2 = threading.Thread(name="t2", target=fn2) t1.start() t2.start() t1.join() t2.join() self.assertEqual(results, [temp1, temp2]) finally: os.rmdir(temp1) os.rmdir(temp2) def test_stdin_nohang(self): py = create_tmp_test(""" print("hi") """) read, write = os.pipe() stdin = os.fdopen(read, "r") python(py.name, _in=stdin) @requires_utf8 def test_unicode_path(self): from sh import Command python_name = os.path.basename(sys.executable) py = create_tmp_test("""#!/usr/bin/env {0} # -*- coding: utf8 -*- print("字") """.format(python_name), prefix="字", delete=False) try: py.close() os.chmod(py.name, int(0o755)) cmd = Command(py.name) # all of these should behave just fine str(cmd) repr(cmd) unicode(cmd) running = cmd() str(running) repr(running) unicode(running) str(running.process) repr(running.process) unicode(running.process) finally: os.unlink(py.name) # https://github.com/amoffat/sh/issues/121 def test_wraps(self): from sh import ls wraps(ls)(lambda f: True) def test_signal_exception_aliases(self): """ proves that signal exceptions with numbers and names are equivalent """ import signal import sh sig_name = "SignalException_%d" % signal.SIGQUIT sig = getattr(sh, sig_name) from sh import SignalException_SIGQUIT self.assertEqual(sig, SignalException_SIGQUIT) def test_change_log_message(self): py = create_tmp_test(""" print("cool") """) def log_msg(cmd, call_args, pid=None): return "Hi! I ran something" buf = StringIO() handler = logging.StreamHandler(buf) logger = logging.getLogger("sh") logger.setLevel(logging.INFO) try: logger.addHandler(handler) python(py.name, "meow", "bark", _log_msg=log_msg) finally: logger.removeHandler(handler) loglines = buf.getvalue().split("\n") self.assertTrue(loglines, "Log handler captured no messages?") self.assertTrue(loglines[0].startswith("Hi! I ran something")) # https://github.com/amoffat/sh/issues/273 def test_stop_iteration_doesnt_block(self): """ proves that calling calling next() on a stopped iterator doesn't hang. """ py = create_tmp_test(""" print("cool") """) p = python(py.name, _iter=True) for i in range(100): try: next(p) except StopIteration: pass # https://github.com/amoffat/sh/issues/195 def test_threaded_with_contexts(self): import threading import time py = create_tmp_test(""" import sys a = sys.argv res = (a[1], a[3]) sys.stdout.write(repr(res)) """) p1 = python.bake("-u", py.name, 1) p2 = python.bake("-u", py.name, 2) results = [None, None] def f1(): with p1: time.sleep(1) results[0] = str(system_python("one")) def f2(): with p2: results[1] = str(system_python("two")) t1 = threading.Thread(target=f1) t1.start() t2 = threading.Thread(target=f2) t2.start() t1.join() t2.join() correct = [ "('1', 'one')", "('2', 'two')", ] self.assertEqual(results, correct) # https://github.com/amoffat/sh/pull/292 def test_eintr(self): import signal def handler(num, frame): pass signal.signal(signal.SIGALRM, handler) py = create_tmp_test(""" import time time.sleep(2) """) p = python(py.name, _bg=True) signal.alarm(1) p.wait() class StreamBuffererTests(unittest.TestCase): def test_unbuffered(self): from sh import StreamBufferer b = StreamBufferer(0) self.assertEqual(b.process(b"test"), [b"test"]) self.assertEqual(b.process(b"one"), [b"one"]) self.assertEqual(b.process(b""), [b""]) self.assertEqual(b.flush(), b"") def test_newline_buffered(self): from sh import StreamBufferer b = StreamBufferer(1) self.assertEqual(b.process(b"testing\none\ntwo"), [b"testing\n", b"one\n"]) self.assertEqual(b.process(b"\nthree\nfour"), [b"two\n", b"three\n"]) self.assertEqual(b.flush(), b"four") def test_chunk_buffered(self): from sh import StreamBufferer b = StreamBufferer(10) self.assertEqual(b.process(b"testing\none\ntwo"), [b"testing\non"]) self.assertEqual(b.process(b"\nthree\n"), [b"e\ntwo\nthre"]) self.assertEqual(b.flush(), b"e\n") @requires_posix class ExecutionContextTests(unittest.TestCase): def test_basic(self): import sh out = StringIO() _sh = sh(_out=out) _sh.echo("-n", "TEST") self.assertEqual("TEST", out.getvalue()) def test_no_interfere1(self): import sh out = StringIO() _sh = sh(_out=out) # noqa: F841 from _sh import echo echo("-n", "TEST") self.assertEqual("TEST", out.getvalue()) # Emptying the StringIO out.seek(0) out.truncate(0) sh.echo("-n", "KO") self.assertEqual("", out.getvalue()) def test_no_interfere2(self): import sh out = StringIO() from sh import echo _sh = sh(_out=out) # noqa: F841 echo("-n", "TEST") self.assertEqual("", out.getvalue()) def test_no_bad_name(self): out = StringIO() def fn(): import sh sh = sh(_out=out) self.assertRaises(RuntimeError, fn) def test_set_in_parent_function(self): import sh out = StringIO() _sh = sh(_out=out) def nested1(): _sh.echo("-n", "TEST1") def nested2(): import sh sh.echo("-n", "TEST2") nested1() nested2() self.assertEqual("TEST1", out.getvalue()) def test_reimport_no_interfere(self): import sh out = StringIO() _sh = sh(_out=out) import _sh # this reimport '_sh' from the eponymous local variable _sh.echo("-n", "TEST") self.assertEqual("TEST", out.getvalue()) def test_importer_detects_module_name(self): import sh _sh = sh() omg = _sh # noqa: F841 from omg import cat # noqa: F401 def test_importer_only_works_with_sh(self): def unallowed_import(): _os = os # noqa: F841 from _os import path # noqa: F401 self.assertRaises(ImportError, unallowed_import) def test_reimport_from_cli(self): # The REPL and CLI both need special handling to create an execution context that is safe to # reimport if IS_PY3: cmdstr = '; '.join(('import sh, io, sys', 'out = io.StringIO()', '_sh = sh(_out=out)', 'import _sh', '_sh.echo("-n", "TEST")', 'sys.stderr.write(out.getvalue())', )) else: cmdstr = '; '.join(('import sh, StringIO, sys', 'out = StringIO.StringIO()', '_sh = sh(_out=out)', 'import _sh', '_sh.echo("-n", "TEST")', 'sys.stderr.write(out.getvalue())', )) err = StringIO() python('-c', cmdstr, _err=err) self.assertEqual('TEST', err.getvalue()) if __name__ == "__main__": root = logging.getLogger() root.setLevel(logging.DEBUG) root.addHandler(NullHandler()) test_kwargs = {} if IS_PY2 and MINOR_VER != 6: test_kwargs["failfast"] = True test_kwargs["verbosity"] = 2 try: # if we're running a specific test, we can let unittest framework figure out # that test and run it itself. it will also handle setting the return code # of the process if any tests error or fail if len(sys.argv) > 1: unittest.main(**test_kwargs) # otherwise, it looks like we want to run all the tests else: suite = unittest.TestLoader().loadTestsFromModule(sys.modules[__name__]) test_kwargs["verbosity"] = 2 result = unittest.TextTestRunner(**test_kwargs).run(suite) if not result.wasSuccessful(): exit(1) finally: if cov: cov.stop() cov.save() sh-1.14.2/tox.ini000066400000000000000000000004451404764061700135400ustar00rootroot00000000000000[tox] # virtualenv for py26 is broken, so don't put it here envlist = py{27,31,32,33,34,35,36,37,38},docs [testenv] deps = -r requirements-dev.txt commands = python sh.py tox [testenv:docs] basepython = python3 commands = python setup.py check --restructuredtext --metadata --strict