===========================================================================
Demo ziptools extracts on Android 11, for shared, app-specific,
and app-private internal (non-removable) storage types on a 
Pixel 4a.  See _README.txt for more background and details.
===========================================================================


# setup
$ Z=/sdcard/Download/ziptools
$ D=/sdcard/Download



###########################################################################
# SHARED STORAGE  (/sdcard == /storage/emulated/0)
#
# Modtimes work for files, folders, and symlink stubs.
# Symlinks and permissions do not work, and are lost.
###########################################################################


$ cd /sdcard
$ rm -rf content
$ python $Z/zip-extract.py $D/content.zip . -permissions
Unzipping from /sdcard/Download/content.zip to .
Extracted content/
(Link) --Symlink not supported
Extracted content/DIR-LINK
Extracted content/PERM444.py
Extracted content/PERM666.py
Extracted content/file2.py
(Link) --Symlink not supported
Extracted content/FILE-LINK
Extracted content/folder/
Extracted content/folder/sitesearch-savedterms.txt
Extracted content/file1.html
Extracted content/.htaccess
Extract finished: files=8, folders=2, links=0, unknowns=0.
$
$ ls -a --full-time content/
total 92
-rw-rw---- 1 root everybody   286 2019-03-02 13:57:13.000000000 -0800 .htaccess
-rw-rw---- 1 root everybody     7 2021-08-22 14:56:28.000000000 -0700 DIR-LINK
-rw-rw---- 1 root everybody    10 2021-08-22 14:56:41.000000000 -0700 FILE-LINK
-rw-rw---- 1 root everybody 26824 2020-11-26 10:26:29.000000000 -0800 PERM444.py
-rw-rw---- 1 root everybody 38457 2021-06-12 15:25:43.000000000 -0700 PERM666.py
-rw-rw---- 1 root everybody  2522 2019-03-02 14:45:01.000000000 -0800 file1.html
-rw-rw---- 1 root everybody   151 2017-06-13 14:58:38.000000000 -0700 file2.py
drwxrwx--- 2 root everybody  3488 2017-08-06 16:48:15.000000000 -0700 folder
$



###########################################################################
# APP-SPECIFIC STORAGE  (/sdcard/Android/data/app)
#
# Modtimes work for files, folders, and symlink stubs.
# Symlinks are lost, as are permissions -- *UNLIKE* the Z Fold3.
###########################################################################


$ cd /sdcard/Android/data/com.termux
$ rm -rf content
$ python $Z/zip-extract.py $D/content.zip . -permissions
Unzipping from /sdcard/Download/content.zip to .
Extracted content/
(Link) --Symlink not supported
Extracted content/DIR-LINK
Extracted content/PERM444.py
Extracted content/PERM666.py
Extracted content/file2.py
(Link) --Symlink not supported
Extracted content/FILE-LINK
Extracted content/folder/
Extracted content/folder/sitesearch-savedterms.txt
Extracted content/file1.html
Extracted content/.htaccess
Extract finished: files=8, folders=2, links=0, unknowns=0.
$
$ ls -a --full-time content/
total 99
drwxrwx--x 3 u0_a246 sdcard_rw  3488 2021-08-22 14:56:41.000000000 -0700 .
drwxrwx--x 7 u0_a246 sdcard_rw  3488 2021-09-03 14:53:53.016975400 -0700 ..
-rw-rw---- 1 u0_a246 sdcard_rw   286 2019-03-02 13:57:13.000000000 -0800 .htaccess
-rw-rw---- 1 u0_a246 sdcard_rw     7 2021-08-22 14:56:28.000000000 -0700 DIR-LINK
-rw-rw---- 1 u0_a246 sdcard_rw    10 2021-08-22 14:56:41.000000000 -0700 FILE-LINK
-rw-rw---- 1 u0_a246 sdcard_rw 26824 2020-11-26 10:26:29.000000000 -0800 PERM444.py
-rw-rw---- 1 u0_a246 sdcard_rw 38457 2021-06-12 15:25:43.000000000 -0700 PERM666.py
-rw-rw---- 1 u0_a246 sdcard_rw  2522 2019-03-02 14:45:01.000000000 -0800 file1.html
-rw-rw---- 1 u0_a246 sdcard_rw   151 2017-06-13 14:58:38.000000000 -0700 file2.py
drwxrwx--x 2 u0_a246 sdcard_rw  3488 2017-08-06 16:48:15.000000000 -0700 folder
$



###########################################################################
# APP-PRIVATE STORAGE  (/data/data/app)
#
# Modtimes work, for files, folders, and symlinks.
# Symlinks and permissions work too, but other apps can't access (sans SAF).
###########################################################################


