Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,11 +74,11 @@ Detailed explanations:

## Current status

The project foundation and **Phases 1–8 are complete**. **Phase 9: External Libraries is in progress** with three reviewed-track chapters: [`pandas`](external-libraries/01-pandas/README.md), targeting pandas 3.0.x, [`openpyxl`](external-libraries/02-openpyxl/README.md), targeting openpyxl 3.1.x, and [`requests`](external-libraries/03-requests/README.md), targeting Requests 2.34.x.
The project foundation and **Phases 1–9 are complete**. **Phase 9: External Libraries** now contains four reviewed-track chapters: [`pandas`](external-libraries/01-pandas/README.md), [`openpyxl`](external-libraries/02-openpyxl/README.md), [`requests`](external-libraries/03-requests/README.md), and [`pytest`](external-libraries/04-pytest/README.md).

The phase now covers tabular-data transformation, Excel workbook automation, and HTTP/API consumption. Repository CI installs the explicit third-party contract in [`requirements-external.txt`](requirements-external.txt) before running approved examples.
The completed phase covers tabular-data transformation, Excel workbook automation, HTTP/API consumption, and automated testing. Repository CI installs the explicit third-party contract in [`requirements-external.txt`](requirements-external.txt) before running approved examples.

The next planned Phase 9 chapter is `pytest`. See the [External Libraries index](external-libraries/README.md), [roadmap](docs/roadmap.en.md), or [full learning path](docs/learning-path.en.md) for current status.
The next planned curriculum stage is **Phase 10: Practical Projects**. See the [External Libraries index](external-libraries/README.md), [roadmap](docs/roadmap.en.md), or [full learning path](docs/learning-path.en.md) for the completed Phase 9 record.

## Visual identity

Expand Down
6 changes: 3 additions & 3 deletions docs/learning-path.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,16 +115,16 @@ Phase 7 is complete with five reviewed chapters. Chapters 01–02 establish exce

Phase 8 is complete with nine reviewed chapters. The sequence moves from path modeling through time, structured data formats, runtime diagnostics, specialized containers, lazy iteration, decimal arithmetic, and finally operating-system and filesystem contracts. Chapter 09 closes the phase with environment state, path-like boundaries, deterministic scanning and traversal, metadata, copy/move/removal behavior, platform capabilities, and archive-safety decisions.

## Phase 9 · External Libraries 🚧
## Phase 9 · External Libraries

[Open the External Libraries section index](../external-libraries/README.md)

1. ✅ [`pandas`: Working with Tabular Data](../external-libraries/01-pandas/README.md)
2. ✅ [`openpyxl`: Automating Excel Workbooks](../external-libraries/02-openpyxl/README.md)
3. ✅ [`requests`: Consuming HTTP APIs](../external-libraries/03-requests/README.md)
4. `pytest`
4. ✅ [`pytest`: Engineering Automated Tests](../external-libraries/04-pytest/README.md)

Phase 9 is in progress. Chapter 01 establishes labeled/tabular data contracts with pandas 3.0.x. Chapter 02 adds openpyxl 3.1.x workbook automation. Chapter 03 adds Requests 2.34.x HTTP/API contracts: methods, query parameters, headers, JSON, timeouts, exception boundaries, Sessions, TLS verification, streaming, retries, secret redaction, pagination, and deterministic local-server testing.
Phase 9 is complete with four reviewed chapters. The sequence moves from tabular-data contracts through Excel workbook automation and HTTP/API clients, then closes with pytest 9.1.x automated-testing contracts: discovery, assertions, parametrization, fixtures, temporary resources, monkeypatching, capture, marks, deterministic isolation, and CI behavior.

## Phase 10 · Practical Projects ⏳

Expand Down
6 changes: 3 additions & 3 deletions docs/learning-path.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,16 +115,16 @@ La Fase 7 está completada con cinco capítulos revisados. Los Capítulos 01–0

