py2docfx 0.1.11rc1981066__py3-none-any.whl → 0.1.11rc1997820__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/psutil/tests/test_memleaks.py

@@ -14,7 +14,6 @@ PyPy appears to be completely unstable for this framework, probably
 because of how its JIT handles memory, so tests are skipped.
 """
 
-from __future__ import print_function
 
 import functools
 import os
@@ -28,8 +27,6 @@ from psutil import OPENBSD
 from psutil import POSIX
 from psutil import SUNOS
 from psutil import WINDOWS
-from psutil._compat import ProcessLookupError
-from psutil._compat import super
 from psutil.tests import HAS_CPU_AFFINITY
 from psutil.tests import HAS_CPU_FREQ
 from psutil.tests import HAS_ENVIRON
@@ -42,7 +39,6 @@ from psutil.tests import HAS_RLIMIT
 from psutil.tests import HAS_SENSORS_BATTERY
 from psutil.tests import HAS_SENSORS_FANS
 from psutil.tests import HAS_SENSORS_TEMPERATURES
-from psutil.tests import QEMU_USER
 from psutil.tests import TestMemoryLeak
 from psutil.tests import create_sockets
 from psutil.tests import get_testfn
@@ -399,7 +395,6 @@ class TestModuleFunctionsLeaks(TestMemoryLeak):
         times = FEW_TIMES if POSIX else self.times
         self.execute(lambda: psutil.disk_usage('.'), times=times)
 
-    @pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
     def test_disk_partitions(self):
         self.execute(psutil.disk_partitions)
 
@@ -437,7 +432,6 @@ class TestModuleFunctionsLeaks(TestMemoryLeak):
         tolerance = 80 * 1024 if WINDOWS else self.tolerance
         self.execute(psutil.net_if_addrs, tolerance=tolerance)
 
-    @pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
     def test_net_if_stats(self):
         self.execute(psutil.net_if_stats)
 

py2docfx/venv/venv1/Lib/site-packages/psutil/tests/test_misc.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 
 # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
@@ -7,19 +6,18 @@
 
 """Miscellaneous tests."""
 
-import ast
 import collections
-import errno
+import contextlib
+import io
 import json
 import os
 import pickle
 import socket
-import stat
 import sys
+from unittest import mock
 
 import psutil
 import psutil.tests
-from psutil import POSIX
 from psutil import WINDOWS
 from psutil._common import bcat
 from psutil._common import cat
@@ -30,26 +28,11 @@ from psutil._common import memoize_when_activated
 from psutil._common import parse_environ_block
 from psutil._common import supports_ipv6
 from psutil._common import wrap_numbers
-from psutil._compat import PY3
-from psutil._compat import FileNotFoundError
-from psutil._compat import redirect_stderr
-from psutil.tests import CI_TESTING
-from psutil.tests import HAS_BATTERY
-from psutil.tests import HAS_MEMORY_MAPS
 from psutil.tests import HAS_NET_IO_COUNTERS
-from psutil.tests import HAS_SENSORS_BATTERY
-from psutil.tests import HAS_SENSORS_FANS
-from psutil.tests import HAS_SENSORS_TEMPERATURES
-from psutil.tests import PYTHON_EXE
-from psutil.tests import PYTHON_EXE_ENV
-from psutil.tests import QEMU_USER
-from psutil.tests import SCRIPTS_DIR
 from psutil.tests import PsutilTestCase
-from psutil.tests import mock
 from psutil.tests import process_namespace
 from psutil.tests import pytest
 from psutil.tests import reload_module
-from psutil.tests import sh
 from psutil.tests import system_namespace
 
 
@@ -69,8 +52,8 @@ class TestSpecialMethods(PsutilTestCase):
         p = psutil.Process(self.spawn_testproc().pid)
         r = func(p)
         assert "psutil.Process" in r
-        assert "pid=%s" % p.pid in r
-        assert "name='%s'" % str(p.name()) in r.replace("name=u'", "name='")
+        assert f"pid={p.pid}" in r
+        assert f"name='{p.name()}'" in r.replace("name=u'", "name='")
         assert "status=" in r
         assert "exitcode=" not in r
         p.terminate()
@@ -86,7 +69,7 @@ class TestSpecialMethods(PsutilTestCase):
         ):
             p = psutil.Process()
             r = func(p)
-            assert "pid=%s" % p.pid in r
+            assert f"pid={p.pid}" in r
             assert "status='zombie'" in r
             assert "name=" not in r
         with mock.patch.object(
@@ -96,7 +79,7 @@ class TestSpecialMethods(PsutilTestCase):
         ):
             p = psutil.Process()
             r = func(p)
-            assert "pid=%s" % p.pid in r
+            assert f"pid={p.pid}" in r
             assert "terminated" in r
             assert "name=" not in r
         with mock.patch.object(
@@ -106,7 +89,7 @@ class TestSpecialMethods(PsutilTestCase):
         ):
             p = psutil.Process()
             r = func(p)
-            assert "pid=%s" % p.pid in r
+            assert f"pid={p.pid}" in r
             assert "name=" not in r
 
     def test_process__str__(self):
@@ -116,7 +99,7 @@ class TestSpecialMethods(PsutilTestCase):
         assert repr(psutil.Error()) == "psutil.Error()"
 
     def test_error__str__(self):
-        assert str(psutil.Error()) == ""  # noqa
+        assert str(psutil.Error()) == ""
 
     def test_no_such_process__repr__(self):
         assert (
@@ -202,7 +185,7 @@ class TestSpecialMethods(PsutilTestCase):
         assert p1 != 'foo'
 
     def test_process__hash__(self):
-        s = set([psutil.Process(), psutil.Process()])
+        s = {psutil.Process(), psutil.Process()}
         assert len(s) == 1
 
 
@@ -217,7 +200,6 @@ class TestMisc(PsutilTestCase):
         for name in dir_psutil:
             if name in {
                 'debug',
-                'long',
                 'tests',
                 'test',
                 'PermissionError',
@@ -236,11 +218,11 @@ class TestMisc(PsutilTestCase):
                             fun.__doc__ is not None
                             and 'deprecated' not in fun.__doc__.lower()
                         ):
-                            raise self.fail('%r not in psutil.__all__' % name)
+                            raise self.fail(f"{name!r} not in psutil.__all__")
 
         # Import 'star' will break if __all__ is inconsistent, see:
         # https://github.com/giampaolo/psutil/issues/656
-        # Can't do `from psutil import *` as it won't work on python 3
+        # Can't do `from psutil import *` as it won't work
         # so we simply iterate over __all__.
         for name in psutil.__all__:
             assert name in dir_psutil
@@ -286,9 +268,6 @@ class TestMisc(PsutilTestCase):
         for fun, name in ns.iter(ns.getters):
             if name in {"win_service_iter", "win_service_get"}:
                 continue
-            if QEMU_USER and name == "net_if_stats":
-                # OSError: [Errno 38] ioctl(SIOCETHTOOL) not implemented
-                continue
             with self.subTest(name=name):
                 try:
                     ret = fun()
@@ -338,18 +317,6 @@ class TestMisc(PsutilTestCase):
         assert b.pid == 4567
         assert b.name == 'name'
 
-    # # XXX: https://github.com/pypa/setuptools/pull/2896
-    # @pytest.mark.skipif(APPVEYOR,
-    #     reason="temporarily disabled due to setuptools bug"
-    # )
-    # def test_setup_script(self):
-    #     setup_py = os.path.join(ROOT_DIR, 'setup.py')
-    #     if CI_TESTING and not os.path.exists(setup_py):
-    #         raise pytest.skip("can't find setup.py")
-    #     module = import_module_by_path(setup_py)
-    #     self.assertRaises(SystemExit, module.setup)
-    #     self.assertEqual(module.get_version(), psutil.__version__)
-
     def test_ad_on_process_creation(self):
         # We are supposed to be able to instantiate Process also in case
         # of zombie processes or access denied.
@@ -587,7 +554,7 @@ class TestCommonModule(PsutilTestCase):
 
             supports_ipv6.cache_clear()
             with mock.patch(
-                'psutil._common.socket.socket', side_effect=socket.error
+                'psutil._common.socket.socket', side_effect=OSError
             ) as s:
                 assert not supports_ipv6()
                 assert s.called
@@ -609,7 +576,7 @@ class TestCommonModule(PsutilTestCase):
                 supports_ipv6.cache_clear()
                 assert s.called
         else:
-            with pytest.raises(socket.error):
+            with pytest.raises(OSError):
                 sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
                 try:
                     sock.bind(("::1", 0))
@@ -620,31 +587,19 @@ class TestCommonModule(PsutilTestCase):
         this_file = os.path.abspath(__file__)
         assert isfile_strict(this_file)
         assert not isfile_strict(os.path.dirname(this_file))
-        with mock.patch(
-            'psutil._common.os.stat', side_effect=OSError(errno.EPERM, "foo")
-        ):
-            with pytest.raises(OSError):
-                isfile_strict(this_file)
-        with mock.patch(
-            'psutil._common.os.stat', side_effect=OSError(errno.EACCES, "foo")
-        ):
+        with mock.patch('psutil._common.os.stat', side_effect=PermissionError):
             with pytest.raises(OSError):
                 isfile_strict(this_file)
         with mock.patch(
-            'psutil._common.os.stat', side_effect=OSError(errno.ENOENT, "foo")
+            'psutil._common.os.stat', side_effect=FileNotFoundError
         ):
             assert not isfile_strict(this_file)
         with mock.patch('psutil._common.stat.S_ISREG', return_value=False):
             assert not isfile_strict(this_file)
 
     def test_debug(self):
-        if PY3:
-            from io import StringIO
-        else:
-            from StringIO import StringIO
-
         with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
-            with redirect_stderr(StringIO()) as f:
+            with contextlib.redirect_stderr(io.StringIO()) as f:
                 debug("hello")
                 sys.stderr.flush()
         msg = f.getvalue()
@@ -654,7 +609,7 @@ class TestCommonModule(PsutilTestCase):
 
         # supposed to use repr(exc)
         with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
-            with redirect_stderr(StringIO()) as f:
+            with contextlib.redirect_stderr(io.StringIO()) as f:
                 debug(ValueError("this is an error"))
         msg = f.getvalue()
         assert "ignoring ValueError" in msg
@@ -662,7 +617,7 @@ class TestCommonModule(PsutilTestCase):
 
         # supposed to use str(exc), because of extra info about file name
         with mock.patch.object(psutil._common, "PSUTIL_DEBUG", True):
-            with redirect_stderr(StringIO()) as f:
+            with contextlib.redirect_stderr(io.StringIO()) as f:
                 exc = OSError(2, "no such file")
                 exc.filename = "/foo"
                 debug(exc)
@@ -838,7 +793,7 @@ class TestWrapNumbers(PsutilTestCase):
         assert cache[1] == {
             'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 100}
         }
-        assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
+        assert cache[2] == {'disk_io': {'disk1': {('disk1', 2)}}}
 
         def check_cache_info():
             cache = wrap_numbers.cache_info()
@@ -849,7 +804,7 @@ class TestWrapNumbers(PsutilTestCase):
                     ('disk1', 2): 100,
                 }
             }
-            assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
+            assert cache[2] == {'disk_io': {'disk1': {('disk1', 2)}}}
 
         # then it remains the same
         input = {'disk1': nt(100, 100, 10)}
@@ -873,7 +828,7 @@ class TestWrapNumbers(PsutilTestCase):
         assert cache[1] == {
             'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 190}
         }
-        assert cache[2] == {'disk_io': {'disk1': set([('disk1', 2)])}}
+        assert cache[2] == {'disk_io': {'disk1': {('disk1', 2)}}}
 
     def test_cache_changing_keys(self):
         input = {'disk1': nt(5, 5, 5)}
@@ -916,143 +871,3 @@ class TestWrapNumbers(PsutilTestCase):
         psutil.net_io_counters.cache_clear()
         caches = wrap_numbers.cache_info()
         assert caches == ({}, {}, {})
-
-
-# ===================================================================
-# --- Example script tests
-# ===================================================================
-
-
-@pytest.mark.skipif(
-    not os.path.exists(SCRIPTS_DIR), reason="can't locate scripts directory"
-)
-class TestScripts(PsutilTestCase):
-    """Tests for scripts in the "scripts" directory."""
-
-    @staticmethod
-    def assert_stdout(exe, *args, **kwargs):
-        kwargs.setdefault("env", PYTHON_EXE_ENV)
-        exe = '%s' % os.path.join(SCRIPTS_DIR, exe)
-        cmd = [PYTHON_EXE, exe]
-        for arg in args:
-            cmd.append(arg)
-        try:
-            out = sh(cmd, **kwargs).strip()
-        except RuntimeError as err:
-            if 'AccessDenied' in str(err):
-                return str(err)
-            else:
-                raise
-        assert out, out
-        return out
-
-    @staticmethod
-    def assert_syntax(exe):
-        exe = os.path.join(SCRIPTS_DIR, exe)
-        with open(exe, encoding="utf8") if PY3 else open(exe) as f:
-            src = f.read()
-        ast.parse(src)
-
-    def test_coverage(self):
-        # make sure all example scripts have a test method defined
-        meths = dir(self)
-        for name in os.listdir(SCRIPTS_DIR):
-            if name.endswith('.py'):
-                if 'test_' + os.path.splitext(name)[0] not in meths:
-                    # self.assert_stdout(name)
-                    raise self.fail(
-                        'no test defined for %r script'
-                        % os.path.join(SCRIPTS_DIR, name)
-                    )
-
-    @pytest.mark.skipif(not POSIX, reason="POSIX only")
-    def test_executable(self):
-        for root, dirs, files in os.walk(SCRIPTS_DIR):
-            for file in files:
-                if file.endswith('.py'):
-                    path = os.path.join(root, file)
-                    if not stat.S_IXUSR & os.stat(path)[stat.ST_MODE]:
-                        raise self.fail('%r is not executable' % path)
-
-    def test_disk_usage(self):
-        self.assert_stdout('disk_usage.py')
-
-    def test_free(self):
-        self.assert_stdout('free.py')
-
-    def test_meminfo(self):
-        self.assert_stdout('meminfo.py')
-
-    def test_procinfo(self):
-        self.assert_stdout('procinfo.py', str(os.getpid()))
-
-    @pytest.mark.skipif(CI_TESTING and not psutil.users(), reason="no users")
-    def test_who(self):
-        self.assert_stdout('who.py')
-
-    def test_ps(self):
-        self.assert_stdout('ps.py')
-
-    def test_pstree(self):
-        self.assert_stdout('pstree.py')
-
-    def test_netstat(self):
-        self.assert_stdout('netstat.py')
-
-    @pytest.mark.skipif(QEMU_USER, reason="QEMU user not supported")
-    def test_ifconfig(self):
-        self.assert_stdout('ifconfig.py')
-
-    @pytest.mark.skipif(not HAS_MEMORY_MAPS, reason="not supported")
-    def test_pmap(self):
-        self.assert_stdout('pmap.py', str(os.getpid()))
-
-    def test_procsmem(self):
-        if 'uss' not in psutil.Process().memory_full_info()._fields:
-            raise pytest.skip("not supported")
-        self.assert_stdout('procsmem.py')
-
-    def test_killall(self):
-        self.assert_syntax('killall.py')
-
-    def test_nettop(self):
-        self.assert_syntax('nettop.py')
-
-    def test_top(self):
-        self.assert_syntax('top.py')
-
-    def test_iotop(self):
-        self.assert_syntax('iotop.py')
-
-    def test_pidof(self):
-        output = self.assert_stdout('pidof.py', psutil.Process().name())
-        assert str(os.getpid()) in output
-
-    @pytest.mark.skipif(not WINDOWS, reason="WINDOWS only")
-    def test_winservices(self):
-        self.assert_stdout('winservices.py')
-
-    def test_cpu_distribution(self):
-        self.assert_syntax('cpu_distribution.py')
-
-    @pytest.mark.skipif(not HAS_SENSORS_TEMPERATURES, reason="not supported")
-    def test_temperatures(self):
-        if not psutil.sensors_temperatures():
-            raise pytest.skip("no temperatures")
-        self.assert_stdout('temperatures.py')
-
-    @pytest.mark.skipif(not HAS_SENSORS_FANS, reason="not supported")
-    def test_fans(self):
-        if not psutil.sensors_fans():
-            raise pytest.skip("no fans")
-        self.assert_stdout('fans.py')
-
-    @pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
-    @pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
-    def test_battery(self):
-        self.assert_stdout('battery.py')
-
-    @pytest.mark.skipif(not HAS_SENSORS_BATTERY, reason="not supported")
-    @pytest.mark.skipif(not HAS_BATTERY, reason="no battery")
-    def test_sensors(self):
-        self.assert_stdout('sensors.py')

py2docfx/venv/venv1/Lib/site-packages/psutil/tests/test_osx.py

@@ -13,6 +13,7 @@ import time
 import psutil
 from psutil import MACOS
 from psutil import POSIX
+from psutil.tests import CI_TESTING
 from psutil.tests import HAS_BATTERY
 from psutil.tests import TOLERANCE_DISK_USAGE
 from psutil.tests import TOLERANCE_SYS_MEM
@@ -62,7 +63,7 @@ class TestProcess(PsutilTestCase):
         terminate(cls.pid)
 
     def test_process_create_time(self):
-        output = sh("ps -o lstart -p %s" % self.pid)
+        output = sh(f"ps -o lstart -p {self.pid}")
         start_ps = output.replace('STARTED', '').strip()
         hhmmss = start_ps.split(' ')[-2]
         year = start_ps.split(' ')[-1]
@@ -83,7 +84,7 @@ class TestSystemAPIs(PsutilTestCase):
         # test psutil.disk_usage() and psutil.disk_partitions()
         # against "df -a"
         def df(path):
-            out = sh('df -k "%s"' % path).strip()
+            out = sh(f'df -k "{path}"').strip()
             lines = out.split('\n')
             lines.pop(0)
             line = lines.pop(0)
@@ -129,6 +130,10 @@ class TestSystemAPIs(PsutilTestCase):
         sysctl_hwphymem = sysctl('sysctl hw.memsize')
         assert sysctl_hwphymem == psutil.virtual_memory().total
 
+    @pytest.mark.skipif(
+        CI_TESTING and MACOS and platform.machine() == 'arm64',
+        reason="skipped on MACOS + ARM64 + CI_TESTING",
+    )
     @retry_on_failure()
     def test_vmem_free(self):
         vmstat_val = vm_stat("free")
@@ -172,7 +177,7 @@ class TestSystemAPIs(PsutilTestCase):
     def test_net_if_stats(self):
         for name, stats in psutil.net_if_stats().items():
             try:
-                out = sh("ifconfig %s" % name)
+                out = sh(f"ifconfig {name}")
             except RuntimeError:
                 pass
             else:
@@ -185,7 +190,7 @@ class TestSystemAPIs(PsutilTestCase):
     def test_sensors_battery(self):
         out = sh("pmset -g batt")
         percent = re.search(r"(\d+)%", out).group(1)
-        drawing_from = re.search("Now drawing from '([^']+)'", out).group(1)
+        drawing_from = re.search(r"Now drawing from '([^']+)'", out).group(1)
         power_plugged = drawing_from == "AC Power"
         psutil_result = psutil.sensors_battery()
         assert psutil_result.power_plugged == power_plugged

py2docfx/venv/venv1/Lib/site-packages/psutil/tests/test_posix.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 
 # Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
@@ -11,8 +10,10 @@ import datetime
 import errno
 import os
 import re
+import shutil
 import subprocess
 import time
+from unittest import mock
 
 import psutil
 from psutil import AIX
@@ -25,16 +26,13 @@ from psutil import SUNOS
 from psutil.tests import AARCH64
 from psutil.tests import HAS_NET_IO_COUNTERS
 from psutil.tests import PYTHON_EXE
-from psutil.tests import QEMU_USER
 from psutil.tests import PsutilTestCase
-from psutil.tests import mock
 from psutil.tests import pytest
 from psutil.tests import retry_on_failure
 from psutil.tests import sh
 from psutil.tests import skip_on_access_denied
 from psutil.tests import spawn_testproc
 from psutil.tests import terminate
-from psutil.tests import which
 
 
 if POSIX:
@@ -104,9 +102,6 @@ def ps_name(pid):
     if SUNOS:
         field = "comm"
     command = ps(field, pid).split()
-    if QEMU_USER:
-        assert "/bin/qemu-" in command[0]
-        return command[1]
     return command[0]
 
 
@@ -136,7 +131,7 @@ def ps_vsz(pid):
 
 def df(device):
     try:
-        out = sh("df -k %s" % device).strip()
+        out = sh(f"df -k {device}").strip()
     except RuntimeError as err:
         if "device busy" in str(err).lower():
             raise pytest.skip("df returned EBUSY")
@@ -288,7 +283,7 @@ class TestProcess(PsutilTestCase):
             assert ps_pathname == psutil_pathname
         except AssertionError:
             # certain platforms such as BSD are more accurate returning:
-            # "/usr/local/bin/python2.7"
+            # "/usr/local/bin/python3.7"
             # ...instead of:
             # "/usr/local/bin/python"
             # We do not want to consider this difference in accuracy
@@ -348,7 +343,7 @@ class TestSystemAPIs(PsutilTestCase):
     # for some reason ifconfig -a does not report all interfaces
     # returned by psutil
     @pytest.mark.skipif(SUNOS, reason="unreliable on SUNOS")
-    @pytest.mark.skipif(not which('ifconfig'), reason="no ifconfig cmd")
+    @pytest.mark.skipif(not shutil.which("ifconfig"), reason="no ifconfig cmd")
     @pytest.mark.skipif(not HAS_NET_IO_COUNTERS, reason="not supported")
     def test_nic_names(self):
         output = sh("ifconfig -a")
@@ -358,8 +353,8 @@ class TestSystemAPIs(PsutilTestCase):
                     break
             else:
                 raise self.fail(
-                    "couldn't find %s nic in 'ifconfig -a' output\n%s"
-                    % (nic, output)
+                    f"couldn't find {nic} nic in 'ifconfig -a'"
+                    f" output\n{output}"
                 )
 
     # @pytest.mark.skipif(CI_TESTING and not psutil.users(),
@@ -408,9 +403,7 @@ class TestSystemAPIs(PsutilTestCase):
                         started = [x.capitalize() for x in started]
 
         if not tstamp:
-            raise pytest.skip(
-                "cannot interpret tstamp in who output\n%s" % (out)
-            )
+            raise pytest.skip(f"cannot interpret tstamp in who output\n{out}")
 
         with self.subTest(psutil=psutil.users(), who=out):
             for idx, u in enumerate(psutil.users()):