add doc/en/scripting/filesystem.md

This commit is contained in:
MihailRis
2024-06-13 20:12:49 +03:00
parent 1081c74afb
commit 14b0ec08f7
3 changed files with 99 additions and 102 deletions
+5 -4
View File
@@ -1,10 +1,12 @@
# Файловая система и сериализация
## Библиотека *file*
Библиотека функций для работы с файлами
```python
file.resolve(путь: str) -> str
```
```
Функция приводит запись `точка_входа:путь` (например `user:worlds/house1`) к обычному пути. (например `C://Users/user/.voxeng/worlds/house1`)
@@ -127,11 +129,10 @@ toml.parse(code: str) -> table
При сохранении данных пака в мире следует использовать функцию
```python
pack.data_file(packid: str, filename: str) -> str
pack.data_file(id_пака: str, имя_файла: str) -> str
```
Функция возвращает путь к файлу данных по типу: `world:data/packid/filename`
Функция возвращает путь к файлу данных по типу: `world:data/id_пака/имя_файла`
и создает недостающие директории в пути.
При использовании путей не соответствующим `data/{packid}/...` возможна потеря данных при перезаписи мира.