| Name | bookup-fuse JSON |
| Version |
0.1.8
JSON |
| download |
| home_page | None |
| Summary | Mount Bookup .bdb (SQLite) files as a FUSE filesystem exposing Markdown pages. |
| upload_time | 2025-08-13 02:56:12 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT |
| keywords |
fuse
sqlite
filesystem
markdown
bookup
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
Hier ist ein Vorschlag für eine prägnante, aber informative `README.md` für dein Projekt:
````markdown
# bookup-fuse
**Mount Bookup `.bdb` (SQLite) databases as a virtual FUSE filesystem** — browse and edit your Bookup pages and sections directly as Markdown files.
## Features
- Mount a Bookup `.bdb` file into a directory
- Exposes two top-level folders:
- `Pages/` — all pages without section nesting
- `Sections/` — hierarchical structure of sections containing pages
- Read and edit Markdown content directly via any text editor
- Changes are written back to the `.bdb` database in real time
- Works with standard FUSE mounts on Linux
## Requirements
- **Python** ≥ 3.9
- **libfuse** installed on your system
Fedora / RHEL:
```bash
sudo dnf install fuse fuse3 fuse3-libs
````
Debian / Ubuntu:
```bash
sudo apt install fuse
```
* Python package **fusepy** (installed automatically with this package)
## Installation
```bash
pip install bookup-fuse
```
Or from source:
```bash
git clone https://github.com/beimgraben/bookup-fuse.git
cd bookup-fuse
pip install .
```
## Usage
```bash
bookup-fuse <bookup_bdb_file> <mount_point>
```
Example:
```bash
bookup-fuse my-notes.bdb /mnt/bookup
```
This will create a directory structure like:
```
/mnt/bookup
├── Pages
│ ├── Page One.md
│ └── Another Note.md
├── Sections
│ ├── Work
│ │ └── Task List.md
│ └── Personal
│ ├── Recipes.md
│ └── Journal.md
└── .desktop.ini
```
## Unmounting
```bash
fusermount -u /mnt/bookup # Linux (FUSE)
# or
umount /mnt/bookup
```
## Notes
* `.desktop.ini` is included for compatibility with Windows' folder tooltips but can be ignored.
* Page and section names containing `/` are automatically sanitized to `_` in file names.
* Timestamps are stored as UNIX epochs in the database.
## Development
```bash
# Install in editable mode
pip install -e ".[dev]"
# Run from source
python src/bookup_fuse.py my-notes.bdb /mnt/bookup
```
Raw data
{
"_id": null,
"home_page": null,
"name": "bookup-fuse",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "fuse, sqlite, filesystem, markdown, bookup",
"author": null,
"author_email": "Frederik <you@example.com>",
"download_url": "https://files.pythonhosted.org/packages/c9/c9/20795a9f8dd27931d03d193e3d83658082bdc37fd1afa8dc03ee108cfce5/bookup_fuse-0.1.8.tar.gz",
"platform": null,
"description": "Hier ist ein Vorschlag f\u00fcr eine pr\u00e4gnante, aber informative `README.md` f\u00fcr dein Projekt:\n\n````markdown\n# bookup-fuse\n\n**Mount Bookup `.bdb` (SQLite) databases as a virtual FUSE filesystem** \u2014 browse and edit your Bookup pages and sections directly as Markdown files.\n\n## Features\n\n- Mount a Bookup `.bdb` file into a directory\n- Exposes two top-level folders:\n - `Pages/` \u2014 all pages without section nesting\n - `Sections/` \u2014 hierarchical structure of sections containing pages\n- Read and edit Markdown content directly via any text editor\n- Changes are written back to the `.bdb` database in real time\n- Works with standard FUSE mounts on Linux\n\n## Requirements\n\n- **Python** \u2265 3.9\n- **libfuse** installed on your system\n Fedora / RHEL:\n ```bash\n sudo dnf install fuse fuse3 fuse3-libs\n````\n\nDebian / Ubuntu:\n\n```bash\nsudo apt install fuse\n```\n\n* Python package **fusepy** (installed automatically with this package)\n\n## Installation\n\n```bash\npip install bookup-fuse\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/beimgraben/bookup-fuse.git\ncd bookup-fuse\npip install .\n```\n\n## Usage\n\n```bash\nbookup-fuse <bookup_bdb_file> <mount_point>\n```\n\nExample:\n\n```bash\nbookup-fuse my-notes.bdb /mnt/bookup\n```\n\nThis will create a directory structure like:\n\n```\n/mnt/bookup\n\u251c\u2500\u2500 Pages\n\u2502 \u251c\u2500\u2500 Page One.md\n\u2502 \u2514\u2500\u2500 Another Note.md\n\u251c\u2500\u2500 Sections\n\u2502 \u251c\u2500\u2500 Work\n\u2502 \u2502 \u2514\u2500\u2500 Task List.md\n\u2502 \u2514\u2500\u2500 Personal\n\u2502 \u251c\u2500\u2500 Recipes.md\n\u2502 \u2514\u2500\u2500 Journal.md\n\u2514\u2500\u2500 .desktop.ini\n```\n\n## Unmounting\n\n```bash\nfusermount -u /mnt/bookup # Linux (FUSE)\n# or\numount /mnt/bookup\n```\n\n## Notes\n\n* `.desktop.ini` is included for compatibility with Windows' folder tooltips but can be ignored.\n* Page and section names containing `/` are automatically sanitized to `_` in file names.\n* Timestamps are stored as UNIX epochs in the database.\n\n## Development\n\n```bash\n# Install in editable mode\npip install -e \".[dev]\"\n\n# Run from source\npython src/bookup_fuse.py my-notes.bdb /mnt/bookup\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Mount Bookup .bdb (SQLite) files as a FUSE filesystem exposing Markdown pages.",
"version": "0.1.8",
"project_urls": {
"Homepage": "https://example.com/bookup-fuse",
"Issues": "https://github.com/yourname/bookup-fuse/issues",
"Repository": "https://github.com/yourname/bookup-fuse"
},
"split_keywords": [
"fuse",
" sqlite",
" filesystem",
" markdown",
" bookup"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1d31fb148d5d9173708886af9a68e773f145eb55c7aa214e8fe633b5d62a6570",
"md5": "378904e1d006eb83756bb68907af0834",
"sha256": "5ef3f128dafd6668346bc6929e334d41055f32fb6b13e1e70b61505cd7069a3d"
},
"downloads": -1,
"filename": "bookup_fuse-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "378904e1d006eb83756bb68907af0834",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 20595,
"upload_time": "2025-08-13T02:56:10",
"upload_time_iso_8601": "2025-08-13T02:56:10.258304Z",
"url": "https://files.pythonhosted.org/packages/1d/31/fb148d5d9173708886af9a68e773f145eb55c7aa214e8fe633b5d62a6570/bookup_fuse-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c9c920795a9f8dd27931d03d193e3d83658082bdc37fd1afa8dc03ee108cfce5",
"md5": "057cba70fb854d0264e5d981c3f66a47",
"sha256": "29739ccb7aa78e4e273de46741626ee31873f9485db4e5e5d8deedca937e479f"
},
"downloads": -1,
"filename": "bookup_fuse-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "057cba70fb854d0264e5d981c3f66a47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 20349,
"upload_time": "2025-08-13T02:56:12",
"upload_time_iso_8601": "2025-08-13T02:56:12.705042Z",
"url": "https://files.pythonhosted.org/packages/c9/c9/20795a9f8dd27931d03d193e3d83658082bdc37fd1afa8dc03ee108cfce5/bookup_fuse-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 02:56:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourname",
"github_project": "bookup-fuse",
"github_not_found": true,
"lcname": "bookup-fuse"
}
