File: with.rst

package info (click to toggle)
python-sh 2.2.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 900 kB
  • sloc: python: 4,157; makefile: 25
file content (28 lines) | stat: -rw-r--r-- 642 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
.. _with_contexts:

'With' Contexts
===============

Commands can be run within a Python ``with`` context.  Popular commands using
this might be ``sudo`` or ``fakeroot``:

.. code-block:: python

	with sh.contrib.sudo:
	    print(ls("/root"))

.. seealso::

    :ref:`contrib_sudo`
		
If you need to run a command in a with context and pass in arguments, for
example, specifying a -p prompt with sudo, you need to use the :ref:`_with=True
<with>` This let's the command know that it's being run from a with context so
it can behave correctly:

.. code-block:: python

	with sh.contrib.sudo(k=True, _with=True):
	    print(ls("/root"))