mirror of
https://github.com/ansible-collections/community.crypto.git
synced 2026-03-27 13:53:24 +00:00
a5a4e022ba
* Add leading underscore. Remove deprecated module utils. * Document module and plugin utils as private. Add changelog fragment. * Convert relative to absolute imports. * Remove unnecessary imports.
57 lines
1.9 KiB
Python
57 lines
1.9 KiB
Python
# Copyright (c) 2024, Felix Fontein <felix@fontein.de>
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
|
|
# Do not use this from other collections or standalone plugins/modules!
|
|
|
|
from __future__ import annotations
|
|
|
|
from ansible.module_utils.common.text.converters import to_native
|
|
from ansible_collections.community.crypto.plugins.module_utils._crypto.math import (
|
|
convert_int_to_hex,
|
|
)
|
|
|
|
|
|
def th(number: int) -> str:
|
|
abs_number = abs(number)
|
|
mod_10 = abs_number % 10
|
|
mod_100 = abs_number % 100
|
|
if mod_100 not in (11, 12, 13):
|
|
if mod_10 == 1:
|
|
return "st"
|
|
if mod_10 == 2:
|
|
return "nd"
|
|
if mod_10 == 3:
|
|
return "rd"
|
|
return "th"
|
|
|
|
|
|
def parse_serial(value: str | bytes) -> int:
|
|
"""
|
|
Given a colon-separated string of hexadecimal byte values, converts it to an integer.
|
|
"""
|
|
value_str = to_native(value)
|
|
result = 0
|
|
for i, part in enumerate(value_str.split(":")):
|
|
try:
|
|
part_value = int(part, 16)
|
|
if part_value < 0 or part_value > 255:
|
|
raise ValueError("the value is not in range [0, 255]")
|
|
except ValueError as exc:
|
|
raise ValueError(
|
|
f"The {i + 1}{th(i + 1)} part {part!r} is not a hexadecimal number in range [0, 255]: {exc}"
|
|
)
|
|
result = (result << 8) | part_value
|
|
return result
|
|
|
|
|
|
def to_serial(value: int) -> str:
|
|
"""
|
|
Given an integer, converts its absolute value to a colon-separated string of hexadecimal byte values.
|
|
"""
|
|
value_str = convert_int_to_hex(value).upper()
|
|
if len(value_str) % 2 != 0:
|
|
value_str = f"0{value_str}"
|
|
return ":".join(value_str[i : i + 2] for i in range(0, len(value_str), 2))
|