mountlet 0.2.0__tar.gz

mountlet-0.2.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## Unreleased
+
+- Renamed the project, import package, installed command, and user config directory to Mountlet.
+- Added an optional PySide6 desktop tray preview with mount, unmount, restart-mount, and open-folder actions.
+- Split tray interactions between hover status, left-click remote actions, and right-click app actions.
+- Added app-level and per-remote Mountlet config files.
+- Open-folder actions can use current-desktop Dolphin windows on X11 when available, with fallback open strategies elsewhere.
+
+## 0.1.1 - 2026-05-31
+
+- Improved setup guidance when `rclone` is not installed yet.
+- Honored `RCLONE_CONFIG` consistently in setup and config helper commands.
+
+## 0.1.0 - 2026-05-31
+
+Initial public CLI release.
+
+- Single public command: `mountlet`.
+- Fast readiness check before opening the menu.
+- Guided setup flow with `mountlet setup`.
+- Optional rclone connection flow with `mountlet setup --configure-rclone`.
+- Interactive menu for mounting, unmounting, refreshing, and verifying remotes.
+- Subcommands for setup, path inspection, verification, reconnect, import, and export.
+- User-specific app directories for config, state, and cache.
+- Import/export helpers for rclone configuration bundles.
+- `--version` / `-V` version output.
+- CI workflow for tests and package build.
+- Exported bundles are documented as sensitive credential backups.

mountlet-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Holt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mountlet-0.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include CHANGELOG.md
+include SECURITY.md
+recursive-include docs *.md
+recursive-include examples *.sample

