Python interface to Sandboxie.
Project description
sandboxie is a Python interface to Sandboxie.
Quickstart
>>> import sandboxie >>> sbie = sandboxie.Sandboxie()
Create a sandbox:
>>> sbie.create_sandbox(box='foo', options={'Enabled': 'yes'})
Start a sandboxed process:
>>> sbie.start('notepad.exe', box='foo', wait=False)
Get sandboxed processes:
>>> for pid in sbie.running_processes(box='foo'): >>> print(pid) 3 15688 5716 26916
Terminate sandboxed processes:
>>> sbie.terminate_processes(box='foo')
Delete the contents of a sandbox:
>>> sbie.delete_contents(box='foo')
Destroy a sandbox:
>>> sbie.destroy_sandbox(box='foo')
Installation
The preferred way is to use pip:
$ pip install sandboxie
You can also use easy_install, but it’s discouraged.
Supported Python versions
Python 2.7 and 3.2 are currently supported from a single codebase, without 2to3 translation.
Contribute
The code repository is on GitHub: https://github.com/gg/sandboxie-py.
To contribute:
Work on an open issue or submit a new issue to start a discussion around a bug or feature request.
- When submitting a bug, ensure your description includes the following:
the version of sandboxie used
any relevant system information, such as your operating system
steps to produce the bug (so others could reproduce it)
Fork the repository and add the bug fix or feature to the develop branch.
Write tests that demonstrate the bug was fixed or the feature works as expected.
Submit a pull request and bug the maintainer until your contribution gets merged and published :-) You should also add yourself to AUTHORS.
Running the Tests
tox is used to run unit and integration tests in each of the supported Python environments.
First install tox:
$ pip install tox
Then run tox from the project root directory:
$ tox
Note: the integration tests require Sandboxie to be installed on your machine.
Coding Style
Ensure that your contributed code complies with PEP 8. The test runner tox also checks for PEP 8 compliance.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.