Initial commit for profile PyHasher

Untracked files matching the following rules:
- Rule "!.vscode/launch.json": 1 file

.continue/config.ts

@@ -0,0 +1,78 @@
+import { PartialConfig, Ollama, OpenAI } from "@continuedev/config-types";
+import {
+  DiffContextProvider,
+  FileContextProvider,
+  FolderContextProvider,
+  GitHubIssuesContextProvider,
+  TerminalContextProvider,
+  URLContextProvider,
+} from "@continuedev/core";
+
+// --- PASSO FONDAMENTALE: Incolla la tua chiave API di OpenRouter qui ---
+const OPENROUTER_API_KEY = "sk-or-TUA_CHIAVE_OPENROUTER_QUI";
+
+const config: PartialConfig = {
+  models: [
+    // --- Modelli Cloud (Agenti) - Per compiti complessi e analisi codebase ---
+    {
+      title: "Gemini 1.5 Pro (Agent)",
+      provider: "openai", // Usa il provider "openai" per la compatibilità con OpenRouter
+      model: "google/gemini-1.5-pro",
+      apiBase: "https://openrouter.ai/api/v1",
+      apiKey: OPENROUTER_API_KEY,
+      contextProviders: [
+        new DiffContextProvider(),
+        new FileContextProvider(),
+        new FolderContextProvider(),
+        new GitHubIssuesContextProvider(),
+        new TerminalContextProvider(),
+        new URLContextProvider(),
+      ],
+    },
+    {
+      title: "Claude 3.5 Sonnet (Agent)",
+      provider: "openai",
+      model: "anthropic/claude-3.5-sonnet",
+      apiBase: "https://openrouter.ai/api/v1",
+      apiKey: OPENROUTER_API_KEY,
+      contextProviders: [
+        new DiffContextProvider(),
+        new FileContextProvider(),
+        new FolderContextProvider(),
+        new GitHubIssuesContextProvider(),
+        new TerminalContextProvider(),
+        new URLContextProvider(),
+      ],
+    },
+    
+    // --- Modelli Locali (Gratuiti) - Per richieste dirette e veloci ---
+    {
+      title: "CodeLlama 13b (local)",
+      provider: "ollama",
+      model: "codellama:13b",
+      apiBase: "http://192.168.100.1:11434",
+    },
+    {
+      title: "DeepSeek Coder v2 (local)",
+      provider: "ollama",
+      model: "deepseek-coder-v2:16b",
+      apiBase: "http://192.168.100.1:11434",
+    },
+    // Aggiungi qui gli altri tuoi modelli locali seguendo questo schema
+    {
+      title: "Llama 3.1 8b (local)",
+      provider: "ollama",
+      model: "llama3.1:8b",
+      apiBase: "http://192.168.100.1:11434",
+    },
+  ],
+  
+  // Modello per il completamento automatico del codice
+  tabCompleteModel: {
+      provider: "ollama",
+      model: "codellama:13b",
+      apiBase: "http://192.168.100.1:11434",
+  },
+};
+
+export default config;

.gitignore

@@ -148,3 +148,5 @@ dmypy.json
 # Temporary files
 *.swp
 *~
