Menu

Tree [bd8a2b] main /
 History

HTTPS access


File Date Author Commit
 debian 2026-07-01 Reaper Reaper [13b563] debian: declare Python test build dependency
 extensions 2026-07-01 Reaper Reaper [c14f8a] extension: add Nautilus Nemo and Caja provider
 icons 2026-07-01 Reaper Reaper [684efc] icons: add Subversion status emblem set
 src 2026-07-01 Reaper Reaper [32f9eb] core: add Subversion status parser and mapper
 tests 2026-07-01 Reaper Reaper [a10a06] tests: cover SVN status parsing and mapping
 tools 2026-07-01 Reaper Reaper [1443f7] tools: add local SVN fixture helpers
 .gitignore 2026-07-01 Reaper Reaper [a10a06] tests: cover SVN status parsing and mapping
 AUTHORS 2026-07-01 Reaper Reaper [7388c3] docs: initialize project metadata
 LICENSE 2026-07-01 Reaper Reaper [7388c3] docs: initialize project metadata
 PROJECT_STATUS.md 2026-07-01 Reaper Reaper [bd8a2b] docs: document validation status and next steps
 README.md 2026-07-01 Reaper Reaper [1443f7] tools: add local SVN fixture helpers

Read Me

svn-filemanager-icons

svn-filemanager-icons is a lightweight Python extension that overlays
Subversion working-copy status emblems in Linux file managers.

It is intentionally modeled after git-nautilus-icons, but for SVN working
copies and with Debian/Ubuntu package splits for:

  • Nemo
  • Caja
  • Nautilus

The project is deliberately not a TortoiseSVN/RabbitVCS-style graphical
frontend. It does not add commit/update/revert menus or dialogs. It only adds
visual status clues.

Runtime model

The extension uses the Subversion command-line client:

  • svn status --xml --verbose
  • local working-copy metadata only by default
  • no Python SVN bindings
  • no RabbitVCS dependency

The status work is done in a helper process so file-manager UI code does not
block while SVN status is computed.

Emblems

The initial icon vocabulary is intentionally small:

  • svn-repo
  • svn-clean
  • svn-modified
  • svn-added
  • svn-deleted
  • svn-conflicted
  • svn-unversioned
  • svn-ignored
  • svn-external
  • svn-locked
  • svn-error

Debian package split

The intended binary package layout is:

  • svn-filemanager-icons-common
  • nemo-svn-filemanager-icons
  • caja-svn-filemanager-icons
  • nautilus-svn-filemanager-icons

The file-manager packages depend on subversion and the common icon/core
package.

Credits and license

The project uses the BSD 2-Clause license, matching git-nautilus-icons.

Original git-nautilus-icons concept and architecture:
Chris Billington.

SVN adaptation and Debian packaging:
Reaper JohnGrimmReaper@disroot.org.

Developer test helpers

Run parser/unit tests without a desktop session:

python3 -m unittest discover -s tests -v

Create an offline SVN working-copy fixture on a machine with subversion
installed:

tools/create-local-svn-fixture.sh

Inspect computed emblem names from the command line:

tools/inspect-status.py /path/to/working-copy