grantjenks/python-diskcache

No problems traced to this repository code in these checks.

Reviewed as expected for a test run: attempted writes that failed, so nothing was written.

OSV scanned supported lockfiles; unpinned dependencies and unsupported formats are outside this check.

A short run cannot establish that code is safe.

Connections show IP addresses; proxies can hide the final hostname.

Tracing covers dispatched commands and their children, not the whole OS; guest root can interfere with tracing.

Full safety evidence →

• DiskCache supports multiple eviction policies including LFU: Real input produced the expected result: Timings for least-frequently-used

  Source: Supports multiple eviction policies (LRU and LFU included)

  Input: stress_test_core run with -v least-frequently-used

  Expected: stress run reports least-frequently-used timings

  Command: <guest-path> -m tests.stress_test_core -n 2000 -k 10 -s 1 -v least-frequently-used

  Observed: Timings for least-frequently-used ------------------------------------------------------------------------------- Action Count Miss Median P90 P99 Max Total ========= ========= ========= ========= ========= ========= ========= ========= get 1962 0 1.061ms 1.175ms 1.968ms 10.981ms 2.178s set 26 0 2.103ms 3.708ms 5.404ms 11.168ms 67.870ms delete 1 0 2.408ms 2.408ms 2.408ms 2.408ms 2.408ms Total 1989 2.249s ======

Examples

• Test suite runs and passes (tox py env equivalent: pytest with tests.settings): command completed successfully

  Source: tox.ini [testenv] commands=pytest

  Input: pytest in checkout with DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=checkout

  Expected: all tests pass

  Command: <guest-path> -q -p no:cacheprovider

  Observed: 9->456, 670-673, 1190->1192, 1202->1204, 1876->1879, 2439, 2446-2449 diskcache/djangocache.py 99 0 10 1 99% 437->447 diskcache/fanout.py 220 0 16 0 100% diskcache/persistent.py 312 0 72 2 99% 33->36, 174->182 diskcache/recipes.py 172 0 18 0 100% ---------------------------------------------------------------------- TOTAL 1744 9 438 13 99% Required test coverage of 98% reached. Total coverage: 98.81% 251 passed, 3 warnings, 12 subtests passed in 162.12s (0:02:42)

• Stress test runs documented operations: command completed successfully

  Source: docs/development.rst Stress testing

  Input: -n 2000 -k 10 -s 1

  Expected: timings table printed

  Command: <guest-path> -m tests.stress_test_core -n 2000 -k 10 -s 1

  Observed: -- Action Count Miss Median P90 P99 Max Total ========= ========= ========= ========= ========= ========= ========= ========= get 1962 0 264.168us 293.016us 1.038ms 1.369ms 558.519ms set 26 0 1.663ms 2.619ms 3.614ms 4.998ms 48.087ms delete 1 0 2.260ms 2.260ms 2.260ms 2.260ms 2.260ms Total 1989 608.866ms ========= ========= ========= ========= ========= ========= ========= ========= Total wall clock time: 0.870 seconds

Local or hosted: local

Use diskcache (pure-Python disk-backed cache) from the pinned checkout: run the documented test suite and the documented stress script that performs cache get/set/delete, including the LFU eviction policy promised in the README.

