minor change to core.py

docs: remove end-of-the-file line in CONTRIBUTING.md

.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  build-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: 1.8.4
+
+      - name: Install dependencies
+        run: poetry install --no-root --only main
+
+      - name: Build package
+        run: poetry build
+
+      - name: Generate checksums
+        run: |
+          cd dist
+          for file in *; do
+            sha256sum "$file" > "$file.sha256"
+          done
+
+      - name: Publish to PyPI
+        env:
+          POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_TOKEN }}
+        run: poetry publish
+
+      - name: Upload artifacts to GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            dist/*

.github/workflows/release-please.yml

@@ -0,0 +1,18 @@
+name: Release Please
+
+on:
+  push:
+    branches: ["main"]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Release Please
+        uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+    ".": "0.1.1"
+}

CONTRIBUTING.md

@@ -0,0 +1,95 @@
+# How to Contribute to `resrm`
+
+Thanks for your interest in contributing to `resrm`! This guide walks you through the process step by step so you can send contributions with confidence.
+
+### For external contributors
+
+1. **Fork the repository** via GitHub: click *Fork* at the top right.
+2. **Clone your fork**:
+
+   ```bash
+   git clone https://github.com/<your-username>/resrm.git
+   cd resrm
+   ```
+3. **Add the upstream repo** so you can sync later:
+
+   ```bash
+   git remote add upstream https://github.com/mdaleo404/resrm.git
+   ```
+4. **Create a feature branch**:
+
+   ```bash
+   git checkout -b feature/my-new-thing
+   ```
+5. Make your changes and test them locally.
+6. **Push to your fork**:
+
+   ```bash
+   git push -u origin feature/my-new-thing
+   ```
+7. Open a **Pull Request** targeting the `main` branch of the upstream repo.
+
+### For maintainers
+
+You may create branches directly in the main repository without forking.
+
+## Commit Message Style Commit Message Style
+
+To keep the automated changelog clean, follow this commit style:
+
+**Format:**
+
+```
+type: short description
+```
+
+**Accepted types:**
+
+* `feat:` new features
+* `fix:` bug fixes
+* `refactor:` internal improvements
+* `perf:` performance changes
+* `docs:` documentation updates
+* `chore:` maintenance
+* `test:` test-only changes
+
+**Examples:**
+
+```
+feat: add --dry-run flag
+fix: handle unicode paths
+refactor: simplify cleanup logic
+```
+
+Don’t overthink it — the maintainer can adjust commit types during merge if needed.
+
+## What Happens After You Submit a PR?
+
+After reviewing your changes, your PR (hopefully) gets merged. Then:
+
+* **Release Please** automatically creates a **release PR** summarizing changes
+* The maintainer merges that release PR
+* A GitHub Release is created
+* The package is published to PyPI
+* Wheels, source tarballs, and checksums are attached to the GitHub Release
+
+No need to bump versions manually (unless needed).
+
+## Code Style
+
+* Follow standard Python formatting
+* Add type hints when possible
+* Keep functions small and readable
+* Stick to clear naming
+
+## Need Help, Found a Bug, Have a Request?
+
+If you're unsure about anything:
+
+* **Open an issue**
+* Start a discussion
+* Ask questions before writing lots of code
+
+## Thank You
+
+Your contributions — large or small — help make `resrm` better for everyone. Thanks for being part of the project!

README.md

@@ -18,9 +18,9 @@ It moves files to a per-user _trash_ instead of permanently deleting them, while
 ## Installation
 
 **NOTE:** To use `resrm` with `sudo`, the path to `resrm` must be in the `$PATH` seen by `root`.\
-Either install `resrm` as `root`, use `sudo -E resrm`, or add the `$PATH` to `/etc/sudoers` using its `Defaults secure_path` parameter.
+Either install `resrm` as `root` (_preferred_), use `sudo -E resrm`, or add the `$PATH` to `/etc/sudoers` using its `Defaults secure_path` parameter.
 
-Install via PyPI:
+Install via PyPI (_preferred_):
 
 ```bash
 pip install resrm

release-please-config.json

@@ -0,0 +1,11 @@
+{
+    "release-type": "python",
+    "package-name": "resrm",
+    "changelog-sections": [
+        { "type": "feat", "section": "Added", "hidden": false },
+        { "type": "fix", "section": "Fixed", "hidden": false },
+        { "type": "refactor", "section": "Changed", "hidden": false },
+        { "type": "perf", "section": "Changed", "hidden": false },
+        { "type": "docs", "section": "Documentation", "hidden": false }
+    ]
+}

resrm/README.md

@@ -18,9 +18,9 @@ It moves files to a per-user _trash_ instead of permanently deleting them, while
 ## Installation
 
 **NOTE:** To use `resrm` with `sudo`, the path to `resrm` must be in the `$PATH` seen by `root`.\
-Either install `resrm` as `root`, use `sudo -E resrm`, or add the `$PATH` to `/etc/sudoers` using its `Defaults secure_path` parameter.
+Either install `resrm` as `root` (_preferred_), use `sudo -E resrm`, or add the `$PATH` to `/etc/sudoers` using its `Defaults secure_path` parameter.
 
-Install via PyPI:
+Install via PyPI (_preferred_):
 
 ```bash
 pip install resrm

resrm/src/resrm/core.py

@@ -116,6 +116,41 @@ def find_candidates(identifier: str) -> List[Dict]:
     if id_matches:
         return id_matches
 
+def restore_many(identifiers: List[str]):
+    """Restore multiple files, prompting when needed."""
+    for identifier in identifiers:
+        candidates = find_candidates(identifier)
+
+        if not candidates:
+            print(f"No match found for '{identifier}'")
+            continue
+
+        # Only one match - restore immediately
+        if len(candidates) == 1:
+            restore_one(candidates[0])
+            continue
+
+        # Multiple matches - prompt user
+        print(f"Multiple matches for '{identifier}':")
+        for i, entry in enumerate(candidates, start=1):
+            print(f"{i}) {short_id(entry['id'])}  {entry['orig_path']}  ({entry['timestamp']})")
+
+        try:
+            choice = input("Choose number to restore (or skip): ").strip()
+        except KeyboardInterrupt:
+            print("\nAborted.")
+            return
+
+        if not choice.isdigit():
+            print("Skipped.")
+            continue
+
+        idx = int(choice) - 1
+        if 0 <= idx < len(candidates):
+            restore_one(candidates[idx])
+        else:
+            print("Invalid selection. Skipped.")
+
 def restore_one(entry: Dict) -> bool:
     src = TRASH_DIR / entry["id"]
     dest = Path(entry["orig_path"])
@@ -209,7 +244,7 @@ def move_to_trash(path: Path, interactive: bool, force: bool, recursive: bool, p
             print(f"Failed permanent delete: {e}")
         return
 
-    # 🚫 Prevent non-root user deleting root-owned files
+    # Prevent non-root user deleting root-owned files
     try:
         st = path.stat()
         if st.st_uid == 0 and os.geteuid() != 0:
@@ -218,7 +253,7 @@ def move_to_trash(path: Path, interactive: bool, force: bool, recursive: bool, p
     except Exception:
         pass
 
-    # 🧭 Detect which trash to use (based on file owner)
+    # Detect which trash to use (based on file owner)
     try:
         import pwd
         owner_uid = path.stat().st_uid
@@ -273,7 +308,7 @@ def main(argv: Optional[List[str]] = None):
     parser.add_argument("-f", action="store_true", help="force")
     parser.add_argument("-i", action="store_true", help="interactive")
     parser.add_argument("--perma", action="store_true", help="permanent delete")
-    parser.add_argument("--restore", nargs=1, help="restore by id or basename")
+    parser.add_argument("--restore", nargs="+", help="restore by id or basename")
     parser.add_argument("-l", action="store_true", help="list trash")
     parser.add_argument("--empty", action="store_true", help="empty the trash permanently")
     parser.add_argument("--help", action="store_true", help="show help")
@@ -293,7 +328,7 @@ def main(argv: Optional[List[str]] = None):
         return
 
     if args.restore:
-        restore(args.restore[0])
+        restore_many(args.restore)
         return
 
     if not args.paths:
@@ -309,4 +344,4 @@ def main(argv: Optional[List[str]] = None):
                 continue
             print(f"resrm: cannot remove '{pth}': Is a directory")
             continue
-        move_to_trash(pth, interactive=args.i, force=args.f, recursive=args.r, perma=args.perma)
+        move_to_trash(pth, interactive=args.i, force=args.f, recursive=args.r, perma=args.perma)