{
    "info": {
        "author": "Facebook",
        "author_email": "callumryan@fb.com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3.6"
        ],
        "description": "# idb\n\n![idb logo](docs/assets/idb_logo_color.jpg)\n\nThe \u201ciOS Development Bridge\u201d or `idb`, is a command line interface for automating iOS Simulators and Devices for development. It has three main goals:\n\n* *Remote Automation.* `idb` has a \u201ccompanion\u201d that runs on macOS and a python client and cli that runs anywhere. This enables scenarios such as a \u201cDevice Lab\u201d within a Data Center or fanning out commands to large numbers of iOS Simulators.\n* *Simple Primitives.* `idb` exposes granular APIs that enable building more sophisticated workflows on top. This means you can use `idb` from an IDE or build an automated testing scenario that is more than just running a set of tests. All of these primitives are consistent across OS Versions and between Simulators and Devices. The cli is intended to also be easy to use for humans as well as automation, as such it provides terse and self-documenting commands.\n* *Exposing missing functionality.* Xcode has a number of features that aren't available outside it's own UI. `idb` exposes many of these features so that they can be used within other GUI-less automation.\n\n`idb` is largely built from the `FBSimulatorControl` and `FBDeviceControl` Frameworks, contained within this repository. These Frameworks can be used independently of `idb`, but `idb` is likely to provide the simplest install and the most sensible defaults for most users.\n\nWe've given a talk about `idb` at F8, so that you can learn a bit more about what `idb` is and why we built it. A [recording of the talk is available here](https://developers.facebook.com/videos/2019/reliable-code-at-scale/).\n\n## Quick Start\n**Under Construction**\nplease bear with us. the quick start steps might not be working for you yet.\n\n`idb` is made up of 2 parts, each of which needs to be installed separately.\n\n### `idb` companion\n\nEach target (simulator/device) will have a companion process attached allowing `idb` to communicate remotely.\n\nThe `idb` companion can be installed via brew or built from [source](https://github.com/facebook/idb)\n```\nbrew tap facebook/fb\nbrew install idb-companion\n```\nNote: Instructions on how to install brew can be found [here](https://brew.sh)\n\n### `idb` client\n\nA cli tool and python client is provided to interact with `idb`.\n\nIt can be installed via pip:\n```\npip3.6 install fb-idb\n```\nNote: The idb client requires python 3.6 or greater to be installed.\n\nPlease refer to [fbidb.io](https://www.fbidb.io/) for detailed installation instructions and a guided tour of idb.\n\nOnce installed, just run the list-targets command which will show you all the simulators installed on your system:\n\n```\n$ idb list-targets\n...\niPhone X | 569C0F94-5D53-40D2-AF8F-F4AA5BAA7D5E | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone Xs | 2A1C6A5A-0C67-46FD-B3F5-3CB42FFB38B5 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone Xs Max | D3CF178F-EF61-4CD3-BB3B-F5ECAD246310 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\niPhone X\u0280 | 74064851-4B98-473A-8110-225202BB86F6 | Shutdown | simulator | iOS 12.2 | x86_64 | No Companion Connected\n...\n```\n\n`list-apps` will show you all the apps installed in a simulator:\n\n```\n$ idb list-apps --udid 74064851-4B98-473A-8110-225202BB86F6\ncom.apple.Maps | Maps | system | x86_64 | Not running | Not Debuggable\ncom.apple.MobileSMS | MobileSMS | system | x86_64 | Not running | Not Debuggable\ncom.apple.mobileslideshow | MobileSlideShow | system | x86_64 | Not running | Not Debuggable\ncom.apple.mobilesafari | MobileSafari | system | x86_64 | Not running | Not Debuggable\n```\n\n`launch` will launch an application the application:\n\n```\n$ idb launch com.apple.mobilesafari\n```\n\nHead over [here](https://www.fbidb.io) for more details on what you can do with idb and the full list of commands.\n\n## Building from Source\n\n`idb` is made up of 2 parts.\n\nTo build the python part make sure you are in the root of the repo and run:\n\n```\npip3 install .\n```\n\nTo build the objective-c/c++ part:\n\nMake sure you have installed gRPC dependencies: ```brew tap grpc/grpc && brew install grpc```\n\n```\nopen idb_companion.xcworkspace\n```\n\nThis will open an xcode project that you can build and run.\n\n## Documentation\n\nFind the full documentation for this project at [fbidb.io](https://www.fbidb.io/)\n\n## Contributing\n\nWe've released `idb` because it's a big part of how we scale iOS automation at Facebook. We hope that others will be able to benefit from the project where they may have needs that aren't currently serviced by the standard Xcode toolchain.\n\n## Code of Conduct\n\nFacebook has adopted a Code of Conduct that we expect project participants to adhere to. Please [read the full text](https://code.fb.com/codeofconduct) so that you can understand what actions will and will not be tolerated.\n\n## Contributing Guide\n\nRead our [contributing guide](.github/CONTRIBUTING.md) to learn about our development process.\n\n## License\n\n[`idb` is MIT-licensed](LICENSE).\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/facebook/idb",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "fb-idb",
        "package_url": "https://pypi.org/project/fb-idb/",
        "platform": "",
        "project_url": "https://pypi.org/project/fb-idb/",
        "project_urls": {
            "Homepage": "https://github.com/facebook/idb"
        },
        "release_url": "https://pypi.org/project/fb-idb/0.0.7/",
        "requires_dist": [
            "aiofiles",
            "grpclib",
            "protobuf"
        ],
        "requires_python": ">=3.6",
        "summary": "iOS debug bridge",
        "version": "0.0.7"
    },
    "last_serial": 5731883,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "14f32c274214f6eccff285febfe225a2",
                    "sha256": "930bd4b13940594fc5fb10406929cfa54e3456946602e8582e3934eb21cbf86c"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "14f32c274214f6eccff285febfe225a2",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 121773,
                "upload_time": "2019-04-26T18:11:52",
                "url": "https://files.pythonhosted.org/packages/49/05/68e95281e52c447bd88f672ea0bfa3032e5592746f9fa5528d62a1d3725f/fb_idb-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "c64318bcca8572c912b69710f50398e2",
                    "sha256": "1c7129c81c970d60822600f8117ac87dea04f2e2c66561901ca92bf01f1f87e4"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "c64318bcca8572c912b69710f50398e2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 55860,
                "upload_time": "2019-04-26T18:12:08",
                "url": "https://files.pythonhosted.org/packages/ef/e6/4bcc8e3d3c3a718f1c9d5d16476bac22fab8ffeeebab8622dc5bd4e703a0/fb-idb-0.0.1.tar.gz"
            }
        ],
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c8793a2fb09499957dbadcaaa3a0317c",
                    "sha256": "dc4d3b0d9cbce2708ebe10e8b3798593e3f6449e75093bbaa21a0cb2b76994f3"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "c8793a2fb09499957dbadcaaa3a0317c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 124467,
                "upload_time": "2019-04-27T19:45:27",
                "url": "https://files.pythonhosted.org/packages/7e/e3/d7970cb21d56a2d104b59df8138c1b5aaf4b9a1d6a1d814e2217b7bc186e/fb_idb-0.0.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "89e1d0fcf946cd6299229871b85b839e",
                    "sha256": "86ba80b5630f7cbc3c18f394b1fd65a9536d7de67e02f2a43b0729d88f71bb1c"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "89e1d0fcf946cd6299229871b85b839e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56311,
                "upload_time": "2019-04-27T19:45:30",
                "url": "https://files.pythonhosted.org/packages/0d/18/0de9c65057ce2939d732a43ed53af0c3450240dcf16e03f500fc1d550cfb/fb-idb-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "cb4c024715a766d20457367a60a01795",
                    "sha256": "5a5d7fffecbe4f56138478b096b70548a3fd49b853d93cc8d3caed9f6ad35dfc"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "cb4c024715a766d20457367a60a01795",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 124781,
                "upload_time": "2019-04-28T21:07:39",
                "url": "https://files.pythonhosted.org/packages/df/9a/d1c296db025e911a8896f6b648b9e961cb52c2c5cf25c2c107ec1b4a0340/fb_idb-0.0.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "8fe894e27e59c8f55b37b3f5b123a203",
                    "sha256": "ab5e27de9049a6859adee0dd2575dc8091b8e752199722412bbb52bd0dd93878"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "8fe894e27e59c8f55b37b3f5b123a203",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56472,
                "upload_time": "2019-04-28T21:07:43",
                "url": "https://files.pythonhosted.org/packages/b4/6f/579212c5fc42762bfd795d66ce01df647d34ad8433b937a906b3589b9d69/fb-idb-0.0.3.tar.gz"
            }
        ],
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8159fcdb3ae4649a3fbd33f3a1687c8c",
                    "sha256": "816840aaac4a792d3b963f53b45e8750898c8b4defee55133de39841f9eefdf6"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "8159fcdb3ae4649a3fbd33f3a1687c8c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 122749,
                "upload_time": "2019-04-29T20:58:10",
                "url": "https://files.pythonhosted.org/packages/d2/c4/2731f7e7366a92531613361c4eaea6e58f0f48772d1c13a617eca02ddc4a/fb_idb-0.0.4-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "61add803d0b732f53f8336aadcd6fa08",
                    "sha256": "445583795e38fa6c2412f695ab0b7ddcab397c83ca9e3e781b00f57e302ac6ae"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "61add803d0b732f53f8336aadcd6fa08",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56909,
                "upload_time": "2019-04-29T20:58:14",
                "url": "https://files.pythonhosted.org/packages/12/ac/d201d7ccf4451170ee65e1333f3e458254f8fda15fb2e6310f8126aedd0d/fb-idb-0.0.4.tar.gz"
            }
        ],
        "0.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "52de7e70303f85ead3b8b2c8845a41ca",
                    "sha256": "9fc8a64489fc6425fadfc32af45bed48558659354692d3a2f94ab433243dddf7"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "52de7e70303f85ead3b8b2c8845a41ca",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 124981,
                "upload_time": "2019-04-29T22:52:54",
                "url": "https://files.pythonhosted.org/packages/3e/48/99284cb5e80614f809949f7202785c46700bb0d5f5a7d5f958d78fb8213f/fb_idb-0.0.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ecbbb4efd64e5fb29f698be1ea5afc2d",
                    "sha256": "3a4cb7f72d38912f7cb95aa82989f0ff20c8ad066b2c765f3c3b555b8451ed8d"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "ecbbb4efd64e5fb29f698be1ea5afc2d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56589,
                "upload_time": "2019-04-29T22:52:58",
                "url": "https://files.pythonhosted.org/packages/c8/a1/e7ca8c13dcdcc15a61d8f3454ea0f531ca6ea517cc594458fa2bb91dfcd2/fb-idb-0.0.5.tar.gz"
            }
        ],
        "0.0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "418010b0ffc795724aae9c152fc21028",
                    "sha256": "0716961ea8e4a34365c9030a05eded02ccff9ada36ca795081385742ade0bc5a"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.6-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "418010b0ffc795724aae9c152fc21028",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 125172,
                "upload_time": "2019-05-01T01:21:28",
                "url": "https://files.pythonhosted.org/packages/72/c9/48a748621116daae61eab4ccb03623c3cec817dbd62919b1efd4f9c794bd/fb_idb-0.0.6-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "28fd0a97b24f00666686ddf6f54a1573",
                    "sha256": "f4c3bd33f9be2d908cbf0d74f6e528f2ca49eb4a57d4d90d5aa6b5875565dbc4"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "28fd0a97b24f00666686ddf6f54a1573",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56777,
                "upload_time": "2019-05-01T01:21:30",
                "url": "https://files.pythonhosted.org/packages/5c/84/c72046b7f08ab5dcc71a3325ee718e046884f9a70029d8d8e8ab6dd6256e/fb-idb-0.0.6.tar.gz"
            }
        ],
        "0.0.7": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "2243d9722d6d863f6de40222555ceb48",
                    "sha256": "b573ba79095f42d2a66a543ff61d829ecb06417c1ebefca6d3f3f8c03112ba9d"
                },
                "downloads": -1,
                "filename": "fb_idb-0.0.7-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "2243d9722d6d863f6de40222555ceb48",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 108720,
                "upload_time": "2019-08-26T16:24:35",
                "url": "https://files.pythonhosted.org/packages/a8/41/b8b497f7fd041adab6c14034747ea29ad4c74f6d039f09718e8f89ea32a9/fb_idb-0.0.7-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "aa4708b6b25f846cf1e9f395d5d825bb",
                    "sha256": "47535471766b3bcee88ee3d45dc7448cac91d8a15d53db62f40ed6725dee6f30"
                },
                "downloads": -1,
                "filename": "fb-idb-0.0.7.tar.gz",
                "has_sig": false,
                "md5_digest": "aa4708b6b25f846cf1e9f395d5d825bb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 56159,
                "upload_time": "2019-08-26T16:24:37",
                "url": "https://files.pythonhosted.org/packages/4a/09/a24a975099b3d9acb826f9ebf56197c312343bb06ba659b51a4751e70875/fb-idb-0.0.7.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "2243d9722d6d863f6de40222555ceb48",
                "sha256": "b573ba79095f42d2a66a543ff61d829ecb06417c1ebefca6d3f3f8c03112ba9d"
            },
            "downloads": -1,
            "filename": "fb_idb-0.0.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2243d9722d6d863f6de40222555ceb48",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 108720,
            "upload_time": "2019-08-26T16:24:35",
            "url": "https://files.pythonhosted.org/packages/a8/41/b8b497f7fd041adab6c14034747ea29ad4c74f6d039f09718e8f89ea32a9/fb_idb-0.0.7-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "aa4708b6b25f846cf1e9f395d5d825bb",
                "sha256": "47535471766b3bcee88ee3d45dc7448cac91d8a15d53db62f40ed6725dee6f30"
            },
            "downloads": -1,
            "filename": "fb-idb-0.0.7.tar.gz",
            "has_sig": false,
            "md5_digest": "aa4708b6b25f846cf1e9f395d5d825bb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 56159,
            "upload_time": "2019-08-26T16:24:37",
            "url": "https://files.pythonhosted.org/packages/4a/09/a24a975099b3d9acb826f9ebf56197c312343bb06ba659b51a4751e70875/fb-idb-0.0.7.tar.gz"
        }
    ]
}