FEMM 5

Модули и функции · встроенный MicroPython FEMM 5

base64

Текстовое кодирование двоичных данных.

Условия работы

base64.b64encodeКодирует небольшие бинарные блоки результатов.

base64.b64encode

b64encode(s, altchars=None)

Кодирует небольшие бинарные блоки результатов.

Аргументы

Аргументы вызова base64.b64encode
ИмяНазначение и допустимые значения
sБайтовые данные.
altcharsNone или два байта, заменяющие + и /.

Возвращаемое значение

bytes Base64.

Пример

MicroPython FEMM 5
"Пример base64.b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует небольшие бинарные блоки результатов.\nРезультат: bytes Base64."

import base64
assert base64.b64encode(b'FEMM') == b'RkVNTQ=='

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.b64decodeДекодирует Base64; корректное дополнение = обязательно.

base64.b64decode

b64decode(s, altchars=None, validate=False)

Декодирует Base64; корректное дополнение = обязательно.

Аргументы

Аргументы вызова base64.b64decode
ИмяНазначение и допустимые значения
sBase64 как bytes или ASCII-строка.
altcharsАльтернативная пара символов алфавита.
validateTrue запрещает посторонние символы до проверки дополнения.

Возвращаемое значение

Исходные bytes.

Особенности вызова

  • validate=True использует байтовый шаблон re, неработающий в этой сборке; используйте validate=False и проверяйте формат входных данных отдельно.

Пример

MicroPython FEMM 5
"Пример base64.b64decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует Base64; корректное дополнение = обязательно.\nРезультат: Исходные bytes."

import base64
assert base64.b64decode(b'RkVNTQ==') == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.standard_b64encodeКодирует стандартным алфавитом.

base64.standard_b64encode

standard_b64encode(s)

Кодирует стандартным алфавитом.

Аргументы

Аргументы вызова base64.standard_b64encode
ИмяНазначение и допустимые значения
sБайтовые данные.

Возвращаемое значение

bytes Base64.

Пример

MicroPython FEMM 5
"Пример base64.standard_b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует стандартным алфавитом.\nРезультат: bytes Base64."

import base64
assert base64.standard_b64encode(b'A') == b'QQ=='

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.standard_b64decodeДекодирует стандартный Base64.

base64.standard_b64decode

standard_b64decode(s)

Декодирует стандартный Base64.

Аргументы

Аргументы вызова base64.standard_b64decode
ИмяНазначение и допустимые значения
sBase64 как bytes или ASCII-строка.

Возвращаемое значение

Исходные bytes.

Пример

MicroPython FEMM 5
"Пример base64.standard_b64decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует стандартный Base64.\nРезультат: Исходные bytes."

import base64
assert base64.standard_b64decode(b'QQ==') == b'A'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.urlsafe_b64encodeКодирует данные для имени или URL-параметра; символ = сохраняется.

base64.urlsafe_b64encode

urlsafe_b64encode(s)

Кодирует данные для имени или URL-параметра; символ = сохраняется.

Аргументы

Аргументы вызова base64.urlsafe_b64encode
ИмяНазначение и допустимые значения
sБайтовые данные.

Возвращаемое значение

bytes с - и _ вместо + и /.

Пример

MicroPython FEMM 5
"Пример base64.urlsafe_b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует данные для имени или URL-параметра; символ = сохраняется.\nРезультат: bytes с - и _ вместо + и /."

import base64
assert base64.urlsafe_b64encode(bytes([255])) == b'_w=='

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.urlsafe_b64decodeИмя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b"-_").

base64.urlsafe_b64decode

urlsafe_b64decode(s)

Имя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b"-_").

Аргументы

Аргументы вызова base64.urlsafe_b64decode
ИмяНазначение и допустимые значения
sДанные алфавита Base64 с - и _.

Возвращаемое значение

NotImplementedError при вызове в проверенной сборке.

Пример

MicroPython FEMM 5
"Пример base64.urlsafe_b64decode.\nСреда: встроенный MicroPython FEMM 5.\nИмя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b\"-_\").\nРезультат: NotImplementedError при вызове в проверенной сборке."

import base64
try:
    base64.urlsafe_b64decode(b'_w==')
except NotImplementedError:
    pass
else:
    raise AssertionError("expected NotImplementedError")

Ожидаемый результат. Получено и перехвачено ожидаемое исключение NotImplementedError.

Скачать пример · Ссылка на функцию

Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.

base64.b32encodeКодирует буквенно-цифровым алфавитом Base32.

base64.b32encode

b32encode(s)

Кодирует буквенно-цифровым алфавитом Base32.

Аргументы

Аргументы вызова base64.b32encode
ИмяНазначение и допустимые значения
sБайтовые данные.

Возвращаемое значение

bytes Base32.

Пример

MicroPython FEMM 5
"Пример base64.b32encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует буквенно-цифровым алфавитом Base32.\nРезультат: bytes Base32."

import base64
assert base64.b32encode(b'A') == b'IE======'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.b32decodeДекодирует Base32 с явно заданными послаблениями алфавита.

base64.b32decode

b32decode(s, casefold=False, map01=None)

Декодирует Base32 с явно заданными послаблениями алфавита.

Аргументы

Аргументы вызова base64.b32decode
ИмяНазначение и допустимые значения
sДанные Base32.
casefoldРазрешать строчные буквы.
map01None запрещает 0/1; I или L задаёт замену 1, при этом 0 заменяется на O.

Возвращаемое значение

Исходные bytes.

Пример

MicroPython FEMM 5
"Пример base64.b32decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует Base32 с явно заданными послаблениями алфавита.\nРезультат: Исходные bytes."

