Python/apps/py-cutils: cutils/util/walk.py annotate

annotate cutils/util/walk.py @ 280:f3e0b479928c

treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them

author	Franz Glasner <fzglas.hg@dom66.de>
date	Sun, 23 Feb 2025 10:01:09 +0100
parents	f7850ff5cbe0
children	16507317e834

rev	line source
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	1 # -- coding: utf-8 --
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	2 # :-
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	3 # :Copyright: (c) 2020-2025 Franz Glasner
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	4 # :License: BSD-3-Clause
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	5 # :-
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	6 r"""Utility sub-module to implement a heavily customized :func:`os.walk`.
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	7
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	8 """
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	9
196 0f4febf646f5 Prepare for more Python2/3 compatibility: everywhere import print_function and absolute_import Franz Glasner <fzglas.hg@dom66.de> parents: 195 diff changeset	10 from __future__ import print_function, absolute_import
0f4febf646f5 Prepare for more Python2/3 compatibility: everywhere import print_function and absolute_import Franz Glasner <fzglas.hg@dom66.de> parents: 195 diff changeset	11
0f4febf646f5 Prepare for more Python2/3 compatibility: everywhere import print_function and absolute_import Franz Glasner <fzglas.hg@dom66.de> parents: 195 diff changeset	12
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	13 __all__ = ["WalkDirEntry", "ScanDir", "getfsencoding"]
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	14
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	15
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	16 import os
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	17 try:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	18 from os import scandir
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	19 except ImportError:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	20 try:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	21 from scandir import scandir
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	22 except ImportError:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	23 scandir = None
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	24 import stat
198 c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	25 import sys
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	26
164 a813094ae4f5 Move PY2 from cutils.util.constants into cutils.util Franz Glasner <fzglas.hg@dom66.de> parents: 162 diff changeset	27 from . import PY2
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	28
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	29
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	30 _notset = object()
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	31
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	32
198 c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	33 _FSENCODING = sys.getfilesystemencoding()
c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	34
c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	35
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	36 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	37
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	38 def _unix_path(s):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	39 if isinstance(s, bytes):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	40 return s.replace(b"\\", b"/")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	41 return s.replace(u"\\", u"/")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	42
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	43 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	44
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	45 def _unix_path(s):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	46 return s.replace("\\", "/")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	47
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	48
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	49 class WalkDirEntry(object):
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	50
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	51 """A :class:`os.DirEntry` alike to be used in :func:`walk` and for
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	52 its results.
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	53
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	54 """
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	55
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	56 __slots__ = ("_name", "_path", # encoded as given in the ctor
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	57 "_is_symlink", "_is_reg", "_is_dir", "_stat_result",
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	58 "_stat_errno", "_stat_errstr",
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	59 "_alt_fsname", "_alt_u8name")
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	60
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	61 def __init__(self, name, path):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	62 self._name = name # the name as given in the constructor
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	63 """The name exactly as given in the ctor"""
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	64 self._path = _unix_path(path)
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	65 """The path as given in the ctor -- but normalized to have slashes"""
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	66 self._is_symlink = self._is_reg = self._is_dir = self._stat_result = \
266 0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	67 self._stat_errno = self._stat_errstr = None
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	68 self._alt_fsname = self._alt_u8name = _notset
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	69
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	70 @property
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	71 def name(self):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	72 """The original name exactly as given in the ctor"""
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	73 return self._name
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	74
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	75 @property
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	76 def path(self):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	77 """The original path exactly as given in the ctor."""
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	78 return self._path
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	79
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	80 @property
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	81 def fsname(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	82 """The name as bytes for the filesystem.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	83
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	84 :rtype: bytes or None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	85
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	86 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	87 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	88 if isinstance(self._name, bytes):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	89 return self._name
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	90 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	91 return self._name.encode(_FSENCODING, "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	92 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	93 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	94 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	95 return os.fsencode(self._name)
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	96
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	97 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	98 def alt_fsname(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	99 """Alternative and "escaped" filesystem name -- always bytes.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	100
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	101 :rtype: bytes
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	102
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	103 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	104 if self._alt_fsname is _notset:
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	105 self._alt_fsname = WalkDirEntry.alt_fs(self._name)
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	106 return self._alt_fsname
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	107
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	108 @property
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	109 def fspath(self):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	110 """Always bytes.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	111
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	112 :rtype: bytes or None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	113
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	114 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	115 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	116 if isinstance(self._path, bytes):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	117 return self._path
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	118 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	119 return self._path.encode(_FSENCODING, "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	120 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	121 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	122 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	123 return os.fsencode(self._path)
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	124
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	125 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	126 def alt_fspath(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	127 """Alternative and "escaped" filesystem path -- always bytes.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	128
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	129 :rtype: bytes
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	130
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	131 """
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	132 return WalkDirEntry.alt_fs(self._path)
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	133
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	134 @staticmethod
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	135 def alt_fs(what):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	136 if PY2:
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	137 if isinstance(what, bytes):
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	138 return what
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	139 return what.encode(_FSENCODING, "backslashreplace")
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	140 else:
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	141 return os.fsencode(what)
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	142
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	143 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	144 def uname(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	145 """Always "real", strictly encoded Unicode or `None` if this is not
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	146 possible.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	147
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	148 :rtype: text or None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	149
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	150 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	151 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	152 if isinstance(self._name, bytes):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	153 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	154 return self._name.decode(_FSENCODING, "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	155 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	156 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	157 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	158 return self._name
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	159 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	160 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	161 self._name.encode("utf-8", "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	162 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	163 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	164 return self._name
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	165
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	166 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	167 def upath(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	168 """Always "real", strictly encoded Unicode or `None` if this is not
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	169 possible.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	170
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	171 :rtype: text or None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	172
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	173 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	174 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	175 if isinstance(self._path, bytes):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	176 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	177 return self._path.decode(_FSENCODING, "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	178 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	179 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	180 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	181 return self._path
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	182 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	183 try:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	184 self._path.encode("utf-8", "strict")
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	185 except UnicodeError:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	186 return None
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	187 return self._path
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	188
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	189 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	190 def u8name(self):
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	191 """`.uname` as UTF-8 or `None` (as strict as `uname`).
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	192
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	193 Also do not allow CR of LF in the name.
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	194
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	195 """
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	196 n = self.uname
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	197 if n is None:
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	198 return None
280 f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	199 if (u'\n' in n) or (u'\r' in n) or (u'\\' in n):
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	200 return None
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	201 return n.encode("utf-8", "strict")
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	202
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	203 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	204 def u8path(self):
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	205 """`.upath` as UTF-8 or `None` (as strict as `upath`.
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	206
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	207 Also do not allow CR or LF in the path.
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	208
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	209 """
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	210 p = self.upath
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	211 if p is None:
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	212 return None
280 f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	213 if (u'\n' in p) or (u'\r' in p) or (u'\\' in p):
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	214 return None
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	215 return p.encode("utf-8", "strict")
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	216
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	217 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	218 def alt_u8name(self):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	219 if self._alt_u8name is _notset:
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	220 self._alt_u8name = WalkDirEntry.alt_u8(self._name)
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	221 return self._alt_u8name
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	222
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	223 @property
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	224 def alt_u8path(self):
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	225 return WalkDirEntry.alt_u8(self._path)
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	226
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	227 @staticmethod
3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	228 def alt_u8(what):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	229 if PY2:
203 3a85f7bbe0b1 Common static method for some alternative encodings Franz Glasner <fzglas.hg@dom66.de> parents: 201 diff changeset	230 if isinstance(what, bytes):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	231 try:
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	232 s = (what.decode(_FSENCODING, "strict")
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	233 .encode("utf-8", "strict"))
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	234 except UnicodeError:
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	235 s = (WalkDirEntry.surrogate_decode(what)
f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	236 .encode("ascii", "backslashreplace"))
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	237 else:
280 f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	238 s = what.encode("ascii", "backslashreplace")
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	239 else:
276 f7850ff5cbe0 treesum: when walking: if filenames contain CR and/or LF pretend that this names are not properly encoded. Franz Glasner <fzglas.hg@dom66.de> parents: 274 diff changeset	240 s = what.encode("utf-8", "backslashreplace")
280 f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	241 return (s.replace(b'\\', b"\\x5c")
f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	242 .replace(b'\n', b"\\x0a")
f3e0b479928c treesum: FIX: Also check for that backslashes are nor in u8name or u8path and encode them Franz Glasner <fzglas.hg@dom66.de> parents: 276 diff changeset	243 .replace(b'\r', b"\\x0d"))
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	244
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	245 @property
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	246 def is_symlink(self):
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	247 return self._is_symlink
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	248
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	249 @property
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	250 def is_reg(self):
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	251 return self._is_reg
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	252
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	253 @property
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	254 def is_dir(self):
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	255 return self._is_dir
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	256
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	257 @property
274 224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	258 def is_chr(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	259 return (stat.S_ISCHR(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	260 if self._stat_result is not None
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	261 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	262
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	263 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	264 def is_blk(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	265 return (stat.S_ISBLK(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	266 if self._stat_result is not None
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	267 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	268
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	269 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	270 def is_fifo(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	271 return (stat.S_ISFIFO(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	272 if self._stat_result is not None
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	273 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	274
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	275 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	276 def is_socket(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	277 return (stat.S_ISSOCK(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	278 if self._stat_result is not None
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	279 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	280
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	281 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	282 def is_door(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	283 test = getattr(stat, "S_ISDOOR", None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	284 return (test(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	285 if test and (self._stat_result is not None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	286 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	287
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	288 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	289 def is_eventport(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	290 test = getattr(stat, "S_ISPORT", None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	291 return (test(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	292 if test and (self._stat_result is not None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	293 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	294
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	295 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	296 def is_whiteout(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	297 test = getattr(stat, "S_ISWHT", None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	298 return (test(self._stat_result.st_mode)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	299 if test and (self._stat_result is not None)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	300 else False)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	301
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	302 @property
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	303 def is_special(self):
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	304 """Anything besides a regular file and a directory"""
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	305 if self._stat_result is None:
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	306 return False
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	307 return not (self.is_reg or self.is_dir)
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	308
224725fd9f2f WalkDirEntry: add support for special files (character and block special, FIFO, socket, door, whiteout, event port, ...) Franz Glasner <fzglas.hg@dom66.de> parents: 273 diff changeset	309 @property
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	310 def stat(self):
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	311 return self._stat_result
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	312
266 0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	313 @property
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	314 def stat_errno(self):
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	315 return self._stat_errno
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	316
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	317 @property
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	318 def stat_errstr(self):
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	319 return self._stat_errstr
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	320
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	321 def __repr__(self):
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	322 tag = ""
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	323 if self._is_symlink:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	324 tag += "l"
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	325 if self._is_dir:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	326 tag += "d"
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	327 if tag:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	328 return "<WalkDirEntry %r (%s)>" % (self._name, tag)
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	329 return "<WalkDirEntry %r>" % (self._name,)
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	330
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	331 @classmethod
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	332 def from_direntry(cls_, entry):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	333 w = cls_(entry.name, entry.path)
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	334 try:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	335 w._is_dir = entry.is_dir(follow_symlinks=True)
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	336 except OSError:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	337 #
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	338 # If is_dir() raises an OSError, consider that the entry
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	339 # is not a directory, same behaviour than os.path.isdir().
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	340 #
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	341 w._is_dir = False
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	342 try:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	343 w._is_symlink = entry.is_symlink()
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	344 except OSError:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	345 #
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	346 # If is_symlink() raises an OSError, consider that the entry
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	347 # is not a symbolic link, same behaviour than os.path.islink().
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	348 #
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	349 w._is_symlink = False
266 0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	350 # Consistently follow symlinks
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	351 try:
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	352 w._stat_result = entry.stat(follow_symlinks=True)
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	353 except OSError as e:
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	354 w._stat_result = None
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	355 w._stat_errno = e.errno
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	356 w._stat_errstr = e.strerror
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	357 w._is_reg = False
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	358 else:
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	359 w._is_reg = stat.S_ISREG(w._stat_result.st_mode)
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	360 return w
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	361
162 29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	362 @classmethod
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	363 def from_path_name(cls_, path, name, _do_stat=True):
265 188f448ab5e9 FIX: typo in docs Franz Glasner <fzglas.hg@dom66.de> parents: 221 diff changeset	364 """`_do_stat` is to be used only for testing purposes"""
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	365 w = cls_(name, os.path.join(path, name))
162 29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	366 try:
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	367 w._is_dir = os.path.isdir(w._path)
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	368 except OSError:
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	369 #
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	370 # If is_dir() raises an OSError, consider that the entry
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	371 # is not a directory, same behaviour than os.path.isdir().
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	372 #
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	373 w._is_dir = False
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	374 try:
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	375 w._is_symlink = os.path.islink(w._path)
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	376 except OSError:
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	377 #
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	378 # If is_symlink() raises an OSError, consider that the entry
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	379 # is not a symbolic link, same behaviour than os.path.islink().
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	380 #
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	381 w._is_symlink = False
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	382 if _do_stat:
266 0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	383 try:
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	384 w._stat_result = os.stat(w._path)
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	385 except OSError as e:
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	386 w._stat_result = None
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	387 w._stat_errno = e.errno
0add8276e6b8 treesum: Handle errors like broken symlinks properly Franz Glasner <fzglas.hg@dom66.de> parents: 265 diff changeset	388 w._stat_errstr = e.strerror
273 c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	389 w._is_reg = False
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	390 else:
c02a57df2a29 treesum: - WalkDirEntry tests with a FIFO special file - WalkDirEntry.is_reg Franz Glasner <fzglas.hg@dom66.de> parents: 266 diff changeset	391 w._is_reg = stat.S_ISREG(w._stat_result.st_mode)
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	392 return w
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	393
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	394 @classmethod
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	395 def from_readlink(cls_, path):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	396 w = cls_(os.path.basename(path), path)
162 29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	397 return w
29dd5528174c Implement walk._walk() using os.listdir() also. Franz Glasner <fzglas.hg@dom66.de> parents: 156 diff changeset	398
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	399 @staticmethod
221 ca9d5a0dc9bb Rename WalkDirEntry.sort_key and WalkDirEntry.alt_sort_key Franz Glasner <fzglas.hg@dom66.de> parents: 203 diff changeset	400 def sort_key_fs(entry):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	401 return entry.alt_fsname # because it should never throw
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	402
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	403 @staticmethod
221 ca9d5a0dc9bb Rename WalkDirEntry.sort_key and WalkDirEntry.alt_sort_key Franz Glasner <fzglas.hg@dom66.de> parents: 203 diff changeset	404 def sort_key_u8(entry):
201 58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	405 return entry.alt_u8name # because it should never throw
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	406
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	407 if PY2:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	408
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	409 @staticmethod
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	410 def surrogate_decode(what):
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	411 """Decode the bytes object `what` using surrogates from :pep:`383`
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	412 for all non-ASCII octets.
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	413
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	414 """
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	415 uwhat = []
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	416 assert isinstance(what, bytes)
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	417 for ch in what:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	418 chcode = ord(ch)
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	419 if chcode <= 0x7f:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	420 uwhat.append(unichr(chcode)) # noqa: F821 unichr
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	421 else:
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	422 uwhat.append(unichr(0xDC00 + chcode)) # noqa: F821 unichr
58d93453c307 Much more encoding-related methods for DirWalkEntry and some unittests Franz Glasner <fzglas.hg@dom66.de> parents: 199 diff changeset	423 return u"".join(uwhat)
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	424
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	425
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	426 if scandir:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	427
178 dac26a2d9de5 Cleanup: remove non used walk-code Franz Glasner <fzglas.hg@dom66.de> parents: 177 diff changeset	428 class ScanDir(object):
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	429
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	430 """An :func:`os.scandir` wrapper that is always an iterator and
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	431 a context manager.
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	432
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	433 """
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	434
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	435 __slots__ = ("_scandir_it", )
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	436
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	437 def __init__(self, path):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	438 super(ScanDir, self).__init__()
195 e5f6f4db9157 Use the imported "scandir()" implementation instead always the "os.scandir" Franz Glasner <fzglas.hg@dom66.de> parents: 192 diff changeset	439 self._scandir_it = scandir(path)
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	440
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	441 def __iter__(self):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	442 return self
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	443
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	444 def __next__(self):
199 b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	445 if self._scandir_it is None:
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	446 raise StopIteration("closed")
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	447 return WalkDirEntry.from_direntry(next(self._scandir_it))
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	448
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	449 if PY2:
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	450 next = __next__
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	451
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	452 def __enter__(self):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	453 return self
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	454
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	455 def __exit__(self, args, *kwds):
199 b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	456 self.close()
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	457
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	458 def close(self):
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	459 if self._scandir_it is not None:
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	460 if hasattr(self._scandir_it, "close"):
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	461 self._scandir_it.close()
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	462 self._scandir_it = None
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	463
121 2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	464 else:
2dc26a2f3d1c A heavily customized "os.walk()" alike to support the coming treeview implementation Franz Glasner <fzglas.hg@dom66.de> parents: diff changeset	465
178 dac26a2d9de5 Cleanup: remove non used walk-code Franz Glasner <fzglas.hg@dom66.de> parents: 177 diff changeset	466 class ScanDir(object):
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	467
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	468 """An :func:`os.scandir` wrapper that is always an iterator and
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	469 a context manager.
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	470
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	471 """
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	472
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	473 __slots__ = ("_listdir_it", "_path")
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	474
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	475 def __init__(self, path):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	476 super(ScanDir, self).__init__()
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	477 self._listdir_it = iter(os.listdir(path))
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	478 self._path = path
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	479
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	480 def __iter__(self):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	481 return self
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	482
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	483 def __next__(self):
199 b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	484 if self._listdir_it is None:
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	485 raise StopIteration("closed")
175 506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	486 return WalkDirEntry.from_path_name(self._path,
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	487 next(self._listdir_it))
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	488
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	489 if PY2:
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	490 next = __next__
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	491
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	492 def __enter__(self):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	493 return self
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	494
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	495 def __exit__(self, args, *kwds):
506d895a8500 Implement cutils.util.walk.Scandir as a wrapper for os.scandir() Franz Glasner <fzglas.hg@dom66.de> parents: 164 diff changeset	496 pass
198 c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	497
199 b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	498 def close(self):
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	499 pass
b2aba84ca426 Implement a "close()" method for cutils.util.walk.ScanDir. Franz Glasner <fzglas.hg@dom66.de> parents: 198 diff changeset	500
198 c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	501
c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	502 def getfsencoding():
c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	503 """Return the stored _FSENCODING of this module"""
c1e875ba4bdc Put the effective filesystem encoding into the treesum digest file using FSENCODING = <encoding> Franz Glasner <fzglas.hg@dom66.de> parents: 196 diff changeset	504 return _FSENCODING

Mercurial > hgrepos > Python > apps > py-cutils

annotate cutils/util/walk.py @ 280:f3e0b479928c