+_dist/*
+_build/*

CLAUDE.md

@@ -0,0 +1,17 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+- To run the application: `python -m pyhasher`
+
+## Architecture
+
+This is a desktop GUI application built with Python and Tkinter for calculating file hashes.
+
+The core logic is decoupled from the GUI:
+
+- **`pyhasher/core/core.py`**: Contains the `calculate_hashes_for_file` function, which handles all file reading and hash computations. It processes files in chunks to efficiently handle large files. This module has no dependency on the GUI.
+
+- **`pyhasher/gui/gui.py`**: Implements the user interface using Tkinter. It gets the file path from the user, calls the core function to perform the calculations, and displays the results.

README.md

@@ -1,16 +1,50 @@
 # PyHasher
 
-A brief description of PyHasher.
+![PyHasher Screenshot](screenshot.png)
+
+A simple, modern, and cross-platform file hash calculator built with Python and Tkinter.
+
+PyHasher allows you to quickly calculate the most common checksums and cryptographic hashes for any file, providing a clean and straightforward interface for verifying file integrity and authenticity.
+
+---
 
 ## Features
-- Feature 1
-- Feature 2
 
-## Getting Started
+- **Wide Range of Algorithms**: Calculates multiple hashes in a single operation.
-...
+  - **Checksums**: CRC32, Adler-32
+  - **Cryptographic Hashes**: MD5, SHA-1, SHA-2 (256, 384, 512), SHA-3 (256), BLAKE2b
+- **User-Friendly Interface**: A simple GUI to select files and view results.
+- **Efficient**: Processes large files in chunks, keeping memory usage low.
+- **Cross-Platform**: Built with standard Python libraries, it runs on Windows, macOS, and Linux without extra dependencies.
+- **Copy-Paste Ready**: Easily copy any hash value with a simple click and drag.
 
-## Contributing
+---
-...
+
+## Requirements
+
+- Python 3.6+
+
+All required libraries (`tkinter`, `hashlib`, `zlib`) are part of the Python standard library, so no external packages need to be installed.
+
+---
+
+## Installation & Running
+
+1.  **Clone the repository:**
+    ```bash
+    git clone [URL_DEL_TUO_REPOSITORY_GITEA]
+    cd pyhasher
+    ```
+
+2.  **Run the application:**
+    Navigate to the project's root directory (the one containing the `pyhasher` package) and run the following command:
+    ```bash
+    python -m pyhasher
+    ```
+    The application window will appear on the screen.
+
+---
 
 ## License
-...
+
+This project is licensed under the MIT License. See the `LICENSE` file for details.

doc/English-manual.md

@@ -1,24 +1,67 @@
-# PyHasher - English Manual
+# PyHasher - User Manual
 
-## Introduction
+Welcome to PyHasher! This guide will help you understand all the application's features.
-Welcome to PyHasher. This document provides an overview of how to install, use, and understand the project.
 
-## Installation
+### Table of Contents
-Describe the installation steps here. For example:
+1. [What is a Hash?](#1-what-is-a-hash)
-1. Clone the repository: `git clone <repository_url>`
+2. [Quick Start Guide](#2-quick-start-guide)
-2. Navigate to the project directory: `cd PyHasher`
+3. [Supported Algorithms](#3-supported-algorithms)
-3. Install dependencies: `pip install -r requirements.txt` (if applicable)
+4. [Common Use Cases](#4-common-use-cases)
+5. [Frequently Asked Questions (FAQ)](#5-frequently-asked-questions-faq)
 
-## Usage
+---
-Explain how to run and use the application.
-- To run the application: `python -m pyhasher`
-- Command-line arguments (if any).
-- GUI interaction (if any).
 
-## Development
+### 1. What is a Hash?
-Information for developers contributing to the project.
-- Code structure.
-- How to run tests.
 
-## Troubleshooting
+A "hash" (or checksum) is like a digital fingerprint for a file. It's a fixed-length string of text generated by a mathematical algorithm. Even the smallest change to the file (like altering a single character) will produce a completely different hash.
-Common issues and their solutions.
+
+This makes hashes extremely useful for:
+- **Verifying Integrity**: Ensuring a file has not been corrupted during a download or transfer.
+- **Verifying Authenticity**: Checking that a file is exactly what the creator intended to distribute, without any tampering.
+
+### 2. Quick Start Guide
+
+Using PyHasher is very simple:
+
+1.  **Launch the application**.
+2.  **Select a File**: Click the **"Browse..."** button. A dialog box will open for you to choose the file you want to analyze.
+3.  **Calculate Hashes**: Once the file is selected, its path will appear in the text box. Click the **"Calculate Hashes"** button.
+4.  **View and Copy Results**: The application will calculate and display all the hashes in their respective boxes. To copy a value, click inside the box, select the text with your mouse, and use `Ctrl+C` (or `Cmd+C` on Mac).
+
+### 3. Supported Algorithms
+
+PyHasher supports a wide range of algorithms, divided into two categories:
+
+-   **Checksums**: Excellent for detecting accidental errors.
+    -   `CRC32`, `Adler-32`: Very fast and commonly used for data integrity checks (e.g., in ZIP files).
+
+-   **Cryptographic Hashes**: Designed to be secure against intentional modifications.
+    -   `MD5`, `SHA-1`: Older algorithms. Useful for compatibility with legacy systems, but **not recommended** for modern security applications.
+    -   `SHA-2 (256, 384, 512)`: The current industry standard for security, widely used worldwide.
+    -   `SHA-3 (256)`: The newest official standard, designed as a secure alternative to the SHA-2 family.
+    -   `BLAKE2b`: A modern, extremely fast, and secure algorithm.
+
+### 4. Common Use Cases
+
+**Case 1: Verifying a Software Download**
+You've downloaded a program from the internet. The website provides an SHA-256 hash for the installation file.
+1.  Use PyHasher to calculate the SHA-256 hash of the file you downloaded.
+2.  Compare the result with the one published on the website.
+3.  If the two hashes match, your download is perfect and has not been altered.
+
+**Case 2: Checking a Data Backup**
+You have copied important files to an external drive. You want to be sure that the copy is identical to the original.
+1.  Calculate the hashes (e.g., BLAKE2b) of the original files.
+2.  Calculate the hashes of the files copied to the external drive.
+3.  If the hashes match, the copy was successful and error-free.
+
+### 5. Frequently Asked Questions (FAQ)
+
+**Q: Why is the application slow with very large files?**
+**A:** PyHasher must read the entire file content to calculate the hashes. For a multi-gigabyte file, this operation naturally takes time. However, the process is optimized to use very little RAM, so it will not freeze your computer.
+
+**Q: Can I hash an entire folder?**
+**A:** No. The current version of PyHasher is designed to analyze single files only.
+
+**Q: Why are MD5 and SHA-1 included if they are considered insecure?**
+**A:** They are kept for compatibility with older systems or software that may still use them. For any new security needs, we strongly recommend using SHA-256 or newer algorithms.

doc/Italian-manual.md

@@ -1,24 +1,67 @@
-# PyHasher - Manuale Italiano
+# PyHasher - Manuale Utente
 
-## Introduzione
+Benvenuto in PyHasher! Questa guida ti aiuterà a comprendere tutte le funzionalità dell'applicazione.
-Benvenuto in PyHasher. Questo documento fornisce una panoramica su come installare, utilizzare e comprendere il progetto.
 
-## Installazione
+### Indice
-Descrivi i passaggi di installazione qui. Ad esempio:
+1. [Cos'è un Hash?](#1-cosè-un-hash)
-1. Clona il repository: `git clone <repository_url>`
+2. [Guida Rapida](#2-guida-rapida)
-2. Naviga nella directory del progetto: `cd PyHasher`
+3. [Algoritmi Supportati](#3-algoritmi-supportati)
-3. Installa le dipendenze: `pip install -r requirements.txt` (se applicabile)
+4. [Casi d'Uso Comuni](#4-casi-duso-comuni)
+5. [Domande Frequenti (FAQ)](#5-domande-frequenti-faq)
 
-## Utilizzo
+---
-Spiega come eseguire e utilizzare l'applicazione.
-- Per eseguire l'applicazione: `python -m pyhasher`
-- Argomenti da riga di comando (se presenti).
-- Interazione con la GUI (se presente).
 
-## Sviluppo
+### 1. Cos'è un Hash?
-Informazioni per gli sviluppatori che contribuiscono al progetto.
-- Struttura del codice.
-- Come eseguire i test.
 
-## Risoluzione dei problemi
+Un "hash" (o checksum/somma di controllo) è come un'impronta digitale per un file. È una stringa di testo di lunghezza fissa generata da un algoritmo matematico. Anche la più piccola modifica al file (come cambiare un singolo carattere) produrrà un hash completamente diverso.
-Problemi comuni e relative soluzioni.
+
+Questo rende gli hash estremamente utili per:
+- **Verificare l'integrità**: Assicurarsi che un file non sia stato danneggiato durante un download o un trasferimento.
+- **Verificare l'autenticità**: Controllare che un file sia esattamente quello che il creatore intendeva distribuire, senza alterazioni o manomissioni.
+
+### 2. Guida Rapida
+
+Usare PyHasher è molto semplice:
+
+1.  **Avvia l'applicazione**.
+2.  **Seleziona un File**: Clicca sul pulsante **"Browse..."**. Si aprirà una finestra di dialogo per scegliere il file che vuoi analizzare.
+3.  **Calcola gli Hash**: Una volta selezionato il file, il suo percorso apparirà nella casella di testo. Clicca sul pulsante **"Calculate Hashes"**.
+4.  **Visualizza e Copia i Risultati**: L'applicazione calcolerà e mostrerà tutti gli hash nelle rispettive caselle. Per copiare un valore, clicca sulla casella, seleziona il testo con il mouse e usa `Ctrl+C` (o `Cmd+C` su Mac).
+
+### 3. Algoritmi Supportati
+
+PyHasher supporta un'ampia gamma di algoritmi, suddivisi in due categorie:
+
+-   **Checksums (Somme di Controllo)**: Ottimi per rilevare errori accidentali.
+    -   `CRC32`, `Adler-32`: Molto veloci e usati comunemente per la verifica dell'integrità dei dati (es. in file ZIP).
+
+-   **Hash Crittografici**: Progettati per essere sicuri contro modifiche intenzionali.
+    -   `MD5`, `SHA-1`: Algoritmi più datati. Utili per compatibilità con sistemi legacy, ma **non raccomandati** per applicazioni di sicurezza moderne.
+    -   `SHA-2 (256, 384, 512)`: Lo standard attuale per la sicurezza, ampiamente utilizzato in tutto il mondo.
+    -   `SHA-3 (256)`: Il più recente standard ufficiale, progettato per essere un'alternativa sicura alla famiglia SHA-2.
+    -   `BLAKE2b`: Un algoritmo moderno, estremamente veloce e sicuro.
+
+### 4. Casi d'Uso Comuni
+
+**Caso 1: Verificare il download di un software**
+Hai scaricato un programma da Internet. Il sito web fornisce un hash SHA-256 per il file di installazione.
+1.  Usa PyHasher per calcolare l'hash SHA-256 del file che hai scaricato.
+2.  Confronta il risultato con quello pubblicato sul sito.
+3.  Se i due hash corrispondono, il tuo download è perfetto e non è stato alterato.
+
+**Caso 2: Controllare un backup di dati**
+Hai copiato dei file importanti su un disco esterno. Vuoi essere sicuro che la copia sia identica all'originale.
+1.  Calcola gli hash (es. BLAKE2b) dei file originali.
+2.  Calcola gli hash dei file copiati sul disco esterno.
+3.  Se gli hash corrispondono, la copia è avvenuta senza errori.
+
+### 5. Domande Frequenti (FAQ)
+
+**D: Perché l'applicazione impiega del tempo con file molto grandi?**
+**R:** PyHasher deve leggere l'intero contenuto del file per calcolare gli hash. Per un file di diversi gigabyte, questa operazione richiede tempo. Tuttavia, il processo è ottimizzato per usare pochissima memoria RAM, quindi non bloccherà il tuo computer.
+
+**D: Posso calcolare l'hash di un'intera cartella?**
+**R:** No. La versione attuale di PyHasher è progettata per analizzare solo file singoli.
+
+**D: Perché sono inclusi MD5 e SHA-1 se sono considerati insicuri?**
+**R:** Sono mantenuti per motivi di compatibilità con sistemi o software più vecchi che potrebbero ancora utilizzarli. Per qualsiasi nuova esigenza di sicurezza, ti consigliamo di usare SHA-256 o algoritmi più recenti.

pyhasher/_version.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+# File generated by PyInstaller GUI Wrapper. DO NOT EDIT MANUALLY.
+# Contains build-time information scraped from Git (if available)
+# and a helper function to format version strings.
+
+import re
+
+# --- Version Data (Generated) ---
+__version__ = "v.0.0.0.1-0-gf0149af-dirty"
+GIT_COMMIT_HASH = "f0149af3b3d61c9959a5c14fbd2b8105ef333364"
+GIT_BRANCH = "master"
+BUILD_TIMESTAMP = "2025-08-25T06:19:22.500895+00:00"
+IS_GIT_REPO = True
+
+# --- Default Values (for comparison or fallback) ---
+DEFAULT_VERSION = "0.0.0+unknown"
+DEFAULT_COMMIT = "Unknown"
+DEFAULT_BRANCH = "Unknown"
+
+# --- Helper Function ---
+def get_version_string(format_string=None):
+    """
+    Returns a formatted string based on the build version information.
+
+    Args:
+        format_string (str, optional): A format string using placeholders.
+            Defaults to "{version} ({branch}/{commit_short})" if None.
+            Placeholders:
+                {{version}}: Full version string (e.g., 'v1.0.0-5-gabcdef-dirty')
+                {{tag}}: Clean tag part if exists (e.g., 'v1.0.0'), else DEFAULT_VERSION.
+                {{commit}}: Full Git commit hash.
+                {{commit_short}}: Short Git commit hash (7 chars).
+                {{branch}}: Git branch name.
+                {{dirty}}: '-dirty' if the repo was dirty, empty otherwise.
+                {{timestamp}}: Full build timestamp (ISO 8601 UTC).
+                {{timestamp_short}}: Build date only (YYYY-MM-DD).
+                {{is_git}}: 'Git' if IS_GIT_REPO is True, 'Unknown' otherwise.
+
+    Returns:
+        str: The formatted version string, or an error message if formatting fails.
+    """
+    if format_string is None:
+        format_string = "{version} ({branch}/{commit_short})"  # Default format
+
+    replacements = {}
+    try:
+        replacements['version'] = __version__ if __version__ else DEFAULT_VERSION
+        replacements['commit'] = GIT_COMMIT_HASH if GIT_COMMIT_HASH else DEFAULT_COMMIT
+        replacements['commit_short'] = GIT_COMMIT_HASH[:7] if GIT_COMMIT_HASH and len(GIT_COMMIT_HASH) >= 7 else DEFAULT_COMMIT
+        replacements['branch'] = GIT_BRANCH if GIT_BRANCH else DEFAULT_BRANCH
+        replacements['timestamp'] = BUILD_TIMESTAMP if BUILD_TIMESTAMP else "Unknown"
+        replacements['timestamp_short'] = BUILD_TIMESTAMP.split('T')[0] if BUILD_TIMESTAMP and 'T' in BUILD_TIMESTAMP else "Unknown"
+        replacements['is_git'] = "Git" if IS_GIT_REPO else "Unknown"
+        replacements['dirty'] = "-dirty" if __version__ and __version__.endswith('-dirty') else ""
+
+        tag = DEFAULT_VERSION
+        if __version__ and IS_GIT_REPO:
+            match = re.match(r'^(v?([0-9]+(?:\.[0-9]+)*))', __version__)
+            if match:
+                tag = match.group(1)
+        replacements['tag'] = tag
+
+        output_string = format_string
+        for placeholder, value in replacements.items():
+             pattern = re.compile(r'{{\s*' + re.escape(placeholder) + r'\s*}}')
+             output_string = pattern.sub(str(value), output_string)
+
+        if re.search(r'{\s*\w+\s*}', output_string):
+             pass # Or log a warning: print(f"Warning: Unreplaced placeholders found: {output_string}")
+
+        return output_string
+
+    except Exception as e:
+        return f"[Formatting Error: {e}]"

pyhasher/gui/gui.py

@@ -21,6 +21,26 @@ HASH_DISPLAY_ORDER = (
     "BLAKE2b",
 )
 
+# --- Import Version Info FOR THE WRAPPER ITSELF ---
+try:
+    # Use absolute import based on package name
+    from pyhasher import _version as wrapper_version
+
+    WRAPPER_APP_VERSION_STRING = f"{wrapper_version.__version__} ({wrapper_version.GIT_BRANCH}/{wrapper_version.GIT_COMMIT_HASH[:7]})"
+    WRAPPER_BUILD_INFO = f"Wrapper Built: {wrapper_version.BUILD_TIMESTAMP}"
+except ImportError:
+    # This might happen if you run the wrapper directly from source
+    # without generating its _version.py first (if you use that approach for the wrapper itself)
+    WRAPPER_APP_VERSION_STRING = "(Dev Wrapper)"
+    WRAPPER_BUILD_INFO = "Wrapper build time unknown"
+# --- End Import Version Info ---
+
+# --- Constants for Version Generation ---
+DEFAULT_VERSION = "0.0.0+unknown"
+DEFAULT_COMMIT = "Unknown"
+DEFAULT_BRANCH = "Unknown"
+# --- End Constants ---
+
 class PyHasherApp:
     """
     The main GUI application class for PyHasher.
@@ -34,7 +54,10 @@ class PyHasherApp:
             root_window: The main tkinter window.
         """
         self.root = root_window
-        self.root.title("PyHasher")
+        self.root.title(
+                f"PyHasher - {WRAPPER_APP_VERSION_STRING}"
+            )
+
         self.root.geometry("1024x400")  # Increased height for more hashes
         self.file_path = tk.StringVar()