fontawesome_subsetter 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3e81d744b974f18b95ce447ab7181caf0924389dc26cedaf7e9f179f27d7bfa
-  data.tar.gz: 628da1c3dfd1030e922c88b0160c1d218d69ba815b794018b613967a00fa10cb
+  metadata.gz: 33c3b2edc76b53a04844718df0b26cee93aed21d85db538f25f52fafe6453287
+  data.tar.gz: 963351cb3b73e82827ab710e27ceed76d3a4c034ef966025f6df386a13d6bb37
 SHA512:
-  metadata.gz: 52629f090b869d3ea5ca8eb4e8e1e847dc29668b7a3274dfc0497d3306faf632361c90878c94a0e40e71486823ec95e5d3eac513d4239fe6db78ec132b81ce35
-  data.tar.gz: a9f9b3ceb6c473d0ec9d0611ae23d44b3d35a9424bc13436349f4445ba66db918fbec318280ae0c7814a6b73d2ef0e1a39ec88d24995439e5589dcdc14ca5d19
+  metadata.gz: 0f503ad4e00f742e74a499341fde0cd4c837589ad95a57845f24a8a8723589ea44f7147d37df4179dbf3dc164badc382f84fb7fae3dddd0eeb40faa492ae4cdf
+  data.tar.gz: d4a51a28bd5bdd8a5c1499683def9dc88091a8bbd88b1668aa643e76fcdf318dcdde3216c3f67ebcb3a765d34d7d8aa371fe59008989cd288a0b9c937fdb2924

data/README.md

@@ -103,9 +103,40 @@ FontawesomeSubsetter.configure do | config |
 
   # Custom SCSS template (optional — receives @styles hash, must return SCSS string)
   # config.scss_template = ->(styles) { "..." }
+
+  # Additional SCSS variables to inject into the `@use "variables" with (...)` block.
+  # Keys may be symbols/strings (with or without leading `$`). Values are raw SCSS.
+  # config.variables = {
+  #   "fa-font-display" => "swap",
+  #   "fa-css-prefix"   => '"fa"'
+  # }
+
+  # Optional presentational FontAwesome SCSS partials to include. Defaults to `:all`.
+  # Available: "sizing", "widths", "list", "bordered", "animated", "rotated-flipped", "stacked"
+  # (Core partials — functions, mixins, core, icons — are always included.)
+  # config.features = ["animated"]
 end
 ```
 
+## Deploying with Kamal (Docker)
+
+`pyftsubset` must be available during `assets:precompile` in your Docker build stage. Add the following to the **build** stage of your Dockerfile:
+
+```dockerfile
+# In the build stage, install pyftsubset for font subsetting
+RUN apt-get update -qq && \
+    apt-get install --no-install-recommends -y python3 python3-pip python3-venv pipx && \
+    pipx ensurepath && \
+    pipx install fonttools && \
+    pipx inject fonttools brotli && \
+    ln -s /root/.local/bin/pyftsubset /usr/local/bin/pyftsubset && \
+    rm -rf /var/lib/apt/lists /var/cache/apt/archives
+```
+
+Font subsetting runs automatically during `assets:precompile`, so no additional Dockerfile steps are needed — just make sure the line above appears before your `RUN ... assets:precompile` step.
+
+The final (runtime) stage does **not** need `pyftsubset`; subsetted fonts are already baked into the image.
+
 ## License
 
 [MIT](LICENSE.txt) — Copyright (c) 2026

data/lib/fontawesome_subsetter/subsetter.rb

@@ -234,28 +234,32 @@ module FontawesomeSubsetter
     private
 
     def default_scss_template(styles)
-      <<-SCSS
+      extra_vars  = FontawesomeSubsetter.configuration.variables || {}
+      extra_lines = extra_vars.map { | name, value | "  #{ name.to_s.start_with?('$') ? name : "$#{ name }" }: #{ value }," }.join("\n")
 
+      icons       = @styles.except("brands").values.reduce(Set.new) { | all_icons, style | all_icons.merge(style[:sass_icon_cache]) }.join(", ")
+      brand_icons = @styles["brands"][:sass_icon_cache].to_a.join(", ")
+      style_uses  = styles.map { | s | "@use \"./vendor/fontawesome/scss/#{ s[:name] }.scss\";" }.join("\n")
+
+      features         = FontawesomeSubsetter.configuration.features
+      enabled_features = features == :all ? Configuration::AVAILABLE_FEATURES : Array(features).map(&:to_s)
+      feature_uses     = enabled_features.map { | f | "@use \"./vendor/fontawesome/scss/#{ f }\";" }.join("\n")
+
+      <<~SCSS
         // The custom importer strips populated $icons/$brand-icons maps from variables.scss in memory.
         @use "./vendor/fontawesome/scss/variables" with (
           $font-path: "webfonts",
-          $icons: (#{ @styles.except("brands").values.reduce(Set.new) { | all_icons, style | all_icons.merge(style[:sass_icon_cache]) }.join(", ") }),
-          $brand-icons: (#{ @styles["brands"][:sass_icon_cache].to_a.join(", ") }));
+        #{ extra_lines }
+          $icons: (#{ icons }),
+          $brand-icons: (#{ brand_icons }));
 
         @use "./vendor/fontawesome/scss/functions";
         @use "./vendor/fontawesome/scss/mixins";
         @use "./vendor/fontawesome/scss/core";
-        // @use "./vendor/fontawesome/scss/sizing";
-        // @use "./vendor/fontawesome/scss/widths";
-        // @use "./vendor/fontawesome/scss/list";
-        // @use "./vendor/fontawesome/scss/bordered";
-        @use "./vendor/fontawesome/scss/animated";
-        // @use "./vendor/fontawesome/scss/rotated-flipped";
-        // @use "./vendor/fontawesome/scss/stacked";
+        #{ feature_uses }
         @use "./vendor/fontawesome/scss/icons";
 
-        #{ styles.map { "@use \"./vendor/fontawesome/scss/#{ it[:name] }.scss\";" }.join("\n") }
-
+        #{ style_uses }
       SCSS
     end
 

data/lib/fontawesome_subsetter/version.rb

@@ -1,5 +1,5 @@
 module FontawesomeSubsetter
 
-  VERSION = "0.1.7"
+  VERSION = "0.1.9"
 
 end

data/lib/fontawesome_subsetter.rb

@@ -22,12 +22,19 @@ module FontawesomeSubsetter
   class Configuration
 
     attr_accessor :meta_path, :fonts_dir, :build_dir, :scan_globs, :watch_paths,
-                  :watch_file_type_regex, :icon_regex, :scss_template, :styles
+                  :watch_file_type_regex, :icon_regex, :scss_template, :styles,
+                  :variables, :features
+
+    # Optional presentational FontAwesome SCSS partials.
+    # Core partials (functions, mixins, core, icons) are always included.
+    AVAILABLE_FEATURES = ["sizing", "widths", "list", "bordered", "animated", "rotated-flipped", "stacked"].freeze
 
     def initialize
       @scan_globs = ["app/views/**/*.slim", "app/helpers/**/*.rb"]
       @watch_file_type_regex = /\.(slim|rb)$/
       @icon_regex = /icon\(\s*:(?<prefix>fas|far|fab|fad|fal|fat)\s*,\s*:(?<icon>[\w_\-]+)\b/
+      @variables = {}
+      @features = :all
     end
 
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fontawesome_subsetter
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - 16554289+optimuspwnius@users.noreply.github.com