SCE-UNINA (Sistema Consegna Esami)

📘 Sistema Consegna Esami (SCE) is an extension for VS Code / VSCodium to simplify handling exam projects for computer science courses at DIETI, Università degli Studi di Napoli Federico II.

✨ Features

✅ Upload your exam project as a .zip file to the university server
✅ Download the exam paper PDF directly into your workspace
✅ Configure backend server host from the sidebar or Command Palette
✅ Sidebar view with tree-style command access

🚀 Getting Started

1. Install the Extension

If you're using VS Code:

vsce package          # Generate .vsix bundle
code --install-extension sce-unina-0.0.x.vsix

For VSCodium, use:

codium --install-extension sce-unina-0.0.x.vsix

Replace 0.0.x with your actual version number.

2. Using the Extension

Run the backend Server

Open a terminal/prompt, go to backend folder and run the server (sce_unina_server.py):

$ python sce_unina_server.py

By default, sce_unina_server listening on 0.0.0.0:5001 and file name for exam paper is traccia.pdf. Change the server host, port, and file name for exam paper if needed. For example, for server URL 192.168.3.51:8080 and file name sample_exam.docx, use the following:

python sce_unina_server.py --host 192.168.3.51 --port 8080 --file sample_exam.docx

Please, be sure to put the exam trace file within the backend folder.

Run the VSCodium extension

Open VSCodium and create a new project for the exam
Open the SCE-UNINA view from the Activity Bar
Click on:
- 📤 Upload Exam Project, to upload you exam project. Fill up info when requested.
- 📥 Download Exam Paper PDF, to download the exam paper locally.
Or use the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and search for:
- SCE-UNINA: Upload Exam Project
- SCE-UNINA: Download Exam Paper PDF

⚙️ Configuration

To set or change the server URL:

Open Command Palette and run:
```
SCE-UNINA: Configure server host
```
Enter the server address, e.g.:
```
http://127.0.0.1:5001
```

You can also set this manually in sce-unina-config.json:

{
  "serverUrl": "http://your-server-address:port"
}

💻 Development

Prerequisites

Node.js (v18+ recommended)
VS Code or VSCodium
vsce for bundling:

npm install -g @vscode/vsce

Build & Run

npm install
npm run compile
code .

Use F5 to open a new Extension Development Host.

Package

vsce package

This generates a .vsix file for distribution.

🥪 Testing

To run the tests:

npm run test

📄 License

MIT License

🧠 Credits

Luigi De Simone, Assistant Professor @DIETI, Università degli Studi di Napoli Federico II.