[Pkg-mozext-commits] [perspectives-extension] 16/30: README - Update testing info for the new format
David Prévot
taffit at alioth.debian.org
Thu Sep 26 22:31:39 UTC 2013
This is an automated email from the git hooks/post-receive script.
taffit pushed a commit to branch debian
in repository perspectives-extension.
commit 8cf5a333f9afccfb2bed54dc2381d8b950978946
Author: Dave Schaefer <dave.schaefer at gmail.com>
Date: Sat Sep 14 23:47:20 2013 -0600
README - Update testing info for the new format
---
README | 55 +++++--------------------------------------------------
1 file changed, 5 insertions(+), 50 deletions(-)
diff --git a/README b/README
index 0cf4771..f39a0d0 100644
--- a/README
+++ b/README
@@ -22,7 +22,7 @@ Requirements:
- zip
Optional (but strongly recommended!):
-- perl (to run the dtd sanity script)
+- perl (to run the build tests)
To build, just type "make" (assuming of course you have make installed!). This will create a file called 'Perspectives.xpi'.
@@ -43,59 +43,14 @@ TESTING
To test Perspectives:
-- (optional, but recommended) Build and install the Perspectives extension, as above
-- Open test/test.html in your Firefox browser
+- Use 'make test' to build and install the Perspectives extension, as above
+- Open chrome://perspectives/content/test/test.html in your browser
- Press the 'Run Tests' button
Test results will be displayed on the page.
-If you have ideas for further tests please let us know!
-
-
-TESTING - SCRIPT SECURITY PERMISSIONS
-
-Some test cases read and set preferences from the Perspectives extension while running. To do this the javascript code inside test.html needs additional security permissions. If you run the tests you may see a popup warning that says
-
- "A script from "file://" is requesting enhanced abilities that are UNSAFE and could be used to compromise your machine or data:
- >Run or install software on your machine
- Allow these abilities only if you trust this source to be free of viruses or malicious programs."
-
-This is normal behaviour when running the tests. If you trust the code in test.html (and don't take our word for it - read through it yourself to be sure!) you can click 'Allow' and the tests will run. If you click 'Deny' those tests will be skipped, and any remaining tests that do not require permissions will run normally.
-
-
-TESTING - ADDING TEST.HTML TO THE PERMISSIONS WHITELIST
-
-Clicking 'Allow' on the permissions popup above will globally allow any "file://" scripts access to a lot of things. Maybe you don't wish to allow that broad an exception. Maybe you don't wish to store such an exception permanently by checking the 'Remember this decision' checkbox. Or maybe you wish to revoke that stored permission once you are finished testing. Read on.
-
-Firefox stores its permissions whitelist in the prefs.js file under each Firefox profile. Profiles are usually stored in
-
- Windows - %appData%/Mozilla/Firefox/Profiles
- Linux - ~/.mozilla/firefox/
- Mac - <username>/Library/Application Support/Firefox/Profiles
-To find or open your profile folder:
-- In a Firefox window click on Help -> Troubleshooting Information
-- Under the 'Application Basics' section, on the 'Profile Directory' line, click on the button that says 'Open Containing Folder' (Windows and Linux) or 'Show in Finder' (Mac OS)
+Some tests are performed at build time - e.g. checking the localization files for the correct format and contents. All tests of the javascript code are run inside the extension - for security reasons they must be installed along with other extension files.
+If you have ideas for further tests please let us know!
-If Firefox is not running, you can open prefs.js and add or edit the whitelist values. You may wish to make a backup copy of the file first!!
-
-To revoke permissions that have been granted and stored, find the lines that look like
-
- user_pref("capability.principal.codebase.p0.granted", "UniversalXPConnect");
- user_pref("capability.principal.codebase.p0.id", "file:///");
- user_pref("capability.principal.codebase.p0.subjectName", "");
-
-and delete them. Save the file, then re-launch Firefox.
-
-If you want to whitelist only one file, such as the test file for Perspectives, you can add or edit the value to include one local path. e.g.:
-
- user_pref("capability.principal.codebase.p0.granted", "UniversalXPConnect");
- user_pref("capability.principal.codebase.p0.id", "file:///C:/code/perspectives/github/test/test.html");
- user_pref("capability.principal.codebase.p0.subjectName", "");
-
-
-
-Note: if Firefox is running no changes to prefs.js will be saved.
-
-Note: if you use a different profile than the default you may need to change the 'p0' value accordingly.
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-mozext/perspectives-extension.git
More information about the Pkg-mozext-commits
mailing list