cd <guest-path> && pwd && ls -la && git status 2>&1 | head -3; id -u; python3 --version; cat README.md 2>/dev/null | head -150
ls /inputs 2>/dev/null; ls <guest-path>; curl -s -m 10 -i $CDP_URL/json/version; echo "exit=$?"
cd <guest-path> && sed -n 1,200p README.rst
cd <guest-path> && cat requirements-dev.txt requirements.txt tox.ini | head -80; ls .coldpass tests; cat .coldpass/* 2>/dev/null | head -20
cd <guest-path> && grep -n "python_requires\|version" setup.py | head; grep -n "Cache('\|>>> \|\.set(\|\.get(" README.rst | head -40; sed -n 200,400p README.rst | grep -n "pip\|test\|pytest" | head
cd /tmp && (python3 -m venv <guest-path> 2>&1 || (sudo -n apt-get -o DPkg::Lock::Timeout=300 install -y python3-venv >/tmp/apt.log 2>&1 && python3 -m venv <guest-path>)); <guest-path> --version && <guest-path> --version
cd /tmp && <guest-path> install <guest-path> 2>&1 | tail -5; <guest-path> -c "import diskcache,sys;print(diskcache.__version__, diskcache.__file__)"
cd <guest-path> && grep -n "entry_points\|console" setup.py; ls diskcache; ls docs | head -30; sed -n 1,30p tests/test_core.py | head -30
cd <guest-path> && cat diskcache/cli.py | head -60; grep -rn "cli\|command line\|python -m" docs/*.rst README.rst | head
cd <guest-path> && sed -n 1,60p docs/development.rst; grep -n "pytest\|python -m" docs/development.rst; cat .github/workflows/*.yml | grep -n "run:" | head -20
cd <guest-path> && sed -n 60,200p docs/development.rst
cd /tmp && <guest-path> install "django==4.2.*" pytest pytest-cov pytest-django pytest-xdist 2>&1 | tail -2
cd <guest-path> && DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=<guest-path> timeout 900 <guest-path> -q -p no:cacheprovider 2>&1 | tail -15; echo "exit=${PIPESTATUS[0]}"
mkdir -p <guest-path> && cd <guest-path> && timeout 600 <guest-path> -m tests.stress_test_core -n 2000 -k 10 -s 1 2>&1 | tail -15; echo "exit=${PIPESTATUS[0]}"
cd <guest-path> && grep -n "'least-frequently-used'\|least-recently-used'" diskcache/core.py | head -4; grep -n "eviction_policy\|Directory\|dc.Cache(" tests/stress_test_core.py | head -20; ls -la tests | head -3; git check-ignore -v tmp 2>/dev/null; ls -d tmp* 2>/dev/null
cd <guest-path> && timeout 600 <guest-path> -m tests.stress_test_core -n 2000 -k 10 -s 1 -v least-frequently-used 2>&1 | tail -10; echo "exit=${PIPESTATUS[0]}"; ls -d tmp 2>/dev/null; echo done
cd <guest-path> && timeout 600 <guest-path> -m tests.stress_test_core -n 200 -k 10 -s 1 -v least-frequently-used 2>&1 | grep "Timings for"; grep -rniE "cron|webhook|schedul|--once|--now" diskcache/ README.rst | head -5; echo scan-done
cd <guest-path> && cat > claims.json <<'EOF'
[{"kind":"claim","claim":"DiskCache supports multiple eviction policies including LFU","source":"Supports multiple eviction policies (LRU and LFU included)","input":"stress_test_core run with -v least-frequently-used","expected":"stress run reports least-frequently-used timings","probe_kind":"cli","argv":["<guest-path>","-m","tests.stress_test_core","-n","2000","-k","10","-s","1","-v","least-frequently-used"],"expected_text":"Timings for least-frequently-used","cwd":"<guest-path>"}]
EOF
cat > probe.json <<'EOF'
{"kind":"cli","argv":["<guest-path>","-m","tests.stress_test_core","-n","2000","-k","10","-s","1","-v","least-frequently-used"],"cwd":"<guest-path>","expected_text":"Timings for least-frequently-used"}
EOF
cat > examples.json <<'EOF'
[{"kind":"example","claim":"Test suite runs and passes (tox py env equivalent: pytest with tests.settings)","source":"tox.ini [testenv] commands=pytest","input":"pytest in checkout with DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=checkout","expected":"all tests pass","argv":["<guest-path>","-q","-p","no:cacheprovider"],"cwd":"<guest-path>","env":{"DJANGO_SETTINGS_MODULE":"tests.settings","PYTHONPATH":"<guest-path>"},"expected_text":"251 passed"},{"kind":"example","claim":"Stress test runs documented operations","source":"docs/development.rst Stress testing","input":"-n 2000 -k 10 -s 1","expected":"timings table printed","argv":["<guest-path>","-m","tests.stress_test_core","-n","2000","-k","10","-s","1"],"cwd":"<guest-path>","expected_text":"Timings for least-recently-stored"}]
EOF
cat > cycles.json <<'EOF'
{"detected":false,"reason":"Entry points inspected (diskcache/*.py, diskcache/cli.py is docstring-only, setup.py has no entry_points, README). DiskCache is a Python library with no scheduler, cron, loop, webhook or --once/--now trigger; it runs only when a caller uses the Cache API.","checks":[]}
EOF
for f in claims probe examples cycles; do <guest-path> -I -c "import json,sys;json.load(open('$f.json'));print('$f ok')" ; done
cd /tmp && <env-var>=<guest-path> timeout 1500 python3 -I <guest-path> --validate --replay 2>&1 | tail -60; echo "exit=${PIPESTATUS[0]}"
cd <guest-path> && sed -i 's/"cwd":"<guest-path>"}\]/"cwd":"<guest-path>","source_file":"README.rst"}]/' claims.json && cat claims.json && <guest-path> -I -c "import json;json.load(open('claims.json'));print('ok')" && cd /tmp && <env-var>=<guest-path> timeout 1500 python3 -I <guest-path> --validate --replay 2>&1 | tail -60; echo "exit=${PIPESTATUS[0]}"
cd <guest-path> && cat > report.json <<'EOF'
{"outcome":"working","fault_owner":null,"operation":"Use diskcache (pure-Python disk-backed cache) from the pinned checkout: run the documented test suite and the documented stress script that performs cache get/set/delete, including the LFU eviction policy promised in the README.","operation_scope":"Linux guest, Python 3.12.3 in venv <guest-path>; pip install of the checkout (diskcache 5.6.3); test deps django==4.2.* pytest pytest-cov pytest-django pytest-xdist per tox.ini. No browser, network service, or credentials needed.","steps":["pip install <guest-path> (README: pip install diskcache, from pinned checkout)","pip install django==4.2.* pytest pytest-cov pytest-django pytest-xdist (tox.ini testenv deps)","DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=workspace pytest (tox.ini commands=pytest): 251 passed, 3 warnings","python -m tests.stress_test_core -n 2000 -k 10 -s 1 (docs/development.rst stress testing): timings table printed, exit 0","python -m tests.stress_test_core ... -v least-frequently-used: prints 'Timings for least-frequently-used', exit 0","checker --validate --replay: valid=true, claim replayed PASS"],"deviations":["README is README.rst, not README.md; claim includes source_file README.rst so checker reads it.","diskcache ships no command-line interface for get/set (diskcache/cli.py is docstring-only; docs list CLI as a future contribution). Probe therefore drives the documented stress_test_core module, which exercises the cache API.","Python 3.12.3 used; README/tox list 3.6-3.11, setup.py python_requires>=3. Works in practice.","Test deps installed with pip directly rather than tox (tox not installed); same commands and deps as tox.ini [testenv].","Browser CDP endpoint was checked (HTTP 200) but not needed; library has no browser operation."],"stuck_step":null,"main_blocker":null,"plain_failure":null,"suggested_fix":"None required. Optional: add a CLI for get/set/delete as listed in docs/development.rst to allow direct CLI probes."}
EOF
<guest-path> -I -c "import json;json.load(open('report.json'));print('report ok')"; cd <guest-path> && ls -a; ls -d *.egg-info build 2>/dev/null; echo checked
cd <guest-path> && rm -rf build diskcache.egg-info .coverage .cache && cd /tmp && <env-var>=<guest-path> timeout 1500 python3 -I <guest-path> --validate --replay 2>&1 | python3 -c "import json,sys; d=json.load(sys.stdin); print(d['valid'], d['problems'], d['replay']['status'])"; cd <guest-path> && ls -a | tr '\n' ' '