Add lint tests

test/frontmatter.yml

@@ -0,0 +1,41 @@
+# Each piece of content has YAML front matter with these properties:
+title:
+  type: String
+  required: true
+
+description:
+  type: String
+  required: true
+
+slug:
+  type: String
+  required: true
+
+screenshots:
+  type: Array
+  required: true
+
+authors:
+  type: Array
+  required: true
+
+repository:
+  type: String
+  required: true
+
+host:
+  type: String
+  required: true
+
+# All these fields are generated by `scripts/sync-data`
+stars:
+  type: Numeric
+
+installations:
+  type: Numeric
+
+organizations:
+  type: Array
+
+updated:
+  type: String

test/lint_test.rb

@@ -0,0 +1,52 @@
+require "bundler/setup"
+require "safe_yaml"
+require "minitest/autorun"
+
+describe "lint test" do
+  BANNED_WORDS = Regexp.new('\b(' + [
+    "GitHub App",     # They're all GitHub Apps
+    "bot",            # TODO: link to docs about why bot is not preferred
+    "automatically"   # They're all automatic
+  ].join('|') + ')\b', Regexp::IGNORECASE | Regexp::MULTILINE)
+
+  Dir.glob("_apps/*.md").each do |path|
+    describe path do
+      # Load frontmatter
+      data = SafeYAML.load_file(path)
+      fields = SafeYAML.load_file("test/frontmatter.yml")
+
+      it "does not have extraneous fields" do
+        extra_fields = data.keys - fields.keys
+        assert extra_fields.empty?, "Unexpected metadata: #{extra_fields.inspect}"
+      end
+
+      fields.each do |name, attrs|
+        if attrs["required"]
+          it "${name} is required" do
+            assert data.key?(name), "#{name} is required"
+          end
+        end
+
+        if attrs["type"] && data[name]
+          it "${name} must be a #{attrs["type"]}" do
+            assert_kind_of Kernel.const_get(attrs["type"]), data[name]
+          end
+        end
+      end
+
+      it "description should be sentence case" do
+        first_letter = data["description"][0]
+        assert_equal first_letter.upcase, first_letter, "Description should be in sentence case"
+      end
+
+      it "does not use banned words" do
+        %w(title description slug).each do |field|
+          match = data[field].match(BANNED_WORDS)
+          if match
+            assert !match, "`#{match[1]}` should not be used in #{field}"
+          end
+        end
+      end
+    end
+  end
+end