Skip to main content

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.

Metadata

Release files for sandboxie 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sandboxie 0.2.0
File Size Uploaded
sandboxie-0.2.0.zip 8.5 kB Details

Release files / sandboxie-0.2.0.zip

Download URL sandboxie-0.2.0.zip
Size 8.5 kB
Tags Source
SHA-256 checksum
How to use checksums
e4579f3403c27fd22cc0c72c9400ef429504b55cea5d42562893651b1335a3cf
BLAKE2b-256 checksum
How to use checksums
a8298659b1d393799722dd3da4aad61f2e9e3ba745d6651238fdb0467a8a6642
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.0 This release

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page