chrismiles / psi / changeset / d58144bcce28

Up to file-list README:

 PSI - Python System Information
 ===============================
 Overview
 ========
 PSI is a Python module providing direct access to real-time system and
 process information.  It is made up of several sub-modules.
 The ``arch`` module gives some information about the system such as the
 system name and version, the machine architecture etc.  It has a class
 representing each system and a factory function that will return an
 instance of the class which psi is running on currently.
 The ``process`` module provides an interface to information about
 processes currently running on the system.  Each process is
 represented as an instance of the Process class and additionally there
 is a ProcessTable class which is a dictionary of all running
 processes.  To know exactly what attributes are available and what
 they mean you should look at the docstrings and examples below but
 important to note is that all the information is collected at
 instantiation time.  So the contents of ProcessTable and Process
 instances are really snapshots and will still contain all information
 even after the actual process has gone.
 Lastly there are some general functions available directly under the
 ``psi`` namespace such as ``loadavg()``, ``getzoneid()`` etc.  Once
 more see the docstrings for detailed information.
 Some information may not be available on all platforms, rather then
 trying to emulate this information these parts of the API just don't
 exists on those platforms.  Examples of these are:
 ``psi.process.Process.pcpu`` which is not available on Linux,
 ``psi.getzoneid()`` which is only available on SunOS 10 and above etc.
 If not all information can be found some attribute descriptors of
 objects might return subclasses of AttributeError, allowing you to use
 generic ``getattr()`` semantics as well as more specifically detect why
 an attribute is not available (insufficient privileges, not
 implemented, ...).
 PSI is a Python package providing real-time access to processes and
 other miscellaneous system information such as architecture, boottime
 and filesystems. It has a pythonic API which is consistent accross all
 supported platforms but also exposes platform-specific details where
 desirable.
 Install
@@ -49,13 +19,13 @@ docstring of setup.py for the exact supp
 You will also need a working C compiler and the python development
 files.  If a system is not supported yet the build will fail.  After
 building it is best to run the test suite, on some platforms not all
 tests will pass yet and you would rather know of these problems before
 starting to use PSI.
 tests might pass yet and you would rather know of these problems
 before starting to use PSI.
 So to fully install PSI from source::
   $ python setup.py build
-  $ python setup.py test [--all]
+  $ python setup.py test
   $ python setup.py install [<your options>]
 See the Python documentation on installing Python module for more
@@ -91,13 +61,10 @@ Limitations
 Solaris
 -------
 If the module is compiled as 32-bit (which is what will usually happen
 since that tends to be how python is compiled) it will use the ILP32
 model and will not be able to read the address space of 64-bit
 processes as they use the LP64 model.  This means that the full
 argument list and the environment dictionary will not be available.
 The partial argument list can still be retrieved from the
 ``psi.process.Process.command`` attribute.
 The argv array is read from the process memory on Solaris.  If you do
 not have permissions to do this only the ``command`` and ``argc``
 attributes of ``psi.process.Process`` will be available and using the
 ``args`` attribute will return the appropriate ``AttributeError``.
 Unit Tests
@@ -105,13 +72,11 @@ Unit Tests
 To run the unit tests::
-  $ python setup.py test [--all]
+  $ python setup.py test
 The --all option will run tests that require superuser privileges,
 this is required to run some test applications under specific
 schedulers and priorities to test if psi does detect these correctly.
 To acquire superuser privileges sudo is used when available, falling
 back to "su -c".
 Some tests require superuser privileges and will be silently skipped
 when not running as root.  This is required to run test applications
 with specific schedulers and priorities.
 If any tests fail, please copy & paste the output and send operating
 system version, python version, python executable format (32/64-bit)

Up to file-list setup.py:

@@ -62,9 +62,14 @@ more see the docstrings for detailed inf
 Some information may not be available on all platforms, rather then
 trying to emulate this information these parts of the API just don't
-exist on those platforms.  Examples of these are:
+exists on those platforms.  Examples of these are:
 ``psi.process.Process.pcpu`` which is not available on Linux,
 ``psi.getzoneid()`` which is only available on SunOS 10 and above etc.
 If not all information can be found some attribute descriptors of
 objects might return subclasses of AttributeError, allowing you to use
 generic ``getattr()`` semantics as well as more specifically detect why
 an attribute is not available (insufficient privileges, not
 implemented, ...).
 Supported Platforms
@@ -402,7 +407,9 @@ class TestCommand(Command):
         sysconfig.customize_compiler(self.cc)
         self.compile_ctests()
         if os.uname()[0] == 'AIX':
-            self.compile_aix_ctest()
+            self.compile_aix_ctestx()
         if os.uname()[0] == 'Linux':
             self.compile_linux_ctests()
         sys.path.insert(0, self.build_purelib)
         sys.path.insert(0, self.build_platlib)
         tdir = os.path.join(self._dir, 'tests')
@@ -463,7 +470,7 @@ class TestCommand(Command):
         except LinkError:
             distutils.log.warn('app64 not built, some tests will be skipped')
-    def compile_aix_ctest(self):
+    def compile_aix_ctests(self):
         """Compile AIX specific helper executables from C"""
         if not distutils.dep_util.newer('tests/aixapp.c', 'tests/aixapp'):
             distutils.log.info('AIX helper app is up-to-date')
@@ -471,6 +478,16 @@ class TestCommand(Command):
         distutils.log.info('compiling AIX helper app for tests')
         self.cc.link_executable(['tests/aixapp.c'], 'tests/aixapp')
     def compile_linux_ctests(self):
         """Compile Linux specific helper executables from C"""
         if not distutils.dep_util.newer('tests/linux_argvapp.c',
                                         'tests/linux_argvapp'):
             distutils.log.info('Linux helper app is up-to-data')
             return
         distutils.log.info('compiling Linux helper app for tests')
         self.cc.link_executable(['tests/linux_argvapp.c'],
                                 'tests/linux_argvapp')
 class ValgrindCommand(Command):
     description = "runs valgrind on test suite using /opt/pydebug/bin/python"
@@ -514,10 +531,11 @@ class CleanCommand(clean):
                 for f in files:
                     if f.endswith('.pyc'):
                         self._clean_me.append(os.path.join(root, f))
         if os.path.exists(os.path.join('tests', 'app32')):
             self._clean_me.append(os.path.join('tests', 'app32'))
         if os.path.exists(os.path.join('tests', 'app64')):
             self._clean_me.append(os.path.join('tests', 'app64'))
         f = lambda x: os.path.join('tests', x)
         helper_apps = map(f, ('app32', 'app64', 'aixapp', 'linux_argvapp'))
         for app in helper_apps:
             if os.path.exists(app):
                 self._clean_me.append(app)
         clean.finalize_options(self)
     def run(self):

commit 521:	d58144bcce28
parent 515:	9f3299e624b1
parent 520:	158df70b9984
branch:	hostmodule

chrismiles / psi (http://pypi.python.org/pypi/PSI)