Module: utils.sysinfo — IPython 2.3.1 documentation

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »

# Module: `utils.sysinfo`

Utilities for getting information about IPython and the system it’s running in.

## 5 Functions

`IPython.utils.sysinfo.` `pkg_commit_hash`(pkg_path)

  Get short form of commit hash given directory pkg_path

  We get the commit hash from (in order of preference):

  - IPython.utils._sysinfo.commit
  - git output, if we are in a git repository

  If these fail, we return a not-found placeholder tuple

  Parameters: | pkg_path : str directory containing package only used for getting commit from active repo
  Returns: | hash_from : str Where we got the hash from - description hash_str : str short form of hash

`IPython.utils.sysinfo.` `pkg_info`(pkg_path)

  Return dict describing the context of this package

  Parameters: | pkg_path : str path containing __init__.py for package
  Returns: | context : dict with named parameters of interest

`IPython.utils.sysinfo.` `get_sys_info`()

  Return useful information about IPython and the system, as a dict.

`IPython.utils.sysinfo.` `sys_info`()

  Return useful information about IPython and the system, as a string.

  Examples

      In [2]: print sys_info()
      {'commit_hash': '144fdae',      # random
       'commit_source': 'repository',
       'ipython_path': '/home/fperez/usr/lib/python2.6/site-packages/IPython',
       'ipython_version': '0.11.dev',
       'os_name': 'posix',
       'platform': 'Linux-2.6.35-22-generic-i686-with-Ubuntu-10.10-maverick',
       'sys_executable': '/usr/bin/python',
       'sys_platform': 'linux2',
       'sys_version': '2.6.6 (r266:84292, Sep 15 2010, 15:52:39) \n[GCC 4.4.5]'}

`IPython.utils.sysinfo.` `num_cpus`()

  Return the effective number of CPUs in the system as an integer.

  This cross-platform function makes an attempt at finding the total number of available CPUs in the system, as returned by various underlying system and python calls.

  If it can’t find a sensible answer, it returns 1 (though an error may make it return a large positive number that’s actually incorrect).

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »