💥 Supports structure generation for each request method and request parameter.

- Supports generation of structures for each request method
- Supports generation of Query Parameter structure
- Changed the generated file name and structure name

Author: nkmr-jp

README.md

@@ -51,8 +51,8 @@ api-to-go  https://api.github.com/users/github/repos
 # > Docs:    https://docs.github.com/en/rest
 
 # > Response Body:
-# >   - api.github.com/users/user/repos.go:1
-# >   - api.github.com/users/user/repos.json:1
+# >   - api.github.com/users/user/repos_get.go:1
+# >   - api.github.com/users/user/repos_get.json:1
 ```
 
 Generated files and directories.
@@ -63,8 +63,8 @@ Generated files and directories.
 # > └── api.github.com
 # >     └── users
 # >         └── user
-# >             ├── repos.go
-# >             └── repos.json
+# >             ├── repos_get.go
+# >             └── repos_get.json
 ```
 
 Generated struct file `./api.github.com/users/user/repos.go`.
@@ -78,13 +78,13 @@ package user
 
 import "time"
 
-// Repos represents the response body from an HTTP request.
+// ReposGet is the structure of the HTTP Response Body.
 //
 //	Status:  200 OK
 //	Request: GET https://api.github.com/users/github/repos
 //	Format:  /users/{user}/repos
 //	Docs:    https://docs.github.com/en/rest
