jekyll-listme 0.4.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1afa2d6bfd820a02e9abc713944cb7096dd26b68fe11d30c328778413316f06c
+  data.tar.gz: 26cc6ad800c29e885ca89168f087236ffb7a3886ae31e16949deb1811aaa03cc
+SHA512:
+  metadata.gz: f455264505b1a2642309c86298ce92ce18ab18cc51c182885237fa16e5b641aa690402d16683f193e4844639911be2a1b2db9124fc2b52b33099e5b3e257c7ac
+  data.tar.gz: aa987f366f055e5f6105fea809170118f0144ea132bab395258d9fa2a008a7bec4db7d7b43bb001b8d4dc86cea9de9dec897add1c763800a1dc8c7c1027e5f09

data/.devcontainer/.dockerignore

@@ -0,0 +1,5 @@
+.dockerignore
+devcontainer.json
+docker-compose.yml
+Dockerfile
+README.md

data/.devcontainer/devcontainer.json

@@ -0,0 +1,63 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/rust
+{
+  "name": "Jekyll",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  // info about this base image: https://github.com/devcontainers/images/tree/main/src/jekyll
+  "image": "mcr.microsoft.com/devcontainers/jekyll:2.0.5-bookworm",
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "ghcr.io/devcontainers/features/sshd:1": {
+      "version": "latest"
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "18" // has to match the one in .nvmrc
+    }
+  },
+  // Configure tool-specific properties.
+  "customizations": {
+    // Configure properties specific to VS Code.
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "zsh",
+        "terminal.integrated.defaultProfile.osx": "zsh",
+        "terminal.integrated.defaultProfile.windows": "PowerShell"
+      },
+      "extensions": [
+        // ruby dev
+        "Shopify.ruby-extensions-pack", // ruby extensions pack
+        // bash
+        "mads-hartmann.bash-ide-vscode", // bash ide
+        // editor styling
+        "vscode-icons-team.vscode-icons", // better vs code icons
+        "will-stone.plastic", // my fav theme
+        // ide extensions
+        "EditorConfig.EditorConfig", // editorconfig support
+        "eamodio.gitlens", // git++
+        "codezombiech.gitignore", // gitignore assistant
+        "redhat.vscode-yaml", // yaml support
+        "streetsidesoftware.code-spell-checker", // spell checks
+        "wayou.vscode-todo-highlight", // to-do highlighting
+        "mrmlnc.vscode-duplicate", // option to duplicate files/folders
+        "tamasfe.even-better-toml", // toml support
+        "dunstontc.viml", // vim syntax support
+        "malmaud.tmux", // tmux syntax support
+        "hangxingliu.vscode-nginx-conf-hint", // nginx syntax support
+        // gh related
+        "GitHub.vscode-pull-request-github", // gh pr support
+        "github.vscode-github-actions", // gh actions support
+        "GitHub.copilot", // gh copilot
+        "GitHub.copilot-chat" // gh copilot chat
+      ]
+    }
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+  // Use 'postCreateCommand' to run commands after the container is created.
+  // "postCreateCommand": "rustc --version",
+  // NOTE: gh cli is installed by the 'features' property above.
+  "postCreateCommand": "gh extension install github/gh-copilot"
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+}

data/.editorconfig

@@ -0,0 +1,24 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.rb]
+indent_size = 2
+
+[*.py]
+indent_size = 4
+
+[*.sh]
+indent_size = 4
+
+[*.js]
+indent_size = 2

data/.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create release and upload assets
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.ref_name }}
+          tag_name: ${{ github.ref_name }}
+          body: |
+            Release notes for `${{ github.ref_name }}` are available here: https://github.com/pirafrank/jekyll-listme/blob/main/CHANGELOG.md
+          generate_release_notes: false
+          draft: false
+          prerelease: false
+          # Note: drafts and prereleases cannot be set as latest.
+          make_latest: true
+          fail_on_unmatched_files: true
+          # no need to specify GITHUB_TOKEN here, it is automatically provided by GitHub Actions
+          # https://github.com/softprops/action-gh-release#-customizing
+          # https://docs.github.com/en/actions/security-for-github-actions/security-guides/automatic-token-authentication

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,24 @@
+require: rubocop-jekyll
+
+inherit_gem:
+  rubocop-jekyll: .rubocop.yml
+
+AllCops:
+  TargetRubyVersion: 3.0
+  Exclude:
+      - vendor/**/*
+
+Jekyll/NoPutsAllowed:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 154
+
+Metrics/MethodLength:
+  Max: 40
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/.ruby-version

