Skip to content

Commit 021df7c

Browse files
Merge pull request #18 from shadab-mohammad-oracle/patch-5
Update README.md
2 parents a299d90 + 4a5f448 commit 021df7c

File tree

1 file changed

+33
-53
lines changed

1 file changed

+33
-53
lines changed

README.md

Lines changed: 33 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -8,56 +8,41 @@ This project is a secure, lightweight SaaS-like database latency testing GUI and
88

99
![Screenshot 2025-07-03 at 11 26 30 PM](https://github.com/user-attachments/assets/f1b17fb8-f637-4b86-95c9-52dd0b6e2067)
1010

11-
## Databases Supported 🔌 :
12-
13-
### Oracle DB >= 12.2 📌 :
14-
- Amazon RDS Oracle
15-
- OCI Autonomous Database
16-
- OCI VMDB
17-
- OCI Exadata Cloud Service
18-
- Oracle Database On-Premise
19-
20-
### Postgres >= 11 📌 :
21-
- Amazon RDS Postgres
22-
- Amazon RDS Aurora Postgres
23-
- Postgres On-premise
24-
25-
### MySQL >= 5.7 📌 :
26-
- Amazon RDS MySQL
27-
- Amazon RDS Aurora MySQL
28-
- OCI MySQL Database Service
29-
- OCI MySQL Heatwave
30-
- MySQL On-Premise
31-
32-
### URL - HTTPS | HTTP 📌 :
33-
- Check Public or Private URLs for latency
11+
### 1. Clone Repository ###
12+
```bash
13+
git clone https://github.com/oracle-quickstart/db-endpoint-latency-testing-ammeter.git && cd db-endpoint-latency-testing-ammeter/
14+
```
3415

16+
### 2. Create a Python Virtual Environment
3517

36-
### 1. Create a Python Virtual Environment
3718
```bash
3819
python3 -m venv .venv
20+
3921
# Activate on Unix/macOS:
4022
source .venv/bin/activate
23+
4124
# Activate on Windows:
4225
.venv\Scripts\activate
4326
```
44-
### 2. Install requirements
27+
28+
### 3. Install requirements
4529
```bash
46-
pip install -r requirements.txt
30+
pip3 install -r requirements.txt
4731
```
48-
### 3. Launch the Web App
32+
33+
### 4. Launch the Web App
4934
```bash
5035
uvicorn app.main:app --host 0.0.0.0 --port 8000
5136
```
52-
### 4. Open your browser at:
37+
### 5. Open your browser at:
5338
```
5439
http://localhost:8000
5540
```
5641
- Log in: `admin` / `change_this` (update password in `app/main.py` for production).
5742
- Fill out the form and run latency tests in real time with live chart and table views.
5843
- For any errors (connection, authentication) you'll see detailed front-end feedback.
5944

60-
### 5. API Usage via Curl/CLI Example:
45+
### 6. API Usage via Curl/CLI Example:
6146
```bash
6247
curl -u admin:change_this -X POST http://localhost:8000/api/test-latency \
6348
-F dbtype=postgresql -F host=localhost -F port=5432 -F username=postgres -F password=yourpassword -F database=postgres -F interval=1 -F period=10
@@ -70,35 +55,30 @@ curl -u admin:change_this -X POST http://localhost:8000/api/test-latency \
7055

7156
The original `delta.py` script remains available for CLI power users and can test Oracle, PostgreSQL, MySQL, and URLs. **No credentials are stored in this file**; you must supply all values as arguments or interactively via a prompt.
7257

73-
Use it like this (replace ALL UPPERCASE placeholders):
74-
75-
### Oracle Example
7658

77-
```bash
78-
python delta.py --db oracle --user ADMIN_USER --password YOUR_PASSWORD --host "YOUR_ORACLE_DSN" --interval 3 --period 5 --csvoutput oracle_latency.csv
79-
```
80-
- If you omit an argument, you will be prompted at runtime (passwords asked securely).
81-
82-
### PostgreSQL Example
83-
84-
```bash
85-
python delta.py --db postgresql --user PG_USER --password YOUR_PASSWORD --host PG_HOST --port 5432 --database DB_NAME --interval 3 --period 5 --csvoutput postgres_latency.csv
86-
```
87-
### MySQL Example
59+
## Databases Supported 🔌 :
8860

89-
```bash
90-
python delta.py --db mysql --user MYSQL_USER --password YOUR_PASSWORD --host MYSQL_HOST --port 3306 --database DB_NAME --interval 3 --period 5 --csvoutput mysql_latency.csv
91-
```
92-
### URL Example
61+
### Oracle DB >= 12.2 📌 :
62+
- Amazon RDS Oracle
63+
- OCI Autonomous Database
64+
- OCI VMDB
65+
- OCI Exadata Cloud Service
66+
- Oracle Database On-Premise
9367

94-
```bash
95-
python delta.py --db url --url "https://example.com" --interval 3 --period 5 --csvoutput url_latency.csv
96-
```
97-
- All arguments can also be supplied interactively if omitted.
98-
- No passwords, usernames, or hostnames are stored in the codebase.
68+
### Postgres >= 11 📌 :
69+
- Amazon RDS Postgres
70+
- Amazon RDS Aurora Postgres
71+
- Postgres On-premise
9972

100-
---
73+
### MySQL >= 5.7 📌 :
74+
- Amazon RDS MySQL
75+
- Amazon RDS Aurora MySQL
76+
- OCI MySQL Database Service
77+
- OCI MySQL Heatwave
78+
- MySQL On-Premise
10179

80+
### URL - HTTPS | HTTP 📌 :
81+
- Check Public or Private URLs for latency
10282

10383
## Contributing
10484

0 commit comments

Comments
 (0)