Maintenance script: StatLens wiki

2026-10-20T21:29:39Z

StatLens wiki

New page

Stat Lens adds one view to the Explorer, called '''Stat Lens'''. It is a tree with one row per figure. Some rows can be expanded. Expanded and collapsed sections stay as they are when the view is refreshed.

[[File:StatLens_Screenshot_01.png|475px|The Stat Lens view with the Languages section expanded]]

== Rows ==
The rows appear in this order. A row is left out when there is no value for it.

{| class="wikitable"
! Row !! Shows
|-
| ''Languages'' || Total lines of code and the number of languages, for example <code>162,687 lines · 9 languages</code>. Expand it to see each language.
|-
| ''Files'' || Number of files and folders that were scanned.
|-
| ''Size'' || Total size of all scanned files, in B, KB, MB, GB or TB (steps of 1024).
|-
| ''Largest File'' || The file with the most lines of code, with its path and line count. Click it to open the file.
|-
| ''Project Age'' || Date of the first commit, how long ago that was, and the source.
|-
| ''Last Change'' || Date of the last commit, how long ago that was, and the source.
|-
| ''Git'' || Number of commits. Expand it for more. See [[#Git|Git]].
|-
| ''Dependencies'' || Total number of dependencies in all manifest files. Expand it to see each file. See [[StatLens:Dependencies|Dependencies]].
|-
| ''Warnings'' || Only shown when the scan had problems. Expand it to see them. See [[#Warnings|Warnings]].
|-
| ''Last Scan'' || Date and time of the scan the view is showing.
|}

== Languages ==
Each language has its own row under ''Languages'', sorted by lines of code, the largest first. A row shows:
* a colored dot in the language color used by GitHub Linguist. Languages without such a color get one from a fixed palette, always the same for the same language.
* a text bar of ten blocks, for example <code>████░░░░░░</code>, as a quick visual of the share
* the share of all lines of code in percent, with one decimal
* the lines of code and the number of files in that language

The list includes programming languages and also markup, data and prose formats, for example HTML, JSON, YAML or Markdown. How lines are counted is explained on [[StatLens:Scanning|Scanning]].

== Project Age and Last Change ==
Both rows prefer Git:
{| class="wikitable"
! Row !! With Git !! Without Git
|-
| ''Project Age'' || date of the first commit (<code>source: first commit</code>) || oldest creation time of a scanned file (<code>source: oldest file</code>)
|-
| ''Last Change'' || date of the last commit (<code>source: last commit</code>) || newest modification time of a scanned file (<code>source: most recent file change</code>)
|}

The relative age is rounded down: <code>today</code>, then days, then months (30 days each), then years (365 days each).

== Git ==
Expand ''Git'' to see:
{| class="wikitable"
! Row !! Shows
|-
| ''Commits'' || Number of commits reachable from the current <code>HEAD</code>, so the history of the branch you have checked out.
|-
| ''Contributors'' || Number of different author e-mail addresses in that history. Upper and lower case are ignored.
|-
| ''First Commit'' || Date of the oldest commit. If the history has more than one root commit, the oldest one counts.
|-
| ''Last Commit'' || Date of the newest commit on <code>HEAD</code>.
|}

If the folder is not a Git repository, the ''Git'' row says <code>not a Git repository</code> and cannot be expanded. Other notes that can appear:
* <code>git is not installed or not in PATH</code>
* <code>no commits yet</code>, for a repository without commits
* <code>git log failed: ...</code>, if Git returned an error

Only the first folder of the workspace is used, so Git data comes from the repository that contains that folder.

== Warnings ==
''Warnings'' lists problems that did not stop the scan:
* <code>Folder not readable: ...</code>, for a folder the extension could not open. Its contents are skipped.
* <code>Language detection failed: ...</code>. In this case no lines of code are counted, but files, size, dates and dependencies are still shown.

If the whole scan fails, a row with <code>Scan failed: ...</code> and a warning icon appears at the top. An older result stays visible below it.

== Other states ==
{| class="wikitable"
! What you see !! Meaning
|-
| ''No data for this project yet.'' with a ''Scan now'' link || There is no result yet. Click ''Scan now'' to start a scan.
|-
| ''Scanning …'' with a spinning icon || A scan is running. The status bar shows the current step, for example <code>Counting lines … 120/497</code>.
|-
| <code>No files found</code> || The folder is empty or every file in it is excluded.
|-
| <code>No workspace folder open</code> || Open a folder to use the view.
|}

== Number and date format ==
Numbers, dates and times follow the display language of VS Code. With English, a number looks like <code>69,833</code> and a date like <code>Oct 16, 2026</code>.

{{StatLens Nav}}

StatLens:Sidebar View - Revision history

Maintenance script: StatLens wiki