jekyll-theme-open-project-helpers 2.0.19 → 2.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca57af7201d24be44b8599119f06542dc5259103eb3f1e7b6e2296039ba0a150
-  data.tar.gz: 8517f92762844b2b3c3219190c9240229d4217cf0d167ab69455e7bf8db257cc
+  metadata.gz: ff8126d52bf314ac4b6a39f232dce02bce77a121b22063fc5fb1b62333481c9a
+  data.tar.gz: 965b43ee7edce41c4901dd7ab92a57a3f2d8ea586f319eaa26d4a38d1aa6e73f
 SHA512:
-  metadata.gz: b423c8c81a5c1f329c77fcf76e0fe6ea1471effd204320050f537aa26f6348be85c87b95d620ecc7a8e5fd37addc4658cfe881a5cff9d1536248f65247bf030d
-  data.tar.gz: f2bfa0879b66b8266e66a4e04d970fb35ec193f81d140291bbc629fc47071d9bfaa02042feb41865fd6de02422f42310dfa854a58e67cad109ec7cb6988ba585
+  metadata.gz: 01f428993882c421af571725613e52e1ab7c4a0ccdc9b4e0a715b3b9efa4a1d963afbf267ee65e48ae45d6223efcafbb324770e9335237841e03cb31d53d8d32
+  data.tar.gz: c764bbac19e62eb28bd0b42a2196b786cf70a0e2e865ef313b3b843e4266eec850e3c6586bc93ca8fd3d75464fcdb7240c2fd6b555efe4b8c641652617b694db

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2018 Ribose
+Copyright (c) 2020 Ribose
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -8,3 +8,20 @@ required by the theme.
 Currently it enables such features as tag-based filtering
 of open software and specification indexes, unified blog index,
 fetching open project/software/specification data from their repos.
+
+## Releasing
+
+**Release this helpers gem and theme gem in tandem with matching versions.**
+See [https://github.com/riboseinc/jekyll-theme-open-project-helpers](theme gem docs) for more.
+
+
+1. Inside .gemspec within this repo’s root, update main gem version to the one being released.
+
+2. Make a commit for the new release (“chore: Release vX.X.X”).
+
+3. Execute `./develop/release`. This does the following:
+
+   * Builds new gem version
+   * Pushes gem to rubygems.org
+   * Creates new version tag in this repository
+   * Pushes changes to GitHub

data/jekyll-theme-open-project-helpers.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name          = 'jekyll-theme-open-project-helpers'
-  s.version       = '2.0.19'
+  s.version       = '2.1.2'
   s.authors       = ['Ribose Inc.']
   s.email         = ['open.source@ribose.com']
 
@@ -12,7 +12,7 @@ Gem::Specification.new do |s|
 
   s.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|spec|features)/!) }
 
-  s.add_runtime_dependency 'jekyll', '~> 3.8'
+  s.add_runtime_dependency 'jekyll', '~> 4.0'
   s.add_runtime_dependency 'git', '~> 1.4'
   s.add_runtime_dependency 'fastimage', '~> 2.1.4'
   s.add_development_dependency 'rake', '~> 12.0'

data/lib/jekyll-theme-open-project-helpers/filterable_index.rb

@@ -55,7 +55,7 @@ module Jekyll
           # Creates a data structure like { tag1: [item1, item2], tag2: [item2, item3] }
           tags = {}
           items.each do |item|
-            item.data['tags'].each do |tag|
+            (item.data['tags'] or []).each do |tag|
               unless tags.key? tag
                 tags[tag] = []
               end
@@ -131,7 +131,13 @@ end
 def get_all_items(site, collection_name, filter_func)
   # Fetches items of specified type, ordered and prepared for usage in index templates
 
