Skip to main content

Latest release 20191130.1: Initial release: fstags, filesystem based tagging utility.

Simple filesystem based file tagging.

Tags are stored in a file .fstags in directories with a line for each entry in the directory consisting of the directory entry name and the associated tags.

The tags for a file are the union of its direct tags and all relevant ancestor tags, with priority given to tags closer to the file.

For example, a media file for a television episode with the pathname /path/to/series-name/season-02/episode-name--s02e03--something.mp4 might obtain the tags:

series.title="Series Full Name"
season=2
sf
episode=3
episode.title="Full Episode Title"

from the following .fstags files and entries:

  • /path/to/.fstags: series-name sf series.title="Series Full Name"
  • /path/to/series-name/.fstags: season-02 season=2
  • /path/to/series-name/season-02.fstags: episode-name--s02e03--something.mp4 episode=3 episode.title="Full Episode Title"

Tags may be "bare", or have a value. If there is a value it is expressed with an equals ('=') followed by the JSON encoding of the value.

Class FSTagCommand

MRO: cs.cmdutils.BaseCommand
fstag main command line class.

Class FSTags

A class to examine filesystem tags.

Function loadrc(rcfilepath)

Read rc file, return rules.

Function main(argv=None)

Command line mode.

Class PathTags

Class to manipulate the tags for a specific path.

Class RegexpTagRule

A regular expression based Tag rule.

Function rfilepaths(path)

Generator yielding pathnames of files found under path.

Class Tag

A Tag has a .name (str) and a .value.

The name must be a dotted identifier.

A "bare" Tag has a value of None.

Class TagFile

A reference to a specific file containing tags.

Release Log

Release 20191130.1: Initial release: fstags, filesystem based tagging utility.

Release files for cs-fstags 20191130.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cs-fstags 20191130.1
File Size Uploaded
cs.fstags-20191130.1.tar.gz 8.4 kB Details

Release files / cs.fstags-20191130.1.tar.gz

Download URL cs.fstags-20191130.1.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
bdc1f76e82043695fe893096363ca50f3e8ab4de3c66fb4b38e4a0a7cc373a70
BLAKE2b-256 checksum
How to use checksums
a9636e1d54cd9299b653dea1ec9b036edd2d5bc3c9cfb6df2b8d5839eaf44213
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.4
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page