import base64
assert base64.b32decode(b'IE======') == b'A'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.b16encodeПредставляет каждый байт двумя цифрами.

base64.b16encode

b16encode(s)

Представляет каждый байт двумя цифрами.

Аргументы

Аргументы вызова base64.b16encode
ИмяНазначение и допустимые значения
sБайтовые данные.

Возвращаемое значение

bytes с прописными шестнадцатеричными цифрами.

Пример

MicroPython FEMM 5
"Пример base64.b16encode.\nСреда: встроенный MicroPython FEMM 5.\nПредставляет каждый байт двумя цифрами.\nРезультат: bytes с прописными шестнадцатеричными цифрами."

import base64
assert base64.b16encode(b'AB') == b'4142'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.b16decodeПроверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.

base64.b16decode

b16decode(s, casefold=False)

Проверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.

Аргументы

Аргументы вызова base64.b16decode
ИмяНазначение и допустимые значения
sБайтовое или строковое шестнадцатеричное представление.
casefoldРазрешать строчные a–f.

Возвращаемое значение

TypeError при вызове в проверенной сборке.

Пример

MicroPython FEMM 5
"Пример base64.b16decode.\nСреда: встроенный MicroPython FEMM 5.\nПроверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.\nРезультат: TypeError при вызове в проверенной сборке."

import base64
try:
    base64.b16decode(b'4142')
except TypeError:
    pass
else:
    raise AssertionError("expected TypeError")

Ожидаемый результат. Получено и перехвачено ожидаемое исключение TypeError.

Скачать пример · Ссылка на функцию

Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.

base64.encodebytesКодирует многострочное текстовое представление.

base64.encodebytes

encodebytes(s)

Кодирует многострочное текстовое представление.

Аргументы

Аргументы вызова base64.encodebytes
ИмяНазначение и допустимые значения
sБайтовые данные.

Возвращаемое значение

bytes Base64 с переносами строк.

Пример

MicroPython FEMM 5
"Пример base64.encodebytes.\nСреда: встроенный MicroPython FEMM 5.\nКодирует многострочное текстовое представление.\nРезультат: bytes Base64 с переносами строк."

import base64
assert base64.decodebytes(base64.encodebytes(b'FEMM')) == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.decodebytesУбирает форматирование многострочного Base64.

base64.decodebytes

decodebytes(s)

Убирает форматирование многострочного Base64.

Аргументы

Аргументы вызова base64.decodebytes
ИмяНазначение и допустимые значения
sБайтовое многострочное представление Base64.

Возвращаемое значение

Исходные bytes.

Пример

MicroPython FEMM 5
"Пример base64.decodebytes.\nСреда: встроенный MicroPython FEMM 5.\nУбирает форматирование многострочного Base64.\nРезультат: Исходные bytes."

import base64
assert base64.decodebytes(b'QQ==') == b'A'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.encodeПотоковое кодирование Base64.

base64.encode

encode(input, output)

Потоковое кодирование Base64.

Аргументы

Аргументы вызова base64.encode
ИмяНазначение и допустимые значения
inputОткрытый двоичный поток с read/readline.
outputДвоичный поток с write.

Возвращаемое значение

None.

Пример

MicroPython FEMM 5
"Пример base64.encode.\nСреда: встроенный MicroPython FEMM 5.\nПотоковое кодирование Base64.\nРезультат: None."

import base64
import io
src = io.BytesIO(b'FEMM')
dst = io.BytesIO()
base64.encode(src,dst)
assert base64.b64decode(dst.getvalue()) == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.decodeПотоковое восстановление двоичных данных.

base64.decode

decode(input, output)

Потоковое восстановление двоичных данных.

Аргументы

Аргументы вызова base64.decode
ИмяНазначение и допустимые значения
inputДвоичный поток Base64.
outputДвоичный поток назначения.

Возвращаемое значение

None.

Пример

MicroPython FEMM 5
"Пример base64.decode.\nСреда: встроенный MicroPython FEMM 5.\nПотоковое восстановление двоичных данных.\nРезультат: None."

import base64
import io
src = io.BytesIO(b'RkVNTQ==')
dst = io.BytesIO()
base64.decode(src,dst)
assert dst.getvalue() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

base64.encodestringУстаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.

base64.encodestring

encodestring(s)

Устаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.

Аргументы

Аргументы вызова base64.encodestring
ИмяНазначение и допустимые значения
sБайтовые данные соответствующего формата.

Возвращаемое значение

ImportError при вызове в проверенной сборке.

Пример

MicroPython FEMM 5
"Пример base64.encodestring.\nСреда: встроенный MicroPython FEMM 5.\nУстаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.\nРезультат: ImportError при вызове в проверенной сборке."

import base64
try:
    base64.encodestring(b'QQ==')
except ImportError:
    pass
else:
    raise AssertionError("expected ImportError")

Ожидаемый результат. Получено и перехвачено ожидаемое исключение ImportError.

Скачать пример · Ссылка на функцию

Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.

base64.decodestringУстаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.

base64.decodestring

decodestring(s)

Устаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.

Аргументы

Аргументы вызова base64.decodestring
ИмяНазначение и допустимые значения
sБайтовые данные соответствующего формата.

Возвращаемое значение

ImportError при вызове в проверенной сборке.

Пример

MicroPython FEMM 5
"Пример base64.decodestring.\nСреда: встроенный MicroPython FEMM 5.\nУстаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.\nРезультат: ImportError при вызове в проверенной сборке."

import base64
try:
    base64.decodestring(b'QQ==')
except ImportError:
    pass
else:
    raise AssertionError("expected ImportError")

Ожидаемый результат. Получено и перехвачено ожидаемое исключение ImportError.

Скачать пример · Ссылка на функцию

Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.

Имена в установленной сборке

Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.