@@ -0,0 +1 @@
+3.2.2

data/CHANGELOG.md

@@ -0,0 +1,67 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.4.1] - 2025-02-15
+
+### 🚜 Refactor
+
+- Use @site class instance variable
+- Remove rubocop warnings
+
+### ⚙️ Miscellaneous Tasks
+
+- Better project setup
+- Removed unneeded files
+- Update readme
+
+## [0.4.0] - 2024-04-23
+
+### 🚀 Features
+
+- Count support
+- Count all
+
+### 💼 Other
+
+- Easier syntax
+- Bump to 0.4.0 and readme update
+
+## [0.3.0] - 2024-04-22
+
+### 🚀 Features
+
+- Add listing of drafts and posts
+- Add listing of pages
+- Added base58 id support and removed toml for good
+
+### 🐛 Bug Fixes
+
+- Fixed nasty typo
+
+### 💼 Other
+
+- Bump to 0.3.0
+
+## [0.2.0] - 2024-03-21
+
+### 🚀 Features
+
+- First commit
+- First working version
+- Added ruby-version file
+- Add option to print as csv or tsv
+- Add option to print as psv or toml
+- Case-insensitive input + validation
+
+### 💼 Other
+
+- Devcontainer
+- Readme update
+- Bump to 0.2.0
+
+### ⚙️ Miscellaneous Tasks
+
+- Chores
+
+<!-- generated by git-cliff -->

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in jekyll-listme.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,55 @@
+PATH
+  remote: .
+  specs:
+    jekyll-listme (0.4.1)
+      json (~> 2.7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    json (2.7.1)
+    language_server-protocol (3.17.0.4)
+    parallel (1.26.3)
+    parser (3.3.7.1)
+      ast (~> 2.4.1)
+      racc
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.1.0)
+    regexp_parser (2.10.0)
+    rexml (3.4.0)
+    rubocop (1.57.2)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.2.2.4)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.38.0)
+      parser (>= 3.3.1.0)
+    rubocop-jekyll (0.14.0)
+      rubocop (~> 1.57.0)
+      rubocop-performance (~> 1.2)
+    rubocop-performance (1.23.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (2.6.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (~> 2.5)
+  jekyll-listme!
+  rake (~> 13.0)
+  rubocop-jekyll (~> 0.14)
+
+BUNDLED WITH
+   2.5.6

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Francesco Pira
+
+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.

data/README.md

@@ -0,0 +1,67 @@
+# Jekyll ListMe
+
+A [Jekyll](https://jekyllrb.com/) [command](https://jekyllrb.com/docs/plugins/commands/) plugin to list and count data in your Jekyll website. List tags, categories, and more, and count their occurrencies. Choose among various output formats.
+
+## Installation
+
+```Gemfile
+gem 'jekyll-listme', git: 'https://github.com/pirafrank/jekyll-listme', branch: 'main'
+```
+
+## Update
+
+```sh
+bundle update jekyll-listme
+```
+
+## Usage
+
+Plain text is the default output format:
+
+```sh
+bundle exec jekyll list tags
+bundle exec jekyll list categories
+```
+
+You can choose an output format like this:
+
+```sh
+bundle exec jekyll list tags --output FORMAT
+bundle exec jekyll list categories --output FORMAT
+```
+
+You can also count items, instead of listing them:
+
+```sh
+bundle exec jekyll list --count tags --output FORMAT
+bundle exec jekyll list --all --output FORMAT
+```
+
+Supported formats are:
+
+- `plain`
+- `json`
+- `yaml`
+- `csv`
+- `tsv`
+- `psv`
+
+## Development
+
+Clone and run `bundle install` to get started.
+
+Code lives in `lib/jekyll/commands` and is referenced with `require` in `lib/jekyll/listme.rb`. To experiment with that code, run `bundle exec jekyll list` from a Jekyll site with this gem added as plugin. Read more on [Jekyll's Commands documentation](https://jekyllrb.com/docs/plugins/commands/).
+
+I got the first steps to create the template from [here](https://maxchadwick.xyz/blog/building-a-custom-jekyll-command-plugin).
+
+## Contributing
+
+[Bug reports](https://github.com/pirafrank/jekyll-listme/issues) and [pull requests](https://github.com/pirafrank/jekyll-listme/pulls) are welcome on GitHub.
+
+## Guarantee
+
+This plugin is provided as is, without any guarantee. Use at your own risk.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/cliff.toml

@@ -0,0 +1,91 @@
+# git-cliff ~ default configuration file
+# https://git-cliff.org/docs/configuration
+#
+# Lines starting with "#" are comments.
+# Configuration options are organized into tables and keys.
+# See documentation for more information on available options.
+
+[changelog]
+# template for the changelog header
+header = """
+# Changelog\n
+All notable changes to this project will be documented in this file.\n
+"""
+# template for the changelog body
+# https://keats.github.io/tera/docs/#introduction
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
+            {% if commit.breaking %}[**breaking**] {% endif %}\
+            {{ commit.message | upper_first }}\
+    {% endfor %}
+{% endfor %}\n
+"""
+# template for the changelog footer
+footer = """
+<!-- generated by git-cliff -->
+"""
+# remove the leading and trailing s
+trim = true
+# postprocessors
+postprocessors = [
+  # { pattern = '<REPO>', replace = "https://github.com/orhun/git-cliff" }, # replace repository URL
+]
+# render body even when there are no releases to process
+# render_always = true
+# output file path
+# output = "test.md"
+
+[git]
+# parse the commits based on https://www.conventionalcommits.org
+conventional_commits = true
+# filter out the commits that are not conventional
+filter_unconventional = false
+# process each line of a commit as an individual commit
+split_commits = false
+# regex for preprocessing the commit messages
+commit_preprocessors = [
+  # because of old commits -- start
+  { pattern = "^add(.*)", replace = "feat: Add$1"},
+  { pattern = "^first(.*)", replace = "feat: first$1"},
+  { pattern = "^count(.*)", replace = "feat: count$1"},
+  { pattern = "^case-(.*)", replace = "feat: case-$1"},
+  # because of old commits -- end
+  #
+  # Replace issue numbers
+  #{ pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](<REPO>/issues/${2}))"},
+  # Check spelling of the commit with https://github.com/crate-ci/typos
+  # If the spelling is incorrect, it will be automatically fixed.
+  #{ pattern = '.*', replace_command = 'typos --write-changes -' },
+]
+# regex for parsing and grouping commits
+commit_parsers = [
+  { message = "^feat", group = "<!-- 0 -->🚀 Features" },
+  { message = "^fix", group = "<!-- 1 -->🐛 Bug Fixes" },
+  { message = "^doc", group = "<!-- 3 -->📚 Documentation" },
+  { message = "^perf", group = "<!-- 4 -->⚡ Performance" },
+  { message = "^refactor", group = "<!-- 2 -->🚜 Refactor" },
+  { message = "^style", group = "<!-- 5 -->🎨 Styling" },
+  { message = "^test", group = "<!-- 6 -->🧪 Testing" },
+  { message = "^chore\\(release\\): prepare for", skip = true },
+  { message = "^chore\\(deps.*\\)", skip = true },
+  { message = "^chore\\(pr\\)", skip = true },
+  { message = "^chore\\(pull\\)", skip = true },
+  { message = "^chore|^ci", group = "<!-- 7 -->⚙️ Miscellaneous Tasks" },
+  { body = ".*security", group = "<!-- 8 -->🛡️ Security" },
+  { message = "^revert", group = "<!-- 9 -->◀️ Revert" },
+  { message = ".*", group = "<!-- 10 -->💼 Other" },
+]
+# filter out the commits that are not matched by commit parsers
+filter_commits = false
+# sort the tags topologically
+topo_order = false
+# sort the commits inside sections by oldest/newest order
+sort_commits = "oldest"

data/jekyll-listme.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "lib/jekyll/listme/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "jekyll-listme"
+  spec.version = Jekyll::Listme::VERSION
+  spec.authors = ["Francesco Pira"]
+  spec.email = ["dev@fpira.com"]
+
+  spec.summary = "List tags and categories for your Jekyll website."
+  spec.description = "Jekyll command plugin to list tags and categories for your Jekyll website and number of their occurrencies. Choose between a JSON, YAML, or plain text output."
+  spec.homepage = "https://github.com/pirafrank/jekyll-listme"
+
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r!^bin/!) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "https://github.com/pirafrank/jekyll-listme/blob/main/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/pirafrank/jekyll-listme/issues"
+
+  spec.add_dependency "json", "~> 2.7"
+
+  spec.add_development_dependency "bundler", "~> 2.5"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rubocop-jekyll", "~> 0.14"
+end

data/lib/jekyll/commands/listme.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Jekyll
+  module Commands
+    class ListMe < Command
+      class << self
+        def init_with_program(prog)
+          prog.command(:list) do |c|
+            c.description "List tags and categories used in the site."
+            c.syntax "list [items] [options]"
+
+            # nb. check the short option because it may be used elsewhere.
+            #     run --help to see the full list of options.
+            c.option "output", "-o", "--output FORMAT", "Output format"
+            c.option "count", "-c", "--count", "Count the number of items"
+            c.option "all", "-a", "--all", "Count all items"
+
+            c.action do |args, options|
+              options["serving"] = false
+              Jekyll::Commands::ListMe.process(args, options)
+            end
+          end
+        end
+
+        def normalize_output_format(output)
+          if output.nil?
+            "plain"
+          else
+            output.downcase
+          end
+        end
+
+        def init_site(opts)
+          Jekyll.logger.adjust_verbosity(opts)
+          options = configuration_from_options(opts)
+          options["show_drafts"] = true
+          site = Jekyll::Site.new(options)
+          site.reset
+          site.read
+          @site = site
+        end
+
+        def populate_results(choice)
+          results = Hash.new(0)
+          case choice
+          when "tags"
+            results["tags"] = tags
+          when "categories"
+            results["categories"] = categories
+          when "drafts"
+            results["drafts"] = posts(true)
+          when "posts"
+            results["posts"] = posts(false)
+          when "pages"
+            results["pages"] = pages
+          else
+            Jekyll.logger.error "Invalid option. You must specify a known option. Check --help."
+            return
+          end
+          results
+        end
+
+        def process(args, opts)
+          supported_items = %w(tags categories drafts posts pages)
+          choice = opts["all"] ? "all" : args[0]
+          if choice.nil?
+            Jekyll.logger.error "You must specify items to list.\nSupported items are: #{supported_items.join(", ")}"
+            return
+          end
+          # normalize to lowercase
+          choice = choice.downcase
+          unless supported_items.include?(choice) || opts["all"]
+            Jekyll.logger.error "Invalid argument. Supported items are: #{supported_items.join(", ")}"
+            return
+          end
+
+          opts["output"] = normalize_output_format(opts["output"])
+          supported_formats = %w(plain yaml json csv tsv psv)
+          unless supported_formats.include?(opts["output"])
+            Jekyll.logger.error "Invalid output format. Supported formats are: #{supported_formats.join(", ")}"
+            return
+          end
+
+          # Generate the website
+          init_site(opts)
+          # Populate the results based on the choice
+          to_print = Hash.new(0)
+          if choice == "all"
+            supported_items.each do |item|
+              results = populate_results(item)
+              to_print[item] = count_items(results[item])
+            end
+          else
+            results = populate_results(choice)
+            if opts["count"]
+              to_print[choice] = count_items(results[choice])
+            else
+              to_print = results[choice]
+            end
+          end
+
+          # finally print the data
+          print_data(to_print, opts)
+        end
+
+        def print_data(data, opts)
+          print_list_text(data) if opts["output"] == "plain"
+          print_list_yaml(data) if opts["output"] == "yaml"
+          print_list_json(data) if opts["output"] == "json"
+          print_list_text(data, ",") if opts["output"] == "csv"
+          print_list_text(data, "\t") if opts["output"] == "tsv"
+          print_list_text(data, "|") if opts["output"] == "psv"
+        end
+
+        def count_items(list)
+          count = 0
+          if list.instance_of?(Hash)
+            count = list.keys.length
+          elsif list.instance_of?(Array)
+            count = list.length
+          end
+          count
+        end
+
+        def categories
+          @site.categories.keys
+        end
+
+        def tags
+          tags = Hash.new(0)
+          # Loop through all the posts
+          @site.posts.docs.each do |post|
+            # Loop through each tag of the post
+            post.data["tags"].each do |tag|
+              # If the tag already exists in the map, increment the count
+              if tags.key?(tag)
+                tags[tag] += 1
+              else
+                # Otherwise initialize the count to 1
+                tags[tag] = 1
+              end
+            end
+          end
+
+          # Sort the tags alphabetically (case-insensitive)
+          tags.sort_by { |tag, _| tag.downcase }.to_h
+        end
+
+        def posts(is_draft)
+          list = []
+          @site.posts.docs.sort_by { |post| post.data["date"] }.each do |post|
+            next unless post.data["draft"] == is_draft
+
+            iso_date = post.data["date"].iso8601
+            post_id = generate_base58_from_string(post.data["slug"])
+            title = post.data["title"]
+            list << { "date" => iso_date, "id" => post_id, "title" => title }
+          end
+          list
+        end
+
+        def pages
+          pages = Hash.new(0)
+          @site.pages.each do |page|
+            pages[page.url] = page.data["title"]
+          end
+          pages
+        end
+
+        def generate_base58_from_string(str)
+          # Generate a base58 string from the input string
+          alphabet = "123456789abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ"
+          base = alphabet.length
+          base58 = ""
+          num_hex = Digest::SHA1.hexdigest(str)
+          num = num_hex.to_i(16)
+          while num > 0 # rubocop:disable Style/NumericPredicate
+            num, remainder = num.divmod(base)
+            base58 = alphabet[remainder] + base58
+          end
+          base58
+        end
+
+        def print_list_text(list, separator = " ")
+          if list.instance_of?(Hash)
+            list.each do |key, value|
+              puts "#{key}#{separator}#{value}"
+            end
+          elsif list.instance_of?(Array)
+            list.each do |item|
+              if item.instance_of?(String)
+                puts item
+              elsif item.instance_of?(Hash)
+                puts item.values.join(separator)
+              elsif item.instance_of?(Array)
+                puts item.join(separator)
+              else
+                puts "Invalid data type"
+              end
+            end
+          else
+            puts "Invalid data type"
+          end
+        end
+
+        def print_list_json(list)
+          # Print the output in JSON format
+          puts JSON.pretty_generate(list)
+        end
+
+        def print_list_yaml(list)
+          # Print the output in YAML format
+          puts list.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/jekyll/listme/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Listme
+    VERSION = "0.4.1"
+  end
+end

data/lib/jekyll/listme.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "listme/version"
+require_relative "commands/listme"
+
+module Jekyll
+  module Listme
+    class Error < StandardError; end
+    # Your code goes here...
+  end
+end

data/sig/jekyll/listme.rbs

@@ -0,0 +1,6 @@
+module Jekyll
+  module Listme
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-listme
+version: !ruby/object:Gem::Version
+  version: 0.4.1
+platform: ruby
+authors:
+- Francesco Pira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+description: Jekyll command plugin to list tags and categories for your Jekyll website
+  and number of their occurrencies. Choose between a JSON, YAML, or plain text output.
+email:
+- dev@fpira.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".devcontainer/.dockerignore"
+- ".devcontainer/devcontainer.json"
+- ".editorconfig"
+- ".github/workflows/release.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-version"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- cliff.toml
+- jekyll-listme.gemspec
+- lib/jekyll/commands/listme.rb
+- lib/jekyll/listme.rb
+- lib/jekyll/listme/version.rb
+- sig/jekyll/listme.rbs
+homepage: https://github.com/pirafrank/jekyll-listme
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/pirafrank/jekyll-listme
+  changelog_uri: https://github.com/pirafrank/jekyll-listme/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/pirafrank/jekyll-listme/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.18
+signing_key: 
+specification_version: 4
+summary: List tags and categories for your Jekyll website.
+test_files: []