statbtrfs 0.37__tar.gz → 0.39__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.
- {statbtrfs-0.37/statbtrfs.egg-info → statbtrfs-0.39}/PKG-INFO +27 -3
- statbtrfs-0.39/README.txt +62 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/setup.py +1 -1
- {statbtrfs-0.37 → statbtrfs-0.39/statbtrfs.egg-info}/PKG-INFO +27 -3
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/SOURCES.txt +1 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/requires.txt +1 -1
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.py +215 -232
- statbtrfs-0.39/tests/test_broken_pipe.py +51 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_cli.py +14 -2
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_filesystems.py +2 -3
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_filter_recent.py +2 -2
- statbtrfs-0.39/tests/test_import_seams.py +17 -0
- statbtrfs-0.39/tests/test_live.py +16 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_mounts.py +3 -11
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_show.py +2 -5
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_scrub_orchestration.py +13 -0
- statbtrfs-0.37/README.txt +0 -38
- statbtrfs-0.37/tests/test_import_seams.py +0 -56
- statbtrfs-0.37/tests/test_live.py +0 -39
- {statbtrfs-0.37 → statbtrfs-0.39}/LICENSE +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/setup.cfg +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/dependency_links.txt +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/entry_points.txt +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/top_level.txt +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_color.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_options.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_output.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_scrub.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_stats.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_privileges.py +0 -0
- {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_watch.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: statbtrfs
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.39
|
|
4
4
|
Summary: Query Btrfs filesystem status
|
|
5
5
|
Home-page: https://github.com/yufei-pan/statbtrfs
|
|
6
6
|
Author: Yufei Pan
|
|
@@ -12,7 +12,7 @@ Classifier: Operating System :: POSIX :: Linux
|
|
|
12
12
|
Requires-Python: >=3.6
|
|
13
13
|
Description-Content-Type: text/plain
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist: multiCMD>=1.
|
|
15
|
+
Requires-Dist: multiCMD>=1.56
|
|
16
16
|
Provides-Extra: completion
|
|
17
17
|
Requires-Dist: argcomplete; extra == "completion"
|
|
18
18
|
Dynamic: author
|
|
@@ -56,7 +56,31 @@ options:
|
|
|
56
56
|
-V, --version show program's version number and exit
|
|
57
57
|
|
|
58
58
|
Exit status: 0 healthy; 1 problems found (device errors, scrub errors or missing devices); 2 the
|
|
59
|
-
check failed (no matching mounts, an unreadable filesystem, no root); 130 interrupted
|
|
59
|
+
check failed (no matching mounts, an unreadable filesystem, no root); 130 interrupted; 141 the
|
|
60
|
+
reader of stdout went away (| head).
|
|
61
|
+
|
|
62
|
+
Known limitation: when each btrfs command has to run through sudo, a missing btrfs shows as "Could not fetch
|
|
63
|
+
complete info … Skipping…" rather than "btrfs not found on PATH" (see docs/limitations.md).
|
|
64
|
+
|
|
65
|
+
Upgrading to 0.39 from 0.38:
|
|
66
|
+
- The embedded multiCMD is now 1.57. It runs whenever the installed multiCMD is older, so multiCMD itself need not be upgraded. On EL7 and EL8, stock pip 9.0.3 cannot upgrade multiCMD, so `pip3 install -U statbtrfs` fails there: use `pip3 install statbtrfs==0.39`, or upgrade pip first.
|
|
67
|
+
- Known: on EL7, btrfs-progs 4.9.1's scrub status is not read, so `-s` can say a scrub finished while it runs and the status columns stay `Never`. A checksum error still shows. Planned for 0.40.
|
|
68
|
+
- Faster command starts on Python 3.6 - 3.10, where the embedded multiCMD 1.57 imports only built-in
|
|
69
|
+
modules in the wrapper that puts each command in its own process group (about 7 ms to 3.5 ms of CPU
|
|
70
|
+
per command on Python 3.6.8). Nothing else about starting a command changes.
|
|
71
|
+
|
|
72
|
+
Upgrading to 0.38 from 0.37:
|
|
73
|
+
- multiCMD 1.56 or newer is required (the embedded copy is 1.56).
|
|
74
|
+
- An unreadable filesystem now prints only the note under the table, "Could not fetch complete info for
|
|
75
|
+
<mounts>. Skipping...". The three lines before it ("Could not parse btrfs show info.", "Output from btrfs
|
|
76
|
+
filesystem show was:" and the raw output) are gone.
|
|
77
|
+
- statbtrfs | head, or any reader that exits early, now ends quietly with exit 141 (128 + SIGPIPE)
|
|
78
|
+
instead of a BrokenPipeError traceback and exit 1.
|
|
79
|
+
- Ctrl-C outside -s and -w (say while btrfs hangs on a dying device) exits 130 quietly instead of a
|
|
80
|
+
traceback.
|
|
81
|
+
- -s and -w clear the screen with ESC[H ESC[J, so a long run no longer pushes tables into the scrollback of
|
|
82
|
+
terminals that treat ESC[2J that way.
|
|
83
|
+
- Library callers: find_btrfs_mounts() takes no argument and execute_command(s) lose wait=.
|
|
60
84
|
|
|
61
85
|
Install:
|
|
62
86
|
sudo pip install statbtrfs
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
usage: statbtrfs [-h] [-s | -w] [-i INTERVAL] [-m MAX_SCRUB_COUNT]
|
|
2
|
+
[-d EXCLUDE_RECENT_SCRUBBED_DAYS] [--scrub-command-lockout SCRUB_COMMAND_LOCKOUT]
|
|
3
|
+
[--color {auto,always,never}] [-V]
|
|
4
|
+
[pattern ...]
|
|
5
|
+
|
|
6
|
+
Check Btrfs filesystem status.
|
|
7
|
+
|
|
8
|
+
positional arguments:
|
|
9
|
+
pattern Patterns to filter btrfs mounts. Default="*"
|
|
10
|
+
|
|
11
|
+
options:
|
|
12
|
+
-h, --help show this help message and exit
|
|
13
|
+
-s, --scrub Issue scrub to all pools
|
|
14
|
+
-w, --watch Refresh every -i seconds while any scrub is running, then exit (never
|
|
15
|
+
starts scrubs)
|
|
16
|
+
-i, --interval INTERVAL
|
|
17
|
+
Interval for status check in seconds
|
|
18
|
+
-m, --max-scrub-count MAX_SCRUB_COUNT
|
|
19
|
+
Maximum number of scrubs running at the same time (0: one per CPU)
|
|
20
|
+
-d, --exclude-recent-scrubbed-days EXCLUDE_RECENT_SCRUBBED_DAYS
|
|
21
|
+
Exclude mounts scrubbed within this many days
|
|
22
|
+
--scrub-command-lockout SCRUB_COMMAND_LOCKOUT
|
|
23
|
+
Seconds to wait after starting a scrub before starting another
|
|
24
|
+
--color {auto,always,never}
|
|
25
|
+
Colour output: auto (default) on a terminal unless NO_COLOR is set
|
|
26
|
+
-V, --version show program's version number and exit
|
|
27
|
+
|
|
28
|
+
Exit status: 0 healthy; 1 problems found (device errors, scrub errors or missing devices); 2 the
|
|
29
|
+
check failed (no matching mounts, an unreadable filesystem, no root); 130 interrupted; 141 the
|
|
30
|
+
reader of stdout went away (| head).
|
|
31
|
+
|
|
32
|
+
Known limitation: when each btrfs command has to run through sudo, a missing btrfs shows as "Could not fetch
|
|
33
|
+
complete info … Skipping…" rather than "btrfs not found on PATH" (see docs/limitations.md).
|
|
34
|
+
|
|
35
|
+
Upgrading to 0.39 from 0.38:
|
|
36
|
+
- The embedded multiCMD is now 1.57. It runs whenever the installed multiCMD is older, so multiCMD itself need not be upgraded. On EL7 and EL8, stock pip 9.0.3 cannot upgrade multiCMD, so `pip3 install -U statbtrfs` fails there: use `pip3 install statbtrfs==0.39`, or upgrade pip first.
|
|
37
|
+
- Known: on EL7, btrfs-progs 4.9.1's scrub status is not read, so `-s` can say a scrub finished while it runs and the status columns stay `Never`. A checksum error still shows. Planned for 0.40.
|
|
38
|
+
- Faster command starts on Python 3.6 - 3.10, where the embedded multiCMD 1.57 imports only built-in
|
|
39
|
+
modules in the wrapper that puts each command in its own process group (about 7 ms to 3.5 ms of CPU
|
|
40
|
+
per command on Python 3.6.8). Nothing else about starting a command changes.
|
|
41
|
+
|
|
42
|
+
Upgrading to 0.38 from 0.37:
|
|
43
|
+
- multiCMD 1.56 or newer is required (the embedded copy is 1.56).
|
|
44
|
+
- An unreadable filesystem now prints only the note under the table, "Could not fetch complete info for
|
|
45
|
+
<mounts>. Skipping...". The three lines before it ("Could not parse btrfs show info.", "Output from btrfs
|
|
46
|
+
filesystem show was:" and the raw output) are gone.
|
|
47
|
+
- statbtrfs | head, or any reader that exits early, now ends quietly with exit 141 (128 + SIGPIPE)
|
|
48
|
+
instead of a BrokenPipeError traceback and exit 1.
|
|
49
|
+
- Ctrl-C outside -s and -w (say while btrfs hangs on a dying device) exits 130 quietly instead of a
|
|
50
|
+
traceback.
|
|
51
|
+
- -s and -w clear the screen with ESC[H ESC[J, so a long run no longer pushes tables into the scrollback of
|
|
52
|
+
terminals that treat ESC[2J that way.
|
|
53
|
+
- Library callers: find_btrfs_mounts() takes no argument and execute_command(s) lose wait=.
|
|
54
|
+
|
|
55
|
+
Install:
|
|
56
|
+
sudo pip install statbtrfs
|
|
57
|
+
|
|
58
|
+
Development:
|
|
59
|
+
pip install -r requirements-dev.txt
|
|
60
|
+
pytest # unit tests (offline)
|
|
61
|
+
pytest --cov=statbtrfs --cov-fail-under=85
|
|
62
|
+
pytest -m live # optional status-only smoke on a btrfs host (as root)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: statbtrfs
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.39
|
|
4
4
|
Summary: Query Btrfs filesystem status
|
|
5
5
|
Home-page: https://github.com/yufei-pan/statbtrfs
|
|
6
6
|
Author: Yufei Pan
|
|
@@ -12,7 +12,7 @@ Classifier: Operating System :: POSIX :: Linux
|
|
|
12
12
|
Requires-Python: >=3.6
|
|
13
13
|
Description-Content-Type: text/plain
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist: multiCMD>=1.
|
|
15
|
+
Requires-Dist: multiCMD>=1.56
|
|
16
16
|
Provides-Extra: completion
|
|
17
17
|
Requires-Dist: argcomplete; extra == "completion"
|
|
18
18
|
Dynamic: author
|
|
@@ -56,7 +56,31 @@ options:
|
|
|
56
56
|
-V, --version show program's version number and exit
|
|
57
57
|
|
|
58
58
|
Exit status: 0 healthy; 1 problems found (device errors, scrub errors or missing devices); 2 the
|
|
59
|
-
check failed (no matching mounts, an unreadable filesystem, no root); 130 interrupted
|
|
59
|
+
check failed (no matching mounts, an unreadable filesystem, no root); 130 interrupted; 141 the
|
|
60
|
+
reader of stdout went away (| head).
|
|
61
|
+
|
|
62
|
+
Known limitation: when each btrfs command has to run through sudo, a missing btrfs shows as "Could not fetch
|
|
63
|
+
complete info … Skipping…" rather than "btrfs not found on PATH" (see docs/limitations.md).
|
|
64
|
+
|
|
65
|
+
Upgrading to 0.39 from 0.38:
|
|
66
|
+
- The embedded multiCMD is now 1.57. It runs whenever the installed multiCMD is older, so multiCMD itself need not be upgraded. On EL7 and EL8, stock pip 9.0.3 cannot upgrade multiCMD, so `pip3 install -U statbtrfs` fails there: use `pip3 install statbtrfs==0.39`, or upgrade pip first.
|
|
67
|
+
- Known: on EL7, btrfs-progs 4.9.1's scrub status is not read, so `-s` can say a scrub finished while it runs and the status columns stay `Never`. A checksum error still shows. Planned for 0.40.
|
|
68
|
+
- Faster command starts on Python 3.6 - 3.10, where the embedded multiCMD 1.57 imports only built-in
|
|
69
|
+
modules in the wrapper that puts each command in its own process group (about 7 ms to 3.5 ms of CPU
|
|
70
|
+
per command on Python 3.6.8). Nothing else about starting a command changes.
|
|
71
|
+
|
|
72
|
+
Upgrading to 0.38 from 0.37:
|
|
73
|
+
- multiCMD 1.56 or newer is required (the embedded copy is 1.56).
|
|
74
|
+
- An unreadable filesystem now prints only the note under the table, "Could not fetch complete info for
|
|
75
|
+
<mounts>. Skipping...". The three lines before it ("Could not parse btrfs show info.", "Output from btrfs
|
|
76
|
+
filesystem show was:" and the raw output) are gone.
|
|
77
|
+
- statbtrfs | head, or any reader that exits early, now ends quietly with exit 141 (128 + SIGPIPE)
|
|
78
|
+
instead of a BrokenPipeError traceback and exit 1.
|
|
79
|
+
- Ctrl-C outside -s and -w (say while btrfs hangs on a dying device) exits 130 quietly instead of a
|
|
80
|
+
traceback.
|
|
81
|
+
- -s and -w clear the screen with ESC[H ESC[J, so a long run no longer pushes tables into the scrollback of
|
|
82
|
+
terminals that treat ESC[2J that way.
|
|
83
|
+
- Library callers: find_btrfs_mounts() takes no argument and execute_command(s) lose wait=.
|
|
60
84
|
|
|
61
85
|
Install:
|
|
62
86
|
sudo pip install statbtrfs
|