petercorke / petercorke/machinevision-toolbox-python

Repo root is full of untracked scratch/junk files

Aperta
#45 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

tech-debt
Lingua principale
Python
Stelle
220
Fork
30
Merge medio
12g 23h
PR unite (30g)
5

Descrizione

Observed 2026-07-29, pre-existing (not from any one session's work). git status on the
opencv5 working branch shows ~50 untracked files/dirs at the repo root and scattered through
src/, docs/, examples/, tests/, e.g.: stray scratch scripts (findimages.py,
phone.py, sunday.py, readbag.py, fmtparser.py, audit_typing.py, inspect_bag.py,
src/machinevisiontoolbox/cvfuncs.py, docbugs.py, newcameras.py, test_skimage.py,
testblobplots.py), planning notes (CODEAUTOLINK_FORK_PLAN.md, MIGRATION.md, NOTES,
OPENCV_FUNCTIONS.md/OPENCV_FUNCTIONS-original.md, plot_call_inventory.md), build
artifacts (machinevision-toolbox-python.pdf/.svg, machinevisiontoolbox.pdf,
aruco0.pdf, aruco50.pdf), stray media/data (flowers.jpg, xx.mp4, ss, bags/,
examples/bus.jpg, examples/street_scene.jpg, examples/yolo26n.pt,
packages/mvtb-data/mvtbdata/data/bunny.dat, .../images/tags.png), old Sphinx warning-log
captures (docs/warnings*.txt), and a couple of loose x.json files.

One item worth checking rather than just sweeping up: release-please-config.json is
untracked despite release-please.yml requiring it (config-file: release-please-config.json) — if that's really never been committed, release-please may
only be working by accident (whatever's on disk locally) and would break for anyone else's
checkout / a fresh CI runner. Worth confirming before cleanup, not after.

Fix

Triage into: (a) delete outright (build artifacts, one-off scratch scripts that are clearly
done), (b) commit properly if still wanted (release-please-config.json almost certainly
belongs in git), (c) move to .gitignore if it's a recurring local-only output (e.g. the
docs/warnings*.txt capture files, if that workflow continues). Don't bulk git clean -xdf
without a human eyeballing the list first — some of this may be in-progress work, not junk.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia esaminando l’elenco di git status e i file temporanei, le note, gli artefatti, i contenuti multimediali e i log degli avvisi indicati, senza eseguire una pulizia globale. Verifica release-please.yml rispetto al file non tracciato release-please-config.json, quindi classifica gli elementi per l’eliminazione, il commit o .gitignore. Il lavoro è completo quando il lavoro previsto è preservato, gli output locali ricorrenti sono gestiti e la configurazione di release funziona da un checkout pulito.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
git, github-actions, python
Ambito
build-system, release, tooling
Tipo di issue
Refactoring
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
52/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.