initial commit

node_modules/parse-path/lib/index.js

@@ -0,0 +1,80 @@
+"use strict";
+
+var protocols = require("protocols");
+
+/**
+ * parsePath
+ * Parses the input url.
+ *
+ * @name parsePath
+ * @function
+ * @param {String} url The input url.
+ * @return {Object} An object containing the following fields:
+ *
+ *    - `protocols` (Array): An array with the url protocols (usually it has one element).
+ *    - `protocol` (String): The first protocol or `"file"`.
+ *    - `port` (String): The domain port (default: `""`).
+ *    - `resource` (String): The url domain/hostname.
+ *    - `host` (String): The url domain (including subdomain and port).
+ *    - `user` (String): The authentication user (default: `""`).
+ *    - `password` (String): The authentication password (default: `""`).
+ *    - `pathname` (String): The url pathname.
+ *    - `hash` (String): The url hash.
+ *    - `search` (String): The url querystring value (excluding `?`).
+ *    - `href` (String): The normalized input url.
+ *    - `query` (Object): The url querystring, parsed as object.
+ *    - `parse_failed` (Boolean): Whether the parsing failed or not.
+ */
+function parsePath(url) {
+
+    var output = {
+        protocols: [],
+        protocol: null,
+        port: null,
+        resource: "",
+        host: "",
+        user: "",
+        password: "",
+        pathname: "",
+        hash: "",
+        search: "",
+        href: url,
+        query: {},
+        parse_failed: false
+    };
+
+    try {
+        var parsed = new URL(url);
+        output.protocols = protocols(parsed);
+        output.protocol = output.protocols[0];
+        output.port = parsed.port;
+        output.resource = parsed.hostname;
+        output.host = parsed.host;
+        output.user = parsed.username || "";
+        output.password = parsed.password || "";
+        output.pathname = parsed.pathname;
+        output.hash = parsed.hash.slice(1);
+        output.search = parsed.search.slice(1);
+        output.href = parsed.href;
+        output.query = Object.fromEntries(parsed.searchParams);
+    } catch (e) {
+        // TODO Maybe check if it is a valid local file path
+        //      In any case, these will be parsed by higher
+        //      level parsers such as parse-url, git-url-parse, git-up
+        output.protocols = ["file"];
+        output.protocol = output.protocols[0];
+        output.port = "";
+        output.resource = "";
+        output.user = "";
+        output.pathname = "";
+        output.hash = "";
+        output.search = "";
+        output.href = url;
+        output.query = {};
+        output.parse_failed = true;
+    }
+
+    return output;
+}
+
+module.exports = parsePath;