$ cd
$ pwd
/data/data/com.termux/files/home
$ rm -rf content
$ python $Z/zip-extract.py $D/content.zip . -permissions
Unzipping from /sdcard/Download/content.zip to .
Extracted content/
(Link) Extracted content/DIR-LINK
Extracted content/PERM444.py
Extracted content/PERM666.py
Extracted content/file2.py
(Link) Extracted content/FILE-LINK
Extracted content/folder/
Extracted content/folder/sitesearch-savedterms.txt
Extracted content/file1.html
Extracted content/.htaccess
Extract finished: files=6, folders=2, links=2, unknowns=0.
$
$ ls -a --full-time content/
total 91
drwxr-xr-x 3 u0_a246 u0_a246  3488 2021-08-22 14:56:41.000000000 -0700 .
drwx------ 8 u0_a246 u0_a246  3488 2021-09-03 14:54:36.596979741 -0700 ..
-rwxrwxrwx 1 u0_a246 u0_a246   286 2019-03-02 13:57:13.000000000 -0800 .htaccess
lrwxrwxrwx 1 u0_a246 u0_a246    18 2021-08-22 14:56:28.000000000 -0700 DIR-LINK -> folder/
lrwxrwxrwx 1 u0_a246 u0_a246    18 2021-08-22 14:56:41.000000000 -0700 FILE-LINK -> file1.html
-r--r--r-- 1 u0_a246 u0_a246 26824 2020-11-26 10:26:29.000000000 -0800 PERM444.py
-rw-rw-rw- 1 u0_a246 u0_a246 38457 2021-06-12 15:25:43.000000000 -0700 PERM666.py
-rwxrwxrwx 1 u0_a246 u0_a246  2522 2019-03-02 14:45:01.000000000 -0800 file1.html
-rwxrwxrwx 1 u0_a246 u0_a246   151 2017-06-13 14:58:38.000000000 -0700 file2.py
drwxr-xr-x 2 u0_a246 u0_a246  3488 2017-08-06 16:48:15.000000000 -0700 folder
$



###########################################################################
# VERIFY CONTENT ACROSS ALL THREE
#
# Uses Mergeall's diffall.py byte-for-byte compare.  The only diffs are
# the two symlinks botched in shared and some storages (they're simple 
# stub files where botched, but symlinks where retained). 
###########################################################################


$ M=/sdcard/Download/Mergeall-source


#
# App-private to app-specific
#

$ python $M/diffall.py /data/data/com.termux/files/home/content/
>                      /sdcard/Android/data/com.termux/content -skipcruft
--------------------
Comparing /data/data/com.termux/files/home/content/ to /sdcard/Android/data/com.termux/content
Directory lists are identical
Comparing contents
*MISSED: DIR-LINK
PERM444.py matches
PERM666.py matches
file2.py matches
*MISSED: FILE-LINK
file1.html matches
.htaccess matches
--------------------
Comparing /data/data/com.termux/files/home/content//folder to /sdcard/Android/data/com.termux/content/folder
Directory lists are identical
Comparing contents
sitesearch-savedterms.txt matches
================================================================================
Runtime hrs:mins:secs = 0:0:0.01
Dirs checked 2, Files checked: 6, Files skipped: 0
System metadata (cruft) files were skipped
Diffs found: 2
- items MISSED at [/data/data/com.termux/files/home/content/] - [/sdcard/Android/data/com.termux/content]: [DIR-LINK]
- items MISSED at [/data/data/com.termux/files/home/content/] - [/sdcard/Android/data/com.termux/content]: [FILE-LINK]
End of report.


#
# App-private to shared
#

$ python $M/diffall.py /data/data/com.termux/files/home/content/ \
>                      /sdcard/content -skipcruft | tail -n 8
================================================================================
Runtime hrs:mins:secs = 0:0:0.02
Dirs checked 2, Files checked: 6, Files skipped: 0
System metadata (cruft) files were skipped
Diffs found: 2
- items MISSED at [/data/data/com.termux/files/home/content/] - [/sdcard/content]: [DIR-LINK]
- items MISSED at [/data/data/com.termux/files/home/content/] - [/sdcard/content]: [FILE-LINK]
End of report.


#
# App-private to original (which also lost permissions)
#

$ python $M/diffall.py /data/data/com.termux/files/home/content/ \
>                      /sdcard/copyraw/content -skipcruft | tail -n 8
================================================================================
Runtime hrs:mins:secs = 0:0:0.02
Dirs checked 2, Files checked: 6, Files skipped: 0
System metadata (cruft) files were skipped
Diffs found: 2
- items MISSED at [/data/data/com.termux/unzip/content/] - [/sdcard/copyraw/content]: [DIR-LINK]
- items MISSED at [/data/data/com.termux/unzip/content/] - [/sdcard/copyraw/content]: [FILE-LINK]
End of report.


#
# Verify modtime timestamps with Mergeall (also shown in ls)
#

$ python $M/mergeall.py /data/data/com.termux/files/home/content/ \
>                       /sdcard/content -report -skipcruft | tail -n 9
-------------------------------------------------------------------------------
*Summary
Compared    => files: 6, folders: 2
Differences => samefile: 0, uniqueto: 0, uniquefrom: 0, mixedmode: 2
Changed:
files   => created: 0, deleted: 0, replaced: 0
folders => created: 0, deleted: 0, replaced: 0
-------------------------------------------------------------------------------
Finished.