smallsolar
/
libkiwix
mirror of https://github.com/kiwix/libkiwix.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix: testlog based cacheid retrieval

This commit is contained in:
Emmanuel Engelhart 2022-09-14 15:54:25 +02:00
parent ee3514d2d6
commit 5130bf9774
No known key found for this signature in database
GPG Key ID: 120B30D020B553D3
1 changed files with 13 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -113,16 +113,20 @@ compiled by custom Python code available in this repository `scripts`
directory. This happens automatically at compilation time without any directory. This happens automatically at compilation time without any
additional command to run. additional command to run.
To avoid HTTP caching issue, the URLs (to the static content) are To avoid HTTP caching issues, the URLs (to the static content) are
appended with a `cacheid` parameter (this is called "cache appended with a `cacheid` parameter (this is called "cache
busting"). This `cacheid` value derived from the SHA1SUM of each busting"). This `cacheid` value derived from the
targeted static file. As a consequence, each time you change a static [sha1sum](https://en.wikipedia.org/wiki/Sha1sum) of each targeted
file, the corresponding `cacheid` value will change. To properly test static file. As a consequence, each time you change a static file, the
this feature, this `cacheid` needs to be added manually to the corresponding `cacheid` value will change.
automated test and has to be commited. To know what are the expected
`cacheid` values, you can build once the libkiwix and then run `grep To properly test this feature, this `cacheid` needs to be added
-r cacheid build/static/`. Finally update `test/server.cpp` with the manually to the automated tests and has to be commited. After
appropriate `cacheid` values which have changed. modifying the needed static file, [run the automated
tests](#Testing). They will fail, but the inspection of the testing
log will give you the new `cacheid` value(s). Finally update
`test/server.cpp` with the appropriate `cacheid` value(s) which have
changed.
Testing Testing
------- -------