release v0.1.0

Author: justjavac

.gitattributes

@@ -0,0 +1,4 @@
+*                 text=auto  eol=lf
+*.bat             text eol=crlf
+*.cmd             text eol=crlf
+*.ps1             text eol=crlf

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: ci
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    name: ${{ matrix.kind }} ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macOS-latest, ubuntu-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Deno
+        uses: denolib/setup-deno@master
+        with:
+          deno-version: 1.3
+
+      - name: Format
+        run: deno fmt --check
+
+      - name: Lint
+        run: deno lint --unstable
+
+      - name: Test
+        run: deno test

.gitignore

@@ -0,0 +1,6 @@
+*.log
+.cache
+.DS_Store
+*bak
+.history
+.temp/**

CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 - [2020-08-24]
+
+- first release

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) justjavac.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,55 @@
+# deno_is_unc_path
+
+[![tag](https://img.shields.io/github/release/justjavac/deno_is_unc_path)](https://github.com/justjavac/deno_is_unc_path/releases)
+[![Build Status](https://github.com/justjavac/deno_is_unc_path/workflows/ci/badge.svg?branch=master)](https://github.com/justjavac/deno_is_unc_path/actions)
+[![license](https://img.shields.io/github/license/justjavac/deno_is_unc_path)](https://github.com/justjavac/deno_is_unc_path/blob/master/LICENSE)
+
+Whether the filepath is a windows [UNC](https://msdn.microsoft.com/en-us/library/gg465305.aspx) file path.
+
+ABNF syntax:
+
+```plain
+UNC                = "\\" host-name "\" share-name  [ "\" object-name ]
+ host-name          = "[" IPv6address "]" / IPv4address / reg-name  
+    ; IPv6address, IPv4address, and reg-name as specified in [RFC3986] 
+ share-name         = 1*80pchar
+ pchar              = %x20-21 / %x23-29 / %x2D-2E / %x30-39 / %x40-5A / %x5E-7B / %x7D-FF  
+ object-name        = *path-name [ "\" file-name ]
+ path-name          = 1*255pchar
+ file-name          = 1*255fchar [ ":" stream-name [ ":" stream-type ] ]
+ fchar              = %x20-21 / %x23-29 / %x2B-2E / %x30-39 / %x3B / %x3D / %x40-5B / %x5D-7B / %x7D-FF 
+ stream-name        = *schar
+ schar              = %x01-2E / %x30-39 / %x3B-5B /%x5D-FF
+ stream-type        = 1*schar
+ ```
+
+## Usage
+
+```ts
+import isUncPath from "https://deno.land/x/is_unc_path/mod.ts";
+
+// return `true`
+isUncPath('\\/foo/bar');
+isUncPath('\\\\foo/bar');
+isUncPath('\\\\foo\\admin$');
+isUncPath('\\\\foo\\admin$\\system32');
+isUncPath('\\\\foo\\temp');
+isUncPath('\\\\/foo/bar');
+isUncPath('\\\\\\/foo/bar');
+
+// return `false`
+isUncPath('/foo/bar');
+isUncPath('/');
+isUncPath('/foo');
+isUncPath('/foo/');
+isUncPath('c:');
+isUncPath('c:.');
+isUncPath('c:./');
+isUncPath('c:./file');
+isUncPath('c:/');
+isUncPath('c:/file');
+```
+
+## License
+
+[deno_is_unc_path](https://github.com/justjavac/deno_is_unc_path) is released under the MIT License. See the bundled [LICENSE](./LICENSE) file for details.

mod.ts

@@ -0,0 +1,9 @@
+const UNC_PATH_REGEX = /^[\\\/]{2,}[^\\\/]+[\\\/]+[^\\\/]+/;
+
+/**
+ * Whether the filepath is a windows [UNC](https://msdn.microsoft.com/en-us/library/gg465305.aspx) file path.
+ * @param path
+ */
+export default function isUncPath(path: string): boolean {
+  return UNC_PATH_REGEX.test(path);
+}

mod_test.ts

@@ -0,0 +1,28 @@
+// base on https://gDeno.testhub.com/jonschlinkert/is-isUncPath-path/blob/9bd6a77c5b12115869963d1b4c3078dda51c15da/test.js
+
+import { assertEquals } from "https://deno.land/std/testing/asserts.ts";
+
+import isUncPath from "./mod.ts";
+
+Deno.test("should return true for UNC paths", function () {
+  assertEquals(isUncPath("\\/foo/bar"), true);
+  assertEquals(isUncPath("\\\\foo/bar"), true);
+  assertEquals(isUncPath("\\\\foo\\admin$"), true);
+  assertEquals(isUncPath("\\\\foo\\admin$\\system32"), true);
+  assertEquals(isUncPath("\\\\foo\\temp"), true);
+  assertEquals(isUncPath("\\\\/foo/bar"), true);
+  assertEquals(isUncPath("\\\\\\/foo/bar"), true);
+});
+
+Deno.test("should return false for non-UNC paths", function () {
+  assertEquals(isUncPath("/foo/bar"), false);
+  assertEquals(isUncPath("/"), false);
+  assertEquals(isUncPath("/foo"), false);
+  assertEquals(isUncPath("/foo/"), false);
+  assertEquals(isUncPath("c:"), false);
+  assertEquals(isUncPath("c:."), false);
+  assertEquals(isUncPath("c:./"), false);
+  assertEquals(isUncPath("c:./file"), false);
+  assertEquals(isUncPath("c:/"), false);
+  assertEquals(isUncPath("c:/file"), false);
+});