@scalar/snippetz 0.2.7 → 0.2.9

package/dist/httpsnippet-lite/esm/targets/python/python3/client.js

@@ -0,0 +1,95 @@
+import { CodeBuilder } from '../../../helpers/code-builder.js';
+import { escapeForDoubleQuotes } from '../../../helpers/escape.js';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-nocheck
+/**
+ * @description
+ * HTTP code snippet generator for native Python3.
+ *
+ * @author
+ * @montanaflynn
+ *
+ * for any questions or issues regarding the generated code snippet, please open an issue mentioning the author.
+ */
+const python3 = {
+    info: {
+        key: 'python3',
+        title: 'http.client',
+        link: 'https://docs.python.org/3/library/http.client.html',
+        description: 'Python3 HTTP Client',
+    },
+    convert: ({ uriObj: { path, protocol, host }, postData, allHeaders, method }, options = {}) => {
+        const { insecureSkipVerify = false } = options;
+        const { push, blank, join } = new CodeBuilder();
+        // Start Request
+        push('import http.client');
+        if (insecureSkipVerify) {
+            push('import ssl');
+        }
+        blank();
+        // Check which protocol to be used for the client connection
+        if (protocol === 'https:') {
+            const sslContext = insecureSkipVerify
+                ? ', context = ssl._create_unverified_context()'
+                : '';
+            push(`conn = http.client.HTTPSConnection("${host}"${sslContext})`);
+            blank();
+        }
+        else {
+            push(`conn = http.client.HTTPConnection("${host}")`);
+            blank();
+        }
+        // Create payload string if it exists
+        const payload = JSON.stringify(postData === null || postData === void 0 ? void 0 : postData.text);
+        if (payload) {
+            push(`payload = ${payload}`);
+            blank();
+        }
+        // Create Headers
+        const headers = allHeaders;
+        const headerCount = Object.keys(headers).length;
+        if (headerCount === 1) {
+            for (const header in headers) {
+                push(`headers = { '${header}': "${escapeForDoubleQuotes(headers[header])}" }`);
+                blank();
+            }
+        }
+        else if (headerCount > 1) {
+            let count = 1;
+            push('headers = {');
+            for (const header in headers) {
+                if (count++ !== headerCount) {
+                    push(`    '${header}': "${escapeForDoubleQuotes(headers[header])}",`);
+                }
+                else {
+                    push(`    '${header}': "${escapeForDoubleQuotes(headers[header])}"`);
+                }
+            }
+            push('}');
+            blank();
+        }
+        // Make Request
+        if (payload && headerCount) {
+            push(`conn.request("${method}", "${path}", payload, headers)`);
+        }
+        else if (payload && !headerCount) {
+            push(`conn.request("${method}", "${path}", payload)`);
+        }
+        else if (!payload && headerCount) {
+            push(`conn.request("${method}", "${path}", headers=headers)`);
+        }
+        else {
+            push(`conn.request("${method}", "${path}")`);
+        }
+        // Get Response
+        blank();
+        push('res = conn.getresponse()');
+        push('data = res.read()');
+        blank();
+        push('print(data.decode("utf-8"))');
+        return join();
+    },
+};
+
+export { python3 };

package/dist/httpsnippet-lite/esm/targets/python/requests/client.d.ts