La Fase 8 está completada con nueve capítulos revisados. La secuencia avanza desde modelado de rutas por tiempo, formatos estructurados de datos, diagnóstico en runtime, contenedores especializados, iteración lazy, aritmética decimal y finalmente contratos del sistema operativo y filesystem. El Capítulo 09 cierra la fase con estado del entorno, fronteras path-like, exploración y recorrido deterministas, metadatos, comportamiento de copia/movimiento/eliminación, capacidades de plataforma y decisiones de seguridad para archives.

## Fase 9 · Bibliotecas Externas 🚧
## Fase 9 · Bibliotecas Externas

[Abre el índice de la sección Bibliotecas Externas](../external-libraries/README.es.md)

1. ✅ [`pandas`: Trabajando con Datos Tabulares](../external-libraries/01-pandas/README.es.md)
2. ✅ [`openpyxl`: Automatizando Libros de Excel](../external-libraries/02-openpyxl/README.es.md)
3. ✅ [`requests`: Consumiendo APIs HTTP](../external-libraries/03-requests/README.es.md)
4. `pytest`
4. ✅ [`pytest`: Ingeniería de Pruebas Automatizadas](../external-libraries/04-pytest/README.es.md)

La Fase 9 está en progreso. El Capítulo 01 establece contratos de datos etiquetados/tabulares con pandas 3.0.x. El Capítulo 02 añade automatización de libros con openpyxl 3.1.x. El Capítulo 03 añade contratos HTTP/API con Requests 2.34.x: métodos, parámetros de query, headers, JSON, timeouts, fronteras de excepción, Sessions, verificación TLS, streaming, retries, redacción de secretos, paginación y pruebas deterministas con servidor local.
La Fase 9 está completada con cuatro capítulos revisados. La secuencia avanza desde contratos de datos tabulares por automatización de libros de Excel y clientes HTTP/API, y cierra con contratos de pruebas automatizadas en pytest 9.1.x: descubrimiento, assertions, parametrización, fixtures, recursos temporales, monkeypatching, captura, marks, aislamiento determinista y comportamiento en CI.

## Fase 10 · Proyectos Prácticos ⏳

Expand Down
6 changes: 3 additions & 3 deletions docs/learning-path.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,16 +115,16 @@ A Fase 7 está concluída com cinco capítulos revisados. Os Capítulos 01–02

A Fase 8 está concluída com nove capítulos revisados. A sequência avança de modelagem de caminhos por tempo, formatos estruturados de dados, diagnóstico em runtime, contêineres especializados, iteração lazy, aritmética decimal e finalmente contratos do sistema operacional e filesystem. O Capítulo 09 encerra a fase com estado do ambiente, fronteiras path-like, varredura e travessia determinísticas, metadados, comportamento de cópia/movimentação/remoção, capacidades de plataforma e decisões de segurança para archives.

## Fase 9 · Bibliotecas Externas 🚧
## Fase 9 · Bibliotecas Externas

[Abra o índice da seção Bibliotecas Externas](../external-libraries/README.pt-BR.md)

1. ✅ [`pandas`: Trabalhando com Dados Tabulares](../external-libraries/01-pandas/README.pt-BR.md)
2. ✅ [`openpyxl`: Automatizando Workbooks do Excel](../external-libraries/02-openpyxl/README.pt-BR.md)
3. ✅ [`requests`: Consumindo APIs HTTP](../external-libraries/03-requests/README.pt-BR.md)
4. `pytest`
4. ✅ [`pytest`: Engenharia de Testes Automatizados](../external-libraries/04-pytest/README.pt-BR.md)

A Fase 9 está em andamento. O Capítulo 01 estabelece contratos de dados rotulados/tabulares com pandas 3.0.x. O Capítulo 02 acrescenta automação de workbooks com openpyxl 3.1.x. O Capítulo 03 acrescenta contratos HTTP/API com Requests 2.34.x: métodos, parâmetros de query, headers, JSON, timeouts, fronteiras de exceção, Sessions, verificação TLS, streaming, retries, redação de segredos, paginação e testes determinísticos com servidor local.
A Fase 9 está concluída com quatro capítulos revisados. A sequência avança de contratos de dados tabulares por automação de workbooks do Excel e clientes HTTP/API, encerrando com contratos de testes automatizados em pytest 9.1.x: descoberta, assertions, parametrização, fixtures, recursos temporários, monkeypatching, captura, marks, isolamento determinístico e comportamento em CI.

