{ "info": { "author": "Matthew Noorenberghe", "author_email": "MattN+mozscreenshots@mozilla.com", "bugtrack_url": null, "classifiers": [ "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: JavaScript", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "# mozscreenshots\n\nTake screenshots of Mozilla applications in various UI configurations.\n\nThe tool will setup the browser in every possible combination of the specified configuration sets (e.g. `WindowSize`) and take a screenshot. Note that the order of the sets affects the order that the configurations are setup. If no sets are specified, the default is: `TabsInTitlebar Tabs WindowSize Toolbars LightweightThemes`.\n\nNote that the extension (XPI) code has mostly moved to https://mxr.mozilla.org/mozilla-central/source/browser/tools/mozscreenshots/mozscreenshots/extension/\n\n[Documentation on MDN](https://developer.mozilla.org/en-US/docs/Mozilla/QA/Browser_screenshots)\n\n# dependencies\n* `mozrunner` (mozscreenshots subclasses mozrunner for standalone execution only)\n* `compare` and `convert` from ImageMagick for `compare_screenshots`\n* `apngasm`(optional) to generate animated PNG comparison images\n\n# capturing screenshots from mozilla source\n mach mochitest --subsuite screenshots\n mach mochitest --subsuite screenshots --setenv MOZSCREENSHOTS_SETS=DevTools\n mach mochitest --subsuite screenshots --setenv MOZSCREENSHOTS_SETS=DevEdition,TabsInTitlebar,Tabs,WindowSize,Toolbars\n\n# capturing screenshots from the standalone executable (not recently tested)\nTo output the list of valid sets, use `--list-sets`.\n\n## installation\n pip install -U mozscreenshots\n\n## after installation:\n\n mozscreenshots -b /Applications/Firefox.app/Contents/MacOS/firefox [sets]\n\n## examples\n\n mozscreenshots -b /Applications/Nightly.app/Contents/MacOS/firefox Tabs WindowSize LightweightThemes\n mozscreenshots -b /c/Program\\ Files\\ \\(x86\\)/Mozilla\\ Firefox/firefox.exe SystemTheme WindowSize Toolbars\n mozscreenshots -b ~/nightly/firefox Tabs WindowSize Toolbars LightweightThemes\n\n# output\nThe screenshots can be found in the following directories for now (issue 9 will make them configurable):\n\n* In `MOZ_UPLOAD_DIR` if the environment variables is defined\n* `/%TmpD%/mozscreenshots/` (a temporary directory which is output at the before capturing begins)\n\n# caveats\n* The `SystemTheme` configuration attempts to change the Windows theme while the application is running which doesn't always work correctly. The alternative is to manually change the Windows theme before a run and not including the `SystemTheme` set.\n* On OS X, if you have another instance of the binary running from the same path (e.g. with a different profile), the wrong application may be captured. You can use a symlink to workaround the issue.\n* There is no attempt to reset the profile or system theme back to their original value after a run. The Windows theme can be re-set manually and runs shouldn't be performed on a user's default profile.\n\n# fetching images from automation\n\nUse `fetch_screenshots` to fetch screenshots from Mozilla automation (e.g. Try server):\n\n pip install -U mozscreenshots\n fetch_screenshots -n 2017-01-17\n fetch_screenshots --project mozilla-central -r 3e275d37a06236981bff399b7d7aa0646be3fee7\n fetch_screenshots -r \n\n# comparing images for changes\n\nUse `compare_screenshots` to compare image files or directories (recursively) using ImageMagick. System UI\n(e.g. the clock and taskbar) is cropped out of the images when necessary so they aren't included in\nimage comparisons and generate false positives.\n\n pip install -U mozscreenshots\n compare_screenshots mozilla-central/08138045c38c/ try/5f6ca9194dd9/\n\n# web UI\n\nhttps://screenshots.mattn.ca/compare/\n", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/mnoorenberghe/mozscreenshots/tarball/0.4.0", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mnoorenberghe/mozscreenshots", "keywords": "mozilla,screenshots,Firefox", "license": "MPL 2.0", "maintainer": null, "maintainer_email": null, "name": "mozscreenshots", "package_url": "https://pypi.org/project/mozscreenshots/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/mozscreenshots/", "project_urls": { "Download": "https://github.com/mnoorenberghe/mozscreenshots/tarball/0.4.0", "Homepage": "https://github.com/mnoorenberghe/mozscreenshots" }, "release_url": "https://pypi.org/project/mozscreenshots/0.4.0/", "requires_dist": null, "requires_python": null, "summary": "Takes screenshots of different states of a Mozilla application", "version": "0.4.0" }, "last_serial": 2581618, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "fbd418cc8985d38035a3e4d7d9addb12", "sha256": "22359c468e7f9296af382e93799b2ff0cc0a260dc40eb376688e4e10f8b7a135" }, "downloads": -1, "filename": "mozscreenshots-0.2.tar.gz", "has_sig": false, "md5_digest": "fbd418cc8985d38035a3e4d7d9addb12", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51256, "upload_time": "2015-05-28T07:04:45", "url": "https://files.pythonhosted.org/packages/53/b4/13cf382c901c5eb540c64c6ddb2920869a0b810643b63a34402ecc1375db/mozscreenshots-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "370e03af6147a3c7d9e573d6c6bb6871", "sha256": "cb1c6e148c86b493af1c0feda80d483f600d7114284d7ca42b8c090c73f15dea" }, "downloads": -1, "filename": "mozscreenshots-0.2.1.tar.gz", "has_sig": false, "md5_digest": "370e03af6147a3c7d9e573d6c6bb6871", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51344, "upload_time": "2015-05-28T18:13:40", "url": "https://files.pythonhosted.org/packages/b4/53/c7b1e28bb84217c0384a5c4774df0e6a103aa827f21e48e62dbefb598159/mozscreenshots-0.2.1.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "71ac390c4150333840a6f974149bfc2e", "sha256": "18e700015b540d969be528bbcde0b23d97cb75783b274c5625c6387cf22f50b0" }, "downloads": -1, "filename": "mozscreenshots-0.3.tar.gz", "has_sig": false, "md5_digest": "71ac390c4150333840a6f974149bfc2e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 52517, "upload_time": "2016-02-03T14:55:20", "url": "https://files.pythonhosted.org/packages/d7/23/6f43bc2f4a99b5db3585528afee00862964d09df579364e6cbfec4c39036/mozscreenshots-0.3.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "3721b391ee3a76e1b25d8e30ed52a339", "sha256": "a6e2ef8d1c35a714fc49d22c5c9a4a1c72e5f8704a11857c51a262148c13f433" }, "downloads": -1, "filename": "mozscreenshots-0.3.1.tar.gz", "has_sig": false, "md5_digest": "3721b391ee3a76e1b25d8e30ed52a339", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 53947, "upload_time": "2016-02-11T23:15:59", "url": "https://files.pythonhosted.org/packages/e5/18/be2039a4aef069884fea678f7db338a90afcdc65c8b3aec6b5c6127bd8e1/mozscreenshots-0.3.1.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "f8513b26394ae552e1e807ff3bb0357c", "sha256": "be1ddd888c9eb12ad8e45f0e6b95615e3376923cd4708d37b56a95221b9481e8" }, "downloads": -1, "filename": "mozscreenshots-0.4.0.tar.gz", "has_sig": false, "md5_digest": "f8513b26394ae552e1e807ff3bb0357c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20866, "upload_time": "2017-01-18T07:45:18", "url": "https://files.pythonhosted.org/packages/6a/88/cb35760e25664b6af311d462aac11fc144f1e4d59790daafb30a1c79e75f/mozscreenshots-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f8513b26394ae552e1e807ff3bb0357c", "sha256": "be1ddd888c9eb12ad8e45f0e6b95615e3376923cd4708d37b56a95221b9481e8" }, "downloads": -1, "filename": "mozscreenshots-0.4.0.tar.gz", "has_sig": false, "md5_digest": "f8513b26394ae552e1e807ff3bb0357c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20866, "upload_time": "2017-01-18T07:45:18", "url": "https://files.pythonhosted.org/packages/6a/88/cb35760e25664b6af311d462aac11fc144f1e4d59790daafb30a1c79e75f/mozscreenshots-0.4.0.tar.gz" } ] }