iterfilesystem 1.4.3

IterFilesystem

Multiprocess directory iteration via os.scandir()

Who’s this Lib for?

You want to process a large number of files and/or a few very big files and give feedback to the user on how long it will take.

Example

Use example CLI, e.g.:

~$ git clone https://github.com/jedie/IterFilesystem.git
~$ cd IterFilesystem
~/IterFilesystem$ pipenv install
~/IterFilesystem$ pipenv shell
(IterFilesystem) ~/IterFilesystem$ print_fs_stats --help
(IterFilesystem) ~/IterFilesystem$ pip install -e .
...
Successfully installed iterfilesystem

~/IterFilesystem$ $ poetry run print_fs_stats --help
usage: print_fs_stats.py [-h] [-v] [--debug] [--path PATH]
                         [--skip_dir_patterns [SKIP_DIR_PATTERNS [SKIP_DIR_PATTERNS ...]]]
                         [--skip_file_patterns [SKIP_FILE_PATTERNS [SKIP_FILE_PATTERNS ...]]]

Scan filesystem and print some information

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  --debug               enable DEBUG
  --path PATH           The file path that should be scanned e.g.: "~/foobar/"
                        default is "~"
  --skip_dir_patterns [SKIP_DIR_PATTERNS [SKIP_DIR_PATTERNS ...]]
                        Directory names to exclude from scan.
  --skip_file_patterns [SKIP_FILE_PATTERNS [SKIP_FILE_PATTERNS ...]]
                        File names to ignore.

example output looks like this:

(IterFilesystem) ~/IterFilesystem$ $ print_fs_stats --path ~/IterFilesystem --skip_dir_patterns ".*" "*.egg-info" --skip_file_patterns ".*"
Read/process: '~/IterFilesystem'...
Skip directory patterns:
    * .*
    * *.egg-info

Skip file patterns:
    * .*

Filesystem items..:Read/process: '~/IterFilesystem'...

...

Filesystem items..: 100%|█████████████████████████████████████████|135/135 13737.14entries/s [00:00<00:00, 13737.14entries/s]
File sizes........: 100%|██████████████████████████████████████████████████████████████|843k/843k [00:00<00:00, 88.5MBytes/s]
Average progress..: 100%|███████████████████████████████████████████████████████████████████████████████████████|00:00<00:00
Current File......:, /home/jens/repos/IterFilesystem/Pipfile


Processed 135 filesystem items in 0.02 sec
SHA515 hash calculated over all file content: 10f9475b21977f5aea1d4657a0e09ad153a594ab30abc2383bf107dbc60c430928596e368ebefab3e78ede61dcc101cb638a845348fe908786cb8754393439ef
File count: 109
Total file size: 843.5 KB
6 directories skipped.
6 files skipped.

History

• **dev** - compare v1.4.3…master

  • TBC

• 16.03.2020 - v1.4.3

  • Use logging and remove “verbose mode”

  • Nicer “Average progess” bar

  • Bugfix “Current File” bar: remove comma

• 16.02.2020 - v1.4.2

  • iterate over sorted dir entries

  • update CI pipelines

• 02.02.2020 - v1.4.1

  • Bugfix human_filesize

• 02.02.2020 - v1.4.0

  • stats_helper.abort exists always usefull to get information if KeyboardInterrupt was used

  • use poetry and modernize project setup

• 20.10.2019 - v1.3.1

  • Bugfix if scan directory is completely empty

• 13.10.2019 - v1.3.0

  • Set ionice and nice priority via psutils

• 13.10.2019 - v1.2.0

  • Refactor API

  • cleanup statistics and process bar

  • handle access errors like: Permission denied

  • fix tests

• 12.10.2019 - v1.1.0

  • don’t create separate process for worker: Just do the work in main process

  • dir/file filter uses now fnmatch

• 12.10.2019 - v1.0.0

  • refactoring:

    • don’t use persist-queue

    • switch from threading to multiprocessing

    • enhance progress display with multiple tqdm process bars

• 15.09.2019 - v0.2.0

  • store persist queue in temp directory

  • Don’t catch process_path_item errors, this should be made in child class

• 15.09.2019 - v0.1.0

  • add some project meta files and tests

  • setup CI

  • fix tests

• 15.09.2019 - v0.0.1

  • first Release on PyPi

Links

• https://pypi.python.org/pypi/IterFilesystem/

• https://github.com/jedie/IterFilesystem/

Donating

• paypal.me/JensDiemer

• Flattr This!

• Send Bitcoins to 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F

Note: this file is generated from README.creole 2020-03-16 18:09:30 with "python-creole"