stars/github__ahernot__tag-indexer
2
0
Fork 0
mirror of https://github.com/ahernot/tag-indexer.git synced 2026-06-21 00:11:15 -06:00
Code Issues Projects Releases Packages Wiki Activity
macOS platform-specific utility to permanently alias files according to their tags
246 commits 1 branch 6 tags 244 KiB
  • Python 100%
Find a file
Exact
ahernot ae0010e059 Update README.md
2021-04-28 17:09:10 +02:00
_legacy Create .pytags-dirtype 2021-04-26 20:27:48 +02:00
_samples add sample beacons 2021-04-28 17:02:14 +02:00
.gitignore Update .gitignore 2021-04-26 13:11:42 +02:00
aliaser.py Update aliaser.py 2021-04-27 13:19:04 +02:00
cleaner.py change BEACON_NAME to BEACON_FILENAME 2021-04-27 13:52:51 +02:00
coordinator.py Update coordinator.py 2021-04-27 13:51:10 +02:00
file_analysis.py update formatting 2021-04-27 13:11:47 +02:00
functions.py add docstring 2021-04-27 14:10:25 +02:00
indexer.py add docstrings 2021-04-27 14:14:14 +02:00
LICENSE.txt Create LICENSE.txt 2021-04-24 16:53:45 +02:00
logger.py add reset on save 2021-04-27 14:11:35 +02:00
main.py Update main.py 2021-04-27 14:24:13 +02:00
parser.py add unknown dir exception 2021-04-28 17:02:52 +02:00
preferences.py Update preferences.py 2021-04-27 14:21:27 +02:00
README.md Update README.md 2021-04-28 17:09:10 +02:00
requirements.txt Create requirements.txt 2021-04-24 17:23:30 +02:00
tag_processer.py Update tag_processer.py 2021-04-27 14:16:46 +02:00

README.md

tag-indexer v2.0.2

Creative Commons Licence
This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.


This is a macOS platform-specific program designed to permanently alias (using the Unix aliasing method) files according to their tags. Recursive parsing and linear algorithm (v1.0.0 was full recursive).


To do

  • v2.0.3: Add progress indicator and milestone cues ("Done parsing", …)
  • v2.0.3: Add implementation of '.pytags-skipdir' beacon to skip parsing a directory
  • v2.0.3: Add runtime deltatime calculation and logging in log.txt
  • v2.0.3: Add instructions of use
  • v2.0.3: Add folder reading option in main.py which reads yearmonth from folder hierarchy and adds it in alias_dirpath_rel: generate_alias_relpath()
  • v2.0.3: Implement cleaner.clean_dir function
  • v2.1: Add an option to modify the aliases' file creation datetimes to match their liked files', in tag_processer.add_aliases
  • v2.2: hard-store +ALIAS and -ALIAS >> on startup, rundown this task list first to avoid missing tags in case of crash
  • v2.2: Add naming the file according to datetime: add a .pysorter-datetime file which acts as a datetime beacon for the current folder
  • v2.3: Add an alias SQL database to save the paths to (equivalent to the alias file system), and add file hyperlink generation for a query

Working principle

  • Retrieving tags to process from the tags database
  • Running through the directories to decipher changes
  • Change will be compared with the contents of the '.pytags_tags' hidden file
  • Only files' tags will be accounted for by the program



Instructions

  • To be continued

  • To display hidden files (macOS): type defaults write com.apple.finder AppleShowAllFiles YES in the macOS Terminal app

  • Never manually add or delete alias files

  • Use cleaner.remove_beacons function to remove all the beacon files from a directory and its subdirectories

Beacons

.pytags-beacon: references all files in a directory, with their tags. JSON format
.pytags-skipdir: (NOT IMPLEMENTED) skip parsing of a directory and its subdirectories