Модули и функции · встроенный 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.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.