Skip to content

Commit 9d1c2ee

Browse files
committed
add a Makefile
1 parent 3b6cd58 commit 9d1c2ee

File tree

3 files changed

+23
-3
lines changed

3 files changed

+23
-3
lines changed

.editorconfig

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
[*]
1+
[*.js]
22
indent_size = 2
3-
indent_style = space
3+
indent_style = space

Makefile

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
.DEFAULT_GOAL := parse
2+
3+
save:
4+
@node save_data.js
5+
6+
parse: save
7+
@node run.js > ./schema.json
8+
9+
clean:
10+
@rm *.html

README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,21 @@ This can be used to facilitate rapid discovery of the API surface.
66

77
It converts the HTML documentation of tables spread across 50 different pages with an unhelpful navigation system, into a single JSON artifact.
88

9+
## Requirements
10+
11+
This has been developed and tested using node.js. There is one dependency, `jsdom`, which is used for scraping data from HTML pages using standard web apis.
12+
13+
## Usage
14+
15+
A `Makefile` is included for convenience.
16+
17+
Just run `make` to get the `schema.json` file.
18+
919
## I thought SOAP handles this for me?
1020

1121
A well implemented SOAP API _should_ describe objects and their relationships. When it comes to the `doSelect` API, the "ease of use" intended by the SOAP protocol goes into a Web Services black box. The API rot can become worse if your organization filters API access through a gateway.
1222

13-
Hence, this project exists and can be used create visualizations or progamatically create APIs using the JSON schema artifact.
23+
Hence, this project exists and can be used create visualizations or programatically create APIs using the JSON schema artifact.
1424

1525
## Development
1626

0 commit comments

Comments
 (0)