jw-pkg

Author	SHA1	Message	Date
Jan Lindemann	772512aee0	FileContext.open() / close(): Only call wrapped once FileContext's _open() and _close() are called everytime their wrapper is called, which tasks the caller with keeping track of whether they were already called or not. Be a little easier on the caller, keep track in an open count, and call _open() only once for multiple calls to open(), and close() likewise. The caller still needs to make sure the number of open() and close() calls matches. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-24 16:53:55 +02:00
Jan Lindemann	4c81647bbe	lib.FileContext: Support attaching data filters - Add optional in_pipe and out_pipe parameters to __init__() - Add a add_proc_filter() method Add possibilites to attach input / output pipes to a FileContext instance. Data will be passed through the input pipe between ._get() and .get(), and through the output pipe between .put() and _put(). Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 20:18:40 +02:00
Jan Lindemann	58f7997bc6	lib.FileContext.open(): Add method Add an async open() method which should allow to do what __init__() couldn't, because it's not async, and to match the already existing .close(). It's called by __aenter__() __aexit__() if the FileContext is instantiated as context manager, or at will when the user finds it a good idea. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:32:34 +02:00
Jan Lindemann	432830a5c5	lib.FileContext.mkdir(): Add method Add .mkdir() to the API which should do the expected, and implement it in ExecContext and Local specializations. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:30:22 +02:00
Jan Lindemann	7547d13a6d	lib.FileContext: Support chroot Add a bool parameter "chroot" to __init__(). If passed, all path-centric operations act as if .root was prepended to it. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:30:08 +02:00
Jan Lindemann	b52264dfad	lib.FileContext.root: Add property Add a .root property, returning the path part of the instantiating URI. Nothing meaningful beyond returning it is done with it so far. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:29:20 +02:00
Jan Lindemann	6a3cf7a283	lib.FileContext: Beautify NotImplementedErrors Each wrapper method throws a NotImplementedError by default. Make that error a little more descriptive in case it really gets thrown. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:28:54 +02:00
Jan Lindemann	3360ec86cb	lib.FileContext: Add URI manipulation methods Add .schema_from_uri(), .split_uri(), .id() to define some standardish way to dissect an URI the same way FileContext does. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-23 15:27:38 +02:00
Jan Lindemann	b44879c517	lib.FileContext.file_exists(): Fix missing await file_exists and _stat() in file_exists() are async, need to be awaited, but aren't. Fix that. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-21 21:52:09 +02:00
Jan Lindemann	3cf5b2264e	lib.FileContext: Add file methods Add the following methods, meant to do the obvious: unlink(self, path: str) -> None erase(self, path: str) -> None rename(self, src: str, dst: str) -> None mktemp(self, tmpl: str, directory: bool=False) -> None chown(self, path: str, owner: str\|None=None, group: str\|None=None) -> None chmod(self, path: str, mode: int) -> None stat(self, path: str, follow_symlinks: bool=True) -> StatResult file_exists(self, path: str) -> bool is_dir(self, path: str) -> bool All methods are async and call their protected counterpart, which is designed to be overridden. If possible, default implementations do something meaningful, if not, they just raise plain NotImplementedError. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00
Jan Lindemann	fe3508036e	lib.FileContext.put(): Change param mode type str -> int Don't pass mode as a string to put(). Given the multitunde of possible string representations for numbers, some understood by int(string, 0) and some not, there's too much room for passing strings which are unparseable, or worse, prone to be parsed wrongly. However, pass mode down to _put() as a string for convenience, because that's what most _put() implementations will need to use. If they don't, converting to int is easy from the one defined string format. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00
Jan Lindemann	64e9fbff59	lib.FileContext.put(): Swap params path and content Swap the positions of the "path" and "content" parameters of put(). Path comes always first, in every path related function I know. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00
Jan Lindemann	94eee5c4bb	lib.FileContext.put(): Add parameter "atomic" Add the parameter "atomic" to put() / _put(). If instructs the implementation to take extra precautions to make sure the operation either succeeds or fails entirely, i.e. doesn't leave a broken target file behind. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00
Jan Lindemann	0d6eeeadcf	lib.FileContext.log_name: Beautify Prepend the class name to .log_name. Not sure if that makes logs more legible, but we'll try it out for a while. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00
Jan Lindemann	4f98fd6c78	lib.FileTransfer: Rename to FileContext Rename class FileTransfer to FileContext because that's the better name. It's the base class of ExecContext and also a context. Signed-off-by: Jan Lindemann <jan@janware.com>	2026-04-18 10:43:31 +02:00

15 commits