Each Lair comes with an attached file system that is fully encapsulated, i.e., cannot be accessed by files or processes within other Lairs. Each Lair is represented as a directory within the workspace, but modifying its contents is most similar to rebuilding a Docker image.
| └── my-app.py
Files can be referenced by their relative path (the current directory is your Lair directory), and certain directories and files are protected, including:
- Lair directory
.wayscriptdirectories and nested files
Create a new file or directory
Create a file or directory within your Lair's file system by pressing ＋ next to the search bar.
You can also upload a file or directory from your local device's file system by dragging it into your Lair's file system.
Select a file to open and modify its contents within WayScript's in-built editor.
When using the WayScript desktop app, your file system exists in two places:
- Remote - on cloud infrastructure (self-hosted or WayScript managed)
- Local - on your local device
The WayScript desktop app creates and accesses files on your local device and then syncs those files to your remote infrastructure.
Setting up your file sync between remote and local
On first launch of the WayScript desktop app, follow the prompts to choose a local
homedirectory to sync WayScript files between remote and your local device. Our tool will then create a new directory with the names of your workspaces within the specified directory and download files present on remote.
The WayScript file system accesses your local files through the in-app file browser. You can open multiple files in a tab view and edit file content using the app's in-built text editor.
Pressing “Fetch” will evaluate whether there are changes that have not be downloaded from remote to your local machine. The app will also automatically “Fetch” before protected actions such as starting a new process or updating your integrations.
Pressing “Pull” will attempt to download files from remote to your local machine, based on the following rules:
- If the file has been modified or created in remote and NOT modified on your local machine, the remote file will replace your local file.
- If the file has been modified on your local machine, you will be asked if you would like to overwrite the local file with the remote file.
Pressing “Push” will attempt to upload your local machine’s workspace to replace your remote workspace.
homedirectory on your local machine is initialized with a strict directory structure and helper files to ensure data integrity in the WayScript file system. Please exercise caution when completing the following local file operations:
- Adding package directories with an extremely high number of files (such as
node_modules) to your Lair directory may result in an error while syncing. We recommend building your tool outside the Lair filesystem and then copying your project folder into your Lair directory.
- Placing files outside of Lair directories (e.g.,
myworkspace > myfile.py) may result in an invalid workspace state and require you to reconfigure your
- Modifying the
.wayscriptdirectories and nested files stored under your workspace root directory and Lair directories may result in an unresponsive app state. These files are used for configuration or identification purposes.