Skip to content
This repository has been archived by the owner on Nov 3, 2020. It is now read-only.

ezekg/sass-prof

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

98 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sass Prof

Gem

Sass Prof

Sass Prof is a code profiler for Sass. For each @function, @mixin, @include and $variable, Sass Prof will show its execution time, which file called it and what arguments were given when it was called. Currently, @extend is not supported but it is a planned feature.

Requirements

  • Sass ~> 3.4.0

Installation

  1. Install with gem install sass-prof
  2. If you're using Compass, add require "sass-prof" to your config.rb
  3. Sass Prof will automatically run next time you compile
  4. That's it!

Uninstall

  1. Remove the line require "sass-prof" from your config.rb

Usage

You may specify a few options within your config.rb, such as ignoring certain actions or directing output to a log file.

require "sass-prof"

# Configuration object
prof = SassProf::Config

# Directs all output to a log file
# Default is `false`
prof.output_file = "sass-prof.log"

# Adjust max column width
# Default is `false`
prof.max_width = 40

# Mutes all output to stdout
# Default is `false`
prof.quiet = true

# Maximum execution time allowed in ms
# Default is `100`
prof.t_max = 500

# Alias for `t_max`
prof.max_execution_time = 15

# Enable colored output
# Default is `true`
prof.color = true

# Execution time floating point precision
# Default is `15`
prof.precision = 5

# Ignore certain action types during profile
# Default is `[]`
prof.ignore = [
  :fundef,
  :fun,
  :mixdef,
  :mix,
  :var,
]

# Alias for `ignore`
prof.ignore_actions = []

Please note: your compile times will be slower due to the overhead of Sass Prof, but I've tried to be as accurate as possible in the measurements. This library was created to help you find potential bottlenecks within your code, so I hope it succeeds in that regard. If you find any bugs or inconsistencies, please file an issue or pull request.

Contributing

  1. Fork it ( https://github.com/ezekg/sass-prof/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

About

A code profiler for Sass libraries

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published