Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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:

  1. 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)
  2. Fork the repository and add the bug fix or feature to the develop branch.

  3. Write tests that demonstrate the bug was fixed or the feature works as expected.

  4. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sandboxie, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size sandboxie-0.2.0.zip (8.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page