libervia-backend: libervia/backend/tools/common/utils.py annotate

annotate libervia/backend/tools/common/utils.py @ 4351:6a0a081485b8

plugin autocrypt: Autocrypt protocol implementation: Implementation of autocrypt: `autocrypt` header is checked, and if present and no public key is known for the peer, the key is imported. `autocrypt` header is also added to outgoing message (only if an email gateway is detected). For the moment, the JID is use as identifier, but the real email used by gateway should be used in the future. rel 456

author	Goffi <goffi@goffi.org>
date	Fri, 28 Feb 2025 09:23:35 +0100
parents	0d7bb4df2343
children

rev	line source
3045 6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	1 #!/usr/bin/env python3
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	2
3480 7550ae9cfbac Renamed the project from "Salut à Toi" to "Libervia": Goffi <goffi@goffi.org> parents: 3479 diff changeset	3 # Libervia: an XMPP client
3479 be6d91572633 date update Goffi <goffi@goffi.org> parents: 3292 diff changeset	4 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
3045 6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	5
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	6 # This program is free software: you can redistribute it and/or modify
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	7 # it under the terms of the GNU Affero General Public License as published by
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	8 # the Free Software Foundation, either version 3 of the License, or
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	9 # (at your option) any later version.
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	10
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	11 # This program is distributed in the hope that it will be useful,
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	14 # GNU Affero General Public License for more details.
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	15
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	16 # You should have received a copy of the GNU Affero General Public License
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	18
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	19 """Misc utils for both backend and frontends"""
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	20
3265 1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	21 import collections.abc
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	22
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	23 size_units = {
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	24 "b": 1,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	25 "kb": 1000,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	26 "mb": 1000**2,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	27 "gb": 1000**3,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	28 "tb": 1000**4,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	29 "pb": 1000**5,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	30 "eb": 1000**6,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	31 "zb": 1000**7,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	32 "yb": 1000**8,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	33 "o": 1,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	34 "ko": 1000,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	35 "mo": 1000**2,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	36 "go": 1000**3,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	37 "to": 1000**4,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	38 "po": 1000**5,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	39 "eo": 1000**6,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	40 "zo": 1000**7,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	41 "yo": 1000**8,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	42 "kib": 1024,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	43 "mib": 1024**2,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	44 "gib": 1024**3,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	45 "tib": 1024**4,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	46 "pib": 1024**5,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	47 "eib": 1024**6,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	48 "zib": 1024**7,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	49 "yib": 1024**8,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	50 "kio": 1024,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	51 "mio": 1024**2,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	52 "gio": 1024**3,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	53 "tio": 1024**4,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	54 "pio": 1024**5,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	55 "eio": 1024**6,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	56 "zio": 1024**7,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	57 "yio": 1024**8,
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	58 }
3265 1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	59
3045 6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	60
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	61 def per_luminance(red, green, blue):
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	62 """Caculate the perceived luminance of a RGB color
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	63
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	64 @param red(int): 0-1 normalized value of red
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	65 @param green(int): 0-1 normalized value of green
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	66 @param blue(int): 0-1 normalized value of blue
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	67 @return (float): 0-1 value of luminance (<0.5 is dark, else it's light)
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	68 """
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	69 # cf. https://stackoverflow.com/a/1855903, thanks Gacek
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	70
6af44ca3beac tools (common): helping method to calculate luminance: Goffi <goffi@goffi.org> parents: diff changeset	71 return 0.299 * red + 0.587 * green + 0.114 * blue
3265 1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	72
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	73
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	74 def recursive_update(ori: dict, update: dict):
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	75 """Recursively update a dictionary"""
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	76 # cf. https://stackoverflow.com/a/3233356, thanks Alex Martelli
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	77 for k, v in update.items():
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	78 if isinstance(v, collections.abc.Mapping):
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	79 ori[k] = recursive_update(ori.get(k, {}), v)
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	80 else:
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	81 ori[k] = v
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	82 return ori
1649bbe8d07e tools (common/utils): new `recursive_update` method for dicts Goffi <goffi@goffi.org> parents: 3136 diff changeset	83
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	84
3292 84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	85 class OrderedSet(collections.abc.MutableSet):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	86 """A mutable sequence which doesn't keep duplicates"""
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	87
3292 84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	88 # TODO: complete missing set methods
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	89
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	90 def __init__(self, values=None):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	91 self._dict = {}
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	92 if values is not None:
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	93 self.update(values)
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	94
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	95 def __len__(self):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	96 return len(self._dict)
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	97
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	98 def __iter__(self):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	99 return iter(self._dict.keys())
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	100
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	101 def __contains__(self, item):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	102 return item in self._dict
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	103
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	104 def add(self, item):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	105 self._dict[item] = None
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	106
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	107 def discard(self, item):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	108 try:
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	109 del self._dict[item]
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	110 except KeyError:
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	111 pass
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	112
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	113 def update(self, items):
84f77f04aa08 tools (common/utils): new OrderedSet class Goffi <goffi@goffi.org> parents: 3265 diff changeset	114 self._dict.update({i: None for i in items})
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	115
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	116
4037 524856bd7b19 massive refactoring to switch from camelCase to snake_case: Goffi <goffi@goffi.org> parents: 3524 diff changeset	117 def parse_size(size):
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	118 """Parse a file size with optional multiple symbole"""
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	119 try:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	120 return int(size)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	121 except ValueError:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	122 number = []
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	123 symbol = []
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	124 try:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	125 for c in size:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	126 if c == " ":
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	127 continue
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	128 if c.isdigit():
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	129 number.append(c)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	130 elif c.isalpha():
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	131 symbol.append(c)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	132 else:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	133 raise ValueError("unexpected char in size: {c!r} (size: {size!r})")
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	134 number = int("".join(number))
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	135 symbol = "".join(symbol)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	136 if symbol:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	137 try:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	138 multiplier = size_units[symbol.lower()]
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	139 except KeyError:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	140 raise ValueError(
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	141 "unknown size multiplier symbole: {symbol!r} (size: {size!r})"
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	142 )
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	143 else:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	144 return number * multiplier
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	145 return number
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	146 except Exception as e:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	147 raise ValueError(f"invalid size: {e}")
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	148
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	149
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	150 def get_size_multiplier(size: int \| str, suffix="o"):
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	151 """Get multiplier of a file size"""
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	152 size = int(size)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	153 # cf. https://stackoverflow.com/a/1094933 (thanks)
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	154 for unit in ["", "Ki", "Mi", "Gi", "Ti", "Pi", "Ei", "Zi"]:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	155 if abs(size) < 1024.0:
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	156 return size, f"{unit}{suffix}"
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	157 size /= 1024.0
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	158 return size, f"Yi{suffix}"
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	159
584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	160
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4231 diff changeset	161 def get_human_size(size: int \| str, suffix: str = "o", sep: str = " ") -> str:
4231 e11b13418ba6 plugin XEP-0353, XEP-0234, jingle: WebRTC data channel signaling implementation: Goffi <goffi@goffi.org> parents: 4071 diff changeset	162 """Return data size in a human readable format."""
4037 524856bd7b19 massive refactoring to switch from camelCase to snake_case: Goffi <goffi@goffi.org> parents: 3524 diff changeset	163 size, symbol = get_size_multiplier(size, suffix)
3524 584379473925 tools (common/utils): new methods to parse and generate file size with symbols: Goffi <goffi@goffi.org> parents: 3480 diff changeset	164 return f"{size:.2f}{sep}{symbol}"

Mercurial > libervia-backend

annotate libervia/backend/tools/common/utils.py @ 4351:6a0a081485b8