## Fase 10 · Projetos Práticos ⏳

Expand Down
6 changes: 3 additions & 3 deletions docs/localized/README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,11 +74,11 @@ Explicaciones detalladas:

## Estado actual

La base del proyecto y las **Fases 1–8 están completadas**. La **Fase 9: Bibliotecas Externas está en progreso** con tres capítulos revisados de la ruta: [`pandas`](../../external-libraries/01-pandas/README.es.md), apuntando a pandas 3.0.x, [`openpyxl`](../../external-libraries/02-openpyxl/README.es.md), apuntando a openpyxl 3.1.x, y [`requests`](../../external-libraries/03-requests/README.es.md), apuntando a Requests 2.34.x.
La base del proyecto y las **Fases 1–9 están completadas**. La **Fase 9: Bibliotecas Externas** ahora contiene cuatro capítulos revisados de la ruta: [`pandas`](../../external-libraries/01-pandas/README.es.md), [`openpyxl`](../../external-libraries/02-openpyxl/README.es.md), [`requests`](../../external-libraries/03-requests/README.es.md) y [`pytest`](../../external-libraries/04-pytest/README.es.md).

La fase ahora cubre transformación de datos tabulares, automatización de libros de Excel y consumo HTTP/API. El CI del repositorio instala el contrato explícito de terceros en [`requirements-external.txt`](../../requirements-external.txt) antes de ejecutar los ejemplos aprobados.
La fase completada cubre transformación de datos tabulares, automatización de libros de Excel, consumo HTTP/API y pruebas automatizadas. El CI del repositorio instala el contrato explícito de terceros en [`requirements-external.txt`](../../requirements-external.txt) antes de ejecutar los ejemplos aprobados.

El siguiente capítulo planificado de la Fase 9 es `pytest`. Consulta el [índice de Bibliotecas Externas](../../external-libraries/README.es.md), el [roadmap](../roadmap.es.md) o la [ruta completa de aprendizaje](../learning-path.es.md) para el estado actualizado.
La siguiente etapa planificada del currículo es **Fase 10: Proyectos Prácticos**. Consulta el [índice de Bibliotecas Externas](../../external-libraries/README.es.md), el [roadmap](../roadmap.es.md) o la [ruta completa de aprendizaje](../learning-path.es.md) para el registro de la Fase 9 completada.

## Identidad visual

Expand Down
6 changes: 3 additions & 3 deletions docs/localized/README.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,11 +74,11 @@ Explicações detalhadas:

## Status atual

A fundação do projeto e as **Fases 1–8 estão concluídas**. A **Fase 9: Bibliotecas Externas está em andamento** com três capítulos revisados da trilha: [`pandas`](../../external-libraries/01-pandas/README.pt-BR.md), tendo pandas 3.0.x como alvo, [`openpyxl`](../../external-libraries/02-openpyxl/README.pt-BR.md), tendo openpyxl 3.1.x como alvo, e [`requests`](../../external-libraries/03-requests/README.pt-BR.md), tendo Requests 2.34.x como alvo.
A fundação do projeto e as **Fases 1–9 estão concluídas**. A **Fase 9: Bibliotecas Externas** agora contém quatro capítulos revisados da trilha: [`pandas`](../../external-libraries/01-pandas/README.pt-BR.md), [`openpyxl`](../../external-libraries/02-openpyxl/README.pt-BR.md), [`requests`](../../external-libraries/03-requests/README.pt-BR.md) e [`pytest`](../../external-libraries/04-pytest/README.pt-BR.md).

A fase agora cobre transformação de dados tabulares, automação de workbooks do Excel e consumo HTTP/API. O CI do repositório instala o contrato explícito de terceiros em [`requirements-external.txt`](../../requirements-external.txt) antes de executar os exemplos aprovados.
A fase concluída cobre transformação de dados tabulares, automação de workbooks do Excel, consumo HTTP/API e testes automatizados. O CI do repositório instala o contrato explícito de terceiros em [`requirements-external.txt`](../../requirements-external.txt) antes de executar os exemplos aprovados.