@@ -0,0 +1,16 @@
+export declare const requests: {
+    info: {
+        key: string;
+        title: string;
+        link: string;
+        description: string;
+    };
+    convert: ({ queryObj, url, postData, allHeaders, method }: {
+        queryObj: any;
+        url: any;
+        postData: any;
+        allHeaders: any;
+        method: any;
+    }, options: any) => any;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/httpsnippet-lite/esm/targets/python/requests/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../src/httpsnippet-lite/esm/targets/python/requests/client.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;CAqJpB,CAAA"}

package/dist/httpsnippet-lite/esm/targets/python/requests/client.js

@@ -0,0 +1,177 @@
+import { CodeBuilder } from '../../../helpers/code-builder.js';
+import { escapeForDoubleQuotes } from '../../../helpers/escape.js';
+import { getHeaderName } from '../../../helpers/headers.js';
+import { literalRepresentation } from '../helpers.js';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-nocheck
+/**
+ * @description
+ * HTTP code snippet generator for Python using Requests
+ *
+ * @author
+ * @montanaflynn
+ *
+ * for any questions or issues regarding the generated code snippet, please open an issue mentioning the author.
+ */
+const builtInMethods = [
+    'HEAD',
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'OPTIONS',
+];
+const requests = {
+    info: {
+        key: 'requests',
+        title: 'Requests',
+        link: 'http://docs.python-requests.org/en/latest/api/#requests.request',
+        description: 'Requests HTTP library',
+    },
+    convert: ({ queryObj, url, postData, allHeaders, method }, options) => {
+        const opts = {
+            indent: '    ',
+            pretty: true,
+            ...options,
+        };
+        // Start snippet
+        const { push, blank, join } = new CodeBuilder({ indent: opts.indent });
+        // Import requests
+        push('import requests');
+        blank();
+        // Set URL
+        push(`url = "${url}"`);
+        blank();
+        // Construct query string
+        let qs;
+        if (Object.keys(queryObj).length) {
+            qs = `querystring = ${JSON.stringify(queryObj)}`;
+            push(qs);
+            blank();
+        }
+        const headers = allHeaders;
+        // Construct payload
+        let payload = {};
+        const files = {};
+        let hasFiles = false;
+        let hasPayload = false;
+        let jsonPayload = false;
+        switch (postData === null || postData === void 0 ? void 0 : postData.mimeType) {
+            case 'application/json':
+                if (postData.jsonObj) {
+                    push(`payload = ${literalRepresentation(postData.jsonObj, opts)}`);
+                    jsonPayload = true;
+                    hasPayload = true;
+                }
+                break;
+            case 'multipart/form-data':
+                if (!postData.params) {
+                    break;
+                }
+                payload = {};
+                postData.params.forEach((p) => {
+                    if (p.fileName) {
+                        files[p.name] = `open('${p.fileName}', 'rb')`;
+                        hasFiles = true;
+                    }
+                    else {
+                        payload[p.name] = p.value;
+                        hasPayload = true;
+                    }
+                });
+                if (hasFiles) {
+                    push(`files = ${literalRepresentation(files, opts)}`);
+                    if (hasPayload) {
+                        push(`payload = ${literalRepresentation(payload, opts)}`);
+                    }
+                    // The requests library will only automatically add a `multipart/form-data` header if there are files being sent. If we're **only** sending form data we still need to send the boundary ourselves.
+                    const headerName = getHeaderName(headers, 'content-type');
+                    if (headerName) {
+                        delete headers[headerName];
+                    }
+                }
+                else {
+                    const nonFilePayload = JSON.stringify(postData.text);
+                    if (nonFilePayload) {
+                        push(`payload = ${nonFilePayload}`);
+                        hasPayload = true;
+                    }
+                }
+                break;
+            default: {
+                if (!postData) {
+                    break;
+                }
+                if (postData.mimeType === 'application/x-www-form-urlencoded' &&
+                    postData.paramsObj) {
+                    push(`payload = ${literalRepresentation(postData.paramsObj, opts)}`);
+                    hasPayload = true;
+                    break;
+                }
+                const payload = JSON.stringify(postData.text);
+                if (payload) {
+                    push(`payload = ${payload}`);
+                    hasPayload = true;
+                }
+            }
+        }
+        // Construct headers
+        const headerCount = Object.keys(headers).length;
+        if (headerCount === 0 && (hasPayload || hasFiles)) {
+            // If we don't have any heads but we do have a payload we should put a blank line here between that payload consturction and our execution of the requests library.
+            blank();
+        }
+        else if (headerCount === 1) {
+            for (const header in headers) {
+                push(`headers = {"${header}": "${escapeForDoubleQuotes(headers[header])}"}`);
+                blank();
+            }
+        }
+        else if (headerCount > 1) {
+            let count = 1;
+            push('headers = {');
+            for (const header in headers) {
+                if (count !== headerCount) {
+                    push(`"${header}": "${escapeForDoubleQuotes(headers[header])}",`, 1);
+                }
+                else {
+                    push(`"${header}": "${escapeForDoubleQuotes(headers[header])}"`, 1);
+                }
+                count += 1;
+            }
+            push('}');
+            blank();
+        }
+        // Construct request
+        let request = builtInMethods.includes(method)
+            ? `response = requests.${method.toLowerCase()}(url`
+            : `response = requests.request("${method}", url`;
+        if (hasPayload) {
+            if (jsonPayload) {
+                request += ', json=payload';
+            }
+            else {
+                request += ', data=payload';
+            }
+        }
+        if (hasFiles) {
+            request += ', files=files';
+        }
+        if (headerCount > 0) {
+            request += ', headers=headers';
+        }
+        if (qs) {
+            request += ', params=querystring';
+        }
+        request += ')';
+        push(request);
+        blank();
+        // Print response
+        push('print(response.json())');
+        return join();
+    },
+};
+
+export { requests };

package/dist/httpsnippet-lite/esm/targets/python/target.d.ts

@@ -0,0 +1,44 @@
+export declare const python: {
+    info: {
+        key: string;
+        title: string;
+        extname: string;
+        default: string;
+    };
+    clientsById: {
+        python3: {
+            info: {
+                key: string;
+                title: string;
+                link: string;
+                description: string;
+            };
+            convert: ({ uriObj: { path, protocol, host }, postData, allHeaders, method }: {
+                uriObj: {
+                    path: any;
+                    protocol: any;
+                    host: any;
+                };
+                postData: any;
+                allHeaders: any;
+                method: any;
+            }, options?: {}) => any;
+        };
+        requests: {
+            info: {
+                key: string;
+                title: string;
+                link: string;
+                description: string;
+            };
+            convert: ({ queryObj, url, postData, allHeaders, method }: {
+                queryObj: any;
+                url: any;
+                postData: any;
+                allHeaders: any;
+                method: any;
+            }, options: any) => any;
+        };
+    };
+};
+//# sourceMappingURL=target.d.ts.map

package/dist/httpsnippet-lite/esm/targets/python/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../../src/httpsnippet-lite/esm/targets/python/target.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWlB,CAAA"}

package/dist/httpsnippet-lite/esm/targets/r/httr/client.d.ts

@@ -0,0 +1,17 @@
+export declare const httr: {
+    info: {
+        key: string;
+        title: string;
+        link: string;
+        description: string;
+    };
+    convert: ({ url, queryObj, queryString, postData, allHeaders, method }: {
+        url: any;
+        queryObj: any;
+        queryString: any;
+        postData: any;
+        allHeaders: any;
+        method: any;
+    }, options?: {}) => any;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/httpsnippet-lite/esm/targets/r/httr/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../src/httpsnippet-lite/esm/targets/r/httr/client.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;CAoHhB,CAAA"}

package/dist/httpsnippet-lite/esm/targets/r/httr/client.js

@@ -0,0 +1,127 @@
+import { CodeBuilder } from '../../../helpers/code-builder.js';
+import { escapeForDoubleQuotes, escapeForSingleQuotes } from '../../../helpers/escape.js';
+import { getHeader } from '../../../helpers/headers.js';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-nocheck
+/**
+ * @description
+ * HTTP code snippet generator for R using httr
+ *
+ * @author
+ * @gabrielakoreeda
+ *
+ * for any questions or issues regarding the generated code snippet, please open an issue mentioning the author.
+ */
+const httr = {
+    info: {
+        key: 'httr',
+        title: 'httr',
+        link: 'https://cran.r-project.org/web/packages/httr/vignettes/quickstart.html',
+        description: 'httr: Tools for Working with URLs and HTTP',
+    },
+    convert: ({ url, queryObj, queryString, postData, allHeaders, method }, options = {}) => {
+        let _a, _b;
+        // Start snippet
+        const { push, blank, join } = new CodeBuilder({
+            indent: (_a = options.indent) !== null && _a !== void 0 ? _a : '  ',
+        });
+        // Import httr
+        push('library(httr)');
+        blank();
+        // Set URL
+        push(`url <- "${url}"`);
+        blank();
+        // Construct query string
+        const qs = queryObj;
+        delete queryObj.key;
+        const entries = Object.entries(qs);
+        const entriesCount = entries.length;
+        if (entriesCount === 1) {
+            const entry = entries[0];
+            push(`queryString <- list(${entry[0]} = "${entry[1]}")`);
+            blank();
+        }
+        else if (entriesCount > 1) {
+            push('queryString <- list(');
+            entries.forEach(([key, value], i) => {
+                const isLastItem = i !== entriesCount - 1;
+                const maybeComma = isLastItem ? ',' : '';
+                push(`${key} = "${value}"${maybeComma}`, 1);
+            });
+            push(')');
+            blank();
+        }
+        // Construct payload
+        const payload = JSON.stringify(postData === null || postData === void 0 ? void 0 : postData.text);
+        if (payload) {
+            push(`payload <- ${payload}`);
+            blank();
+        }
+        // Define encode
+        if (postData && (postData.text || postData.jsonObj || postData.params)) {
+            switch (postData.mimeType) {
+                case 'application/x-www-form-urlencoded':
+                    push('encode <- "form"');
+                    blank();
+                    break;
+                case 'application/json':
+                    push('encode <- "json"');
+                    blank();
+                    break;
+                case 'multipart/form-data':
+                    push('encode <- "multipart"');
+                    blank();
+                    break;
+                default:
+                    push('encode <- "raw"');
+                    blank();
+                    break;
+            }
+        }
+        // Construct headers
+        const cookieHeader = getHeader(allHeaders, 'cookie');
+        const acceptHeader = getHeader(allHeaders, 'accept');
+        const setCookies = cookieHeader
+            ? `set_cookies(\`${String(cookieHeader)
+                .replace(/;/g, '", `')
+                .replace(/` /g, '`')
+                .replace(/[=]/g, '` = "')}")`
+            : undefined;
+        const setAccept = acceptHeader
+            ? `accept("${escapeForDoubleQuotes(acceptHeader)}")`
+            : undefined;
+        const setContentType = `content_type("${escapeForDoubleQuotes((_b = postData === null || postData === void 0 ? void 0 : postData.mimeType) !== null && _b !== void 0 ? _b : 'application/octet-stream')}")`;
+        const otherHeaders = Object.entries(allHeaders)
+            // These headers are all handled separately:
+            .filter(([key]) => !['cookie', 'accept', 'content-type'].includes(key.toLowerCase()))
+            .map(([key, value]) => `'${key}' = '${escapeForSingleQuotes(value)}'`)
+            .join(', ');
+        const setHeaders = otherHeaders ? `add_headers(${otherHeaders})` : undefined;
+        // Construct request
+        let request = `response <- VERB("${method}", url`;
+        if (payload) {
+            request += ', body = payload';
+        }
+        if (queryString.length) {
+            request += ', query = queryString';
+        }
+        const headerAdditions = [setHeaders, setContentType, setAccept, setCookies]
+            .filter((x) => !!x)
+            .join(', ');
+        if (headerAdditions) {
+            request += `, ${headerAdditions}`;
+        }
+        if (postData && (postData.text || postData.jsonObj || postData.params)) {
+            request += ', encode = encode';
+        }
+        request += ')';
+        push(request);
+        blank();
+        // Print response
+        push('content(response, "text")');
+        return join();
+    },
+};
+
+export { httr };

package/dist/httpsnippet-lite/esm/targets/r/target.d.ts

@@ -0,0 +1,27 @@
+export declare const r: {
+    info: {
+        key: string;
+        title: string;
+        extname: string;
+        default: string;
+    };
+    clientsById: {
+        httr: {
+            info: {
+                key: string;
+                title: string;
+                link: string;
+                description: string;
+            };
+            convert: ({ url, queryObj, queryString, postData, allHeaders, method }: {
+                url: any;
+                queryObj: any;
+                queryString: any;
+                postData: any;
+                allHeaders: any;
+                method: any;
+            }, options?: {}) => any;
+        };
+    };
+};
+//# sourceMappingURL=target.d.ts.map

package/dist/httpsnippet-lite/esm/targets/r/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../../src/httpsnippet-lite/esm/targets/r/target.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAUb,CAAA"}

package/dist/httpsnippet-lite/esm/targets/ruby/native/client.d.ts

@@ -0,0 +1,16 @@
+export declare const native: {
+    info: {
+        key: string;
+        title: string;
+        link: string;
+        description: string;
+    };
+    convert: ({ uriObj, method: rawMethod, fullUrl, postData, allHeaders }: {
+        uriObj: any;
+        method: any;
+        fullUrl: any;
+        postData: any;
+        allHeaders: any;
+    }, options?: {}) => any;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/httpsnippet-lite/esm/targets/ruby/native/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../src/httpsnippet-lite/esm/targets/ruby/native/client.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAqElB,CAAA"}

package/dist/httpsnippet-lite/esm/targets/ruby/native/client.js

@@ -0,0 +1,72 @@
+import { CodeBuilder } from '../../../helpers/code-builder.js';
+import { escapeForSingleQuotes } from '../../../helpers/escape.js';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-nocheck
+const native = {
+    info: {
+        key: 'native',
+        title: 'net::http',
+        link: 'http://ruby-doc.org/stdlib-2.2.1/libdoc/net/http/rdoc/Net/HTTP.html',
+        description: 'Ruby HTTP client',
+    },
+    convert: ({ uriObj, method: rawMethod, fullUrl, postData, allHeaders }, options = {}) => {
+        const { insecureSkipVerify = false } = options;
+        const { push, blank, join } = new CodeBuilder();
+        push("require 'uri'");
+        push("require 'net/http'");
+        blank();
+        // To support custom methods we check for the supported methods
+        // and if doesn't exist then we build a custom class for it
+        const method = rawMethod.toUpperCase();
+        const methods = [
+            'GET',
+            'POST',
+            'HEAD',
+            'DELETE',
+            'PATCH',
+            'PUT',
+            'OPTIONS',
+            'COPY',
+            'LOCK',
+            'UNLOCK',
+            'MOVE',
+            'TRACE',
+        ];
+        const capMethod = method.charAt(0) + method.substring(1).toLowerCase();
+        if (!methods.includes(method)) {
+            push(`class Net::HTTP::${capMethod} < Net::HTTPRequest`);
+            push(`  METHOD = '${method.toUpperCase()}'`);
+            push(`  REQUEST_HAS_BODY = '${(postData === null || postData === void 0 ? void 0 : postData.text) ? 'true' : 'false'}'`);
+            push('  RESPONSE_HAS_BODY = true');
+            push('end');
+            blank();
+        }
+        push(`url = URI("${fullUrl}")`);
+        blank();
+        push('http = Net::HTTP.new(url.host, url.port)');
+        if (uriObj.protocol === 'https:') {
+            push('http.use_ssl = true');
+            if (insecureSkipVerify) {
+                push('http.verify_mode = OpenSSL::SSL::VERIFY_NONE');
+            }
+        }
+        blank();
+        push(`request = Net::HTTP::${capMethod}.new(url)`);
+        const headers = Object.keys(allHeaders);
+        if (headers.length) {
+            headers.forEach((key) => {
+                push(`request["${key}"] = '${escapeForSingleQuotes(allHeaders[key])}'`);
+            });
+        }
+        if (postData === null || postData === void 0 ? void 0 : postData.text) {
+            push(`request.body = ${JSON.stringify(postData.text)}`);
+        }
+        blank();
+        push('response = http.request(request)');
+        push('puts response.read_body');
+        return join();
+    },
+};
+
+export { native };

package/dist/httpsnippet-lite/esm/targets/ruby/target.d.ts

@@ -0,0 +1,26 @@
+export declare const ruby: {
+    info: {
+        key: string;
+        title: string;
+        extname: string;
+        default: string;
+    };
+    clientsById: {
+        native: {
+            info: {
+                key: string;
+                title: string;
+                link: string;
+                description: string;
+            };
+            convert: ({ uriObj, method: rawMethod, fullUrl, postData, allHeaders }: {
+                uriObj: any;
+                method: any;
+                fullUrl: any;
+                postData: any;
+                allHeaders: any;
+            }, options?: {}) => any;
+        };
+    };
+};
+//# sourceMappingURL=target.d.ts.map

package/dist/httpsnippet-lite/esm/targets/ruby/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../../src/httpsnippet-lite/esm/targets/ruby/target.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;CAUhB,CAAA"}

package/dist/httpsnippet-lite/esm/targets/shell/curl/client.d.ts

@@ -0,0 +1,17 @@
+export declare const curl: {
+    info: {
+        key: string;
+        title: string;
+        link: string;
+        description: string;
+    };
+    convert: ({ fullUrl, method, httpVersion, headersObj, allHeaders, postData }: {
+        fullUrl: any;
+        method: any;
+        httpVersion: any;
+        headersObj: any;
+        allHeaders: any;
+        postData: any;
+    }, options?: {}) => any;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/httpsnippet-lite/esm/targets/shell/curl/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../src/httpsnippet-lite/esm/targets/shell/curl/client.ts"],"names":[],"mappings":"AA4CA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;CAsJhB,CAAA"}