jekyll-postcss-v2 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ba330d199aa1671ac43e2cfe7d61072d6d73b6d5e3280d1051bf75113948440c
+  data.tar.gz: 7acf137ddb7e194a625ff6b2a8ec09afb4a1f774fa240d5c4a36e3347d7dddbb
+SHA512:
+  metadata.gz: 3682a8afa70f816943a0ee63e04cdb25276cfe748699e17af9d5d2d5bda639adb4e17255fef5fdd931bbde3d8f6ef21e637deb786d34072fa0517e451d531dc4
+  data.tar.gz: cbfff3eedc371741b44bfa6ea7eabdbac94ab8c72c5e98804f214c273efc849f61183989b705b639a4547ec2662e8f82cc8c0aec3d31c9e9e82fe1d93b3b17f4

data/.gitignore

@@ -0,0 +1,3 @@
+.jekyll-cache
+_site
+node_modules

data/.rubocop.yml

@@ -0,0 +1,4 @@
+require: rubocop-jekyll
+
+inherit_gem:
+  rubocop-jekyll: .rubocop.yml

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,110 @@
+PATH
+  remote: .
+  specs:
+    jekyll-postcss-v2 (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.2)
+    colorator (1.1.0)
+    concurrent-ruby (1.1.9)
+    diff-lcs (1.4.4)
+    em-websocket (0.5.2)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0.6.0)
+    eventmachine (1.2.7)
+    ffi (1.15.1)
+    forwardable-extended (2.6.0)
+    http_parser.rb (0.6.0)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.4)
+    jekyll (4.2.0)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      em-websocket (~> 0.5)
+      i18n (~> 1.0)
+      jekyll-sass-converter (~> 2.0)
+      jekyll-watch (~> 2.0)
+      kramdown (~> 2.3)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 4.0)
+      mercenary (~> 0.4.0)
+      pathutil (~> 0.9)
+      rouge (~> 3.0)
+      safe_yaml (~> 1.0)
+      terminal-table (~> 2.0)
+    jekyll-sass-converter (2.1.0)
+      sassc (> 2.0.1, < 3.0)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    kramdown (2.3.1)
+      rexml
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    liquid (4.0.3)
+    listen (3.5.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    mercenary (0.4.0)
+    parallel (1.20.1)
+    parser (3.0.1.1)
+      ast (~> 2.4.1)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    powerpack (0.1.3)
+    public_suffix (4.0.6)
+    rainbow (3.0.0)
+    rake (13.0.3)
+    rb-fsevent (0.11.0)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rexml (3.2.5)
+    rouge (3.26.0)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rubocop (0.62.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    rubocop-jekyll (0.5.1)
+      rubocop (>= 0.57.2, < 0.63.0)
+    ruby-progressbar (1.11.0)
+    safe_yaml (1.0.5)
+    sassc (2.4.0)
+      ffi (~> 1.9)
+    terminal-table (2.0.0)
+      unicode-display_width (~> 1.1, >= 1.1.1)
+    unicode-display_width (1.4.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.1)
+  jekyll (>= 3.0)
+  jekyll-postcss-v2!
+  rake (>= 12.3.3)
+  rspec (~> 3.0)
+  rubocop-jekyll (~> 0.5.1)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -0,0 +1,58 @@
+# Jekyll PostCSS v2
+A revamp of [jekyll-postcss](https://github.com/mhanberg/jekyll-postcss) that uses Jekyll hooks and generally tries to be less complicated.
+
+## Table of contents
+
+- [Installation](README.md#installation)
+- [Usage](README.md#usage)
+- [Why v2?](README.md#why-v2)
+- [Why not?](README.md#why-not)
+- [TODO](README.md#todo)
+
+## Installation
+
+_`Gemfile`_
+```ruby
+group :jekyll_plugins do
+  gem 'jekyll-postcss-v2'
+end
+```
+
+_`_config.yml`  
+<sup>(Until [jekyll#8585](https://github.com/jekyll/jekyll/pull/8585) is released)</sup>_ 
+```yml
+plugins:
+  - jekyll-postcss-v2
+```
+
+_In your jekyll source directory:_
+```bash
+npm i -D postcss postcss-cli
+```
+
+## Usage
+
+Configure your `postcss.config.js` file in your jekyll source directory.
+
+## Why v2?
+- Better logging to help catch when things aren't running
+- Processes the output file on disk, skipping the need to parse Sass
+- Doesn't transfer file contents over a network or cli parameter, avoiding issues when files are too large for buffers
+- Respects the Jekyll source directory for configuration files
+- Fewer moving parts. No sockets, no bundled node scripts, no internal caching
+- Probably works with Tailwind JIT<sup>[citation needed]</sup> 🤷‍♂️
+
+## Why not?
+- Potentially slower<sup>[citation needed]</sup>, but more than fast enough for my needs. 
+
+## TODO
+- Write tests
+- Wire up a CI
+- Add configuration
+  - _postcss.config.js location_
+  - _node_modules location_
+- Profile in production / development
+- Investigate what needs to be done around the sourcemap
+- More logging.
+  - Before/after filesizes
+  - Timings

data/Rakefile

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"

data/jekyll-postcss-v2.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "jekyll-postcss-v2/version"
+
+Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
+  spec.name          = "jekyll-postcss-v2"
+  spec.version       = Jekyll::PostCssV2::VERSION
+  spec.authors       = ["Liam Bigelow"]
+  spec.email         = ["liam@bigelow.io"]
+  spec.summary       = "Straight up PostCSS for Jekyll."
+  spec.description   = "Straight up PostCSS for Jekyll."
+  spec.homepage      = "https://github.com/bglw/jekyll-postcss-v2"
+  spec.license       = "MIT"
+
+  if spec.respond_to?(:metadata)
+    spec.metadata["homepage_uri"] = spec.homepage
+    spec.metadata["source_code_uri"] = spec.homepage
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|spec|features)/!) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r!^exe/!) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.1"
+  spec.add_development_dependency "jekyll", ">= 3.0"
+  spec.add_development_dependency "rake", ">= 12.3.3"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop-jekyll", "~> 0.5.1"
+end

data/lib/jekyll-postcss-v2.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require "jekyll-postcss-v2/version"
+require "jekyll-postcss-v2/hook"
+
+module Jekyll
+  module PostCssV2
+  end
+end

data/lib/jekyll-postcss-v2/hook.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module PostCssV2
+  class Engine
+    def initialize(source)
+      @script = Pathname.new(source + "/node_modules/.bin/postcss")
+      unless @script.exist?
+        Jekyll.logger.error "PostCSS v2:",
+                            "PostCSS not found.
+                             Make sure postcss and postcss-cli
+                             are installed in your Jekyll source."
+        Jekyll.logger.error "PostCSS v2:",
+                            "Couldn't find #{@script}"
+        exit 1
+      end
+
+      config = Pathname.new(source + "/postcss.config.js")
+      unless config.exist?
+        Jekyll.logger.error "PostCSS v2:",
+                            "postcss.config.js not found.
+                             Make sure it exists in your Jekyll source."
+        Jekyll.logger.error "PostCSS v2:",
+                            "Couldn't find #{config}"
+        exit 1
+      end
+    end
+
+    def process(page)
+      file_path = Pathname.new(page.site.dest + page.url)
+      postcss_command = `#{@script} #{file_path} -r`
+      Jekyll.logger.info "PostCSS v2:",
+                         "Rewrote #{page.url} #{postcss_command}"
+    end
+  end
+end
+
+Jekyll::Hooks.register :pages, :post_write do |page|
+  if %r!\.css$! =~ page.url
+    engine = PostCssV2::Engine.new(page.site.source)
+    engine.process(page)
+  end
+end

data/lib/jekyll-postcss-v2/version.rb

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

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-postcss-v2
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Liam Bigelow
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-06-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+description: Straight up PostCSS for Jekyll.
+email:
+- liam@bigelow.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- jekyll-postcss-v2.gemspec
+- lib/jekyll-postcss-v2.rb
+- lib/jekyll-postcss-v2/hook.rb
+- lib/jekyll-postcss-v2/version.rb
+homepage: https://github.com/bglw/jekyll-postcss-v2
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/bglw/jekyll-postcss-v2
+  source_code_uri: https://github.com/bglw/jekyll-postcss-v2
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key:
+specification_version: 4
+summary: Straight up PostCSS for Jekyll.
+test_files: []