O próximo capítulo planejado da Fase 9 é `pytest`. Consulte o [índice de Bibliotecas Externas](../../external-libraries/README.pt-BR.md), o [roadmap](../roadmap.pt-BR.md) ou a [trilha completa de estudos](../learning-path.pt-BR.md) para o status atualizado.
A próxima etapa planejada do currículo é **Fase 10: Projetos Práticos**. Consulte o [índice de Bibliotecas Externas](../../external-libraries/README.pt-BR.md), o [roadmap](../roadmap.pt-BR.md) ou a [trilha completa de estudos](../learning-path.pt-BR.md) para o registro da Fase 9 concluída.

## Identidade visual

Expand Down
24 changes: 17 additions & 7 deletions docs/project-structure.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,16 +213,26 @@ python-study-guide/
│ │ ├── table_and_validation.py
│ │ ├── workbook_basics.py
│ │ └── write_only_export.py
│ └── 03-requests/
│ ├── 03-requests/
│ │ ├── README.md
│ │ ├── README.pt-BR.md
│ │ ├── README.es.md
│ │ └── examples/
│ │ ├── get_with_query.py
│ │ ├── http_error_handling.py
│ │ ├── post_json.py
│ │ ├── session_defaults.py
│ │ └── stream_download.py
│ └── 04-pytest/
│ ├── README.md
│ ├── README.pt-BR.md
│ ├── README.es.md
│ └── examples/
│ ├── get_with_query.py
│ ├── http_error_handling.py
│ ├── post_json.py
│ ├── session_defaults.py
│ └── stream_download.py
│ ├── assertions_and_parametrize.py
│ ├── capture_output_and_logs.py
│ ├── exceptions_and_warnings.py
│ ├── fixtures_and_tmp_path.py
│ └── monkeypatch_environment.py
├── functions/
│ ├── README.md
│ ├── README.pt-BR.md
Expand Down Expand Up @@ -558,7 +568,7 @@ python-study-guide/
- `docs/`: master learning paths, roadmaps, project architecture, localized project documents, policies, and responsible AI-assisted development guidance.
- `errors-files-and-modules/`: complete Phase 7 learning path. Chapters 01–05 cover runtime exception handling, deliberate raising and custom exceptions, safe text-file I/O with `open()` and `with`, TXT/CSV/JSON parsing and writing, and code organization through imports, modules, regular packages, execution context, and dependency design, in English, Brazilian Portuguese, and Spanish with deterministic executable examples.
- `exercises/`: focused practice activities connected to learning chapters.
- `external-libraries/`: Phase 9 learning path for third-party packages. It currently contains reviewed multilingual chapters for pandas 3.0.x, openpyxl 3.1.x, and Requests 2.34.x with fifteen deterministic executable examples in total; `pytest` is planned next.
- `external-libraries/`: complete Phase 9 learning path for third-party packages. It contains reviewed multilingual chapters for pandas 3.0.x, openpyxl 3.1.x, Requests 2.34.x, and pytest 9.1.x, with twenty deterministic executable examples in total. The phase covers tabular transformations, Excel workbook automation, HTTP/API clients, and automated-testing contracts; Phase 10 practical projects come next.
- `functions/`: complete Phase 5 learning path. Chapters 01–09 cover defining and calling functions, required inputs, returned values, scope and name lookup, type hints for function interfaces, default values including definition-time evaluation and mutable-default safety, variable-length positional and keyword argument collection with `*args` and `**kwargs`, composition through helper and coordinating functions with explicit dependencies and simple call graphs, and explicit data-flow tracing across calls including parameter bindings, rebinding versus mutation, `None`, tuple results, and return-based handoffs, in English, Brazilian Portuguese, and Spanish with deterministic executable examples.
- `fundamentals/`: complete Phase 1 learning path. Its six chapters teach how Python runs a program, how to use `print()` and `input()`, how assignment and naming work, how to recognize and inspect common built-in data types, and how to convert compatible values deliberately, with aligned multilingual explanations and executable examples.
- `practical-projects/`: future small projects combining several concepts.
Expand Down
24 changes: 17 additions & 7 deletions docs/project-structure.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,16 +213,26 @@ python-study-guide/
│ │ ├── table_and_validation.py
│ │ ├── workbook_basics.py
│ │ └── write_only_export.py
│ └── 03-requests/
│ ├── 03-requests/
│ │ ├── README.md
│ │ ├── README.pt-BR.md
│ │ ├── README.es.md
│ │ └── examples/
│ │ ├── get_with_query.py
│ │ ├── http_error_handling.py
│ │ ├── post_json.py
│ │ ├── session_defaults.py
│ │ └── stream_download.py
│ └── 04-pytest/
│ ├── README.md
│ ├── README.pt-BR.md
│ ├── README.es.md
│ └── examples/
│ ├── get_with_query.py
│ ├── http_error_handling.py
│ ├── post_json.py
│ ├── session_defaults.py
│ └── stream_download.py
│ ├── assertions_and_parametrize.py
│ ├── capture_output_and_logs.py
│ ├── exceptions_and_warnings.py
│ ├── fixtures_and_tmp_path.py
│ └── monkeypatch_environment.py
├── functions/
│ ├── README.md
│ ├── README.pt-BR.md
Expand Down Expand Up @@ -558,7 +568,7 @@ python-study-guide/
- `docs/`: rutas completas de aprendizaje, roadmaps, arquitectura del proyecto, documentos localizados, políticas y guía de desarrollo responsable asistido por IA.
- `errors-files-and-modules/`: ruta completa de la Fase 7. Los Capítulos 01–05 cubren manejo de excepciones en runtime, lanzamiento deliberado y excepciones personalizadas, I/O seguro de archivos de texto con `open()` y `with`, parsing y escritura de TXT/CSV/JSON y organización del código mediante imports, módulos, paquetes regulares, contexto de ejecución y diseño de dependencias, en inglés, portugués de Brasil y español con ejemplos ejecutables deterministas.
- `exercises/`: actividades prácticas relacionadas con los capítulos.
- `external-libraries/`: ruta de la Fase 9 para paquetes de terceros. Actualmente contiene capítulos multilingües revisados de pandas 3.0.x, openpyxl 3.1.x y Requests 2.34.x con quince ejemplos ejecutables deterministas en total; `pytest` es el siguiente planificado.
- `external-libraries/`: ruta completa de la Fase 9 para paquetes de terceros. Contiene capítulos multilingües revisados de pandas 3.0.x, openpyxl 3.1.x, Requests 2.34.x y pytest 9.1.x, con veinte ejemplos ejecutables deterministas en total. La fase cubre transformaciones tabulares, automatización de libros de Excel, clientes HTTP/API y contratos de pruebas automatizadas; la Fase 10 de proyectos prácticos viene a continuación.
- `functions/`: ruta completa de la Fase 5. Los Capítulos 01–09 cubren definición y llamada de funciones, entradas obligatorias, valores retornados, alcance y búsqueda de nombres, type hints para interfaces de funciones, valores predeterminados incluida la evaluación al definir la función y la seguridad con valores mutables, recolección de argumentos posicionales y por palabra clave de cantidad variable con `*args` y `**kwargs`, composición mediante funciones auxiliares y coordinadoras con dependencias explícitas y grafos simples de llamadas, y seguimiento explícito del flujo de datos entre llamadas, incluidos vínculos de parámetros, reasignación frente a mutación, `None`, resultados en tupla y traspasos mediante `return`, en inglés, portugués de Brasil y español, con ejemplos ejecutables determinísticos.
- `fundamentals/`: ruta completa de la Fase 1. Sus seis capítulos enseñan cómo Python ejecuta un programa, cómo usar `print()` e `input()`, cómo funcionan la asignación y los nombres, cómo reconocer e inspeccionar tipos de datos incorporados comunes y cómo convertir valores compatibles de forma deliberada, con explicaciones multilingües alineadas y ejemplos ejecutables.
- `practical-projects/`: futuros proyectos pequeños que combinarán varios conceptos.
Expand Down
Loading