Tip for Easily Backup Local Script Files in TruClient Lite Chrome

Currently TruClient Lite Chrome doesn’t support batch script operations. If the user want to back up all the local scripts, then they have to manually download the scripts one by one.
There are two ways to back up the scripts

  1. All the scripts are saved in the user data directory. So back up the user data directory will back up the script indirectly.
  2. We could use a hack way to download all the scripts as a single zip file.

Steps to back up user data folder

  1. Check the path from the command line of the shortcut of your TruClient Lite Chrome
    1. --user-data-dir=<profile dir> --extensions-on-chrome-urls --silent-debugger-extension-api --disable-web-security --no-first-run
  2. Back up the folder <profile dir>

Steps to download all the scripts as a single zip file

  1. Start the TruClient Lite
  2. Navigate to chrome://extensions/ to open the extension management pages for Chrome
  3. Check the Developer mode
    extension-enable-dev-mode
  4. Click background page link for TruClient Lite
    extension-page
  5. Run the below code on console, the scripts will be saved
    1. var zip = new JSZip(); localforage.iterate((v, k) => { if(k.startsWith('/__scripts__/') && k.indexOf(':metadata:') === -1){ zip.file(k.split('/').pop()+'.zip', v); } }).then(()=>{ a = document.createElement('a'); a.href = window.URL.createObjectURL(zip.generate({type:"blob"})); a.download = "scripts.zip"; a.dispatchEvent(new MouseEvent("click")); });
  6. Restart TruClient Lite

Polyfill for Utf8toUtf16 for JavaScript

As we know the TextEncoder will drop support utf-16 and other legacy encoding types from Mozilla. Google also confirmed it and Chrome will only remain support utf-16 encoding.

Here is a polyfill implementation for convert utf-8 string to utf-16le

  1. function utf8ToUtf16(s) {
  2. var a = new Uint8Array(s.length * 2),
  3. view = new DataView(a.buffer);
  4. s.split('').forEach(function (c, i) {
  5. //the third parameter equal to true indicate little ending
  6. view.setUint16(i * 2, c.charCodeAt(0), true);
  7. });
  8. return a;
  9. }

 

Reference:
https://bugzilla.mozilla.org/show_bug.cgi?id=1257877
https://www.chromestatus.com/feature/5630760492990464

Hook All the Functions in JavaScript Files

During my daily development, I encounter a request to add code snippets before and after each function call for all the JavaScript files. I have figure out three ways to do this

1. Overwrite the Function.prototype.call, this will only effect the directly call the call method from a function object such as foo.call(…). The call method will not triggered with directly call function with brace, such as foo(…)

disadvantage: not cover all the function even normal function calls

2. Use custom or use some AOP JS library to hook specify function. This is also could be extended by use a recursive method to hook all the function object in a give scope such as window in browser.

such as hooker lib, https://github.com/rcorp/hooker

jquery AOP plugin

advantage: easy to use

disadvantage: not cover all of the functions in the JS files, such as anonymous functions are not included.

3. Use some script to parse all the JS files and inject codes before and after all the functions.

This article is mainly to talk about the tool which I created for automatic inject the codes before and after the function calls.

