Metadata-Version: 2.1
Name: instrument_connector
Version: 0.1.0
Summary: A Python library to connect to instruments via PyVISA
Author: Federico Guerra
Author-email: 
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyvisa

# instrument_connector

**instrument_connector** Ã¨ una libreria Python che semplifica la connessione a strumenti via PyVISA. La libreria fornisce un'interfaccia facile da usare per cercare, connettersi e gestire strumenti di misura utilizzando comandi standard.

## FunzionalitÃ 

- Connessione automatica a strumenti tramite modello, IDN o indirizzo.
- Lista di tutte le risorse disponibili con dettagli IDN (se supportati).
- Configurazione opzionale della verbositÃ  per abilitare/disabilitare i messaggi di debug.
- Gestione delle eccezioni personalizzata per rilevare errori di connessione.

## Installazione

Puoi installare la libreria direttamente con pip:

```bash
pip install instrument_connector
```

Se stai sviluppando localmente, puoi installarla in modalitÃ  editabile:

```bash
pip install -e .
```

## Utilizzo

### 1. Connessione a uno strumento

Puoi connetterti a uno strumento specificando il modello o un IDN parziale:

```python
import instrument_connector

try:
    # Connetti allo strumento specificando un modello
    instrument = instrument_connector.connect_to_instrument("2380")
    print("Connected to the instrument successfully!")
    print("Instrument IDN:", instrument.query("*IDN?"))
except instrument_connector.InstrumentConnectionError as e:
    print(f"Failed to connect: {e}")
```

### 2. Lista delle risorse disponibili

Per elencare tutte le risorse disponibili e ottenere informazioni sui dispositivi connessi:

```python
resources = instrument_connector.list_available_resources()
print("Available resources:")
for resource in resources:
    print(f"Address: {resource['address']}, IDN: {resource['idn']}")
```

### 3. Abilitare o disabilitare i messaggi di debug

Puoi configurare la libreria per stampare messaggi di debug durante l'esecuzione:

```python
instrument_connector.set_verbosity(True)  # Abilita messaggi di debug
instrument_connector.set_verbosity(False) # Disabilita messaggi di debug
```

## Dipendenze

La libreria richiede **PyVISA** per la gestione della connessione agli strumenti:

```bash
pip install pyvisa
```

## Licenza

Questo progetto Ã¨ distribuito sotto licenza MIT. Consulta il file [LICENSE](./LICENSE) per i dettagli.
