Skip to main content

Python wrapper around the simctl utility

Project description

isim

Python Version Xcode 15.0

This is a Python wrapper around the xcrun simctl utility that Apple provides for interacting with the various Xcode developer tools.

xcrun simctl is the tool for interacting with the iOS simulator and is the main focus of this module. The syntax is designed to remain as close to that which would be used on the command line as possible. For example, to list all runtimes on the command line you would do:

xcrun simctl list runtimes

With this module you can simply do:

from isim import Runtime
print(Runtime.list_all())

Most functions are on the item that they affect. So instead of running something on a device like:

xcrun simctl do_thing <DEVICE_ID> arg1 arg2 ...

You can do this:

from isim import Device
iPhone7 = Device.from_name("iPhone 7")
iPhone7.do_thing(arg1, arg2, ...)

Testing

To run the tests, all you need to do is run python -m pytest tests from the root directory.

isim and Xcode Versioning

isim follows the current supported version of Xcode for its version scheme.

For example, if the currently supported version of Xcode is 11, then isim will be versioned as 11.minor.patch. The minor version will only be increased if there is a breaking change in Xcode requiring it (which is unlikely). The patch version will be increased with each patch that is made.

There is no expectation of backwards compatibility. If you need to support an older version of Xcode, you'll almost always need an older major version.

Note: The Xcode developer tools are installed with new betas. That means that if you are running Xcode 10.2.1, but then install the Xcode 11 beta, the simulator tools will be for Xcode 11, rather than Xcode 10, even if you run xcode-select -s. That means that as soon as you install a beta on your machine, you will need to use that version of isim.

Project details


Download files

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

Source Distribution

isim-16.1.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

isim-16.1.0-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

Details for the file isim-16.1.0.tar.gz.

File metadata

  • Download URL: isim-16.1.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.5 CPython/3.12.11 Darwin/24.5.0

File hashes

Hashes for isim-16.1.0.tar.gz
Algorithm Hash digest
SHA256 7402a972fc5128312b20293c429e3be0b79c368075d45fd3c3ba46418ee4edba
MD5 e16f3b0b1f2d71fb1b3e5ada1ee42828
BLAKE2b-256 820320eb1bd2a4ede951d5fd79c0273dd8c30d6268c1f84ac39473ec1ec0c4d4

See more details on using hashes here.

File details

Details for the file isim-16.1.0-py3-none-any.whl.

File metadata

  • Download URL: isim-16.1.0-py3-none-any.whl
  • Upload date:
  • Size: 13.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.5 CPython/3.12.11 Darwin/24.5.0

File hashes

Hashes for isim-16.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6f23179162c922ac8de5f5df340d397bb06c2218e263631ea94f605a5486ada6
MD5 dd27bc9858f17fed04b5488cab499f4c
BLAKE2b-256 5633c62ee3419bc4d84eef0790db179cefa5393f958aa24928f34ab4b9987046

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page