feat: check projects fields (#789)

Author: henryiii

_plugins/checkproj.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative 'checks'
+require 'set'
+
+module Checks
+  # This is a Jekyll Generator
+  class CheckProjInfo < Jekyll::Generator
+    # Main entry point for Jekyll
+    def generate(site)
+      @site = site
+
+      @site.pages.each do |page|
+        next unless page['pagetype'] == 'project'
+
+        msg = page.path.to_s
+        p = Record.new(msg, page.data)
+        p.key 'title', :nonempty
+        p.key 'shortname', :nonempty
+        p.key 'focus-area', :nonempty
+        p.key 'team', :nonempty, usernames: people
+
+        p.print_warnings
+      end
+
+      @site.data['fellow_projects'].each do |name, hash|
+        msg = name
+        p = Record.new(msg, hash)
+        p.key 'contacts', :nonempty, usernames: people
+      end
+    end
+
+    private
+
+    def people
+      @people ||= @site.data['people'].keys.to_set
+    end
+  end
+end

_plugins/checks.rb

@@ -16,11 +16,12 @@ def initialize(name, data)
       @data = data
       @missing = []
       @empty = []
+      @names = []
     end
 
     # Check to see if key is present. You can add :optional and/or :nonempty.
     # You can also add :date.
-    def key(key, *args, match: nil, set: nil)
+    def key(key, *args, match: nil, set: nil, usernames: nil)
       optional = !args.delete(:optional).nil?
       nonempty = !args.delete(:nonempty).nil?
       date = !args.delete(:date).nil?
@@ -38,6 +39,7 @@ def key(key, *args, match: nil, set: nil)
       key_match(key, match) if match
       key_date(key) if date
       key_set(key, set.to_set) if set
+      key_usernames(key, usernames.to_set) if usernames
     end
 
     def print_warnings
@@ -88,5 +90,14 @@ def key_set(key, set)
       msg = "'#{key}': #{@data[key]} is not a subset of #{set.to_a}"
       raise_err msg unless @data[key].to_set < set.to_set
     end
+
+    # Like key_set, but filters names with spaces, and shows only unmatched items
+    def key_usernames(key, usernames)
+      team = @data[key].reject { |v| v.include?(' ') || v.include?('@') }.to_set
+      extras = team - usernames
+
+      msg = "'#{key}': Unrecognized usernames: #{extras.to_a} "
+      raise_err msg unless extras.empty?
+    end
   end
 end

pages/projects/skyhookdm.md

@@ -11,7 +11,7 @@ focus-area: doma
 team:
 - jlefevre
 - ivotron
-- esmaeil-mirvakili
+- "[Esmaeil Mirvakili](mailto:[email protected])" # esmaeil-mirvakili
 - JayjeetAtGithub
 - xweichu
 - carlosmalt