mountlet-0.2.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: mountlet
+Version: 0.2.0
+Summary: CLI and tray tools for mounting rclone remotes
+Author: Eric Holt
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eric-holt/mountlet
+Project-URL: Issues, https://github.com/eric-holt/mountlet/issues
+Keywords: rclone,mount,cloud-storage,tui,fuse
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: tray
+Requires-Dist: PySide6>=6.7; extra == "tray"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: twine>=6; extra == "dev"
+Dynamic: license-file
+
+# Mountlet
+
+Mountlet is a terminal app for mounting and unmounting `rclone`
+remotes from a simple menu. It uses your existing `rclone` configuration and
+does not store cloud credentials inside the application install directory.
+
+## How It Works
+
+Mountlet is a friendly control panel for two standard tools:
+
+- `rclone` connects to cloud storage providers such as Google Drive, Dropbox,
+  S3-compatible storage, and WebDAV.
+- FUSE lets Linux show a cloud remote as if it were a normal folder on your
+  computer.
+
+This app reads your `rclone` remotes, creates local mount folders, and starts or
+stops `rclone mount` for you.
+
+## Requirements
+
+- Python 3.10 or newer.
+- `rclone`, which connects to your cloud storage.
+- FUSE, which lets Linux show mounted cloud storage as folders.
+
+On Ubuntu, install the system tools with:
+
+```bash
+sudo apt install rclone fuse3
+```
+
+## Install
+
+For isolated CLI use:
+
+```bash
+pipx install mountlet
+```
+
+For the desktop tray preview:
+
+```bash
+pipx install "mountlet[tray]"
+```
+
+For a local checkout:
+
+```bash
+python -m pip install .
+```
+
+## Use
+
+Open Mountlet:
+
+```bash
+mountlet
+```
+
+The app checks whether your computer is ready before it opens the menu. If
+something is missing, it prints the next step instead of dropping you into an
+empty screen.
+
+For a guided setup check:
+
+```bash
+mountlet setup
+```
+
+If you have not added any cloud storage to `rclone` yet, let setup open
+`rclone`'s connection flow:
+
+```bash
+mountlet setup --configure-rclone
+```
+
+Normal use is:
+
+```bash
+mountlet
+```
+
+Quitting the menu leaves mounted remotes connected. Use `u` in the menu to
+unmount everything.
+
+## Desktop Tray Preview
+
+The tray app is optional and uses PySide6. Start it with:
+
+```bash
+mountlet tray
+```
+
+If you installed the CLI without tray support, add PySide6 with:
+
+```bash
+pipx inject mountlet PySide6
+```
+
+The tray app uses the tray icon this way:
+
+- Hover shows a short mounted/unmounted summary.
+- Left-click shows each remote with mount, unmount, restart-mount, and open-folder actions.
+- Right-click shows app-level actions such as mount all, unmount all, update status, and quit.
+
+If your desktop session does not expose a system tray, use the terminal menu
+instead.
+
+## Extra Commands
+
+These are useful for backup, troubleshooting, or moving to another computer:
+
+```bash
+mountlet path
+mountlet verify
+mountlet verify --auto-reconnect
+mountlet reconnect --remote MyRemote
+mountlet export ~/mountlet-backup
+mountlet import --config ~/mountlet-backup/rclone.conf
+```
+
+## File Locations
+
+Mountlet keeps application data in user-specific locations and leaves
+`rclone` credentials in the standard `rclone` location.
+
+On Linux:
+
+- `~/.config/rclone/rclone.conf`: rclone remotes and credentials.
+- `~/.config/mountlet/config.toml`: Mountlet preferences.
+- `~/.config/mountlet/mounts.toml`: per-remote mount preferences.
+- `~/.local/state/mountlet/`: runtime state.
+- `~/.cache/mountlet/`: cache files.
+- `~/cloud_mounts/`: default mount root.
+
+Print the paths for your system:
+
+```bash
+mountlet path
+```
+
+Create the Mountlet user folders:
+
+```bash
+mountlet path --ensure
+```
+
+That command also creates starter `config.toml` and `mounts.toml` files if they
+do not exist yet.
+
+Override the mount root for a shell session:
+
+```bash
+export MOUNTLET_MOUNT_BASE=/path/to/mounts
+```
+
+### App Settings
+
+Use `config.toml` for app-wide behavior:
+
+```toml
+[app]
+mount_base = ""
+auto_mount = false
+auto_mount_delay = 2.0
+
+[tray]
+open_folder_behavior = "current_desktop"
+focus_file_manager = true
+```
+
+Use `mounts.toml` for per-remote behavior. Remote names must match the names in
+`rclone`.
+
+```toml
+[remotes."Work__Drive"]
+auto_mount = true
+mount_path = "~/cloud_mounts/drive/Work"
+mount_flags = "--read-only --dir-cache-time 10m"
+```
+
+Keep cloud account details in `rclone.conf`; use these files only for Mountlet
+behavior.
+
+## Credentials
+
+`rclone.conf` can contain OAuth tokens and provider credentials. Treat exported
+bundles as sensitive files.
+
+- Do not share real `rclone.conf` files.
+- Do not share `client_secret*.json` files.
+- Store backups outside application install directories.
+- Review exported bundles before copying them to another machine.
+
+## Status
+
+The current public target is Linux CLI use. The desktop tray is an early preview
+for the next product layer.
+
+See the [changelog](https://github.com/eric-holt/mountlet/blob/main/CHANGELOG.md)
+for version history.

mountlet-0.2.0/README.md

@@ -0,0 +1,200 @@
+# Mountlet
+
+Mountlet is a terminal app for mounting and unmounting `rclone`
+remotes from a simple menu. It uses your existing `rclone` configuration and
+does not store cloud credentials inside the application install directory.
+
+## How It Works
+
+Mountlet is a friendly control panel for two standard tools:
+
+- `rclone` connects to cloud storage providers such as Google Drive, Dropbox,
+  S3-compatible storage, and WebDAV.
+- FUSE lets Linux show a cloud remote as if it were a normal folder on your
+  computer.
+
+This app reads your `rclone` remotes, creates local mount folders, and starts or
+stops `rclone mount` for you.
+
+## Requirements
+
+- Python 3.10 or newer.
+- `rclone`, which connects to your cloud storage.
+- FUSE, which lets Linux show mounted cloud storage as folders.
+
+On Ubuntu, install the system tools with:
+
+```bash
+sudo apt install rclone fuse3
+```
+
+## Install
+
+For isolated CLI use:
+
+```bash
+pipx install mountlet
+```
+
+For the desktop tray preview:
+
+```bash
+pipx install "mountlet[tray]"
+```
+
+For a local checkout:
+
+```bash
+python -m pip install .
+```
+
+## Use
+
+Open Mountlet:
+
+```bash
+mountlet
+```
+
+The app checks whether your computer is ready before it opens the menu. If
+something is missing, it prints the next step instead of dropping you into an
+empty screen.
+
+For a guided setup check:
+
+```bash
+mountlet setup
+```
+
+If you have not added any cloud storage to `rclone` yet, let setup open
+`rclone`'s connection flow:
+
+```bash
+mountlet setup --configure-rclone
+```
+
+Normal use is:
+
+```bash
+mountlet
+```
+
+Quitting the menu leaves mounted remotes connected. Use `u` in the menu to
+unmount everything.
+
+## Desktop Tray Preview
+
+The tray app is optional and uses PySide6. Start it with:
+
+```bash
+mountlet tray
+```
+
+If you installed the CLI without tray support, add PySide6 with:
+
+```bash
+pipx inject mountlet PySide6
+```
+
+The tray app uses the tray icon this way:
+
+- Hover shows a short mounted/unmounted summary.
+- Left-click shows each remote with mount, unmount, restart-mount, and open-folder actions.
+- Right-click shows app-level actions such as mount all, unmount all, update status, and quit.
+
+If your desktop session does not expose a system tray, use the terminal menu
+instead.
+
+## Extra Commands
+
+These are useful for backup, troubleshooting, or moving to another computer:
+
+```bash
+mountlet path
+mountlet verify
+mountlet verify --auto-reconnect
+mountlet reconnect --remote MyRemote
+mountlet export ~/mountlet-backup
+mountlet import --config ~/mountlet-backup/rclone.conf
+```
+
+## File Locations
+
+Mountlet keeps application data in user-specific locations and leaves
+`rclone` credentials in the standard `rclone` location.
+
+On Linux:
+
+- `~/.config/rclone/rclone.conf`: rclone remotes and credentials.
+- `~/.config/mountlet/config.toml`: Mountlet preferences.
+- `~/.config/mountlet/mounts.toml`: per-remote mount preferences.
+- `~/.local/state/mountlet/`: runtime state.
+- `~/.cache/mountlet/`: cache files.
+- `~/cloud_mounts/`: default mount root.
+
+Print the paths for your system:
+
+```bash
+mountlet path
+```
+
+Create the Mountlet user folders:
+
+```bash
+mountlet path --ensure
+```
+
+That command also creates starter `config.toml` and `mounts.toml` files if they
+do not exist yet.
+
+Override the mount root for a shell session:
+
+```bash
+export MOUNTLET_MOUNT_BASE=/path/to/mounts
+```
+
+### App Settings
+
+Use `config.toml` for app-wide behavior:
+
+```toml
+[app]
+mount_base = ""
+auto_mount = false
+auto_mount_delay = 2.0
+
+[tray]
+open_folder_behavior = "current_desktop"
+focus_file_manager = true
+```
+
+Use `mounts.toml` for per-remote behavior. Remote names must match the names in
+`rclone`.
+
+```toml
+[remotes."Work__Drive"]
+auto_mount = true
+mount_path = "~/cloud_mounts/drive/Work"
+mount_flags = "--read-only --dir-cache-time 10m"
+```
+
+Keep cloud account details in `rclone.conf`; use these files only for Mountlet
+behavior.
+
+## Credentials
+
+`rclone.conf` can contain OAuth tokens and provider credentials. Treat exported
+bundles as sensitive files.
+
+- Do not share real `rclone.conf` files.
+- Do not share `client_secret*.json` files.
+- Store backups outside application install directories.
+- Review exported bundles before copying them to another machine.
+
+## Status
+
+The current public target is Linux CLI use. The desktop tray is an early preview
+for the next product layer.
+
+See the [changelog](https://github.com/eric-holt/mountlet/blob/main/CHANGELOG.md)
+for version history.

mountlet-0.2.0/SECURITY.md

@@ -0,0 +1,26 @@
+# Security
+
+Mountlet works with `rclone` configuration files. Those files may
+contain OAuth tokens, refresh tokens, client secrets, provider credentials, and
+remote paths that identify private infrastructure.
+
+## Reporting Issues
+
+This repository does not have a public security contact configured yet. Before
+public release, enable GitHub private vulnerability reporting or add a dedicated
+security contact.
+
+## Handling Local Secrets
+
+- Keep real `rclone.conf` files out of version control.
+- Keep `client_secret*.json` files out of version control.
+- Treat exported bundles as credentials.
+- Prefer private backup locations outside this repository and outside package
+  install directories.
+- Keep installed-user configuration in user config directories such as
+  `~/.config/rclone/` and `~/.config/mountlet/`.
+- Rotate provider credentials if a real config bundle is shared accidentally.
+
+## Supported Versions
+
+No public stable version is supported yet.

mountlet-0.2.0/docs/README.md

@@ -0,0 +1,91 @@
+# Development Notes
+
+This directory contains maintainer-facing notes. The root `README.md` is the
+user-facing document used for package publication.
+
+## Development
+
+Install from a local checkout:
+
+```bash
+python -m pip install -e .
+```
+
+Run the stdlib test suite:
+
+```bash
+python -m unittest discover -s tests
+```
+
+Run a syntax check:
+
+```bash
+python -m compileall -q src tests
+```
+
+Optional development tools are declared in the `dev` extra:
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+python -m build
+```
+
+Install the optional tray dependencies when working on the desktop preview:
+
+```bash
+python -m pip install -e ".[dev,tray]"
+mountlet tray
+```
+
+The repository-level `secrets/` directory is for local development only. It is
+ignored by git and must not be part of the installed-user workflow.
+
+## Release Checklist
+
+- Confirm support contact.
+- Add screenshots or terminal recordings for the package page.
+- Publish PyPI/pipx CLI installation instructions.
+- Publish `.deb` installation instructions for the later desktop package.
+- Run CI on every pull request.
+- Build a wheel and install it in a clean virtual environment.
+- Test on a fresh Ubuntu installation with `rclone` and `fuse3`.
+- Verify import/export flows with non-sensitive sample configs.
+- Confirm the built wheel and source distribution do not include local secrets.
+- Follow [RELEASE.md](RELEASE.md) when merging `wip` to `main`, tagging, and publishing.
+
+## Release Strategy
+
+- Keep the CLI/TUI core MIT licensed.
+- Publish CLI builds to PyPI for lightweight `pipx` installation.
+- Publish the first user-facing desktop package as a native Ubuntu `.deb` from
+  GitHub Releases.
+- Build the desktop tray app as the first commercial product layer.
+- Keep Snap and AppImage as later distribution options after the mount and tray
+  flows are proven in the `.deb`.
+
+## Monetization Direction
+
+The free package should remain useful as a local CLI/TUI. Paid value should be
+centered on reliability, convenience, support, and managed configuration.
+
+The first paid product direction is a desktop tray app.
+
+Initial desktop tray scope:
+
+- Basic mount, unmount, restart-mount, and open-folder actions.
+- Auto-mount at login.
+- Remote health checks and notifications.
+- One-click credential reconnect flows.
+- Per-remote mount policies.
+- Commercial support.
+
+Later paid candidates:
+
+- Encrypted local config vault.
+- Team configuration templates.
+
+Open questions:
+
+- What support channel should paid users receive?
+- What platforms are included in the first paid release?

mountlet-0.2.0/docs/RELEASE.md

@@ -0,0 +1,83 @@
+# Release Process
+
+This project uses `wip` for active work and `main` for release-ready code.
+Released versions are marked with git tags, not long-lived version branches.
+
+## Branches
+
+- `wip`: active development and automatic pushes.
+- `main`: stable branch used for public releases.
+- `vX.Y.Z` tags: immutable release points.
+
+Create release branches only if a maintained older line needs fixes while
+`main` has moved ahead. That is not expected for `0.1.x`.
+
+## Release Checklist
+
+Run these from `wip` first:
+
+```bash
+VERSION=0.2.0
+python -m unittest discover -s tests
+python -m compileall -q src tests
+python -m pip wheel . -w /tmp/mountlet-release --no-deps --no-build-isolation
+```
+
+Confirm:
+
+- `README.md` describes the user flow.
+- `CHANGELOG.md` has a section for the version being released.
+- `pyproject.toml` and `src/mountlet/__init__.py` have the same version.
+- `SECURITY.md` has an active security reporting path or GitHub private vulnerability reporting is enabled.
+- Built distributions do not include `secrets/`, `rclone.conf`, or `client_secret*.json`.
+- The package exposes only the `mountlet` console command.
+
+## Merge To Main
+
+```bash
+git checkout main
+git pull origin main
+git merge --squash wip
+git commit -m "Release v$VERSION"
+python -m unittest discover -s tests
+python -m compileall -q src tests
+```
+
+Build from `main`:
+
+```bash
+python -m build
+python -m twine check dist/*
+```
+
+## Tag
+
+After the final release commit is on `main`:
+
+```bash
+git tag -a "v$VERSION" -m "Release v$VERSION"
+git push origin main --tags
+```
+
+## Publish
+
+Publish from the tagged `main` commit, not from `wip`.
+
+Publishing is handled by GitHub Actions through PyPI trusted publishing.
+The PyPI publisher must match:
+
+- Repository: `eric-holt/mountlet`
+- Workflow: `python-publish.yml`
+- Environment: `pypi`
+
+Pushing a release tag starts the publish workflow:
+
+```bash
+git push origin main --tags
+```
+
+Manual PyPI uploads are only a fallback:
+
+```bash
+python -m twine upload dist/*
+```

mountlet-0.2.0/examples/rclone.conf.sample

@@ -0,0 +1,7 @@
+# Example rclone.conf snippet (do not commit real credentials)
+#
+# [MyRemote__Drive]
+# type = drive
+# client_id = your-client-id.apps.googleusercontent.com
+# client_secret = your-client-secret
+# token = {"access_token":"..."}