Skip to content

Commit 29e07b0

Browse files
authored
Merge pull request #23 from oslabs-beta/dev
Merge README updates from Dev into Main
2 parents 89801ae + 7884a3e commit 29e07b0

File tree

5 files changed

+38
-15
lines changed

5 files changed

+38
-15
lines changed

.gitignore

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# Build folder and files #
22
##########################
3-
builds/
3+
build/
44
release/
55

66
# Development folders and files #
77
#################################
88
.tmp/
99
dist/
10-
node_modules/
10+
node_modules
1111
*.compiled.*
1212
package-lock.json
1313
coverage/

README.md

Lines changed: 34 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Swell is a one-stop shop for sending and monitoring your API requests
2222

2323
- Send and monitor streams over HTTP2 / HTTP1 (including SSEs) and WebSockets
2424
- Create GraphQL queries, introspections, mutations, and subscriptions
25+
- Make API requests based on a range of provided options that conform to the specifications defined in an OpenAPI document.
26+
- Verify STUN and TURN server connectivity for WebRTC applications by generating an SDP
2527
- Provides full streaming testing support for gRPC
2628
- View response timing information and history in an interactive chart for each request
2729
- Save workspaces of multiple requests for later access
@@ -33,29 +35,46 @@ Swell is a one-stop shop for sending and monitoring your API requests
3335
## Supported Technologies
3436

3537
- _HTTP2_: Swell supports full HTTP2 multiplexing of requests and responses. HTTP requests to the same host will be sent over the same connection. Swell will attempt to initiate an HTTP2 connection for all HTTPS requests by default, but will revert to HTTP1.1 for legacy servers. Multiple concurrent streams are allowed for each connection.
36-
<kbd><img src="./ReadMeGifs/Gifs/ConcurrentStreams.gif"
37-
style="float: left; margin-right: 10px; margin-bottom : 30px; margin-top : 10px; border: 1px solid black;" /></kbd>
38+
<kbd><img src="./ReadMeGifs/Gifs/ConcurrentStreams.gif" style="float: left; margin-right: 10px; margin-bottom : 30px; margin-top : 10px; border: 1px solid black;" /></kbd>
3839

3940
- _Server-Sent Events (SSE)_: Initiated by a simple toggle box, Swell displays SSE events one by one as they come in. Similar to HTTP2 streams, multiple open connection streams are allowed for SSE.
40-
<kbd><img src="./ReadMeGifs/Gifs/SSE.gif"
41-
style="float: left; margin-right: 10px; margin-bottom : 30px; margin-top : 10px;" /></kbd>
41+
<kbd><img src="./ReadMeGifs/Gifs/SSE.gif" style="float: left; margin-right: 10px; margin-bottom : 30px; margin-top : 10px;" /></kbd>
4242

4343
- _WebSocket (WS)_: Swell enables connecting directly to WebSocket servers with an HTTP handshake. Developers can directly send messages to the connected WS server. Messages are displayed in chatbox format, clearly indicating outgoing and incoming messages.
44-
<kbd><img src="./ReadMeGifs/Gifs/WS.gif"
45-
style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
44+
<kbd><img src="./ReadMeGifs/Gifs/WS.gif" style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
4645

4746
- _GraphQL_: Swell includes full support for all three root types of GraphQL - queries, mutations, and subscriptions as well as Introspection - with and without variables. Smart code editor allows for easy query creation.
48-
<kbd><img src="./ReadMeGifs/Gifs/GraphQL.gif"
49-
style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
47+
<kbd><img src="./ReadMeGifs/Gifs/GraphQL.gif" style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
5048

5149
- _gRPC_: Swell includes full support for all four streaming types of gRPC - unary, client stream, server stream, bidirectional stream.
52-
<kbd><img src="./ReadMeGifs/Gifs/GRPCResponses.gif"
53-
style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
50+
<kbd><img src="./ReadMeGifs/Gifs/GRPCResponses.gif" style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
51+
52+
- _OpenAPI_: Swell supports the enumeration and execution of REST and RPC API requests as defined in a user-provided OpenAPI document.
53+
<kbd><img src="./ReadMeGifs/Gifs/openapi.gif" style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
54+
55+
- _WebRTC_: Swell enables testing STUN and TURN ICE server connectivity for WebRTC applications.
56+
<kbd><img src="./ReadMeGifs/Gifs/webrtc.gif" style="float: left; margin-right: 10px;margin-bottom : 30px; margin-top : 10px;" /></kbd>
57+
58+
Developers enter ICE server details as an array of JavaScript objects (example code block below). An RTCPeerConnection is instantiated and an SDP is generated.
59+
60+
```javascript
61+
[
62+
{
63+
urls: 'turn:111.222.333.444:54321',
64+
username: 'myAwesomeUsername',
65+
credential: 'mySecretPassword', // or token
66+
credentialType: 'password'
67+
},
68+
{
69+
urls: 'stun:555.777.888.999:43210',
70+
},
71+
]
72+
```
5473

5574
## Additional Features
5675

5776
- _Scripting in Swell_: Swell allows you to write assertion tests to aid in the test-driven development cycle of backend API services.
58-
<kbd><img src="./ReadMeGifs/Gifs/SimpleResponseTest.gif"
77+
<kbd><img src="./ReadMeGifs/Gifs/SimpleResponseTest.gif"
5978
style="float: left; margin-right: 10px; margin-bottom : 30px; margin-top : 10px; border: 1px solid black;" /></kbd>
6079
- _Workspaces_: Swell allows you to save workspaces for easier testing of multiple requests.
6180
- _Import/Export Workspaces_: Swell allows you to import and export workspaces, making it easy to share collections with your team.
@@ -125,6 +144,10 @@ Swell is a one-stop shop for sending and monitoring your API requests
125144
- **Andrea Li** - [Andrea-gli](https://github.com/Andrea-gli)
126145
- **Paul Ramirez** - [pauleramirez](https://github.com/pauleramirez)
127146
- **TJ Wetmore** - [TWetmore](https://github.com/TWetmore)
147+
- **Colin Gibson** - [cgefx](https://github.com/cgefx)
148+
- **Ted Craig** - [tedcraig](https://github.com/tedcraig)
149+
- **Anthony Wong** - [awong428](https://github.com/awong428)
150+
- **John Jongsun Suh** - [MajorLift](https://github.com/MajorLift)
128151

129152
## License
130153

ReadMeGifs/Gifs/openapi.gif

2.59 MB
Loading

ReadMeGifs/Gifs/webrtc.gif

2.41 MB
Loading

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,7 @@
126126
"chart.js": "^2.9.3",
127127
"classnames": "^2.2.6",
128128
"codemirror": "^5.58.2",
129+
"yamljs": "^0.3.0",
129130
"codemirror-graphql": "^0.12.1",
130131
"concurrently": "^5.2.0",
131132
"date-fns": "^1.29.0",
@@ -260,8 +261,7 @@
260261
"webpack-bundle-analyzer": "^3.8.0",
261262
"webpack-cli": "^3.3.12",
262263
"webpack-dev-server": "^3.11.0",
263-
"webpack-node-externals": "^1.7.2",
264-
"yamljs": "^0.3.0"
264+
"webpack-node-externals": "^1.7.2"
265265
},
266266
"author": {
267267
"name": "Swell",

0 commit comments

Comments
 (0)