search

yoyodesign / fingerprint

A simple class for handling cache busting on static files (.Net)
MIT License
1 stars 0 forks source link

readme

Build status NuGet release

Yoyo.Fingerprint

A simple html extension method for handling cache busting on static files (.Net)

It can be used for static files that often require cache busting, such as css and javascript.

It works by taking a hash of the file requested, and using that to change the url, which in turn forces the file to be requested again. The hash is also cached and updated when the file is updated, meaning it won't waste memory.

Requirements

The following code in the web.Config

<system.webServer>
  <rewrite>
    <rules>
      <rule name="Yoyo.Fingerprint">
        <match url="([\S]+)(/v-[a-z0-9]+/)([\S]+)" />
        <action type="Rewrite" url="{R:1}/{R:3}" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

Installation

NuGet package repository

To install from NuGet, you can run the following command from within Visual Studio:

PM> Install-Package Yoyo.Fingerprint

How to use it

<link href="https://github.com/yoyodesign/fingerprint/blob/master/@Fingerprint.Tag("/css/style.css")" rel="stylesheet" />

// creates

<link href="https://github.com/yoyodesign/fingerprint/blob/master/css/v-7f2a5d53fbc1758441013d2edbe5ec36/style.css" rel="stylesheet" />