jekyll-tailwindcss 0.1.0-x86_64-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e658afb4fddd43cdd03f6a907ba7f2f45b2be3750ae4b8e7682a4c8865432166
+  data.tar.gz: 8423ed146440946f8ee1111c7f3b59339240fe14ebb8f9b987f60a40449323d6
+SHA512:
+  metadata.gz: 950c590e2e55467359c1913bedbc115167a49b79883b9184e6493a5600125a062d20a936e87639ba69d014d0a59330b3364fb7128c474fe0c9873a16969c7ce3
+  data.tar.gz: be05e09ca526cdf92d692c0c285c8bb9aaad14002c31096450d99688eb3eae6f227e844c5cfa02b153e17a5e8c911441218535138312254874fcd9ee1a4be0d4

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Mike Vormwald
+
+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/LICENSE-DEPENDENCIES

@@ -0,0 +1,26 @@
+jekyll-tailwindcss may redistribute executables from the https://github.com/tailwindlabs/tailwindcss project
+
+The license for that software can be found at https://github.com/tailwindlabs/tailwindcss/blob/master/LICENSE which is reproduced here for your convenience:
+
+    MIT License
+
+    Copyright (c) Adam Wathan <adam.wathan@gmail.com>
+    Copyright (c) Jonathan Reinink <jonathan@reinink.ca>
+
+    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,53 @@
+# Jekyll::Tailwindcss
+
+## Installation
+
+Install the gem in your jekyll project's Gemfile by executing the following:
+
+```sh
+$ bundle add jekyll-tailwindcss
+```
+
+Add it to your list of jekyll-plugins
+
+```yml
+plugins:
+  - jekyll-tailwindcss
+```
+
+## Usage
+
+Currently, this gem assumes you have several files in your project:
+
+**`tailwind.config.js`**
+
+This is the tailwind configuration for your project. Learn [more here](https://tailwindcss.com/docs/configuration).
+
+**`_input.css`**
+
+This file will contain your tailwind directives and any custom classes. Read more in the [docs here](https://tailwindcss.com/docs/functions-and-directives#config)
+
+**`*.tailwindcss`**
+
+Any files with this extension (and contain [frontmatter](https://jekyllrb.com/docs/front-matter/)) will be processed by tailwind, and converted into a corresponding filename with a `.css` extension.
+
+For instance, `assets/css/styles.tailwindcss` will convert to `_site/assets/css/styles.css`
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/vormwald/jekyll-tailwindcss. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/vormwald/jekyll-tailwindcss/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Jekyll::Tailwindcss project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/vormwald/jekyll-tailwindcss/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "standard/rake"
+
+task default: %i[spec standard]

data/exe/tailwindcss

@@ -0,0 +1,18 @@
+#! /usr/bin/env ruby
+# because rubygems shims assume a gem's executables are Ruby
+
+require "tailwindcss/commands"
+
+begin
+  command = [Tailwindcss::Commands.executable, *ARGV]
+  if Gem.win_platform?
+    # use system rather than exec as exec inexplicably fails to find the executable on Windows
+    # see related https://github.com/rubys/sprockets-esbuild/pull/4
+    system(*command, exception: true)
+  else
+    exec(*command)
+  end
+rescue Tailwindcss::Commands::UnsupportedPlatformException, Tailwindcss::Commands::ExecutableNotFoundException => e
+  warn("ERROR: " + e.message)
+  exit 1
+end

data/lib/jekyll/converters/tailwindcss.rb

@@ -0,0 +1,25 @@
+module Jekyll
+  module Converters
+    class Tailwindcss < Converter
+      safe true
+      priority :low
+
+      def matches(ext)
+        /^\.tailwindcss$/i.match?(ext)
+      end
+
+      def output_ext(ext)
+        ".css"
+      end
+
+      def convert(content)
+        dev_mode = Jekyll.env == "development"
+        Jekyll.logger.info "Jekyll Tailwind:", "Generating #{dev_mode ? "" : "minified "}CSS"
+
+        compile_command = ::Tailwindcss::Commands.compile_command(debug: dev_mode).join(" ")
+
+        `#{compile_command}`
+      end
+    end
+  end
+end

data/lib/jekyll-tailwindcss/version.rb

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

data/lib/jekyll-tailwindcss.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "jekyll"
+require_relative "jekyll-tailwindcss/version"
+require_relative "jekyll/converters/tailwindcss"
+require_relative "tailwindcss/commands"
+require_relative "tailwindcss/upstream"
+
+module Jekyll
+  module Tailwindcss
+  end
+end
+
+module Tailwindcss
+end

data/lib/tailwindcss/commands.rb

@@ -0,0 +1,92 @@
+require_relative "upstream"
+
+module Tailwindcss
+  module Commands
+    DEFAULT_DIR = File.expand_path(File.join(__dir__, "..", "..", "exe"))
+    GEM_NAME = "jekyll-tailwindcss"
+
+    # raised when the host platform is not supported by upstream tailwindcss's binary releases
+    class UnsupportedPlatformException < StandardError
+    end
+
+    # raised when the tailwindcss executable could not be found where we expected it to be
+    class ExecutableNotFoundException < StandardError
+    end
+
+    # raised when TAILWINDCSS_INSTALL_DIR does not exist
+    class DirectoryNotFoundException < StandardError
+    end
+
+    class << self
+      def platform
+        [:cpu, :os].map { |m| Gem::Platform.local.send(m) }.join("-")
+      end
+
+      def executable(exe_path: DEFAULT_DIR)
+        tailwindcss_install_dir = ENV["TAILWINDCSS_INSTALL_DIR"]
+        if tailwindcss_install_dir
+          if File.directory?(tailwindcss_install_dir)
+            warn "NOTE: using TAILWINDCSS_INSTALL_DIR to find tailwindcss executable: #{tailwindcss_install_dir}"
+            exe_path = tailwindcss_install_dir
+            exe_file = File.expand_path(File.join(tailwindcss_install_dir, "tailwindcss"))
+          else
+            raise DirectoryNotFoundException, <<~MESSAGE
+              TAILWINDCSS_INSTALL_DIR is set to #{tailwindcss_install_dir}, but that directory does not exist.
+            MESSAGE
+          end
+        else
+          if Tailwindcss::Upstream::NATIVE_PLATFORMS.keys.none? { |p| Gem::Platform.match_gem?(Gem::Platform.new(p), GEM_NAME) }
+            raise UnsupportedPlatformException, <<~MESSAGE
+              jekyll-tailwindcss does not support the #{platform} platform
+              Please install tailwindcss following instructions at https://tailwindcss.com/docs/installation
+            MESSAGE
+          end
+
+          exe_file = Dir.glob(File.expand_path(File.join(exe_path, "*", "tailwindcss"))).find do |f|
+            Gem::Platform.match_gem?(Gem::Platform.new(File.basename(File.dirname(f))), GEM_NAME)
+          end
+        end
+
+        if exe_file.nil? || !File.exist?(exe_file)
+          raise ExecutableNotFoundException, <<~MESSAGE
+            Cannot find the tailwindcss executable for #{platform} in #{exe_path}
+
+            If you're using bundler, please make sure you're on the latest bundler version:
+
+                gem install bundler
+                bundle update --bundler
+
+            Then make sure your lock file includes this platform by running:
+
+                bundle lock --add-platform #{platform}
+                bundle install
+
+            See `bundle lock --help` output for details.
+
+            TODO If you're still seeing this message after taking those steps, try running
+            `bundle config` and ensure `force_ruby_platform` isn't set to `true`. See
+            https://github.com/vormwald/jekyll-tailwindcss#check-bundle_force_ruby_platform
+            for more details.
+          MESSAGE
+        end
+
+        exe_file
+      end
+
+      def compile_command(debug: false, **kwargs)
+        command = [
+          executable(**kwargs),
+          "-i", "./_input.css",
+          "-c", "./tailwind.config.js"
+        ]
+
+        command << "--minify" unless debug
+
+        postcss_path = "postcss.config.js"
+        command += ["--postcss", postcss_path] if File.exist?(postcss_path)
+
+        command
+      end
+    end
+  end
+end

data/lib/tailwindcss/upstream.rb

@@ -0,0 +1,17 @@
+module Tailwindcss
+  # constants describing the upstream tailwindcss project
+  module Upstream
+    VERSION = "v3.4.3"
+
+    # rubygems platform name => upstream release filename
+    NATIVE_PLATFORMS = {
+      "arm64-darwin" => "tailwindcss-macos-arm64",
+      "x64-mingw32" => "tailwindcss-windows-x64.exe",
+      "x64-mingw-ucrt" => "tailwindcss-windows-x64.exe",
+      "x86_64-darwin" => "tailwindcss-macos-x64",
+      "x86_64-linux" => "tailwindcss-linux-x64",
+      "aarch64-linux" => "tailwindcss-linux-arm64",
+      "arm-linux" => "tailwindcss-linux-armv7"
+    }
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: jekyll-tailwindcss
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: x86_64-darwin
+authors:
+- Mike Vormwald
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-04-16 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+- mvormwald@gmail.com
+executables:
+- tailwindcss
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- LICENSE-DEPENDENCIES
+- README.md
+- Rakefile
+- exe/tailwindcss
+- exe/x86_64-darwin/tailwindcss
+- lib/jekyll-tailwindcss.rb
+- lib/jekyll-tailwindcss/version.rb
+- lib/jekyll/converters/tailwindcss.rb
+- lib/tailwindcss/commands.rb
+- lib/tailwindcss/upstream.rb
+homepage: https://github.com/vormwald/jekyll-tailwindcss
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/vormwald/jekyll-tailwindcss
+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.4.20
+signing_key:
+specification_version: 4
+summary: Integrate Tailwind CSS into your Jekyll site.
+test_files: []