[pull] master from Eloston:master

[pull]

See Commits and Changes for more details.

---

Created by pull[bot] (v2.0.0-alpha.4)

Can you help keep this open source service alive? 💖 Please sponsor : )

[sourcery-ai]

Reviewer's Guide

Introduces an asynchronous file transfer web service script with directory browsing and upload modes, plus two new systemd unit templates for mount management.

Sequence Diagram for Directory Browsing (Tree Mode)

sequenceDiagram
    actor User
    participant Server as "aioftws.py (Tree Mode)"
    participant FileSystem

    User->>Server: GET /{path}
    Server->>Server: path = request.match_info['path']
    Server->>Server: Validate path (not absolute, within CWD)
    alt Path is directory
        Server->>FileSystem: List directory contents (full_path.iterdir())
        FileSystem-->>Server: Directory entries
        Server->>Server: Generate HTML listing for path
        Server-->>User: HTTP 200 OK (HTML Page with links)
    else Path is file
        Server->>FileSystem: Access file (full_path)
        FileSystem-->>Server: File data
        Server-->>User: HTTP 200 OK (FileResponse with file content)
    else Path not found or access denied
        Server-->>User: HTTP 40x/500 Error (e.g., 404, 403, 400)
    end

Loading

Sequence Diagram for Requesting the File Upload Page

sequenceDiagram
    actor User
    participant Browser
    participant Server as "aioftws.py (Upload Mode)"

    User->>Browser: Opens / (navigates to upload page URL)
    Browser->>Server: GET /
    Server->>Server: call handle_upload_page()
    Server->>Server: Generate HTML for upload form
    Server-->>Browser: HTTP 200 OK (HTML Upload Form)
    Browser-->>User: Displays Upload Page

Loading

Class Diagram for TreeHTTPRequestHandler

classDiagram
    class TreeHTTPRequestHandler {
        +get() web.Response
    }
    class View {
        <<aiohttp.web.View>>
    }
    View <|-- TreeHTTPRequestHandler
    class Request {
        <<aiohttp.web.Request>>
        +match_info
        +transport
    }
    class Response {
        <<aiohttp.web.Response>>
    }
    class FileResponse {
        <<aiohttp.web.FileResponse>>
    }
    TreeHTTPRequestHandler ..> Request : uses
    TreeHTTPRequestHandler ..> Response : creates
    TreeHTTPRequestHandler ..> FileResponse : creates
    class Path {
        <<pathlib.Path>>
        +is_absolute() bool
        +resolve() Path
        +is_relative_to(other Path) bool
        +exists() bool
        +is_dir() bool
        +is_file() bool
        +iterdir() Iterator[Path]
        +parent Path
        +name str
        +as_posix() str
    }
    TreeHTTPRequestHandler ..> Path : uses

Loading

File-Level Changes

Change	Details	Files
Add asynchronous file transfer web service	Set up no-cache response preparation hook Implement TreeHTTPRequestHandler for secure directory listing Add upload page and multipart upload handlers with file write and result reporting Configure init_app/routes, run_server loop and argparse-driven entry point Discover private/link-local IPs for multi-interface serving	aioftws.py
Add systemd unit templates for mount management	Create ensure-mount@.service template Create mount-restart@.service template	systemd/ensure-mount@.service systemd/mount-restart@.service

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.