(DOCSP-44543): Add support for missing Drivers languages (#151)

* Add support for missing Drivers languages

* Add support for both PHP comment types

* No joy for Jupyter Notebooks

integrationTests/snip/expected/sample.snippet.c-test.c

@@ -0,0 +1,5 @@
+#include <stdio.h>
+int main() {
+   printf("Hello, World!");
+   return 0;
+}

integrationTests/snip/expected/sample.snippet.go-test.go

@@ -0,0 +1,6 @@
+import "fmt"
+
+func main() {
+	fmt.Println("hello world")
+}
+

integrationTests/snip/expected/sample.snippet.multi-line-block-comment.cpp

@@ -0,0 +1,4 @@
+/*
+ * Here's some block comment on multiple lines.
+ */
+auto something = SomeClass::state::something;

integrationTests/snip/expected/sample.snippet.php-octothorp-test.php

@@ -0,0 +1,4 @@
+# Here's a comment with an octothorp
+<?php
+echo "Have an octothorpe! #";
+?>

integrationTests/snip/expected/sample.snippet.php-slash-test.php

@@ -0,0 +1,4 @@
+// Here's a comment with slashes
+<?php
+echo "Fun with PHP!";
+?>

integrationTests/snip/expected/sample.snippet.php-test.php

@@ -0,0 +1,3 @@
+<?php
+echo "Hello World!";
+?>

integrationTests/snip/expected/sample.snippet.python-test.py

@@ -0,0 +1 @@
+print("This line will be printed.")

integrationTests/snip/expected/sample.snippet.ruby-test.rb

@@ -0,0 +1 @@
+puts "Hello World"

integrationTests/snip/expected/sample.snippet.rust-test.rs

@@ -0,0 +1,3 @@
+fn main() {
+    println!("Hello World!");
+}

integrationTests/snip/expected/sample.snippet.sc-test.sc

@@ -0,0 +1,5 @@
+object Hello {
+    def main(args: Array[String]) = {
+        println("Hello, world")
+    }
+}

integrationTests/snip/expected/sample.snippet.scala-test.scala

@@ -0,0 +1,5 @@
+object Hello {
+    def main(args: Array[String]) = {
+        println("Hello, world")
+    }
+}

integrationTests/snip/expected/sample.snippet.single-line-block-comment.cpp

@@ -0,0 +1,2 @@
+/* Here's some block comment on a single line */
+auto something = SomeClass::state::something;

integrationTests/snip/input/sample.c

@@ -0,0 +1,8 @@
+// :snippet-start: c-test
+#include <stdio.h>
+int main() {
+   // printf() displays the string inside quotation // :remove:
+   printf("Hello, World!");
+   return 0;
+}
+// :snippet-end:

integrationTests/snip/input/sample.cpp

@@ -4,4 +4,16 @@ auto something = SomeClass::someProperty;
 
 // :snippet-start: failing-cpp-test
 auto something = SomeClass::state::something;
+// :snippet-end:
+
+// :snippet-start: multi-line-block-comment
+/*
+ * Here's some block comment on multiple lines.
+ */
+auto something = SomeClass::state::something;
+// :snippet-end:
+
+// :snippet-start: single-line-block-comment
+/* Here's some block comment on a single line */
+auto something = SomeClass::state::something;
 // :snippet-end:

integrationTests/snip/input/sample.go

@@ -0,0 +1,11 @@
+package main
+
+// :snippet-start: go-test
+import "fmt"
+
+func main() {
+	// To FMT or LOG, *that* is the question // :remove:
+	fmt.Println("hello world")
+}
+
+// :snippet-end:

integrationTests/snip/input/sample.php

@@ -0,0 +1,22 @@
+// :snippet-start: php-test
+# Sometimes comments start with octothorps :remove:
+<?php
+echo "Hello World!";
+?>
+// :snippet-end:
+
+# :snippet-start: php-octothorp-test
+# Here's a comment with an octothorp
+#And one without a space just for testing :remove:
+<?php
+echo "Have an octothorpe! #";
+?>
+# :snippet-end:
+
+// :snippet-start: php-slash-test
+// Here's a comment with slashes
+//and one without a space just because :remove:
+<?php
+echo "Fun with PHP!";
+?>
+// :snippet-end:

integrationTests/snip/input/sample.py

@@ -0,0 +1,4 @@
+# :snippet-start: python-test
+# My comment is the coolest, for real. :remove:
+print("This line will be printed.")
+# :snippet-end:

integrationTests/snip/input/sample.rb

@@ -0,0 +1,4 @@
+# :snippet-start: ruby-test
+# Here's a comment :remove:
+puts "Hello World"
+# :snippet-end:

integrationTests/snip/input/sample.rs

@@ -0,0 +1,6 @@
+// :snippet-start: rust-test
+fn main() {
+    // Print text to the console. This is a boring comment. :remove:
+    println!("Hello World!");
+}
+// :snippet-end:

integrationTests/snip/input/sample.sc

@@ -0,0 +1,8 @@
+// :snippet-start: sc-test
+object Hello {
+    // Arrrrrrrrrrgs! :remove:
+    def main(args: Array[String]) = {
+        println("Hello, world")
+    }
+}
+// :snippet-end:

integrationTests/snip/input/sample.scala

@@ -0,0 +1,8 @@
+// :snippet-start: scala-test
+object Hello {
+    // Why do we pass arguments - that sounds confrontational. :remove:
+    def main(args: Array[String]) = {
+        println("Hello, world")
+    }
+}
+// :snippet-end:

src/bluehawk/actions/snip.ts

@@ -87,15 +87,23 @@ export const formatInRst = async (
   // nasty hack to cover the suffixes/rst languages we use most often
   // TODO: switch to a better mapping
   const rstLanguageMap: Map<string, string> = new Map([
+    [".c", "c"],
     [".cpp", "cpp"],
     [".cs", "csharp"],
+    [".go", "golang"],
     [".gradle", "groovy"],
     [".java", "java"],
     [".js", "javascript"],
     [".jsx", "javascript"],
     [".json", "json"],
     [".kt", "kotlin"],
     [".m", "objectivec"],
+    [".php", "php"],
+    [".py", "python"],
+    [".rb", "ruby"],
+    [".rs", "rust"],
+    [".sc", "scala"],
+    [".scala", "scala"],
     [".swift", "swift"],
     [".ts", "typescript"],
     [".tsx", "typescript"],

src/bluehawk/getBluehawk.ts

@@ -52,24 +52,27 @@ export const getBluehawk = async (): Promise<Bluehawk> => {
         ".c",
         ".cpp",
         ".cs",
+        ".dart",
+        ".go",
+        ".gradle",
+        ".groovy",
+        ".gsh",
+        ".gvy",
+        ".gy",
         ".h",
         ".hpp",
-        ".kt",
         ".java",
         ".js",
-        ".dart",
         ".jsx",
+        ".kt",
         ".m",
         ".mm",
+        ".rs",
+        ".sc",
+        ".scala",
         ".swift",
         ".ts",
         ".tsx",
-        ".gradle",
-        ".groovy",
-        ".gvy",
-        ".gy",
-        ".gsh",
-        ".go",
       ],
       {
         languageId: "C-like",
@@ -78,7 +81,12 @@ export const getBluehawk = async (): Promise<Bluehawk> => {
       }
     );
 
-    // Add all supported extensions here.
+    bluehawk.addLanguage([".php"], {
+      languageId: "PHP",
+      lineComments: [/#|\/\//],
+      blockComments: [[/\/\*/, /\*\//]],
+    });
+
     bluehawk.addLanguage([".py"], {
       languageId: "Python",
       lineComments: [/# ?/],
@@ -90,6 +98,11 @@ export const getBluehawk = async (): Promise<Bluehawk> => {
       ],
     });
 
+    bluehawk.addLanguage([".rb"], {
+      languageId: "Ruby",
+      lineComments: [/# ?/],
+    });
+
     bluehawk.addLanguage(["", ".txt", ".rst", ".md", ".json"], {
       languageId: "text",
     });