Skip to content

Commit 9e3c990

Browse files
authored
Merge pull request #23 from oslabs-beta/main
Merging into OS Labs
2 parents 0f5fa20 + 5331e07 commit 9e3c990

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

87 files changed

+1251
-1560
lines changed

.babelrc

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

.eslintrc.json

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
{
2-
"env": {
3-
"browser": true,
4-
"es2021": true
5-
},
6-
"extends": [
7-
"eslint:recommended",
8-
"plugin:react/recommended",
9-
"plugin:@typescript-eslint/recommended"
10-
],
11-
"parser": "@typescript-eslint/parser",
12-
"parserOptions": {
13-
"ecmaFeatures": {
14-
"jsx": true
15-
},
16-
"ecmaVersion": "latest",
17-
"sourceType": "module"
18-
},
19-
"plugins": [
20-
"react",
21-
"@typescript-eslint"
22-
],
23-
"rules": {
24-
}
25-
}
2+
"env": {
3+
"browser": true,
4+
"es2021": true
5+
},
6+
"extends": [
7+
"eslint:recommended",
8+
"plugin:react/recommended",
9+
"plugin:@typescript-eslint/recommended"
10+
],
11+
"parser": "@typescript-eslint/parser",
12+
"parserOptions": {
13+
"ecmaFeatures": {
14+
"jsx": true
15+
},
16+
"ecmaVersion": "latest",
17+
"sourceType": "module"
18+
},
19+
"plugins": [
20+
"react",
21+
"@typescript-eslint"
22+
],
23+
"rules": {
24+
}
25+
}

.gitignore

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

README.md

Lines changed: 25 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,45 @@
1-
# Obsidian-Developer-Tool
1+
# Obsidian Developer Tool
22

3-
The Obsidian Developer Tool is an easy-to-use chrome developer tool extension designed for applications using Obsidian. With this extension, users can:
3+
The Obsidian Developer Tool 8.0 is the revamped DevTool for applications using Obsidian with no additonal configuration needed. It's an easy-to-use chrome developer tool extension where users can:
44

5-
- visualize GraphQL query and cache performance metrics
6-
- send dynamic queries and mutations to a user's database
7-
- view and evict data from the browser cache
5+
- visualize client cache performance metrics (i.e. hit ratio, time graphs)
6+
- view previous queries through a query log and client hit, client miss, and mutation time trends
87