It is called hookjs, which is written in python. It could be checkout from my github repo(https://github.com/shangerxin/PersontalTools). The binary version could be download from the bin folder.

$ hookjs -h

usage: hookjs.exe [-h] [-p PATH] [-s START] [-e END]                   [-f [BLACK_FILES [BLACK_FILES ...]]]                   [-d [BLACK_DIRS [BLACK_DIRS ...]]]

A command line JavaScript hook tool for inject start, end codes into every JavaScript functions. Currently only support uncompressed EMCScipt 5. Any errors will be output into the error.log file.

optional arguments:

-h, –help   show this help message and exit

-p PATH, –path PATH  The path to the JavaScript file or directory

-s START, –start START  The start code snippet which will be injected at the                         begin of each function

-e END, –end END     The end code snippet which will be injected at the end                         of each function

-f [BLACK_FILES [BLACK_FILES ...]], –black-files [BLACK_FILES [BLACK_FILES ...]]                         Use regex expression to define the black files list, the files will not be hooked

-d [BLACK_DIRS [BLACK_DIRS ...]], –black-dirs [BLACK_DIRS [BLACK_DIRS ...]]                         Use regex expression to define the black dirs list, the directory and sub directory will not be searched

Created by Edwin, Shang(Shang, Erxin), License under GNU GPLv3. Version 1.0.0

Example:

Inject codes to a JS files, the original JS content

  1. x = findMax(1, 123, 500, 115, 44, 88);
  2.  
  3. (function(){
  4. })();
  5.  
  6. function findMax() {
  7. var i;
  8. var max = -Infinity;
  9. for (i = 0; i < arguments.length; i++) {
  10. if (arguments[i] > max) {
  11. max = arguments[i];
  12. }
  13. }
  14. return max;
  15. }

 

run command

  1. hookjs.exe -p e:\demo.js -s console.log("start"); -e console.log("end");
  1. x = findMax(1, 123, 500, 115, 44, 88);
  2.  
  3. (function(){console.log(start);
  4. console.log(end);})();
  5.  
  6. function findMax() {console.log(start);
  7. var i;
  8. var max = -Infinity;
  9. for (i = 0; i < arguments.length; i++) {
  10. if (arguments[i] > max) {
  11. max = arguments[i];
  12. }
  13. }
  14. console.log(end);return max;
  15. console.log(end);}

 

Limitations:

The tool is not works with compressed JS file such as jquery-min etc. To add hook for these kinds of JS files, it required to format the JS first then use the tool the inject the JS codes.

Current it is not design for support arrow function syntax which is added in EMCAScript 6

Have fun.

Automatic Export About:Config Content Compare the Difference between for Firefox

Requirement:

We need to compare the difference between the configuration changes between the new vision of the FF and the previous version

We wish to compare the configuration setting in plain text. Then we could use the compare tools such as beyond compare or winmerge to give us a quick visual for the difference.

The Problem:

There is not a official way to export the about:confg page from FF into plain text file. There is a prefs.js file locate in the firefox profile folder, it contains some of the configuration setting but not all.

Known solutions to export the about:config but not well enough:

Solution for export the about:config:

Use the GUI automation tool(autoit) to help export the configuration directly from the about:config page. The script is export-opened-firefox-config.au3 which could be download from my github repot

  1. Install autoit, which double be download from official website follow the previous link
  2. Download the export-opened-firefox-config.au3
  3. Before run the script close all the Firefox process existed in the current system
  4. Run the script export-opened-firefox-config.au3
  5. Open the Firefox that you want to export the about the configure content
  6. The script will start automatically and wait for it stops, please make any user input during the script execution
  7. The output.txt will be generated at the same location of the script file export-opened-firefox-config.au3 which contain all the configuration values
  8. Check the last line of the output.txt contain the last item of the about:config. If the values are same then all is well. If not please modify the sleep time for the script to give more calculate time for the low performance system.

Solution for generate the difference compilation results:

Use python to parse and generate the previous generate configuration files and the current user.js settings which contain in the LR-INSTALL-DIRECTORY\dat\FFProfile\user.js. The python script could be check out from my personal tools repo from github

  1. Install python 2.7.x, if current system doesn’t contain python environment
  2. Install xlsxwriter from pip or download the package install manually. Check this link, if you doesn’t familiar with python
  3. Download the script
  4. Copy and replace the about config content files and the user.js into the data folder to make it follow this file structure

2015-12-02_110835

2015-12-02_111617

5. Execute the python script the output files will be overwrite and generated automatically  Note: If the excel file is not required you could common the script lines relative to generate excel to only generate plain text report. The key/value pair is separate by semicolons like this:

2015-12-02_111832

References

Note: the content of the wiki may adapt to the old version of FF to check the new version please follow the link supplied in the wiki pages.

 

Use Python to Create a Tree View Command Line Tool

In recent days I need to generate a directory free from the window command prompt. As I known there is a DOS tool called tree could do this. But it is not quite fit for my requirement. Here is an example which the graphic generated by built-in tree command in window.

D:\PersonalTools>tree D:\emacs-24.5 /A
卷 WareHouse 的文件夹 PATH 列表
卷序列号为 64CA-A0C3

D:\EMACS-24.5
+—admin
|   +—charsets
|   |   \—mapfiles
|   +—coccinelle
|   +—grammars
|   +—notes
|   +—nt
|   \—unidata
+—build-aux
|   \—snippet
+—doc
|   +—emacs
|   +—lispintro
|   +—lispref
|   +—man
|   \—misc
+—etc
|   +—charsets
|   +—e
|   +—forms
|   +—gnus
|   +—images
|   |   +—custom
|   |   +—ezimage
|   |   +—gnus
|   |   +—gud
|   |   +—icons
|   |   |   +—allout-widgets
|   |   |   |   +—dark-bg
|   |   |   |   \—light-bg
|   |   |   \—hicolor
|   |   |       +—128×128
|   |   |       |   \—apps
|   |   |       +—16×16
|   |   |       |   \—apps
|   |   |       +—24×24
|   |   |       |   \—apps
|   |   |       +—32×32
|   |   |       |   \—apps
|   |   |       +—48×48
|   |   |       |   \—apps
|   |   |       \—scalable
|   |   |           +—apps
|   |   |           \—mimetypes
|   |   +—low-color
|   |   +—mail
|   |   +—mpc
|   |   +—newsticker
|   |   +—smilies
|   |   |   +—grayscale
|   |   |   \—medium
|   |   \—tree-widget
|   |       +—default
|   |       \—folder
|   +—nxml
|   +—org
|   +—refcards
|   +—schema
|   +—srecode
|   +—themes
|   \—tutorials
+—info
+—leim
|   +—CXTERM-DIC
|   +—MISC-DIC
|   \—SKK-DIC
+—lib
+—lib-src
+—lisp
|   +—calc
|   +—calendar
|   +—cedet
|   |   +—ede
|   |   +—semantic
|   |   |   +—analyze
|   |   |   +—bovine
|   |   |   +—decorate
|   |   |   +—symref
|   |   |   \—wisent
|   |   \—srecode
|   +—emacs-lisp
|   +—emacs-parallel
|   +—emulation
|   +—erc
|   +—eshell
|   +—gnus
|   +—international
|   +—language
|   +—leim
|   |   +—ja-dic
|   |   \—quail
|   +—mail
|   +—mh-e
|   +—net
|   +—nxml
|   +—obsolete
|   +—org
|   +—play
|   +—progmodes
|   +—term
|   +—textmodes
|   +—url
|   \—vc
+—lwlib
+—m4
+—msdos
+—nextstep
|   +—Cocoa
|   |   \—Emacs.base
|   |       \—Contents
|   |           \—Resources
|   +—GNUstep
|   |   \—Emacs.base
|   |       \—Resources
|   \—templates
+—nt
|   +—icons
|   \—inc
|       +—arpa
|       +—netinet
|       \—sys
+—oldXMenu
+—site-lisp
\—src
\—bitmaps

A quite complicate file structure for emacs 24.5. There are several limitations for this command.

  1. It can’t control the iteration depth
  2. When display with files it doesn’t generated the dash lines which is not clearly to indicate the file structure
  3. If we could give a depth parameter I also want to display the sub items as ellipsis to indicate there is something under but which is omitted

So I use python to write a custom version to enhance this command called treex. It support generated the same structure as the tree command but also provide additional control switch. The source code is already pushed to my personal repository in GitHub. Feel free to check it out.

The help information is

usage: treex.py [-h] [-f] [-d DEPTH] [-m] [-e] path

A Cmd Line Tool for Graphically displays the folder structure of a drive or
path

positional arguments:
path

optional arguments:
-h, –help            show this help message and exit
-f, –file            Display the names of the files in each folder
-d DEPTH, –depth DEPTH
Display the depth number
-m, –mark            Mark the item is file or directory
-e, –ellipsis        Mark the next sub-item with ellipsis

Create by Edwin, Shang(Shang, Erxin) License under MIT. Version 1.0.0

Try to use the treex to generate a depth 2 directory structure

D:\PersonalTools>c:\Python27\python.exe treex.py D:\emacs-24.5 -d 2
Folder path listing
D:\emacs-24.5
+—admin
|   +—charsets
|   +—coccinelle
|   +—grammars
|   +—notes
|   +—nt
|   \—unidata
+—build-aux
|   \—snippet
+—doc
|   +—emacs
|   +—lispintro
|   +—lispref
|   +—man
|   \—misc
+—etc
|   +—charsets
|   +—e
|   +—forms
|   +—gnus
|   +—images
|   +—nxml
|   +—org
|   +—refcards
|   +—schema
|   +—srecode
|   +—themes
|   \—tutorials
+—info
+—leim
|   +—CXTERM-DIC
|   +—MISC-DIC
|   \—SKK-DIC
+—lib
+—lib-src
+—lisp
|   +—calc
|   +—calendar
|   +—cedet
|   +—emacs-lisp
|   +—emacs-parallel
|   +—emulation
|   +—erc
|   +—eshell
|   +—gnus
|   +—international
|   +—language
|   +—leim
|   +—mail
|   +—mh-e
|   +—net
|   +—nxml
|   +—obsolete
|   +—org
|   +—play
|   +—progmodes
|   +—term
|   +—textmodes
|   +—url
|   \—vc
+—lwlib
+—m4
+—msdos
+—nextstep
|   +—Cocoa
|   +—GNUstep
|   \—templates
+—nt
|   +—icons
|   \—inc
+—oldXMenu
+—site-lisp
\—src
\—bitmaps

Here is another result for generate with ellipsis and marks

D:\PersonalTools>c:\Python27\python.exe treex.py D:\emacs-24.5 -d 2 -e -m
Folder path listing
D:\emacs-24.5
[d]+—admin
[d]|   +—charsets
[d]|   |   \—…
[d]|   +—coccinelle
[d]|   +—grammars
[d]|   +—notes
[d]|   +—nt
[d]|   \—unidata
[d]+—build-aux
[d]|   \—snippet
[d]+—doc
[d]|   +—emacs
[d]|   +—lispintro
[d]|   +—lispref
[d]|   +—man
[d]|   \—misc
[d]+—etc
[d]|   +—charsets
[d]|   +—e
[d]|   +—forms
[d]|   +—gnus
[d]|   +—images
[d]|   |   +—…
[d]|   +—nxml
[d]|   +—org
[d]|   +—refcards
[d]|   +—schema
[d]|   +—srecode
[d]|   +—themes
[d]|   \—tutorials
[d]+—info
[d]+—leim
[d]|   +—CXTERM-DIC
[d]|   +—MISC-DIC
[d]|   \—SKK-DIC
[d]+—lib
[d]+—lib-src
[d]+—lisp
[d]|   +—calc
[d]|   +—calendar
[d]|   +—cedet
[d]|   |   +—…
[d]|   +—emacs-lisp
[d]|   +—emacs-parallel
[d]|   +—emulation
[d]|   +—erc
[d]|   +—eshell
[d]|   +—gnus
[d]|   +—international
[d]|   +—language
[d]|   +—leim
[d]|   |   +—…
[d]|   +—mail
[d]|   +—mh-e
[d]|   +—net
[d]|   +—nxml
[d]|   +—obsolete
[d]|   +—org
[d]|   +—play
[d]|   +—progmodes
[d]|   +—term
[d]|   +—textmodes
[d]|   +—url
[d]|   \—vc
[d]+—lwlib
[d]+—m4
[d]+—msdos
[d]+—nextstep
[d]|   +—Cocoa
[d]|   |   \—…
[d]|   +—GNUstep
[d]|   |   \—…
[d]|   \—templates
[d]+—nt
[d]|   +—icons
[d]|   \—inc
[d]|       +—…
[d]+—oldXMenu
[d]+—site-lisp
[d]\—src
[d]    \—bitmaps

The key technical point is the depth first traversal algorithms, and I implement it with nonrecursive mode to reduce the stack usage.

The other key point is how to generate the graphic. There is a pattern between the second line and the previous line. So I use it. The implementation could be found from the source.

That’s all. Happy coding.