File browser
Organisation of the file system and its visual representation are two important tasks for convenient work on any project. The Engee platform provides its own solution for this purpose - File Browser. Git version control integration, easy navigation within the project, file handling and archiving help to organise the file system in Engee.
The File Browser 
is a tool for working with the file system in the Engee environment:
Working with the file browser
The file browser in Engee is denoted by the icon and is a tool for organising files and folders. Let’s take a look at the main features of the file browser.
Display settings
To display the desired columns of the file browser, click on the three-dot button and select Hide/show.
The file browser columns can be moved by dragging the header with the mouse. You can also change their width.
Navigating through the file structure
There are three ways to navigate within the file browser:
-
Click
and enter the name of the desired file in the search bar:
-
Use your mouse to switch between folders and files in the address bar of the file browser. Each folder and file in the address bar is clickable and allows you to navigate to their contents.
-
Enter the slash / and select the desired path using Tab or the left mouse button. The file browser will suggest available folders in your project path.
|
Use the option Return to a higher level
|
File management
To create folders, scripts, files and models, right-click on an empty area of the file browser or on an existing file or folder and select the function Create.
To create a model, click on 
in the Navigation bar.
|
When the system is started for the first time, a new model is created automatically in the Navigation panel. The model name by default is
|
To rename a file, right-click on the file name and select Rename from the menu that appears. Alternatively, you can left-click on the file and then click on the name again to open the edit bar.
Open the context menu by right-clicking on the file/folder and select the desired action. These operations are available for all files and folders in the project:
To add a file, click 
in the file browser or manually move the file to the desired project directory with the mouse. The file browser highlights the place where the file is added in blue colour. For example, let’s add an archive from the desktop.
In addition to archives, you can also move folders: left-click a folder and move it from your computer to the desired project directory. The location of the addition is also highlighted in blue:
In addition to adding an individual file, folders can also be added
You can download files and folders at once in an archive using the combination Ctrl+ left mouse button or Shift+ left mouse button to select several files and folders to open them in the context menu and download them in an archive.
To unzip files, double click on the archive name or select the operation Unpack in the context menu.
Working with Git
The file browser supports working with remote and local repositories using Git. The Engee file browser uses two approaches to create a repository:
-
Initialise a local repository - create your own local repository in the current directory (folder).
-
Clone a remote repository - create a copy of an existing remote repository and work with it as a local repository.
Repository initialisation
| To send changes from an initialised local repository to a remote repository, a link to a specific remote repository is required. Read more at Remote repository. |
Initialisation is the process of creating a new local repository in the current directory.
Create an empty folder in the file browser and navigate to it. Initialise Git by clicking the Init button:
After your repository is initialised locally, the Git file browser’s Git management menu will appear, where you should add a link to the remote repository:
If the remote repository is accessible and the address is entered correctly, a green tick mark will appear next to the link:
You can now work with the Git commands implemented in the file browser (Implemented commands).
| Remote repository - a repository that you plan to make local changes to from the file browser. For example, your own remote repository from GitLab Engee. Read more about creating it at here. |
Repository cloning
| To send changes from a cloned local repository to a remote repository, a link to the specific remote repository is required. Read more at Remote repository. |
Cloning is the process of downloading a public (remote) repository from a hosted repository to the current directory. You can clone the Engee public repository and its associated projects, as well as any other repositories to which you have access.
To clone a remote repository, click the Clone button:
This will open a window to insert the address of the remote repository:
If the remote repository is accessible and the address is entered correctly, the link will be displayed with a green tick mark:
After cloning, you can work with the project as you would with any local repository. All Git commands implemented in the file browser (Implemented commands).
Files from the remote repository will be added to the file browser automatically, e.g. a previously created project with a README file:
Regardless of the method you choose to create a local repository:
-
The current directory (folder) will become a Git repository and will support the basic Git commands implemented in the file browser.
-
If the Git column is hidden, click on the dot sign in the upper right corner of the file browser, select hide/show from the context menu and click on Git. In the Git column, you can add a file or folder to the index with Add for further work in Git, or remove it from the index with Remove.
Implemented commands
The following Git commands are implemented in the file browser using buttons:
-
init- initialises an empty repository in the current directory (folder). -
clone- clones an existing remote repository into the current directory (folder). -
add- adds the specified file to the tracking. If it is a folder, it adds all files of the local repository to the index. Theadd allcommand is also available to add all files to the index. -
remove- removes the specified file from tracking. -
commit- saves the changes to the working directory of the local repository. The command fixes the project state at a certain point in time and saves the history of changes. -
fetch- used to download changes from a remote or local repository to your local repository. -
restore and pull- used to update your local copy of the repository to the latest version. This allows you to have an up-to-date copy of your code and avoid conflicts when merging changes. -
pull- retrieves and loads content from a remote repository into your local repository and updates it with that content.
-
push- transfers changes made in the local repository to the remote repository.