-  items = site.collections[collection_name].docs.select { |item|
+  collection = site.collections[collection_name]
+
+  if collection == nil
+    raise "Collection does not exist: #{collection_name}"
+  end
+
+  items = collection.docs.select { |item|
     filter_func.call(item)
   }
 

data/lib/jekyll-theme-open-project-helpers/project_data_reader.rb

@@ -30,6 +30,8 @@ module Jekyll
         entries.each do |entry|
           path = File.join(dir, entry)
 
+          Jekyll.logger.debug("OPF:", "Reading entry #{path}")
+
           if File.directory?(path)
             read_project_subdir(path, collection, nested=true)
 
@@ -41,10 +43,14 @@ module Jekyll
 
               # Add document to Jekyll document database if it refers to software or spec
               # (as opposed to be some nested document like README)
-              if doc.url.split('/').size == 4
+              if (doc.url.split('/').size == 4) or (doc.url.split('/').size == 5 and collection.label === 'projects')
+                Jekyll.logger.debug("OPF:", "Adding document with URL: #{doc.url}")
                 collection.docs << doc
+              else
+                Jekyll.logger.debug("OPF:", "Did NOT add document with URL (nesting level doesn’t match): #{doc.url}")
               end
             else
+              Jekyll.logger.debug("OPF:", "Adding static file: #{path}")
               collection.files << Jekyll::StaticFile.new(
                 @site,
                 @site.source,
@@ -104,6 +110,9 @@ module Jekyll
             project['site']['git_repo_url'],
             ['assets', '_posts', '_software', '_specs'])
 
+          
+          Jekyll.logger.debug("OPF:", "Reading files in project #{project_path}")
+
           CollectionDocReader.new(site).read(
             project_path,
             @site.collections['projects'])
@@ -131,10 +140,10 @@ module Jekyll
                       spec_checkout_path
                     end
 
+        repo_checkout = nil
         begin
           repo_checkout = git_shallow_checkout(spec_checkout_path, repo_url, [repo_subtree])
         rescue
-          repo_checkout = nil
         end
 
         if repo_checkout
@@ -164,14 +173,23 @@ module Jekyll
       def fetch_and_read_specs(collection_name, build_pages=false)
         # collection_name would be either specs or (for hub site) projects
 
+        Jekyll.logger.debug("OPF:", "Fetching specs for items in collection #{collection_name} (if it exists)")
+
         return unless @site.collections.key?(collection_name)
 
+        Jekyll.logger.debug("OPF:", "Fetching specs for items in collection #{collection_name}")
+
         # Get spec entry points
         entry_points = @site.collections[collection_name].docs.select do |doc|
           doc.data['spec_source']
         end
 
+        if entry_points.size < 1
+          Jekyll.logger.info("OPF:", "Fetching specs for items in collection #{collection_name}: No entry points")
+        end
+
         entry_points.each do |index_doc|
+          Jekyll.logger.debug("OPF:", "Fetching specs: entry point #{index_doc.id} in collection #{collection_name}")
           build_and_read_spec_pages(collection_name, index_doc, build_pages)
         end
       end
@@ -179,14 +197,23 @@ module Jekyll
       def fetch_and_read_software(collection_name)
         # collection_name would be either software or (for hub site) projects
 
+        Jekyll.logger.debug("OPF:", "Fetching software for items in collection #{collection_name} (if it exists)")
+
         return unless @site.collections.key?(collection_name)
 
+        Jekyll.logger.debug("OPF:", "Fetching software for items in collection #{collection_name}")
+
         entry_points = @site.collections[collection_name].docs.select do |doc|
           doc.data['repo_url']
         end
 
+        if entry_points.size < 1
+          Jekyll.logger.info("OPF:", "Fetching software for items in collection #{collection_name}: No entry points")
+        end
+
         entry_points.each do |index_doc|
           item_name = index_doc.id.split('/')[-1]
+          Jekyll.logger.debug("OPF:", "Fetching software: entry point #{index_doc.id} in collection #{collection_name}")
 
           docs = index_doc.data['docs']
           main_repo = index_doc.data['repo_url']
@@ -196,10 +223,10 @@ module Jekyll
 
           docs_path = "#{index_doc.path.split('/')[0..-2].join('/')}/#{item_name}"
 
+          sw_docs_checkout = nil 
           begin
             sw_docs_checkout = git_shallow_checkout(docs_path, sw_docs_repo, [sw_docs_subtree])
           rescue
-            sw_docs_checkout = nil 
           end
 
           if sw_docs_checkout
@@ -280,6 +307,7 @@ module Jekyll
                 :modified_at => nil,
               }
             else
+              Jekyll.logger.debug("OPF:", "Fetching & checking out #{remote_url} for #{repo_path}")
               repo.fetch(DEFAULT_REPO_REMOTE_NAME, { :depth => 1 })
               repo.checkout("#{DEFAULT_REPO_REMOTE_NAME}/#{DEFAULT_REPO_BRANCH}", { :f => true })
             end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-open-project-helpers
 version: !ruby/object:Gem::Version
-  version: 2.0.19
+  version: 2.1.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-08 00:00:00.000000000 Z
+date: 2020-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.8'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.8'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: git
   requirement: !ruby/object:Gem::Requirement
@@ -119,8 +119,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Helpers for the Open Project Jekyll theme