Coder File Push

A simple JavaFX GUI application for pushing files to Coder workspaces on Windows 10/11.

Features

• Workspace Selection - Lists all available Coder workspaces
• File Transfer - Push files from local TEST_DATA folder to remote workspace
• Integrity Verification - SHA-256 checksum verification after transfer
• Debug Mode - Optional verbose output for troubleshooting

Prerequisites

1. Java 17+ (LTS recommended)

Download and install:

• Eclipse Temurin 17+
• Or Oracle JDK 17+

java --version

2. Apache Maven

• Maven Download
• Add bin folder to PATH

mvn --version

3. Coder CLI

The Coder CLI must be installed and authenticated:

1. Download from your Coder deployment or Coder releases
2. Add to PATH
3. Authenticate:

coder login https://your-coder-deployment.com
coder list  # Verify it works

Quick Start

# Clone
git clone https://github.com/your-org/coder-file-push.git
cd coder-file-push

# Build
mvn clean package

# Run
mvn javafx:run

Usage

1. Launch the application
2. Select a workspace from the dropdown
3. Place files in the TEST_DATA/ folder
4. Set remote destination path (default: /home/coder)
5. Click Push Files
6. Check status - files show [VERIFIED] when checksum matches

Project Structure

coder-file-push/
├── pom.xml                          # Maven build config
├── README.md
├── TEST_DATA/                       # Place files here to push
│   └── sample.txt
└── src/
    ├── main/
    │   ├── java/com/coder/filepush/
    │   │   ├── Main.java            # JavaFX entry point
    │   │   ├── MainController.java  # UI controller
    │   │   ├── CoderCliExecutor.java# CLI wrapper
    │   │   ├── CommandRunner.java   # Interface for testability
    │   │   ├── DefaultCommandRunner.java
    │   │   └── ProcessResult.java
    │   └── resources/
    │       └── main.fxml            # UI layout
    └── test/
        └── java/com/coder/filepush/
            └── CoderCliExecutorTest.java

Testing

mvn test

8 unit tests with mocked CLI interactions:

• Checksum calculation
• Workspace list parsing
• Push success/failure
• Verification match/mismatch

Requirements Compliance

REQ	Description	Status
REQ_001	GUI on Windows 10/11	✅ JavaFX
REQ_002	Modern stable Java	✅ Java 17+ LTS
REQ_003	Use installed Coder CLI	✅ Checks on startup
REQ_004	Use ./TEST_DATA folder	✅ Hardcoded
REQ_005	Simple as possible	✅ Single window
REQ_006	Show/select workspaces	✅ Dropdown

Architecture

graph LR
    A[GUI] --> B[MainController]
    B --> C[CoderCliExecutor]
    C --> D[CommandRunner]
    D --> E[coder CLI]
    E --> F[Workspace]

Loading

License

MIT