dazzle-filekit 0.3.0__tar.gz → 0.3.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/PKG-INFO +1 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/__init__.py +3 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/links.py +40 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/metadata.py +97 -14
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/paths.py +11 -6
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/utils/validation.py +6 -5
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit.egg-info/PKG-INFO +1 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit.egg-info/SOURCES.txt +2 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/pyproject.toml +1 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/setup.py +1 -1
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_import_stability.py +2 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_link_primitives.py +51 -0
- dazzle_filekit-0.3.2/tests/test_symlink_timestamps_v031.py +68 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/LICENSE +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/README.md +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/_fallback.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/content.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/operations.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/platform/__init__.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/platform/unix.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/platform/windows.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/utils/__init__.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/utils/compat.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/utils/disk.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/utils/logger.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit/verification.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit.egg-info/dependency_links.txt +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit.egg-info/requires.txt +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/dazzle_filekit.egg-info/top_level.txt +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/setup.cfg +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_ads_and_junction_v024.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_auto_naming.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_compat.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_content_and_process.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_disk.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_fallback.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_metadata_v024_roundtrip.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_operations_primitives_v024.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_paths_platform_simulation.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_paths_v024_enrichments.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_phase_b_absorb_and_v9.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_phase_c_renames.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_phase_d_typeddicts.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_resolver_ops.py +0 -0
- {dazzle_filekit-0.3.0 → dazzle_filekit-0.3.2}/tests/test_smoke.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: dazzle-filekit
|
|
3
|
-
Version: 0.3.
|
|
3
|
+
Version: 0.3.2
|
|
4
4
|
Summary: Cross-platform file operations toolkit with path handling, verification, and metadata preservation
|
|
5
5
|
Author: Dustin
|
|
6
6
|
Author-email: Dustin Darcy <6962246+djdarcy@users.noreply.github.com>
|
|
@@ -116,9 +116,10 @@ from .links import (
|
|
|
116
116
|
read_link_target,
|
|
117
117
|
create_junction,
|
|
118
118
|
create_hardlink,
|
|
119
|
+
remove_link,
|
|
119
120
|
)
|
|
120
121
|
|
|
121
|
-
__version__ = '0.3.
|
|
122
|
+
__version__ = '0.3.2'
|
|
122
123
|
|
|
123
124
|
def configure_logging(level=logging.INFO, log_file=None):
|
|
124
125
|
"""
|
|
@@ -256,6 +257,7 @@ __all__ = [
|
|
|
256
257
|
'read_link_target',
|
|
257
258
|
'create_junction',
|
|
258
259
|
'create_hardlink',
|
|
260
|
+
'remove_link',
|
|
259
261
|
|
|
260
262
|
# Verification functions
|
|
261
263
|
'calculate_file_hash',
|
|
@@ -316,3 +316,43 @@ def create_hardlink(
|
|
|
316
316
|
else:
|
|
317
317
|
logger.error(f"Failed to create hard link {link_path}: {e}")
|
|
318
318
|
return False
|
|
319
|
+
|
|
320
|
+
|
|
321
|
+
def remove_link(path: Union[str, Path]) -> bool:
|
|
322
|
+
"""Remove (detach) a symlink, junction, or hard link WITHOUT deleting its
|
|
323
|
+
target.
|
|
324
|
+
|
|
325
|
+
The inverse of :func:`create_junction` / :func:`create_hardlink` /
|
|
326
|
+
:func:`create_symlink`:
|
|
327
|
+
|
|
328
|
+
* a **junction** is detached with ``os.rmdir`` -- the reparse point is
|
|
329
|
+
removed, the target directory tree is left untouched;
|
|
330
|
+
* a **directory symlink** (Windows) is likewise removed with ``os.rmdir``;
|
|
331
|
+
a **file symlink** with ``unlink`` -- the target file stays;
|
|
332
|
+
* a **hard link** is removed with ``unlink``, which only decrements the
|
|
333
|
+
file's link count (the data survives while another name remains).
|
|
334
|
+
|
|
335
|
+
Returns True on success, False if ``path`` is not a link or removal fails
|
|
336
|
+
(the reason is logged). Ported from preservelib (R7); the conservation
|
|
337
|
+
verdict returned this intrinsic link primitive to its L1 home.
|
|
338
|
+
"""
|
|
339
|
+
p = Path(path)
|
|
340
|
+
kind = detect_link_type(p)
|
|
341
|
+
if kind is None:
|
|
342
|
+
logger.error(f"remove_link: not a link: {p}")
|
|
343
|
+
return False
|
|
344
|
+
try:
|
|
345
|
+
if kind == LINK_JUNCTION:
|
|
346
|
+
os.rmdir(p) # detach junction; target tree untouched
|
|
347
|
+
elif kind == LINK_SYMLINK:
|
|
348
|
+
if p.is_dir():
|
|
349
|
+
os.rmdir(p) # directory symlink (Windows)
|
|
350
|
+
else:
|
|
351
|
+
p.unlink() # file symlink
|
|
352
|
+
elif kind == LINK_HARDLINK:
|
|
353
|
+
p.unlink() # decrements the file's link count
|
|
354
|
+
logger.debug(f"Removed {kind} link: {p}")
|
|
355
|
+
return True
|
|
356
|
+
except OSError as e:
|
|
357
|
+
logger.error(f"remove_link({p}) failed: {e}")
|
|
358
|
+
return False
|
|
@@ -194,6 +194,78 @@ def _collect_windows_metadata(path: Path) -> Dict[str, Any]:
|
|
|
194
194
|
logger.error(f"Error collecting Windows metadata for {path}: {e}")
|
|
195
195
|
return windows_metadata
|
|
196
196
|
|
|
197
|
+
def _set_symlink_timestamps(path_obj: Path, timestamps: Dict[str, Any]) -> bool:
|
|
198
|
+
"""Apply timestamps to a symlink ITSELF, never the target it points to.
|
|
199
|
+
|
|
200
|
+
``os.utime()`` and a default Win32 ``CreateFile`` both follow the reparse
|
|
201
|
+
point to the target -- so applying timestamps to a link the naive way
|
|
202
|
+
silently corrupts the *target's* timestamps. On Windows we open the link
|
|
203
|
+
with ``FILE_FLAG_OPEN_REPARSE_POINT`` and use ``SetFileTime``; on POSIX we
|
|
204
|
+
use ``os.utime(follow_symlinks=False)``. Best-effort: returns False (with a
|
|
205
|
+
warning) when the platform/runtime can't set link timestamps -- it never
|
|
206
|
+
falls back to touching the target.
|
|
207
|
+
"""
|
|
208
|
+
accessed = timestamps.get('accessed')
|
|
209
|
+
modified = timestamps.get('modified')
|
|
210
|
+
created = timestamps.get('created')
|
|
211
|
+
|
|
212
|
+
if platform.system() != 'Windows':
|
|
213
|
+
if (os.utime in os.supports_follow_symlinks
|
|
214
|
+
and accessed is not None and modified is not None):
|
|
215
|
+
try:
|
|
216
|
+
os.utime(path_obj, (accessed, modified), follow_symlinks=False)
|
|
217
|
+
return True
|
|
218
|
+
except Exception as e:
|
|
219
|
+
logger.warning(f"Error applying symlink timestamps to {path_obj}: {e}")
|
|
220
|
+
return False
|
|
221
|
+
logger.warning(
|
|
222
|
+
f"Cannot set link timestamps for {path_obj} on this platform without "
|
|
223
|
+
f"following to the target; skipped."
|
|
224
|
+
)
|
|
225
|
+
return False
|
|
226
|
+
|
|
227
|
+
# Windows: open the link itself (FILE_FLAG_OPEN_REPARSE_POINT) + SetFileTime.
|
|
228
|
+
if not is_win32_available():
|
|
229
|
+
logger.warning(
|
|
230
|
+
f"pywin32 unavailable; cannot set link timestamps for {path_obj} "
|
|
231
|
+
f"without following to the target; skipped."
|
|
232
|
+
)
|
|
233
|
+
return False
|
|
234
|
+
try:
|
|
235
|
+
import win32file
|
|
236
|
+
import win32con
|
|
237
|
+
import pywintypes
|
|
238
|
+
|
|
239
|
+
FILE_WRITE_ATTRIBUTES = 0x100
|
|
240
|
+
FILE_FLAG_OPEN_REPARSE_POINT = 0x00200000
|
|
241
|
+
|
|
242
|
+
def _wt(value):
|
|
243
|
+
if value is None:
|
|
244
|
+
return None
|
|
245
|
+
dt = (datetime.datetime.fromtimestamp(value)
|
|
246
|
+
if isinstance(value, (int, float)) else value)
|
|
247
|
+
return pywintypes.Time(dt)
|
|
248
|
+
|
|
249
|
+
handle = win32file.CreateFile(
|
|
250
|
+
str(path_obj),
|
|
251
|
+
FILE_WRITE_ATTRIBUTES,
|
|
252
|
+
win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
|
|
253
|
+
None,
|
|
254
|
+
win32con.OPEN_EXISTING,
|
|
255
|
+
FILE_FLAG_OPEN_REPARSE_POINT | win32con.FILE_FLAG_BACKUP_SEMANTICS,
|
|
256
|
+
None,
|
|
257
|
+
)
|
|
258
|
+
try:
|
|
259
|
+
# SetFileTime(handle, creation, access, write) -- None leaves unchanged.
|
|
260
|
+
win32file.SetFileTime(handle, _wt(created), _wt(accessed), _wt(modified))
|
|
261
|
+
finally:
|
|
262
|
+
handle.close()
|
|
263
|
+
return True
|
|
264
|
+
except Exception as e:
|
|
265
|
+
logger.warning(f"Error applying symlink timestamps to {path_obj}: {e}")
|
|
266
|
+
return False
|
|
267
|
+
|
|
268
|
+
|
|
197
269
|
def apply_file_metadata(path: Union[str, Path], metadata: FileMetadataDict) -> bool:
|
|
198
270
|
"""
|
|
199
271
|
Apply metadata to a file.
|
|
@@ -217,23 +289,30 @@ def apply_file_metadata(path: Union[str, Path], metadata: FileMetadataDict) -> b
|
|
|
217
289
|
logger.warning(f"Error applying permissions to {path}: {e}")
|
|
218
290
|
success = False
|
|
219
291
|
|
|
220
|
-
# Apply timestamps
|
|
292
|
+
# Apply timestamps. Symlinks need special handling: os.utime() and the
|
|
293
|
+
# default Win32 handle follow the reparse point and would write to the
|
|
294
|
+
# TARGET, so route links through a link-targeting helper that sets all
|
|
295
|
+
# three times on the link itself.
|
|
221
296
|
if 'timestamps' in metadata:
|
|
222
297
|
timestamps = metadata['timestamps']
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
298
|
+
if path_obj.is_symlink():
|
|
299
|
+
if not _set_symlink_timestamps(path_obj, timestamps):
|
|
300
|
+
success = False
|
|
301
|
+
else:
|
|
302
|
+
try:
|
|
303
|
+
os.utime(
|
|
304
|
+
path_obj,
|
|
305
|
+
(timestamps['accessed'], timestamps['modified'])
|
|
306
|
+
)
|
|
307
|
+
except Exception as e:
|
|
308
|
+
logger.warning(f"Error applying timestamps to {path}: {e}")
|
|
309
|
+
success = False
|
|
231
310
|
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
311
|
+
# On Windows, also restore creation time via pywin32
|
|
312
|
+
if platform.system() == 'Windows' and 'created' in timestamps:
|
|
313
|
+
if not restore_windows_creation_time(path_obj, timestamps['created']):
|
|
314
|
+
# Non-fatal -- ctime restoration is best-effort
|
|
315
|
+
pass
|
|
237
316
|
|
|
238
317
|
# Apply platform-specific metadata
|
|
239
318
|
if platform.system() == 'Windows' and 'windows' in metadata:
|
|
@@ -858,6 +937,10 @@ def restore_windows_creation_time(
|
|
|
858
937
|
flags = win32con.FILE_FLAG_BACKUP_SEMANTICS
|
|
859
938
|
else:
|
|
860
939
|
flags = win32con.FILE_ATTRIBUTE_NORMAL
|
|
940
|
+
# Symlinks: open the link itself, not the target it points to, so the
|
|
941
|
+
# creation time lands on the link (otherwise CreateFile follows it).
|
|
942
|
+
if path_obj.is_symlink():
|
|
943
|
+
flags |= 0x00200000 # FILE_FLAG_OPEN_REPARSE_POINT
|
|
861
944
|
|
|
862
945
|
# Handle readonly files: clear attribute, set time, restore attribute
|
|
863
946
|
readonly_cleared = False
|
|
@@ -263,12 +263,17 @@ def split_drive_letter(path: Union[str, Path]) -> Tuple[str, str]:
|
|
|
263
263
|
def is_unc_path(path: Union[str, Path]) -> bool:
|
|
264
264
|
r"""Check if a path is a UNC (``\\server\share``) path.
|
|
265
265
|
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
266
|
+
**This is a thin convenience WRAPPER**, not the canonical home. UNC
|
|
267
|
+
detection is a path-IDENTITY question, which the stack assigns to L0 --
|
|
268
|
+
so this delegates to ``unctools.is_unc_path`` (the owner). It is kept
|
|
269
|
+
public in filekit only as a convenience for file-operation callers, and
|
|
270
|
+
**may be deprecated in 0.4.0** in favour of importing
|
|
271
|
+
``unctools.is_unc_path`` directly.
|
|
272
|
+
|
|
273
|
+
Behaviour (from the owner): normalizes ``/`` -> ``\`` then checks the
|
|
274
|
+
``\\`` prefix, so ``//server/share`` is recognized on every platform.
|
|
275
|
+
0.3.0 collapsed filekit's two previously-divergent copies (win32-only
|
|
276
|
+
here, POSIX-``//`` in ``utils.validation``) onto this single delegate.
|
|
272
277
|
"""
|
|
273
278
|
from unctools import is_unc_path as _unc_is_unc_path
|
|
274
279
|
return _unc_is_unc_path(path)
|
|
@@ -208,11 +208,12 @@ def is_relative_path(path: Union[str, Path]) -> bool:
|
|
|
208
208
|
def is_unc_path(path: Union[str, Path]) -> bool:
|
|
209
209
|
r"""Check if a path is a UNC (``\\server\share``) path.
|
|
210
210
|
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
(
|
|
211
|
+
**Thin convenience WRAPPER** over the canonical owner
|
|
212
|
+
``unctools.is_unc_path`` (UNC detection is path-identity = L0's domain).
|
|
213
|
+
Kept public only for convenience; **may be deprecated in 0.4.0** -- prefer
|
|
214
|
+
``unctools.is_unc_path``. 0.3.0 collapsed this and ``paths.is_unc_path``
|
|
215
|
+
onto the single delegate (they previously diverged on POSIX: this returned
|
|
216
|
+
``//``-prefix True; ``paths`` returned False).
|
|
216
217
|
"""
|
|
217
218
|
from unctools import is_unc_path as _unc_is_unc_path
|
|
218
219
|
return _unc_is_unc_path(path)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: dazzle-filekit
|
|
3
|
-
Version: 0.3.
|
|
3
|
+
Version: 0.3.2
|
|
4
4
|
Summary: Cross-platform file operations toolkit with path handling, verification, and metadata preservation
|
|
5
5
|
Author: Dustin
|
|
6
6
|
Author-email: Dustin Darcy <6962246+djdarcy@users.noreply.github.com>
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "dazzle-filekit"
|
|
7
|
-
version = "0.3.
|
|
7
|
+
version = "0.3.2"
|
|
8
8
|
description = "Cross-platform file operations toolkit with path handling, verification, and metadata preservation"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.9"
|
|
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
|
|
2
2
|
|
|
3
3
|
setup(
|
|
4
4
|
name="dazzle-filekit",
|
|
5
|
-
version="0.3.
|
|
5
|
+
version="0.3.1",
|
|
6
6
|
description="Cross-platform file operations toolkit with path handling, verification, and metadata preservation",
|
|
7
7
|
author="Dustin",
|
|
8
8
|
author_email="6962246+djdarcy@users.noreply.github.com",
|
|
@@ -66,6 +66,7 @@ TOP_LEVEL_LOCKED = [
|
|
|
66
66
|
"read_link_target",
|
|
67
67
|
"create_junction",
|
|
68
68
|
"create_hardlink",
|
|
69
|
+
"remove_link",
|
|
69
70
|
"compute_relative_path",
|
|
70
71
|
"links", # the submodule
|
|
71
72
|
]
|
|
@@ -142,6 +143,7 @@ SUBMODULE_LOCKED = {
|
|
|
142
143
|
"read_link_target",
|
|
143
144
|
"create_junction",
|
|
144
145
|
"create_hardlink",
|
|
146
|
+
"remove_link",
|
|
145
147
|
],
|
|
146
148
|
"dazzle_filekit.utils.validation": [
|
|
147
149
|
"is_junction",
|
|
@@ -30,6 +30,7 @@ from dazzle_filekit import (
|
|
|
30
30
|
detect_link_type,
|
|
31
31
|
get_relative_path,
|
|
32
32
|
read_link_target,
|
|
33
|
+
remove_link,
|
|
33
34
|
)
|
|
34
35
|
from dazzle_filekit import links as links_mod
|
|
35
36
|
|
|
@@ -250,3 +251,53 @@ def test_no_cmd_shellouts_in_link_module():
|
|
|
250
251
|
"link primitives must not shell out to cmd.exe (use PowerShell / DeviceIoControl)"
|
|
251
252
|
)
|
|
252
253
|
assert "powershell" in source.lower()
|
|
254
|
+
|
|
255
|
+
|
|
256
|
+
# ---------------------------------------------------------------------------
|
|
257
|
+
# AC-5 (R7): remove_link detaches a link WITHOUT deleting its target
|
|
258
|
+
# ---------------------------------------------------------------------------
|
|
259
|
+
|
|
260
|
+
|
|
261
|
+
def test_remove_link_not_a_link_returns_false(tmp_path):
|
|
262
|
+
f = tmp_path / "plain.txt"
|
|
263
|
+
f.write_text("data")
|
|
264
|
+
assert remove_link(f) is False
|
|
265
|
+
assert f.exists() # a real file is never removed
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def test_remove_link_file_symlink_keeps_target(tmp_path):
|
|
269
|
+
target = tmp_path / "t.txt"
|
|
270
|
+
target.write_text("payload")
|
|
271
|
+
link = tmp_path / "s.txt"
|
|
272
|
+
if not _try_symlink(target, link):
|
|
273
|
+
pytest.skip("symlink privilege not available")
|
|
274
|
+
assert detect_link_type(link) == "symlink"
|
|
275
|
+
assert remove_link(link) is True
|
|
276
|
+
assert not link.exists() # link detached
|
|
277
|
+
assert target.read_text() == "payload" # target file survives
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
def test_remove_link_hardlink_keeps_data(tmp_path):
|
|
281
|
+
src = tmp_path / "file.txt"
|
|
282
|
+
src.write_text("hard data")
|
|
283
|
+
link = tmp_path / "hard.txt"
|
|
284
|
+
if not create_hardlink(src, link):
|
|
285
|
+
pytest.skip("hard links not supported on this filesystem")
|
|
286
|
+
assert remove_link(link) is True
|
|
287
|
+
assert not link.exists() # the second name is gone
|
|
288
|
+
assert src.read_text() == "hard data" # data survives via the original name
|
|
289
|
+
|
|
290
|
+
|
|
291
|
+
@pytest.mark.skipif(sys.platform != "win32", reason="junctions are Windows-only")
|
|
292
|
+
def test_remove_link_junction_keeps_target_tree(tmp_path):
|
|
293
|
+
target = tmp_path / "target"
|
|
294
|
+
target.mkdir()
|
|
295
|
+
(target / "inside.txt").write_text("keepme")
|
|
296
|
+
link = tmp_path / "jct"
|
|
297
|
+
if not create_junction(target, link):
|
|
298
|
+
pytest.skip("could not create junction in this environment")
|
|
299
|
+
assert detect_link_type(link) == "junction"
|
|
300
|
+
assert remove_link(link) is True
|
|
301
|
+
assert not link.exists() # junction detached
|
|
302
|
+
assert target.is_dir() # target dir survives
|
|
303
|
+
assert (target / "inside.txt").read_text() == "keepme" # contents intact
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
"""Regression tests for symlink-targeted timestamp application (v0.3.1).
|
|
2
|
+
|
|
3
|
+
Before 0.3.1, ``apply_file_metadata`` applied timestamps via ``os.utime(path)``,
|
|
4
|
+
which follows a symlink to its target -- so applying a record's timestamps to a
|
|
5
|
+
link silently corrupted the TARGET file's timestamps and left the link unchanged.
|
|
6
|
+
0.3.1 routes symlinks through a link-targeting path (Windows:
|
|
7
|
+
``FILE_FLAG_OPEN_REPARSE_POINT`` + ``SetFileTime``; POSIX:
|
|
8
|
+
``os.utime(follow_symlinks=False)``).
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import os
|
|
12
|
+
|
|
13
|
+
import pytest
|
|
14
|
+
|
|
15
|
+
from dazzle_filekit import apply_file_metadata
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
def _try_symlink(target, link):
|
|
19
|
+
"""Create a symlink, returning False (to skip) if privileges are lacking."""
|
|
20
|
+
try:
|
|
21
|
+
os.symlink(str(target), str(link))
|
|
22
|
+
except (OSError, NotImplementedError):
|
|
23
|
+
return False
|
|
24
|
+
return os.path.islink(str(link))
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def _link_timestamps_settable():
|
|
28
|
+
"""POSIX needs lutimes (os.utime follow_symlinks); Windows uses Win32."""
|
|
29
|
+
if os.name == "nt":
|
|
30
|
+
return True
|
|
31
|
+
return os.utime in os.supports_follow_symlinks
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
def test_apply_timestamps_to_symlink_does_not_touch_target(tmp_path):
|
|
35
|
+
target = tmp_path / "target.txt"
|
|
36
|
+
target.write_text("payload", encoding="utf-8")
|
|
37
|
+
link = tmp_path / "link.txt"
|
|
38
|
+
if not _try_symlink(target, link):
|
|
39
|
+
pytest.skip("symlink creation not permitted on this platform/account")
|
|
40
|
+
if not _link_timestamps_settable():
|
|
41
|
+
pytest.skip("platform cannot set link timestamps without following")
|
|
42
|
+
|
|
43
|
+
target_before = os.lstat(str(target)).st_mtime
|
|
44
|
+
epoch_2020 = 1577836800.0 # 2020-01-01, clearly distinct from "now"
|
|
45
|
+
|
|
46
|
+
ok = apply_file_metadata(
|
|
47
|
+
str(link),
|
|
48
|
+
{"timestamps": {"created": epoch_2020, "modified": epoch_2020, "accessed": epoch_2020}},
|
|
49
|
+
)
|
|
50
|
+
assert ok is True
|
|
51
|
+
|
|
52
|
+
# The target must be untouched...
|
|
53
|
+
assert abs(os.lstat(str(target)).st_mtime - target_before) < 2
|
|
54
|
+
# ...and the LINK itself must have received the timestamp.
|
|
55
|
+
assert abs(os.lstat(str(link)).st_mtime - epoch_2020) < 2
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def test_apply_timestamps_to_regular_file_still_works(tmp_path):
|
|
59
|
+
# Non-symlink path must be unchanged by the 0.3.1 fix.
|
|
60
|
+
f = tmp_path / "plain.txt"
|
|
61
|
+
f.write_text("x", encoding="utf-8")
|
|
62
|
+
epoch_2020 = 1577836800.0
|
|
63
|
+
ok = apply_file_metadata(
|
|
64
|
+
str(f),
|
|
65
|
+
{"timestamps": {"created": epoch_2020, "modified": epoch_2020, "accessed": epoch_2020}},
|
|
66
|
+
)
|
|
67
|
+
assert ok is True
|
|
68
|
+
assert abs(os.stat(str(f)).st_mtime - epoch_2020) < 2
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|