Skip to content

Commit 0cbe4de

Browse files
committed
documentation for tirith installation
1 parent 5eef345 commit 0cbe4de

13 files changed

+217
-123
lines changed
Loading

documentation/docs/install-tirith-on-linux.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

documentation/docs/install-tirith-on-mac.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

documentation/docs/install-tirith-on-windows.md

Lines changed: 0 additions & 38 deletions
This file was deleted.
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
id: developer-mode-installation
3+
title: Installation for Developers (Using Docker and Dev Containers in VS Code)
4+
sidebar_label: Developer Mode Setup
5+
description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system.
6+
keywords:
7+
- Tirith
8+
- StackGuardian
9+
# url: https://www.tirith.com/support/docs/getting-started-with-tirith
10+
site_name: Tirith
11+
slug: developer-mode-installation/
12+
---
13+
14+
<script type="application/ld+json"
15+
dangerouslySetInnerHTML={{ __html: JSON.stringify({
16+
"@context": "https://schema.org",
17+
"@type": "BreadcrumbList",
18+
"itemListElement": [{
19+
"@type": "ListItem",
20+
"position": 1,
21+
"name": "Home",
22+
"item": "https://www.lambdatest.com"
23+
},{
24+
"@type": "ListItem",
25+
"position": 2,
26+
"name": "Support",
27+
"item": "https://www.lambdatest.com/support/docs/"
28+
},{
29+
"@type": "ListItem",
30+
"position": 3,
31+
"name": "Installation",
32+
"item": "https://www.lambdatest.com/support/docs/developer-mode-installation/"
33+
}]
34+
})
35+
}}></script>
36+
For developers who want to contribute to Tirith, setting up a [Dev Container in Visual Studio Code (VS Code)](https://code.visualstudio.com/docs/devcontainers/create-dev-container#_create-a-devcontainerjson-file) offers a robust development environment. This approach ensures that all dependencies and configurations are consistent across different setups.
37+
38+
## Prerequisite
39+
40+
- Ensure [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) are installed on your machine.
41+
- Install [Git](https://git-scm.com/downloads) in your machine.
42+
- Basic knowledge on [Docker](https://docs.docker.com/engine/install/) is required.
43+
44+
## Steps to Install Tirith
45+
46+
### Step 1: Clone the Repository
47+
Clone the Tirith repository from GitHub to get the latest code:
48+
49+
```bash
50+
git clone https://github.com/StackGuardian/tirith.git
51+
cd tirith
52+
```
53+
54+
### Step 2: Set Up Docker
55+
Ensure [Docker](https://docs.docker.com/engine/install/) is installed and running on your machine. You can manage Docker using Docker Desktop or the command line interface (CLI). Docker allows you to run Tirith within isolated containers, preventing any dependency conflicts with your local system.
56+
57+
### Step 3: Open the Project in VS Code
58+
- Launch Visual Studio Code and open the cloned repository folder.
59+
- Open the Command Palette by pressing `Ctrl+Shift+P` (or `Cmd+Shift+P` on macOS).
60+
- Search for **Dev Containers: Rebuild and Reopen in Container** and select this option.
61+
- VS Code will use the `devcontainer.json` configuration file within the project to build a containerized environment for Tirith. This configuration file contains settings for the development environment, such as necessary extensions and dependencies. Building the container may take a few minutes.
62+
- Once the container is running, you’ll have a fully configured development environment within Docker, optimized for Tirith development.
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
id: manual-installation
3+
title: Manual Installation (Using a Python Virtual Environment)
4+
sidebar_label: Manual Setup
5+
description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system.
6+
keywords:
7+
- Tirith
8+
- StackGuardian
9+
# url: https://www.tirith.com/support/docs/getting-started-with-tirith
10+
site_name: Tirith
11+
slug: manual-installation/
12+
---
13+
14+
<script type="application/ld+json"
15+
dangerouslySetInnerHTML={{ __html: JSON.stringify({
16+
"@context": "https://schema.org",
17+
"@type": "BreadcrumbList",
18+
"itemListElement": [{
19+
"@type": "ListItem",
20+
"position": 1,
21+
"name": "Home",
22+
"item": "https://www.lambdatest.com"
23+
},{
24+
"@type": "ListItem",
25+
"position": 2,
26+
"name": "Support",
27+
"item": "https://www.lambdatest.com/support/docs/"
28+
},{
29+
"@type": "ListItem",
30+
"position": 3,
31+
"name": "Installation",
32+
"item": "https://www.lambdatest.com/support/docs/manual-installation/"
33+
}]
34+
})
35+
}}></script>
36+
If you prefer a manual setup, especially if you want to modify Tirith’s codebase directly, follow these steps to install Tirith in a virtual Python environment.
37+
38+
## Prerequisite
39+
40+
- Ensure [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) are installed on your machine.
41+
- Install [Git](https://git-scm.com/downloads) in your machine.
42+
43+
## Steps to Install Tirith
44+
45+
### Step 1: Clone the Repository
46+
Clone the Tirith repository from GitHub to get the latest code:
47+
48+
```bash
49+
git clone https://github.com/StackGuardian/tirith.git
50+
cd tirith
51+
```
52+
53+
### Step 2: Set Up a Python Virtual Environment
54+
Setting up a virtual environment isolates Tirith’s dependencies, preventing potential conflicts with other projects on your machine.
55+
56+
Create a Virtual Environment:
57+
58+
```bash
59+
virtualenv .venv
60+
```
61+
62+
Activate the Virtual Environment:
63+
64+
```bash
65+
source .venv/bin/activate
66+
```
67+
68+
This command activates the virtual environment, ensuring all packages you install are contained within this environment.
69+
70+
### Step 3: Install Tirith
71+
With the virtual environment activated, install Tirith:
72+
73+
```bash
74+
pip install -e .
75+
```
76+
The -e flag installs Tirith in `editable` mode, allowing you to make modifications to the codebase without needing to reinstall the package.
77+
78+
### Step 4: Verify Installation
79+
To confirm Tirith is installed and running properly, check its version:
80+
81+
```bash
82+
tirith --version
83+
```
84+
You should see a version number output, verifying that Tirith is set up correctly.
85+
<br />
86+
<img loading="lazy" src={require('../../assets/installation/tirith-version.png').default} alt="tirith-version" className="doc_img"/>
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
id: quick-installation
3+
title: Quick Installation for Users
4+
sidebar_label: Quick Setup
5+
description: This documentation overviews you about the introduction of the Tirith software installation on your respective operating system.
6+
keywords:
7+
- Tirith
8+
- StackGuardian
9+
# url: https://www.tirith.com/support/docs/getting-started-with-tirith
10+
site_name: Tirith
11+
slug: quick-installation/
12+
---
13+
14+
<script type="application/ld+json"
15+
dangerouslySetInnerHTML={{ __html: JSON.stringify({
16+
"@context": "https://schema.org",
17+
"@type": "BreadcrumbList",
18+
"itemListElement": [{
19+
"@type": "ListItem",
20+
"position": 1,
21+
"name": "Home",
22+
"item": "https://www.lambdatest.com"
23+
},{
24+
"@type": "ListItem",
25+
"position": 2,
26+
"name": "Support",
27+
"item": "https://www.lambdatest.com/support/docs/"
28+
},{
29+
"@type": "ListItem",
30+
"position": 3,
31+
"name": "Installation",
32+
"item": "https://www.lambdatest.com/support/docs/quick-installation/"
33+
}]
34+
})
35+
}}></script>
36+
If you simply want to install and start using Tirith, this option provides a fast installation process with minimal setup. Perfect for end-users and non-developers who only need basic functionality.
37+
38+
## Prerequisite
39+
40+
- Ensure [Python](https://www.python.org/downloads/) and [pip](https://pip.pypa.io/en/stable/installation/) are installed on your machine.
41+
- Install [Git](https://git-scm.com/downloads) in your machine.
42+
43+
## Steps to Install Tirith
44+
45+
### Step 1: Install using the `pip` command
46+
Run the following command in your terminal to download Tirith directly from the GitHub repository and installs it on your local system. This command ensures that you have the latest version.
47+
48+
```bash
49+
pip install git+https://github.com/StackGuardian/tirith.git
50+
```
51+
52+
53+
### Step 2: Verify Installation
54+
Once installed, verify that Tirith is working by checking its version. You should see a version number (e.g., 1.0.0-beta.12) indicating successful installation.
55+
```bash
56+
tirith --version
57+
```
58+
<br />
59+
<img loading="lazy" src={require('../../assets/installation/tirith-version.png').default} alt="tirith-version" className="doc_img"/>

documentation/sidebars.js

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,23 +8,24 @@ module.exports = {
88
{
99
type: "category",
1010
collapsed: true,
11-
label: "Installation",
11+
label: "Setup Tirith",
12+
1213
items: [
13-
"install-tirith-on-linux",
14-
"install-tirith-on-windows",
15-
"install-tirith-on-mac"
14+
'tirith-installation/quick-installation',
15+
'tirith-installation/developer-mode-installation',
16+
'tirith-installation/manual-installation'
1617
]
1718
},
1819
{
1920
type: "category",
2021
collapsed: true,
2122
label: "Tirith Policies",
2223
items: [
23-
"tirith-policy-structure",
24-
"tirith-policy-error-tolerance",
25-
"tirith-policy-conditions",
26-
"tirith-policy-variables",
27-
"tirith-policy-examples"
24+
"tirith-policies/tirith-policy-structure",
25+
"tirith-policies/tirith-policy-error-tolerance",
26+
"tirith-policies/tirith-policy-conditions",
27+
"tirith-policies/tirith-policy-variables",
28+
"tirith-policies/tirith-policy-examples"
2829
]
2930
},
3031
],

0 commit comments

Comments
 (0)