Модули и функции · встроенный MicroPython FEMM 5
os
Рабочий каталог, файлы, папки и окружение процесса FEMM.
Условия работы
- Пути рекомендуется записывать с /, например C:/projects/motor.fem. Изменение текущего каталога действует на весь интерпретатор.
- stat возвращает список из 10 целых: mode, ino, dev, nlink, uid, gid, size, atime, mtime, ctime. Индекс 6 — размер в байтах. Это фактический результат преобразования C++ vector в Python list.
- Константа sep задаёт системный разделитель. Ошибки файловых операций имеют тип OSError.
os.getcwdos.chdiros.getenvos.listdiros.mkdiros.makedirsos.statos.removeos.unlinkos.rmdiros.renameos.getcwdЧитает базу относительных путей.
os.getcwd
getcwd()Читает базу относительных путей.
Аргументы
Аргументы не требуются.
Возвращаемое значение
Строка абсолютного текущего каталога.
Пример
"Пример os.getcwd.\nСреда: встроенный MicroPython FEMM 5.\nЧитает базу относительных путей.\nРезультат: Строка абсолютного текущего каталога."
import os
assert isinstance(os.getcwd(),str)
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
os.chdirМеняет базу относительных путей; в конце примера исходный каталог восстанавливается.
os.chdir
chdir(path)Меняет базу относительных путей; в конце примера исходный каталог восстанавливается.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Существующий каталог. |
Возвращаемое значение
None.
Пример
"Пример 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.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
name | Имя переменной окружения. |
default | Строка для отсутствующей переменной либо None. |
Возвращаемое значение
Строка значения либо default.
Пример
"Пример 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=".")Читает элементы каталога; порядок не гарантирован.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Каталог для перечисления. |
Возвращаемое значение
Список имён без общего родительского пути.
Пример
"Пример 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)Создаёт одну папку.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Новый каталог; родитель должен существовать. |
Возвращаемое значение
None.
Пример
"Пример 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)Создаёт каталог вместе с отсутствующими родителями.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Цепочка каталогов. |
Возвращаемое значение
None.
Пример
"Пример 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)Читает свойства файла.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Путь существующего объекта. |
Возвращаемое значение
Список из 10 целых; индекс 0 — режим, 6 — размер в байтах.
Пример
"Пример 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)Удаляет файл. Пример касается только созданного им рабочего файла.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Путь файла для удаления. |
Возвращаемое значение
None.
Пример
"Пример 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)Удаляет файл. Пример касается только созданного им рабочего файла.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Путь файла для удаления. |
Возвращаемое значение
None.
Пример
"Пример 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)Удаляет одну пустую папку.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
path | Пустой существующий каталог. |
Возвращаемое значение
None.
Пример
"Пример 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.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
src | Исходное имя файла/каталога. |
dst | Новое имя. |
Возвращаемое значение
None.
Пример
"Пример 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.