🤖 Repository layout updated to latest version

This commit was automatically generated by a script: https://gitfub.space/Jmaa/repo-manager

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Jon Michael Aanes
+Copyright (c) 2024-2025 Jon Michael Aanes
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -17,9 +17,14 @@ your organization's payment plan.
 
 Uses [`python-fuse`](https://github.com/libfuse/python-fuse) library.
 
+## Features
+
+The feature set is mainly aimed towards giving a better writing experience in
+Favro. Management and organization features have been left out.
+
 Features:
 
-- Local access to cards in todolist.
+- Access collections and cards in a file hierarchy.
 - Read card features:
   - Title
   - Description
@@ -37,10 +42,10 @@ Features:
 
 Limitations:
 
-- Only cards in todolist is fetched at the moment.
 - Tasks (checklists on cards) cannot be updated or changed.
 - Images cannot be updated or changed.
 - You cannot create new cards, nor any other files.
+- Collection order is not presented.
 
 ## Usage
 
@@ -51,6 +56,36 @@ Limitations:
    [`python-fuse`](https://github.com/libfuse/python-fuse) implements a whole
    bunch automatically.)
 
+Use `umount` to unmount the mounted directory again.
+
+### Directory structure and latency
+
+Directory structure is something like:
+
+```
+mount
+ -> Collection A
+     -> CARD-101
+     -> CARD-111
+     -> ...
+ -> Collection B
+     -> CARD-201
+     -> CARD-221
+     -> ...
+ -> ...
+```
+
+Some programs like Obsidian eagerly load and cache unneeded files in memory,
+which can reduce performance when those files are fetched over a network. You
+can limit this by configuring favro-sync to only expose individual collections
+by adding a `FAVRO_COLLECTION_FILTER` secret containing allowed collection
+names, like so:
+
+```
+Collection A
+Collection B
+```
+
 ## Architecture
 
 - `FavroFuse`
@@ -70,12 +105,12 @@ Following features are work in progress:
     3. Remove all TaskList's except for the latest (how to determine latest?)
     4. That's three requests just to save a freaking list of tasks!
 - [ ] Frontmatter: Writable Dependencies.
-- [ ] Usability: Richer directory structure
 - [ ] Usability: Allow users to toggle Obsidian mode, instead of being default.
 - [ ] Precision: Get the correct last-modified date.
 - [ ] Performance: Improve cache behaviour. User and tags can have much longer cache times.
 - [ ] Performance: Parallelize requests.
     * Paginated pages can be easily parallelize.
+- [X] Usability: Richer directory structure
 - [X] Frontmatter: Arbitrary structured data (Custom Fields)? Read-only.
 - [X] Frontmatter: Readable Dependencies. As vault links in Obsidian mode.
 
@@ -102,7 +137,7 @@ Full list of requirements:
 ```
 MIT License
 
-Copyright (c) 2024 Jon Michael Aanes
+Copyright (c) 2024-2025 Jon Michael Aanes
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

setup.py

@@ -22,9 +22,14 @@ your organization's payment plan.
 
 Uses [`python-fuse`](https://github.com/libfuse/python-fuse) library.
 
+## Features
+
+The feature set is mainly aimed towards giving a better writing experience in
+Favro. Management and organization features have been left out.
+
 Features:
 
-- Local access to cards in todolist.
+- Access collections and cards in a file hierarchy.
 - Read card features:
   - Title
   - Description
@@ -42,10 +47,10 @@ Features:
 
 Limitations:
 
-- Only cards in todolist is fetched at the moment.
 - Tasks (checklists on cards) cannot be updated or changed.
 - Images cannot be updated or changed.
 - You cannot create new cards, nor any other files.
+- Collection order is not presented.
 
 ## Usage
 
@@ -56,6 +61,36 @@ Limitations:
    [`python-fuse`](https://github.com/libfuse/python-fuse) implements a whole
    bunch automatically.)
 
+Use `umount` to unmount the mounted directory again.
+
+### Directory structure and latency
+
+Directory structure is something like:
+
+```
+mount
+ -> Collection A
+     -> CARD-101
+     -> CARD-111
+     -> ...
+ -> Collection B
+     -> CARD-201
+     -> CARD-221
+     -> ...
+ -> ...
+```
+
+Some programs like Obsidian eagerly load and cache unneeded files in memory,
+which can reduce performance when those files are fetched over a network. You
+can limit this by configuring favro-sync to only expose individual collections
+by adding a `FAVRO_COLLECTION_FILTER` secret containing allowed collection
+names, like so:
+
+```
+Collection A
+Collection B
+```
+
 ## Architecture
 
 - `FavroFuse`
@@ -75,12 +110,12 @@ Following features are work in progress:
     3. Remove all TaskList's except for the latest (how to determine latest?)
     4. That's three requests just to save a freaking list of tasks!
 - [ ] Frontmatter: Writable Dependencies.
-- [ ] Usability: Richer directory structure
 - [ ] Usability: Allow users to toggle Obsidian mode, instead of being default.
 - [ ] Precision: Get the correct last-modified date.
 - [ ] Performance: Improve cache behaviour. User and tags can have much longer cache times.
 - [ ] Performance: Parallelize requests.
     * Paginated pages can be easily parallelize.
+- [X] Usability: Richer directory structure
 - [X] Frontmatter: Arbitrary structured data (Custom Fields)? Read-only.
 - [X] Frontmatter: Readable Dependencies. As vault links in Obsidian mode.
 """.strip()