naturalsize 1.0.17

get human-readable size of files

naturalsize

A Python toolkit for getting human-readable size of file and more

History

Originally designed only to return the human-readable size of a file,
naturalsize has developed itself to a Python toolkit with many useful functions.

Installation

Using pip

You can install naturalsize via pip using

in a commandline:

py -m pip install naturalsize

in a python script:

import os
os.system('py -m pip install naturalsize')

Usage

naturalsize has many functions:

about() returns information about your release

nsize returns the human-readable filesize:

naturalsize.nsize(556677)

returns the size of a 556677 B large file.
The args are:
size for the files size in B
comma for the rounding of the size (default: 2)
base2 uses 1024 instead of 1000 as the base for the size (default: True)
names as a list of names you give to file size units (default: ["B", "KB", "MB", "GB", ...])

randprinter prints random signs the following:

naturalsize.randprinter(2000)

This prints 2000 random signs.
Args are:
numb for the number of signs (default: 1000)
signs as the list signs are chosen from (default: ["a", "b", "c", ...])

randprinter_ returns a callable randprinter object with the given specifications

special_starter waits for a given time and returns whether the user pressed Ctrl+c in this time:

naturalsize.special_starter(100000000)

passes 100 000 000 times and returns then False if the user hasn't interrupted the process.
True is returned if the user interrupted.
Args are:
numbThe number the program passes before returning False (default: 150000000)

isInt returns whether a given object is an integer or a float, if this is accepted via the acceptFloat arg

listToInt sums up all integer or float, if this is accepted via the acceptFloat arg, and returns this
Note that the acceptFloat arg is False by default.

reverse inverses the given boolean

replStr replaces a part of a string the following:

naturalsize.replStr(1, "adc", "b")

returns 'abc' as it replaces the value at index of a string with another string.
The args are:
index for the index the replacement is to be at (default: 0)
strObj as the string replaced in (default: 'a')
setIn as the string set in the other string (default: 'b')

replStrPassage replaces a passage of a string using the above function the following:

naturalsize.replStrPassage(1, 2, "adec", "b")

returns 'abc' as it replaces the values from indexstart to indexend of a string with another string.
The index arg is split up into indexstart and indexend args
for the begin and the end of the to-be-replaced passage (default: 0/1).

More coming soon...