FEMM 5

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

os

Рабочий каталог, файлы, папки и окружение процесса FEMM.

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

os.getcwdЧитает базу относительных путей.

os.getcwd

getcwd()

Читает базу относительных путей.

Аргументы

Аргументы не требуются.

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

Строка абсолютного текущего каталога.

Пример

MicroPython FEMM 5
"Пример os.getcwd.\nСреда: встроенный MicroPython FEMM 5.\nЧитает базу относительных путей.\nРезультат: Строка абсолютного текущего каталога."

import os
assert isinstance(os.getcwd(),str)

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

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

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

os.chdirМеняет базу относительных путей; в конце примера исходный каталог восстанавливается.

os.chdir

chdir(path)

Меняет базу относительных путей; в конце примера исходный каталог восстанавливается.

Аргументы

Аргументы вызова os.chdir
ИмяНазначение и допустимые значения
pathСуществующий каталог.

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

None.

Пример

MicroPython FEMM 5
"Пример os.chdir.\nСреда: встроенный MicroPython FEMM 5.\nМеняет базу относительных путей; в конце примера исходный каталог восстанавливается.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
old=os.getcwd()
try:
    os.chdir(work)
    assert isinstance(os.getcwd(),str)
finally:
    os.chdir(old)

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

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

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

os.getenvЧитает только окружение процесса FEMM.

os.getenv

getenv(name, default=None)

Читает только окружение процесса FEMM.

Аргументы

Аргументы вызова os.getenv
ИмяНазначение и допустимые значения
nameИмя переменной окружения.
defaultСтрока для отсутствующей переменной либо None.

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

Строка значения либо default.

Пример

MicroPython FEMM 5
"Пример os.getenv.\nСреда: встроенный MicroPython FEMM 5.\nЧитает только окружение процесса FEMM.\nРезультат: Строка значения либо default."

import os
v=os.getenv('FEMM_DOC_EXAMPLE_UNSET_261016')
assert v is None or isinstance(v,str)

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

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

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

os.listdirЧитает элементы каталога; порядок не гарантирован.

os.listdir

listdir(path=".")

Читает элементы каталога; порядок не гарантирован.

Аргументы

Аргументы вызова os.listdir
ИмяНазначение и допустимые значения
pathКаталог для перечисления.

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

Список имён без общего родительского пути.

Пример

MicroPython FEMM 5
"Пример os.listdir.\nСреда: встроенный MicroPython FEMM 5.\nЧитает элементы каталога; порядок не гарантирован.\nРезультат: Список имён без общего родительского пути."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
with open(work+'/a.txt','w') as f:
    f.write('demo')
assert 'a.txt' in os.listdir(work)

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

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

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

os.mkdirСоздаёт одну папку.

os.mkdir

mkdir(path)

Создаёт одну папку.

Аргументы

Аргументы вызова os.mkdir
ИмяНазначение и допустимые значения
pathНовый каталог; родитель должен существовать.

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

None.

Пример

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

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
os.mkdir(work+'/child')
assert os.path.isdir(work+'/child')

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

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

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

os.makedirsСоздаёт каталог вместе с отсутствующими родителями.

os.makedirs

makedirs(path)

Создаёт каталог вместе с отсутствующими родителями.

Аргументы

Аргументы вызова os.makedirs
ИмяНазначение и допустимые значения
pathЦепочка каталогов.

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

None.

Пример

MicroPython FEMM 5
"Пример os.makedirs.\nСреда: встроенный MicroPython FEMM 5.\nСоздаёт каталог вместе с отсутствующими родителями.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
os.makedirs(work+'/a/b')
assert os.path.isdir(work+'/a/b')

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

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

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

os.statЧитает свойства файла.

os.stat

stat(path)

Читает свойства файла.

Аргументы

Аргументы вызова os.stat
ИмяНазначение и допустимые значения
pathПуть существующего объекта.

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

Список из 10 целых; индекс 0 — режим, 6 — размер в байтах.

Пример

MicroPython FEMM 5
"Пример os.stat.\nСреда: встроенный MicroPython FEMM 5.\nЧитает свойства файла.\nРезультат: Список из 10 целых; индекс 0 — режим, 6 — размер в байтах."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
p=work+'/a.txt'
with open(p,'w') as f:
    f.write('FEMM')
assert os.stat(p)[6] == 4

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

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

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

os.removeУдаляет файл. Пример касается только созданного им рабочего файла.

os.remove

remove(path)

Удаляет файл. Пример касается только созданного им рабочего файла.

Аргументы

Аргументы вызова os.remove
ИмяНазначение и допустимые значения
pathПуть файла для удаления.

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

None.

Пример

MicroPython FEMM 5
"Пример os.remove.\nСреда: встроенный MicroPython FEMM 5.\nУдаляет файл. Пример касается только созданного им рабочего файла.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
p=work+'/discard.txt'
with open(p,'w') as f:
    f.write('demo')
os.remove(p)
assert not os.path.exists(p)

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

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

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

os.unlinkУдаляет файл. Пример касается только созданного им рабочего файла.

os.unlink

unlink(path)

Удаляет файл. Пример касается только созданного им рабочего файла.

Аргументы

Аргументы вызова os.unlink
ИмяНазначение и допустимые значения
pathПуть файла для удаления.

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

None.

Пример

MicroPython FEMM 5
"Пример os.unlink.\nСреда: встроенный MicroPython FEMM 5.\nУдаляет файл. Пример касается только созданного им рабочего файла.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
p=work+'/discard.txt'
with open(p,'w') as f:
    f.write('demo')
os.unlink(p)
assert not os.path.exists(p)

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

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

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

os.rmdirУдаляет одну пустую папку.

os.rmdir

rmdir(path)

Удаляет одну пустую папку.

Аргументы

Аргументы вызова os.rmdir
ИмяНазначение и допустимые значения
pathПустой существующий каталог.

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

None.

Пример

MicroPython FEMM 5
"Пример os.rmdir.\nСреда: встроенный MicroPython FEMM 5.\nУдаляет одну пустую папку.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
p=work+'/empty'
os.mkdir(p)
os.rmdir(p)
assert not os.path.exists(p)

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

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

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

os.renameПереименовывает объект средствами системы; перенос между дисками может вызвать OSError.

os.rename

rename(src, dst)

Переименовывает объект средствами системы; перенос между дисками может вызвать OSError.

Аргументы

Аргументы вызова os.rename
ИмяНазначение и допустимые значения
srcИсходное имя файла/каталога.
dstНовое имя.

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

None.

Пример

MicroPython FEMM 5
"Пример os.rename.\nСреда: встроенный MicroPython FEMM 5.\nПереименовывает объект средствами системы; перенос между дисками может вызвать OSError.\nРезультат: None."

import os
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
a=work+'/a.txt'
b=work+'/b.txt'
with open(a,'w') as f:
    f.write('demo')
os.rename(a,b)
assert os.path.isfile(b) and not os.path.exists(a)

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

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

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

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

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