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.
Files changed (31) hide show
  1. {statbtrfs-0.37/statbtrfs.egg-info → statbtrfs-0.39}/PKG-INFO +27 -3
  2. statbtrfs-0.39/README.txt +62 -0
  3. {statbtrfs-0.37 → statbtrfs-0.39}/setup.py +1 -1
  4. {statbtrfs-0.37 → statbtrfs-0.39/statbtrfs.egg-info}/PKG-INFO +27 -3
  5. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/SOURCES.txt +1 -0
  6. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/requires.txt +1 -1
  7. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.py +215 -232
  8. statbtrfs-0.39/tests/test_broken_pipe.py +51 -0
  9. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_cli.py +14 -2
  10. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_filesystems.py +2 -3
  11. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_filter_recent.py +2 -2
  12. statbtrfs-0.39/tests/test_import_seams.py +17 -0
  13. statbtrfs-0.39/tests/test_live.py +16 -0
  14. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_mounts.py +3 -11
  15. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_show.py +2 -5
  16. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_scrub_orchestration.py +13 -0
  17. statbtrfs-0.37/README.txt +0 -38
  18. statbtrfs-0.37/tests/test_import_seams.py +0 -56
  19. statbtrfs-0.37/tests/test_live.py +0 -39
  20. {statbtrfs-0.37 → statbtrfs-0.39}/LICENSE +0 -0
  21. {statbtrfs-0.37 → statbtrfs-0.39}/setup.cfg +0 -0
  22. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/dependency_links.txt +0 -0
  23. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/entry_points.txt +0 -0
  24. {statbtrfs-0.37 → statbtrfs-0.39}/statbtrfs.egg-info/top_level.txt +0 -0
  25. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_color.py +0 -0
  26. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_options.py +0 -0
  27. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_output.py +0 -0
  28. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_scrub.py +0 -0
  29. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_parse_stats.py +0 -0
  30. {statbtrfs-0.37 → statbtrfs-0.39}/tests/test_privileges.py +0 -0
  31. {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.37
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.55
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)
@@ -17,7 +17,7 @@ setup(
17
17
  ],
18
18
  },
19
19
  install_requires=[
20
- 'multiCMD>=1.55',
20
+ 'multiCMD>=1.56',
21
21
  ],
22
22
  extras_require={
23
23
  'completion': [
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: statbtrfs
3
- Version: 0.37
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.55
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
@@ -8,6 +8,7 @@ statbtrfs.egg-info/dependency_links.txt
8
8
  statbtrfs.egg-info/entry_points.txt
9
9
  statbtrfs.egg-info/requires.txt
10
10
  statbtrfs.egg-info/top_level.txt
11
+ tests/test_broken_pipe.py
11
12
  tests/test_cli.py
12
13
  tests/test_color.py
13
14
  tests/test_filesystems.py
@@ -1,4 +1,4 @@
1
- multiCMD>=1.55
1
+ multiCMD>=1.56
2
2
 
3
3
  [completion]
4
4
  argcomplete