| TODO |
| ==== |
| |
| A collection of ideas and notes about stuff to implement in future versions. |
| "#NNN" occurrences refer to bug tracker issues at: |
| https://github.com/giampaolo/psutil/issues |
| |
| |
| HIGHER PRIORITY |
| =============== |
| |
| * OpenBSD support. |
| |
| * #371: CPU temperature (apparently OSX and Linux only; on Linux it requires |
| lm-sensors lib). |
| |
| * #269: expose network ifaces RX/TW queues. This should probably go into |
| net_if_stats(). Figure out on what platforms this is supported: |
| Linux: yes |
| Others: ? |
| |
| * Process.threads(): thread names; patch for OSX available at: |
| https://code.google.com/p/plcrashreporter/issues/detail?id=65 |
| |
| * Asynchronous psutil.Popen (see http://bugs.python.org/issue1191964) |
| |
| * (Windows) fall back on using WMIC for Process methods returning AccessDenied |
| |
| * #613: thread names. |
| |
| * #604: emulate os.getloadavg() on Windows |
| |
| * #269: NIC rx/tx queue. |
| |
| |
| LOWER PRIORITY |
| ============== |
| |
| * #355: Android support. |
| |
| * #276: GNU/Hurd support. |
| |
| * #429: NetBSD support. |
| |
| * DragonFlyBSD support? |
| |
| * AIX support? |
| |
| * examples/taskmgr-gui.py (using tk). |
| |
| * system-wide number of open file descriptors: |
| * https://jira.hyperic.com/browse/SIGAR-30 |
| * http://www.netadmintools.com/part295.html |
| |
| * Number of system threads. |
| * Windows: http://msdn.microsoft.com/en-us/library/windows/desktop/ms684824(v=vs.85).aspx |
| |
| * #357: what CPU a process is on. |
| |
| * Doc / wiki which compares similarities between UNIX cli tools and psutil. |
| Example: |
| df -a -> psutil.disk_partitions |
| lsof -> psutil.Process.open_files() and psutil.Process.open_connections() |
| killall-> (actual script) |
| tty -> psutil.Process.terminal() |
| who -> psutil.users() |
| |
| |
| DEBATABLE |
| ========= |
| |
| * psutil.proc_tree() something which obtains a {pid:ppid, ...} dict for |
| all running processes in one shot. This can be factored out from |
| Process.children() and exposed as a first class function. |
| PROS: on Windows we can take advantage of _psutil_windows.ppid_map() |
| which is faster than iterating over all pids and calling ppid(). |
| CONS: examples/pstree.py shows this can be easily done in the user code |
| so maybe it's not worth the addition. |
| |
| * advanced cmdline interface exposing the whole API and providing different |
| kind of outputs (e.g. pprinted, colorized, json). |
| |
| * [Linux]: process cgroups (http://en.wikipedia.org/wiki/Cgroups). They look |
| similar to prlimit() in terms of functionality but uglier (they should allow |
| limiting per-process network IO resources though, which is great). Needs |
| further reading. |
| |
| * Should we expose OS constants (psutil.WINDOWS, psutil.OSX etc.)? |
| |
| * Python 3.3. exposed different sched.h functions: |
| http://docs.python.org/dev/whatsnew/3.3.html#os |
| http://bugs.python.org/issue12655 |
| http://docs.python.org/dev/library/os.html#interface-to-the-scheduler |
| It might be worth to take a look and figure out whether we can include some |
| of those in psutil. |
| Also, we can probably reimplement wait_pid() on POSIX which is currently |
| implemented as a busy-loop. |
| |
| * Certain systems provide CPU times about process children. On those systems |
| Process.cpu_times() might return a (user, system, user_children, |
| system_children) ntuple. |
| * Linux: /proc/{PID}/stat |
| * Solaris: pr_cutime and pr_cstime |
| * FreeBSD: none |
| * OSX: none |
| * Windows: none |
| |
| * ...also, os.times() provides 'elapsed' times as well. |
| |
| * ...also Linux provides guest_time and cguest_time. |
| |
| * Enrich exception classes hierarchy on Python >= 3.3 / post PEP-3151 so that: |
| - NoSuchProcess inherits from ProcessLookupError |
| - AccessDenied inherits from PermissionError |
| - TimeoutExpired inherits from TimeoutError (debatable) |
| See: http://docs.python.org/3/library/exceptions.html#os-exceptions |
| |
| * Process.threads() might grow an extra "id" parameter so that it can be |
| used as such: |
| |
| >>> p = psutil.Process(os.getpid()) |
| >>> p.threads(id=psutil.current_thread_id()) |
| thread(id=2539, user_time=0.03, system_time=0.02) |
| >>> |
| |
| Note: this leads to questions such as "should we have a custom NoSuchThread |
| exception? Also see issue #418. |
| |
| Note #2: this would work with os.getpid() only. |
| psutil.current_thread_id() might be desirable as per issue #418 though. |
| |
| * should psutil.TimeoutExpired exception have a 'msg' kwarg similar to |
| NoSuchProcess and AccessDenied? Not that we need it, but currently we |
| cannot raise a TimeoutExpired exception with a specific error string. |
| |
| * process_iter() might grow an "attrs" parameter similar to Process.as_dict() |
| invoke the necessary methods and include the results into a "cache" |
| attribute attached to the returned Process instances so that one can avoid |
| catching NSP and AccessDenied: |
| for p in process_iter(attrs=['cpu_percent']): |
| print(p.cache['cpu_percent']) |
| This also leads questions as whether we should introduce a sorting order. |
| |
| * round Process.memory_percent() result? |
| |
| * #550: number of threads per core. |
| |
| * Have psutil.Process().cpu_affinity([]) be an alias for "all CPUs"? |
| |
| |
| COMPATIBILITY BREAKAGE |
| ====================== |
| |
| Removals (will likely happen in 2.2): |
| |
| * (S) psutil.Process.nice (deprecated in 0.5.0) |
| * (S) get_process_list (deprecated in 0.5.0) |
| * (S) psutil.*mem* functions (deprecated in 0.3.0 and 0.6.0) |
| * (M) psutil.network_io_counters (deprecated in 1.0.0) |
| * (M) local_address and remote_address Process.connection() namedtuple fields |
| (deprecated in 1.0.0) |
| |
| |
| REJECTED IDEAS |
| ============== |
| |
| STUB |