-type Repos []struct {
+type ReposGet []struct {
 	ID int `json:"id"`
 	NodeID string `json:"node_id"`
 	Name string `json:"name"`

src/buildPath.js

@@ -1,11 +1,11 @@
-const {loadYaml, loadConfig} = require("./common");
+const {loadYaml, loadConfig, capitalize} = require("./common");
 
 function buildPath(url, configFile, opts) {
   const path = _buildPath(url, configFile)
   const pathArr = path.replacedUrl.split("/")
   const pkg = pathArr[pathArr.length - 2].replace(/\./g, '')
   const last = pathArr[pathArr.length - 1] || "index"
-  const struct = _capitalize(last)
+  const struct = capitalize(last)
   pathArr.pop()
   const dir = pathArr.join("/")
   let method = opts?.method.toLowerCase()
@@ -74,9 +74,4 @@ function _replacePath(pathname, format) {
   }
 }
 
-function _capitalize(str) {
-  const lower = str.toLowerCase();
-  return str.charAt(0).toUpperCase() + lower.slice(1);
-}
-
 module.exports = buildPath;

src/common.js

@@ -20,6 +20,11 @@ exports.loadFile = file => {
   return fs.readFileSync(file, 'utf8');
 };
 
+exports.capitalize = str => {
+  const lower = str.toLowerCase();
+  return str.charAt(0).toUpperCase() + lower.slice(1);
+}
+
 exports.isJsonString = str => {
   try {
     JSON.parse(str);

src/run.js

@@ -2,7 +2,7 @@ const fetch = require('node-fetch');
 const fs = require('fs');
 const jsonToGo = require('../vendor/json-to-go.js');
 const buildPath = require('./buildPath');
-const {isJsonString, loadConfig, loadFile, loadJson} = require("./common");
+const {isJsonString, loadConfig, loadFile, loadJson, capitalize} = require("./common");
 
 let cliOpts
 
@@ -35,16 +35,26 @@ function run(urlStr, body, options) {
       return res.json()
     })
     .then(json => {
-      const struct = jsonToGo(JSON.stringify(json), path.struct);
-      const content = buildContent(struct.go, path, comment)
+      let method = capitalize(opts?.method)
+      const struct = jsonToGo(JSON.stringify(json), path.struct + method);
+      const content = buildContent(struct.go, path, comment,"")
       write(json, path, content)
 
       if (opts?.body) {
-        const paramStruct = jsonToGo(opts?.body, path.struct + "Param");
-        const paramContent = buildContent(
-            paramStruct.go, path, buildComment(url, path, opts.method), true
+        const bodyStruct = jsonToGo(opts?.body, path.struct + method + "Body");
+        const bodyContent = buildContent(
+            bodyStruct.go, path, buildComment(url, path, opts.method), "body"
         )
-        writeParam(JSON.stringify(JSON.parse(opts?.body), null, "\t"), path, paramContent)
+        writeBodyParam(JSON.stringify(JSON.parse(opts?.body), null, "\t"), path, bodyContent)
+      }
+      if (url?.search) {
+        const queryJson = queryToJson(new URLSearchParams(url.search))
+        const queryStr = JSON.stringify(queryJson, null, "\t")
+        const queryStruct = jsonToGo(queryStr, path.struct + method + "Query");
+        const queryContent = buildContent(
+            queryStruct.go, path, buildComment(url, path, opts.method), "query"
+        )
+        writeQueryParam(queryStr, path, queryContent)
       }
     }, () => {
       console.log()
@@ -69,17 +79,30 @@ function write(json, path, content) {
   console.log(`  - ${path.jsonFilePath}:1`)
 }
 
-function writeParam(json, path, content) {
-  fs.writeFile(path.paramJsonFilePath, json, (err) => {
+function writeBodyParam(json, path, content) {
+  fs.writeFile(path.bodyJsonFilePath, json, (err) => {
     if (err) throw err;
   });
-  fs.writeFile(path.paramGoFilePath, content, (err) => {
+  fs.writeFile(path.bodyGoFilePath, content, (err) => {
     if (err) throw err;
   });
   console.log()
   console.log("Request Body Parameter:")
-  console.log(`  - ${path.paramGoFilePath}:1`)
-  console.log(`  - ${path.paramJsonFilePath}:1`)
+  console.log(`  - ${path.bodyGoFilePath}:1`)
+  console.log(`  - ${path.bodyJsonFilePath}:1`)
+}
+
+function writeQueryParam(json, path, content) {
+  fs.writeFile(path.queryJsonFilePath, json, (err) => {
+    if (err) throw err;
+  });
+  fs.writeFile(path.queryGoFilePath, content, (err) => {
+    if (err) throw err;
+  });
+  console.log()
+  console.log("Request Query Parameter:")
+  console.log(`  - ${path.queryGoFilePath}:1`)
+  console.log(`  - ${path.queryJsonFilePath}:1`)
 }
 
 function buildOpts(body, cliOpts) {
@@ -116,7 +139,7 @@ function buildOpts(body, cliOpts) {
   return opts
 }
 
-function buildContent(go, path, comment, isParam = false) {
+function buildContent(go, path, comment, paramType) {
   let content = `// Generated Code But Editable.
 // Format The Code with \`go fmt\` or something and edit it manually to use it.
 //
@@ -127,10 +150,12 @@ function buildContent(go, path, comment, isParam = false) {
   if (go.indexOf('time.') !== -1) {
     content += `import "time"\n\n`
   }
-  if (isParam) {
-    content += `// ${go.split(" ")[1]} is the HTTP request's body parameter.\n//`
-  } else {
-    content += `// ${go.split(" ")[1]} represents the response body from an HTTP request.\n//`
+  if (paramType === "body") {
+    content += `// ${go.split(" ")[1]} is the structure of the the HTTP Request Body Parameter.\n//`
+  } else if (paramType === "query") {
+    content += `// ${go.split(" ")[1]} is the structure of the HTTP Request Query Parameter.\n//`
+  }else{
+    content += `// ${go.split(" ")[1]} is the structure of the HTTP Response Body.\n//`
   }
   content += comment
   content += go
@@ -154,4 +179,12 @@ function buildComment(url, path, method, res = false) {
   return `${comment}\n`
 }
 
+function queryToJson(query) {
+  const json = {}
+  for (const [key, value] of query.entries()) {
+    json[key] = value
+  }
+  return json
+}
+
 module.exports = run;

tests/api-to-go.bats

@@ -18,44 +18,53 @@ teardown(){
   write_doc_details "api-to-go"
 }
 
-@test "Command with valid URL should succeed" {
-  COMMAND="$API_TO_GO $BASE_URL/posts/1"
+@test "Command with Path parameters" {
+  COMMAND="$API_TO_GO $BASE_URL/todos/1"
   run eval "$COMMAND"
   [ "$status" -eq 0 ]
 
-  assert_files_match /posts/post.go
-  assert_files_match /posts/post.json
+  assert_files_match /todos/todo_get.go
+  assert_files_match /todos/todo_get.json
 }
 
-@test "Command with URL and JSON body" {
-  DATA='{"title": "foo", "body": "bar", "userId": 1}'
-  COMMAND="$API_TO_GO $BASE_URL/posts '$DATA'"
+@test "Command with Query parameters" {
+  QUERY='?userId=1&completed=false'
+  COMMAND="$API_TO_GO $BASE_URL/todos$QUERY"
   run eval "$COMMAND"
   [ "$status" -eq 0 ]
 
-  assert_files_match /posts.go
-  assert_files_match /posts.json
+  assert_files_match /todos_get.go
+  assert_files_match /todos_get.json
+  assert_files_match /todos_get_query.go
+  assert_files_match /todos_get_query.json
 }
 
-
-@test "Command with URL" {
-  COMMAND="$API_TO_GO $BASE_URL/posts"
+@test "Command with Body parameters" {
+  DATA=' {
+    "userId": 1,
+    "id": 1,
+    "title": "delectus aut autem",
+    "completed": false
+  }'
+  COMMAND="$API_TO_GO $BASE_URL/todos '$DATA'"
   run eval "$COMMAND"
   [ "$status" -eq 0 ]
 
-  assert_files_match /posts.go
-  assert_files_match /posts.json
+  assert_files_match /todos_post.go
+  assert_files_match /todos_post.json
+  assert_files_match /todos_post_body.go
+  assert_files_match /todos_post_body.json
 }
 
 @test "Command with custom headers" {
   HEADERS='{"Content-Type": "application/json"}'
-  COMMAND="$API_TO_GO --headers '$HEADERS' $BASE_URL/posts/1"
+  COMMAND="$API_TO_GO --headers '$HEADERS' $BASE_URL/todos/1"
   run eval "$COMMAND"
   [ "$status" -eq 0 ]
 }
 
 @test "Command with GET method" {
-  COMMAND="$API_TO_GO --method GET $BASE_URL/posts/1"
+  COMMAND="$API_TO_GO --method GET $BASE_URL/todos/1"
   run eval "$COMMAND"
   [ "$status" -eq 0 ]
 }

tests/testdata/jsonplaceholder.typicode.com/todos/todo_get.go

@@ -0,0 +1,19 @@
+// Generated Code But Editable.
+// Format The Code with `go fmt` or something and edit it manually to use it.
+//
+// Generated by: api-to-go (https://github.com/nkmr-jp/api-to-go).
+
+package todos
+
+// TodoGet is the HTTP Response Body.
+//
+//	Status:  200 OK
+//	Request: GET https://jsonplaceholder.typicode.com/todos/1
+//	Format:  /todos/{todo}
+//	Docs:    https://jsonplaceholder.typicode.com/
+type TodoGet struct {
+	UserID    int    `json:"userId"`
+	ID        int    `json:"id"`
+	Title     string `json:"title"`
+	Completed bool   `json:"completed"`
+}

tests/testdata/jsonplaceholder.typicode.com/todos/todo_get.json

@@ -0,0 +1,6 @@
+{
+	"userId": 1,
+	"id": 1,
+	"title": "delectus aut autem",
+	"completed": false
+}

tests/testdata/jsonplaceholder.typicode.com/todos_get.go

@@ -0,0 +1,18 @@
+// Generated Code But Editable.
+// Format The Code with `go fmt` or something and edit it manually to use it.
+//
+// Generated by: api-to-go (https://github.com/nkmr-jp/api-to-go).
+
+package jsonplaceholdertypicodecom
+
+// TodosGet is the HTTP Response Body.
+//
+//	Status:  200 OK
+//	Request: GET https://jsonplaceholder.typicode.com/todos?userId=1
+//	Docs:    https://jsonplaceholder.typicode.com/
+type TodosGet []struct {
+	UserID    int    `json:"userId"`
+	ID        int    `json:"id"`
+	Title     string `json:"title"`
+	Completed bool   `json:"completed"`
+}