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:
-
Repository initialisation (Init) - create your own local repository in the current directory (folder).
-
Cloning a repository (Clone) - 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 Engee directory.
Create an empty folder in the file browser and navigate to it. Initialise Git by clicking the Init button:
A remote repository is a repository that you plan to make local changes to from a file browser. For example, your own remote repository from GitLab Engee. Read more about creating it at here. |
Once the local repository is initialised, the Git file browser’s Git management menu will open, where you need to specify a link to the remote repository to which changes will be sent:
If the local repository is not associated with the remote repository, the Status line will display the message: Your branch is not associated with any upstream branch
.
After specifying a link to the remote repository and if the connection is successful (if the address is correct and access is granted), a green tick icon will be displayed next to the line:
You can now work with the Git commands implemented in the file browser (see para. Implemented commands).
Cloning a repository
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 and paste the address of the remote repository:
Once the remote repository has been cloned, the Git file browser’s Git management menu will open (the same window as during initialisation, Init). The availability of the remote repository will also be marked with a green tick:
Once cloned, you can work with the project as you would with any local repository. All Git commands implemented in the file browser (Implemented commands).
Regardless of the method you choose to create a local repository:
-
The files of the remote repository will be automatically added to the file browser, such as a previously created project with a README file:
-
The current directory (folder) will become a Git repository and will support 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.
Tracking changes to a remote repository
If the local repository in Engee does not contain the latest changes from the remote repository, the Status line will show how many updates (commits[1]) are missing. For example: Your branch is behind 'origin/master' by 3 commit(s), and can be fast-forwarded. This means there are new changes to the remote repository. |
For the status to be updated automatically, the Auto Fetch Remote Changes option must be enabled (by default). It is located next to the remote repository setting:
You can also manually click Fetch to check for changes.
To download the latest changes to the file browser, use the Restore and pull command:
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 all
command is also available to add all files to the index. -
remove
- removes the specified file from tracking. -
commit
- saves the changes in 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
- propagates changes made in the local repository to the remote repository.