{ "info": { "author": "Mozilla Automation and Testing Team", "author_email": "tools@lists.mozilla.org", "bugtrack_url": null, "classifiers": [], "description": "==================\nFxOS App Generator\n==================\n\nA tool to generate, and optionally install, an FxOS application with any given\npermissions.\n\nYou can install this package from pypi as 'fxos_appgen'.\n\nRequirements\n============\n\nYou must have 'adb' installed.\nIf you need to install adb, see\nhttps://developer.mozilla.org/en-US/Firefox_OS/Debugging/Installing_ADB.\n\nOnce installed, add adb to your PATH in your ~/.bashrc\nor equivalent file, by adding the following line to the file\n(replacing $SDK_HOME with the location of the android sdk):\n\n PATH=$SDK_HOME:$PATH\n\nYour phone must have Marionette installed on it and running on port 2828. If\nyour phone does not have Marionette installed, you can install it using this\nrepository: https://github.com/mozilla-b2g/marionette-extension\n\nTo forward Marionette's port to 2828, run::\n\n adb forward tcp:2828 tcp:2828\n\nSetup\n=====\n\nYou should set up and run this tool inside a virtual environment. From the\nroot directory of your source checkout, run::\n\n virtualenv venv\n\nThen activate the virtualenv::\n\n source bin/activate\n\nTo install::\n\n python setup.py install\n\nUsage\n=====\n\nOnce installed, you will have access to 'fxos_appgen' from the command line.\n\nYou can run it like so::\n\n fxos_appgen [options] app_name details_file\n\nBy default, it assumes 'adb' is on your path and will generate a v1.3 certified\napp named 'app.zip' in your current working directory. It will not install the\napp by default.\n\nTo modify this behaviour, use the options listed here::\n\n fxos_appgen --help\n\nYou can also use its API as python package. For example, if you wish to\ngenerate and install a simple, all permissions app::\n\n from fxos_appgen import generate_app\n generate_app(\"My App\", install=True, version=\"1.3\", all_perm=True)\n\nPlease see https://github.com/mozilla-b2g/fxos-appgen/blob/master/fxos_appgen/generator.py\nto learn about the API available.\n\nDetails File\n================\n\nThe details_file must contain the permissions, and may contain the optional\ndata.\n\nThis file is required, unless you use the --all-permissions option. If you use \n--all-permissions, then you may pass in this file to define the other optional\nfields, but the 'permissions' section of the details_file will be ignored.\n\nPermissions (required unless --all-permissions option is used)\n----------------------\n\nTo set permissions on your application, you need to pass in a JSON file \ncontaining the permissions you wish to include.\n\nUnder the reference/ folders, you'll find complete_permissions.json files.\nThese files contain the full list of permissions available for their respective\nFxOS versions. Use these files as references for your own permissions file.\n\nFor example, if I wanted to have an app with only \"read\" access to \"contacts\"\nfor v1.3, my permissions file will only contain this::\n {\n \"permissions\": {\n \"contacts\":{ \"access\": \"readonly\" },\n }\n }\n\nThe \"access\" options take either \"readonly\", \"readwrite\", \"readcreate\" and\n\"createonly\".\n\nFor more information on permissions, please see \nhttps://developer.mozilla.org/en-US/Apps/Build/App_permissions\n\nSystem Messages (optional)\n-------------------------\n\nCertain permissions require you to direct system messages to a particular page\nin your app. For example, if you have \"sms\" as a permission, then you likely\nwant your app to listen for \"sms-delivery-success\", which will tell your app\nthat the sms was sent successfully.\n\nBy default, if you specify a permission that has related system messages,\nthe app generated will assigned its messages to be received at the\nlaunch_path. If you would like to change where the messages get received,\nthen you can add a \"messages\" section to your permissions file and direct\nthe messages the way you like. Here's an example::\n\n {\n \"permissions\": {\n \"sms\": {}\n },\n \"messages\": [\n { \"sms-delivery-success\": \"/index.html\" }\n ]\n }\n\nFor v1.3 builds:\nhttps://mxr.mozilla.org/mozilla-b2g28_v1_3/source/dom/messages/SystemMessagePermissionsChecker.jsm#29\nand\nhttps://github.com/mozilla-b2g/gaia/blob/v1.3/apps/settings/resources/permissions_table.json\n\nFor trunk builds:\nhttps://mxr.mozilla.org/mozilla-central/source/dom/messages/SystemMessagePermissionsChecker.jsm#29 \nand\nhttps://github.com/mozilla-b2g/gaia/blob/master/apps/settings/resources/permissions_table.json\n\nDatastore Access (optional)\n--------------------------\n\nIf your app needs access to a datastore, please add it to your permissions\nfile as either \"datastore-owned\" or \"datastore-access\" as needed, like so::\n\n {\n \"permissions\": {\n \"sms\": {}\n },\n \"messages\": [\n { \"sms-delivery-success\": \"/index.html\" }\n ],\n \"datastores-owned\": {\n \"download_store\": {\n \"access\": \"readwrite\",\n \"description\": \"Stores successful downloads\"\n }\n }\n }\n\nDescription (optional)\n----------------------\n\nYou may customize the description of your app. Add a \"description\" section\nto your permissions file with the desired text. Example::\n {\n \"permissions\": {\n \"sms\": {}\n },\n \"description\": \"My test application\"\n }\n\nBy default, we provide the description for your app as \"Generated app\".\n", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mozilla-b2g/fxos-certsuite", "keywords": "mozilla", "license": "MPL", "maintainer": null, "maintainer_email": null, "name": "fxos_appgen", "package_url": "https://pypi.org/project/fxos_appgen/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/fxos_appgen/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/mozilla-b2g/fxos-certsuite" }, "release_url": "https://pypi.org/project/fxos_appgen/0.15/", "requires_dist": null, "requires_python": null, "summary": "Generates and installs FxOS apps", "version": "0.15" }, "last_serial": 1765715, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "09b5f351f0944556d6859fa00e25810d", "sha256": "55f1788ff67f1cec59074c2c29227ff05b7b366e5c7132ebb51c8491b2a0cabf" }, "downloads": -1, "filename": "fxos_appgen-0.1.tar.gz", "has_sig": false, "md5_digest": "09b5f351f0944556d6859fa00e25810d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6610, "upload_time": "2014-03-25T01:31:35", "url": "https://files.pythonhosted.org/packages/43/77/08c8dd37343ef76c962b028c12d3d7d15847143697a9d0f4280a59f31f9b/fxos_appgen-0.1.tar.gz" } ], "0.10": [ { "comment_text": "", "digests": { "md5": "69044b4b7c72feeaa3eceeefcf011536", "sha256": "925934ef05b992a2cefaca56da6c864c5d98573cd701a8739c2e0851770800ff" }, "downloads": -1, "filename": "fxos_appgen-0.10.tar.gz", "has_sig": false, "md5_digest": "69044b4b7c72feeaa3eceeefcf011536", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8128, "upload_time": "2014-12-30T00:32:45", "url": "https://files.pythonhosted.org/packages/8d/32/3208e01666c3ed4bc5a742857fad3749fa7f23be5a1240444747b43490c2/fxos_appgen-0.10.tar.gz" } ], "0.11": [ { "comment_text": "", "digests": { "md5": "1e5d0bd5085baa7d01602292b034cbb3", "sha256": "52b2caf2dade65f443b76d4a59830cb863afa1bae48158118e40401ebb676f96" }, "downloads": -1, "filename": "fxos_appgen-0.11.tar.gz", "has_sig": false, "md5_digest": "1e5d0bd5085baa7d01602292b034cbb3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11285, "upload_time": "2015-01-06T23:29:41", "url": "https://files.pythonhosted.org/packages/ec/05/d96795e87b8f2bbf0d7aa10909816d6d55e6d6cb71fddaf63e489035e792/fxos_appgen-0.11.tar.gz" } ], "0.12": [ { "comment_text": "", "digests": { "md5": "fc656759b1606a273e7b9c859ec385f4", "sha256": "af34fc9584083f7deda1a55a253fb0d1f0c8059a28465d6cab9c18645744e7e4" }, "downloads": -1, "filename": "fxos_appgen-0.12.tar.gz", "has_sig": false, "md5_digest": "fc656759b1606a273e7b9c859ec385f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10617, "upload_time": "2015-01-20T22:08:55", "url": "https://files.pythonhosted.org/packages/d5/f3/f103ff35ec74856ff3f6cee0ad9affbef3a62c75589fc7cc684e63bcb7cc/fxos_appgen-0.12.tar.gz" } ], "0.13": [ { "comment_text": "", "digests": { "md5": "416d7ee065495489af83c731ae91ae9c", "sha256": "5761a2e8a1692c9f2cd3a8577d26de58a7a2fc3ee662c500d4d6252cad2924f5" }, "downloads": -1, "filename": "fxos_appgen-0.13.tar.gz", "has_sig": false, "md5_digest": "416d7ee065495489af83c731ae91ae9c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8455, "upload_time": "2015-03-13T09:00:56", "url": "https://files.pythonhosted.org/packages/e0/e8/61513c983592b090344327ce8ee5fc1de745179ebab601a6efd2256227d8/fxos_appgen-0.13.tar.gz" } ], "0.14": [ { "comment_text": "", "digests": { "md5": "5e65fe64e0ae19f5def969f27d15eb02", "sha256": "d3cc167fd2fa8e2decba4b41627f5eaeeb7e16a7996031e76e7773931b33ba05" }, "downloads": -1, "filename": "fxos_appgen-0.14.tar.gz", "has_sig": false, "md5_digest": "5e65fe64e0ae19f5def969f27d15eb02", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8575, "upload_time": "2015-07-30T10:19:07", "url": "https://files.pythonhosted.org/packages/2a/a2/0cd4f2b73b10708256eaa4c37359de195f3680981e659d2223560e92c21d/fxos_appgen-0.14.tar.gz" } ], "0.15": [ { "comment_text": "", "digests": { "md5": "3885e526fe5f7157fef060dde6064669", "sha256": "2966950ee29da073387915f0e0f11b10825bd147bd4a624936e6edcacc632b76" }, "downloads": -1, "filename": "fxos_appgen-0.15.tar.gz", "has_sig": false, "md5_digest": "3885e526fe5f7157fef060dde6064669", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10915, "upload_time": "2015-10-13T07:05:56", "url": "https://files.pythonhosted.org/packages/bd/c5/2f320fab8a3eb335fbb6f1b80d519ee9cc170845fc63b6bd6210457d2392/fxos_appgen-0.15.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "b09f4541730884d86b03636f0f5365bc", "sha256": "eb80b56d684757c83a02cf0aa6c93a2f1a656d3d5abe9de189dcc37473dbf0c7" }, "downloads": -1, "filename": "fxos_appgen-0.2.tar.gz", "has_sig": false, "md5_digest": "b09f4541730884d86b03636f0f5365bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6918, "upload_time": "2014-03-25T17:14:26", "url": "https://files.pythonhosted.org/packages/e6/72/cb5ccb1e45b6c7e307e02f84dcb8b0c3f044fa52d756629424bad14efcc9/fxos_appgen-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "bcf18128cc46ada0a2f1368a6a736d4f", "sha256": "c1a56f69c63240e9d002dc374ac69cace35263c9726c7a8c149fd790439f410e" }, "downloads": -1, "filename": "fxos_appgen-0.2.1.tar.gz", "has_sig": false, "md5_digest": "bcf18128cc46ada0a2f1368a6a736d4f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7007, "upload_time": "2014-04-10T17:38:51", "url": "https://files.pythonhosted.org/packages/1a/de/ab6f3b59c5f60c1d2b972c1a7a5cbde375c209ba4471d01e362662bcdb54/fxos_appgen-0.2.1.tar.gz" } ], "0.2.10": [ { "comment_text": "", "digests": { "md5": "419015eb39e9e0d38408d8ab171bf00d", "sha256": "5f55f767237d1ca3931c8cbe5636eb4247e033142cf404db300322cfccd6c5f6" }, "downloads": -1, "filename": "fxos_appgen-0.2.10.tar.gz", "has_sig": false, "md5_digest": "419015eb39e9e0d38408d8ab171bf00d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8172, "upload_time": "2014-06-03T20:07:35", "url": "https://files.pythonhosted.org/packages/4e/26/ea01c39439e22caf27a52247d372a874e7131c143f06aef5b6d366f22310/fxos_appgen-0.2.10.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "e97b705649c99233d6cbf3fa6163f7d8", "sha256": "139d195aeb9f35cd2ba71c97502d41cdf21ee302390736c94bf0a6a11dcc43cb" }, "downloads": -1, "filename": "fxos_appgen-0.2.2.tar.gz", "has_sig": false, "md5_digest": "e97b705649c99233d6cbf3fa6163f7d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7134, "upload_time": "2014-04-10T18:35:45", "url": "https://files.pythonhosted.org/packages/f1/f9/b7794b2bce41c094eade25c465f4de4b58984207cfac988036ccf6602910/fxos_appgen-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "df733227232a188e2e9e09b3a6247615", "sha256": "c7b6336d6e4d6a45d431d431370866215c0cb3a347c5b96aae882f002a55a953" }, "downloads": -1, "filename": "fxos_appgen-0.2.3.tar.gz", "has_sig": false, "md5_digest": "df733227232a188e2e9e09b3a6247615", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7418, "upload_time": "2014-04-15T18:54:10", "url": "https://files.pythonhosted.org/packages/75/20/3a60f6b288a9f24db399895d2911c13325b328030bf82867c57cd2797cfb/fxos_appgen-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "a53f95109bdffc1ee59722abf110adff", "sha256": "ac16b355385c13466d512fc30619b4de6dff5f35aef519f98e014145a54dcca1" }, "downloads": -1, "filename": "fxos_appgen-0.2.4.tar.gz", "has_sig": false, "md5_digest": "a53f95109bdffc1ee59722abf110adff", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7809, "upload_time": "2014-04-24T20:03:58", "url": "https://files.pythonhosted.org/packages/eb/ae/72d26e323fe0f7b3b516d23c55d5697766f5f7a26dcf4158ecab9cda2ef1/fxos_appgen-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "36ac0ae108fa60d374fa20ffb94381fd", "sha256": "bf7fb45183219278d3872ddce5db103c555901a8deb4eb12f1e968a1b2521079" }, "downloads": -1, "filename": "fxos_appgen-0.2.5.tar.gz", "has_sig": false, "md5_digest": "36ac0ae108fa60d374fa20ffb94381fd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7812, "upload_time": "2014-04-30T16:26:21", "url": "https://files.pythonhosted.org/packages/92/c4/8223f4a0c5b4408baf59a6742e6842dc8e78ce3bd756d9a209fc88fb5064/fxos_appgen-0.2.5.tar.gz" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "078fc8bb29969e8381dcbcf2aec12fcd", "sha256": "bf3e398c3aa54fcf4f2f12007bccfafd369591a68b30adb1f5d9391c3d1ffe67" }, "downloads": -1, "filename": "fxos_appgen-0.2.6.tar.gz", "has_sig": false, "md5_digest": "078fc8bb29969e8381dcbcf2aec12fcd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7787, "upload_time": "2014-04-30T18:11:46", "url": "https://files.pythonhosted.org/packages/e4/58/cba96f2059946a52ee6a305b7cfbdea3f8b40818eef3a4c4a21ae8fd82ba/fxos_appgen-0.2.6.tar.gz" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "a099602960bd1e40c751afaa5c231378", "sha256": "99770957e40f39b392dc5a9c7b3c57fc50313e281c3a3d8befb1bce81023fd12" }, "downloads": -1, "filename": "fxos_appgen-0.2.7.tar.gz", "has_sig": false, "md5_digest": "a099602960bd1e40c751afaa5c231378", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8264, "upload_time": "2014-05-09T20:17:57", "url": "https://files.pythonhosted.org/packages/46/01/75b2bd0e07e4721eecc6fabec2f9889132d82752cb5c87359adc45662808/fxos_appgen-0.2.7.tar.gz" } ], "0.2.9": [ { "comment_text": "", "digests": { "md5": "c1cec7f3bd09294786dbc012fc61614a", "sha256": "3d890f492c14c3a4acb1a3f0c48180ff1e5e3288edd56a929ee4ad806892a3bc" }, "downloads": -1, "filename": "fxos_appgen-0.2.9.tar.gz", "has_sig": false, "md5_digest": "c1cec7f3bd09294786dbc012fc61614a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8145, "upload_time": "2014-05-23T13:52:38", "url": "https://files.pythonhosted.org/packages/0d/ed/a01f3089467f35d24f55ef3826f3ecc06a011123865f1dff786338d6a2f1/fxos_appgen-0.2.9.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "c217ab0b876401929107480081449c1f", "sha256": "f97d34d10e25c732cd8e0d0b0f7f846cbd361efb53b7e2ef17366c63a1ee542d" }, "downloads": -1, "filename": "fxos_appgen-0.3.tar.gz", "has_sig": false, "md5_digest": "c217ab0b876401929107480081449c1f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8125, "upload_time": "2014-06-06T15:33:06", "url": "https://files.pythonhosted.org/packages/5b/dc/1b2e0854c434fa93aec14fa47b8b2d40b4b4831dec94d4051eef876cd02a/fxos_appgen-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "6b73bc5f5ffbd0c15407012f700778ad", "sha256": "c4e5337d91a7344f37329f251eec40d6a473610fcfb1637c5f7f077f548ba756" }, "downloads": -1, "filename": "fxos_appgen-0.4.tar.gz", "has_sig": false, "md5_digest": "6b73bc5f5ffbd0c15407012f700778ad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8373, "upload_time": "2014-06-17T16:00:48", "url": "https://files.pythonhosted.org/packages/ba/fe/76af4aee931d58893d9524f196e462be62b34d0a1706a4d01c0432eb556f/fxos_appgen-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "6e394db0626a95b46ef0f3a14df41950", "sha256": "a069c9a756a5a515716b379ad2962d9871bbc7105c734b82dd5a39bf965f6d0c" }, "downloads": -1, "filename": "fxos_appgen-0.5.tar.gz", "has_sig": false, "md5_digest": "6e394db0626a95b46ef0f3a14df41950", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11694, "upload_time": "2014-06-19T11:22:17", "url": "https://files.pythonhosted.org/packages/42/e4/adbfe803ab5572e9b512883c2f12d6ac9331a38ee668982115556cf7278f/fxos_appgen-0.5.tar.gz" } ], "0.6": [ { "comment_text": "", "digests": { "md5": "d958b9e750384580e8a0b29be9eb0209", "sha256": "560930f27df6eb0a865ae5173f0026566910fa1b281e64bad561f5003077b873" }, "downloads": -1, "filename": "fxos_appgen-0.6.tar.gz", "has_sig": false, "md5_digest": "d958b9e750384580e8a0b29be9eb0209", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9713, "upload_time": "2014-08-14T12:22:35", "url": "https://files.pythonhosted.org/packages/e2/78/8476947eb3ee625f5c295b1d95127529bf80972d7dcb047227ceede9b54f/fxos_appgen-0.6.tar.gz" } ], "0.7": [ { "comment_text": "", "digests": { "md5": "85696537b1292d2b7beb7fa47693aedd", "sha256": "f40ea8d2c5f04d1c882981b6a1f55c1b3183cd028b4209827da8e078b87a3005" }, "downloads": -1, "filename": "fxos_appgen-0.7.tar.gz", "has_sig": false, "md5_digest": "85696537b1292d2b7beb7fa47693aedd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7565, "upload_time": "2014-09-04T22:10:02", "url": "https://files.pythonhosted.org/packages/d0/d0/9d50757460e323008a9ae26639f193f62c0b8429f846d25be1542a24e2cc/fxos_appgen-0.7.tar.gz" } ], "0.8": [ { "comment_text": "", "digests": { "md5": "7b8cfc85db8af109f1ccc379c1f745a1", "sha256": "ec4a355fff3d0a7efa8e9444980410f590f9258a7f519b99bed8f67f13f1cc7b" }, "downloads": -1, "filename": "fxos_appgen-0.8.tar.gz", "has_sig": false, "md5_digest": "7b8cfc85db8af109f1ccc379c1f745a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7741, "upload_time": "2014-12-10T23:57:51", "url": "https://files.pythonhosted.org/packages/6e/93/b8e040984e1099c0524dd507a5a2cf9137de114ac10a49f40d00d2e2e79d/fxos_appgen-0.8.tar.gz" } ], "0.9": [ { "comment_text": "", "digests": { "md5": "0110fe4607e419c0d93a2d2549b0b6ad", "sha256": "fd2a37e3af2f18e93c82169b034a755af8b510d47eb106266e0f9205016324a6" }, "downloads": -1, "filename": "fxos_appgen-0.9.tar.gz", "has_sig": false, "md5_digest": "0110fe4607e419c0d93a2d2549b0b6ad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7722, "upload_time": "2014-12-12T00:03:17", "url": "https://files.pythonhosted.org/packages/03/26/5b4ebd0b2e3c4ab9c3e266249f54c5b830e408149daf52ea12086601f41c/fxos_appgen-0.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3885e526fe5f7157fef060dde6064669", "sha256": "2966950ee29da073387915f0e0f11b10825bd147bd4a624936e6edcacc632b76" }, "downloads": -1, "filename": "fxos_appgen-0.15.tar.gz", "has_sig": false, "md5_digest": "3885e526fe5f7157fef060dde6064669", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10915, "upload_time": "2015-10-13T07:05:56", "url": "https://files.pythonhosted.org/packages/bd/c5/2f320fab8a3eb335fbb6f1b80d519ee9cc170845fc63b6bd6210457d2392/fxos_appgen-0.15.tar.gz" } ] }