"If you didn't read the docs, you are just guessing."
::: info
Questa pagina centralizza i riferimenti ufficiali per lo sviluppo in Python e C++. L'obiettivo è fornire un accesso rapido alle specifiche dei linguaggi, alle librerie standard e alle convenzioni di codifica adottate a livello internazionale.
:::
Python è celebre per la sua documentazione chiara ed esaustiva. Ecco i pilastri fondamentali:
¶ 1. Core Language & Standard Library
- Python 3.x Official Docs: La bibbia completa. Include tutorial, reference del linguaggio e la documentazione di ogni modulo della Standard Library.
- Python Language Reference: Descrive la sintassi e la "core semantics" del linguaggio. Fondamentale per capire come funzionano gli oggetti sotto il cofano.
¶ 2. Standards & Style (PEPs)
- PEP 8 - Style Guide for Python Code: Lo standard per scrivere codice leggibile e professionale. Obbligatorio per ogni progetto in questo Wiki.
- PEP Index: L'indice di tutte le Python Enhancement Proposals. Utile per seguire l'evoluzione del linguaggio (es. Type Hinting, Pattern Matching).
Il C++ non ha un'unica "casa" come Python, poiché è uno standard ISO gestito da diversi comitati e implementato da diversi compilatori.
- Cppreference.com: Il riferimento più completo e aggiornato per C++11, 14, 17, 20 e 23. È lo strumento quotidiano di ogni sviluppatore C++.
- Standard C++ (isocpp.org): Il portale della fondazione che gestisce lo standard. Qui si trovano le news ufficiali e lo stato dei lavori sui nuovi standard.
- C++ Core Guidelines (GitHub): Curate da Bjarne Stroustrup e Herb Sutter. Sono una serie di regole per scrivere Modern C++ sicuro ed efficiente, evitando i problemi di gestione memoria del passato.
Dato che il nostro workflow prevede l'integrazione tra i due linguaggi:
- pybind11 Docs: La libreria standard per creare binding C++ per Python in modo semplice e performante.
- Python C API: Documentazione di basso livello per interfacciarsi direttamente con l'interprete CPython.
Prima di implementare nel progetto locale, usa questi tool per testare snippet di documentazione:
| Tool |
Scopo |
Link |
| Compiler Explorer |
Analisi Assembly C++ (Godbolt) |
Link |
| Python Tutor |
Visualizzazione esecuzione Python |
Link |
| Google Colab |
Sandbox Python via Browser |
Link |
graph TD
A[Problema Tecnico] --> B{Dove cerco?}
B --> C[1. Documentazione Ufficiale]
C --> D[2. C++ Core Guidelines / PEP]
D --> E[3. GitHub Issues / Source Code]
E --> F[4. StackOverflow / Blog]
style C fill:#f9f,stroke:#333,stroke-width:4px
Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #Documentation #Python #CPP #Standard #Programming