Skip to main content

Latest release 20191201: New "edit" subcommand to rename files and edit tags.

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 20191201: New "edit" subcommand to rename files and edit tags.

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

Metadata

Release files for cs-fstags 20191201

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 20191201
File Size Uploaded Provenance Actions
cs.fstags-20191201.tar.gz 9.2 kB Without provenance Details for cs.fstags-20191201.tar.gz

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

Download URL cs.fstags-20191201.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
4e7d93f1cd7eed6abdb3fb0a7cc2cdd63e0638e230c91c1c63eee597e0fee44c
BLAKE2b-256 checksum
How to use checksums
232e837f6f6f6adf5aae7a91c33e759b5ae5c21e87e50c159a4ed13d6192ab1f
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

Security for cs-fstags 20191201

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

20191201 This release

1 release file No provenance

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