9-
These features require minimal configuration and are designed to cater to the needs of Obsidian developers utilizing Obsidian Wrapper in their applications.
10-
11-
The Obsidian Developer Tool is an open-source developer tool accelerated by OS Labs and developed by [Yurii Shchyrba](https://github.com/YuriiShchyrba), [Linda Zhao](https://github.com/lzhao15), [Ali Fay](https://github.com/ali-fay), [Anthony Guan](https://github.com/guananthony), [Yasir Choudhury](https://github.com/Yasir-Choudhury)
8+
The Obsidian Developer Tool is an open-source developer tool accelerated by OS Labs and developed by [David Kim](https://github.com/davidtoyoukim), [David Norman](https://github.com/DavidMNorman), [Eileen Cho](https://github.com/exlxxn), and [Joan Manto](https://github.com/JoanManto).
129

1310
# Installation
1411

15-
The Obsidian Developer Tool is currently under the review process to be launched on the Chrome Extension Store. In the meantime, the easiest way to use the developer tool is to build from source and manually add as a chrome extension. To build the latest version, execute the following commands:
16-
12+
Currently, the easiest way to use the developer tool is to build from source and manually add as a chrome extension. To build the latest version, please follow the below instructions.
1713

1814
```
19-
git clone https://github.com/oslabs-beta/obsidian-developer-tool
15+
git clone https://github.com/open-source-labs/obsidian-developer-tool.git
16+
cd obsidian-developer-tool/client
2017
npm install
2118
npm run build
2219
```
2320

24-
Then, in the Chrome Extensions Page (chrome://extensions/), toggle "Developer mode" on in the upper righthand corner, click on "Load unpacked" and navigate to /Obsidian-developer-tool/dist/ and click "Select". The extension should now be loaded and available within chrome developer tools.
21+
In the Chrome Extensions Page (chrome://extensions/), toggle "Developer Mode" on in the upper righthand corner. Click on the "Load Unpacked" button, and navigate to the client folder of the Obsidian Developer Tool repo. Click "Select", and the developer tool should now be loaded and available in the developer tools panel.
22+
23+
# Features
2524

26-
# Usage and Configuration
27-
Clone the Obsidian repository [here](https://github.com/open-source-labs/obsidian), and in the Obsidian Wrapper file, on line 10, update ```chromeExtensionId``` to the value of the unique chrome extension ID for the tool you just unpacked in your extensions. This can be found at chrome://extensions/ on the card for your loaded extension.
25+
**Dashboard** <br/>
26+
The default landing page of the Obsidian Developer Tool is the dashboard, where the query hit rate, query total, and query time graph are displayed. These metrics are updated live as the user executes queries and mutations to test their application. Additional details like algorithm used and total capacity can also be viewed in this page.
2827

29-
There is no further configuration necessary. As long as your application is using Obsidian Wrapper (imported as a path to the local file with the updated chrome extension), the devtool will be able to retrieve cache data and query metrics on actions initiated in the app.
28+
<br/>
3029

31-
**Performance:** <br/>
32-
Navigate to this tab if you would like to visualize the response time of your GraphQL queries. You can access a log of your queries and mutations, as well as the corresponding response time data. Here you can see the lower response times on subsequent queries for the same data - Obsidian's caching strategies at work!
30+
<div><img src='./client/src/assets/dashboard.png' width='75%'/></div>
3331

34-
**Cache:** <br/>
35-
Navigate to this tab to see the data currently in your client-side cache based on queries being made. All of the cached data will appear here, and you also have the ability to manually clear the cache with the 'clear cache' button.
32+
**Query Log** <br/>
33+
The query log is broken up into two parts, the query list and the query graph. Each query in the list can be selected to display details about that query. The query log graph displays each query you've made, organized by whether it was a cache hit, cache miss, or mutation. Clicking on any query node in the graph will isolate that selected query in the list, allowing you to easily check the details of that particular query.
3634

37-
**Playground:** <br/>
38-
In order to use this feature, you must plug in your server's GraphQL endpoint (ex. http://localhost:3000/graphQL) and click the submit button. You will now be able to write queries as well as mutations in order to retrieve and view your data.
35+
<br/>
3936

40-
**Usage Note:**
41-
Use of this developer tool requires Obsidian version 5.0 or greater.
37+
<div><img src='./client/src/assets/query_log.png' width='75%'/></div>
4238

43-
<div><img src='./src/assets/gifs/performance.gif' width="60%"></div>
44-
<div><img src='./src/assets/gifs/cache.gif' width="60%"></div>
45-
<div><img src='./src/assets/gifs/playground.gif' width="60%"></div>
39+
**Usage Note** <br/>
40+
Use of this developer tool requires Obsidian version 8.0 or greater.
4641

47-
# More information:
48-
Obsidian and Obsidian demo documentation:
49-
* [Obsidian](https://github.com/open-source-labs/obsidian)
50-
* [Obsidian Demo](https://github.com/oslabs-beta/obsidian-demo-5.0)
42+
# More Information
43+
Obsidian and Obsidian Demo documentation:
44+
* [Obsidian](https://github.com/open-source-labs/obsidian)
45+
* [Obsidian Demo](https://github.com/oslabs-beta/obsidian-8.0-demo)

__test__/cache.js

Whitespace-only changes.

__test__/performance.js

Whitespace-only changes.

__test__/playground.test.js

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

__test__/react.test.js

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

babel.config.js

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

client/.DS_Store

6 KB
Binary file not shown.

client/.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
node_modules
2+
package-lock.json
3+
dist

client/index.html

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8" />
5+
<link rel="icon" type="image/svg+xml" href="./src/assets/react.svg" />
6+
<link rel="stylesheet" href="./src/stylesheets/index.css">
7+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
8+
<title>Obsidian DevTool</title>
9+
</head>
10+
<body>
11+
<div id="root"></div>
12+
<script type="module" src="./src/main.tsx"></script>
13+
</body>
14+
</html>

0 commit comments

Comments
 (0)