A multilingual, practical guide for studying Python, understanding how its parts connect, and applying them through clear examples.
This project is designed both as a learning path and as a quick-reference library. Instead of presenting isolated commands, each topic explains what a resource does, why it exists, when to use it, when to avoid it, and how it works with other parts of Python.
Folder names, file names, variables, functions, classes, and other identifiers are written in English. This helps learners become familiar with conventions commonly found in libraries, technical documentation, and international software projects.
The explanations are available in English, Brazilian Portuguese, and Spanish.
Each chapter follows a consistent structure:
- What it is
- Why it exists
- Syntax and conventions
- When to use it
- When to avoid it
- How it connects to other resources
- Basic and practical examples
- Common mistakes
- Exercise
- Review checklist
- Quick-reference summary
The guide grows from Python fundamentals to functions, documentation, error handling, files, the standard library, external libraries, testing, and practical projects.
- Full learning path: direct links to every published chapter
- Roadmap in English
- Roadmap em Português
- Roadmap en Español
python-study-guide/
├── assets/
├── comments-and-documentation/
├── collections/
├── docs/
├── errors-files-and-modules/
├── exercises/
├── external-libraries/
├── functions/
├── fundamentals/
├── practical-projects/
├── program-flow/
├── scripts/
├── standard-library/
├── strings-and-numbers/
└── tests/
Detailed explanations:
The project foundation is complete. Phase 0 established the multilingual documentation, contribution workflow, collaboration templates, community standards, authorship, licensing, AI governance, automated quality checks, original visual identity, scalable repository structure, and final foundation audit.
The project foundation and six complete educational sections are available, and Phase 7: Errors, Files, and Modules is now in progress. Phase 1: Fundamentals provides six reviewed beginner chapters. Phase 6 contains six reviewed learning chapters:
- Comments in Python
- Docstrings in Python
- Meaningful Names and Self-Explanatory Code
- Task Markers and Technical Follow-up
- Comments versus Logging in Python
- PEP 8 and Readability in Python
Phases 1, 2, 3, 4, 5, and 6 are complete. Phase 7 now includes Handling Exceptions with try, except, else, and finally, which establishes specific handlers, success-only else, cleanup-oriented finally, propagation, and narrow failure boundaries, plus Raising and Custom Exceptions, which adds deliberate raise, built-in and custom exception selection, re-raising, explicit chaining, and the distinction between raise and assert. Phase 5: Functions contains nine reviewed chapters: Defining and Calling Functions, Parameters and Arguments, Return Values, Scope, Type Hints, Default Values, *args and **kwargs, Functions Working Together, and Data Flow Between Functions. Together they establish function definition and calling, required input flow, returned results, local and global scope, typed interfaces, safe optional inputs, intentionally flexible positional and keyword argument collection, composition through helpers and coordinators, and explicit caller-to-parameter-to-return data flow including rebinding versus mutation. Phase 4 remains complete with eight reviewed Program Flow chapters, ending with Choosing and Combining Program Flow. Phase 3 contains six reviewed Collections chapters, ending with Choosing the Right Collection. Phase 2 remains complete with four reviewed chapters, ending with Numeric Built-ins. See the roadmap or the full learning path for the current curriculum status and direct chapter links.
The project emblem connects Python, code, learning, and relationships between concepts through a geometric serpent, braces, an open book, and connected nodes.
See the visual identity guide for available assets, palette, meaning, accessibility guidance, and usage rules.
This project uses AI tools, including ChatGPT and Codex, to support planning, research, drafting, translation, review, and repository maintenance.
AI output is not accepted automatically. Every change must be understood, verified, and reviewed by the maintainer before it is incorporated into the main branch.
Repository-wide working instructions for AI agents and contributors are recorded in AGENTS.md. Read the AI-assisted development guide for the responsible workflow.
Python Study Guide was created and is maintained by Ramon Estevez Rodriguez.
Community contributions remain credited through commit metadata, Git history, and pull requests. Read the project authorship record for the complete attribution policy.
Participation is governed by the Code of Conduct. The Support Guide explains where different questions and requests belong. Potential vulnerabilities must follow the private process in the Security Policy.
Contributions, corrections, examples, and translation improvements are welcome. Read the contribution guide in English, Portuguese, or Spanish before opening a pull request.
This project is available under the MIT License.