Brunobkr/llama.cpp_AlgMor24_github

1# fresh2 3[![NPM Version][npm-image]][npm-url]4[![NPM Downloads][downloads-image]][downloads-url]5[![Node.js Version][node-version-image]][node-version-url]6[![Build Status][ci-image]][ci-url]7[![Test Coverage][coveralls-image]][coveralls-url]8 9HTTP response freshness testing10 11## Installation12 13This is a [Node.js](https://nodejs.org/en/) module available through the14[npm registry](https://www.npmjs.com/). Installation is done using the15[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):16 17```18$ npm install fresh19```20 21## API22 23```js24var fresh = require('fresh')25```26 27### fresh(reqHeaders, resHeaders)28 29Check freshness of the response using request and response headers.30 31When the response is still "fresh" in the client's cache `true` is32returned, otherwise `false` is returned to indicate that the client33cache is now stale and the full response should be sent.34 35When a client sends the `Cache-Control: no-cache` request header to36indicate an end-to-end reload request, this module will return `false`37to make handling these requests transparent.38 39## Known Issues40 41This module is designed to only follow the HTTP specifications, not42to work-around all kinda of client bugs (especially since this module43typically does not receive enough information to understand what the44client actually is).45 46There is a known issue that in certain versions of Safari, Safari47will incorrectly make a request that allows this module to validate48freshness of the resource even when Safari does not have a49representation of the resource in the cache. The module50[jumanji](https://www.npmjs.com/package/jumanji) can be used in51an Express application to work-around this issue and also provides52links to further reading on this Safari bug.53 54## Example55 56### API usage57 58<!-- eslint-disable no-redeclare -->59 60```js61var reqHeaders = { 'if-none-match': '"foo"' }62var resHeaders = { etag: '"bar"' }63fresh(reqHeaders, resHeaders)64// => false65 66var reqHeaders = { 'if-none-match': '"foo"' }67var resHeaders = { etag: '"foo"' }68fresh(reqHeaders, resHeaders)69// => true70```71 72### Using with Node.js http server73 74```js75var fresh = require('fresh')76var http = require('http')77 78var server = http.createServer(function (req, res) {79  // perform server logic80  // ... including adding ETag / Last-Modified response headers81 82  if (isFresh(req, res)) {83    // client has a fresh copy of resource84    res.statusCode = 30485    res.end()86    return87  }88 89  // send the resource90  res.statusCode = 20091  res.end('hello, world!')92})93 94function isFresh (req, res) {95  return fresh(req.headers, {96    etag: res.getHeader('ETag'),97    'last-modified': res.getHeader('Last-Modified')98  })99}100 101server.listen(3000)102```103 104## License105 106[MIT](LICENSE)107 108[ci-image]: https://img.shields.io/github/workflow/status/jshttp/fresh/ci/master?label=ci109[ci-url]: https://github.com/jshttp/fresh/actions/workflows/ci.yml110[npm-image]: https://img.shields.io/npm/v/fresh.svg111[npm-url]: https://npmjs.org/package/fresh112[node-version-image]: https://img.shields.io/node/v/fresh.svg113[node-version-url]: https://nodejs.org/en/114[coveralls-image]: https://img.shields.io/coveralls/jshttp/fresh/master.svg115[coveralls-url]: https://coveralls.io/r/jshttp/fresh?branch=master116[downloads-image]: https://img.shields.io/npm/dm/fresh.svg117[downloads-url]: https://npmjs.org/package/fresh118