Start Phase 9 with pandas

Author: RamonRDR

.github/workflows/quality-checks.yml

@@ -32,6 +32,9 @@ jobs:
       - name: Show Python version
         run: python --version
 
+      - name: Install external-library dependencies
+        run: python -m pip install --disable-pip-version-check -r requirements-external.txt
+
       - name: Compile Python files
         run: python -m compileall -q -x '(^|/)\.git/' .
 

README.md

@@ -74,9 +74,11 @@ Detailed explanations:
 
 ## Current status
 
-The project foundation and **Phases 1–8 are complete**. [Phase 8: Standard Library](standard-library/README.md) now contains nine reviewed chapters: [`pathlib`](standard-library/01-pathlib/README.md), [`datetime`](standard-library/02-datetime/README.md), [`json`](standard-library/03-json/README.md), [`csv`](standard-library/04-csv/README.md), [`logging`](standard-library/05-logging/README.md), [`collections`](standard-library/06-collections/README.md), [`itertools`](standard-library/07-itertools/README.md), [`decimal`](standard-library/08-decimal/README.md), and [`os` + `shutil`](standard-library/09-os-shutil/README.md).
+The project foundation and **Phases 1–8 are complete**. **Phase 9: External Libraries is now in progress** with its first reviewed-track chapter, [`pandas`](external-libraries/01-pandas/README.md), targeting pandas 3.0.x.
 
-Together, Phase 8 moves from path modeling through time, structured data, diagnostics, specialized containers, lazy iteration, decimal arithmetic, and finally operating-system/filesystem contracts for environment state, traversal, metadata, copy, move, removal, platform capabilities, and archive safety. Phase 9: External Libraries is the next planned curriculum phase. See the [roadmap](docs/roadmap.en.md) or the [full learning path](docs/learning-path.en.md) for direct chapter links and current status.
+The new phase adds an explicit third-party dependency contract through [`requirements-external.txt`](requirements-external.txt), and repository CI installs those dependencies before running approved examples. The pandas chapter covers labeled tabular data, indexes and alignment, dtypes, selection, pandas 3.0 Copy-on-Write, missing-data policy, vectorized transformations, grouping, validated joins, reshaping, and deterministic CSV pipelines.
+
+The next planned Phase 9 chapters are `openpyxl`, `requests`, and `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.
 
 ## Visual identity
 

docs/learning-path.en.md

@@ -115,9 +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 🚧
 
-Planned. Direct chapter links will appear here when the phase begins.
+[Open the External Libraries section index](../external-libraries/README.md)
+
+1. ✅ [`pandas`: Working with Tabular Data](../external-libraries/01-pandas/README.md)
+2. ⏳ `openpyxl`
+3. ⏳ `requests`
+4. ⏳ `pytest`
+
+Phase 9 is in progress. Chapter 01 establishes third-party dependency contracts and introduces labeled/tabular data with pandas 3.0.x: `Series`, `DataFrame`, indexes, label alignment, dtypes, selection, Copy-on-Write, missing data, vectorized transformations, grouping, validated joins, reshaping, and deterministic CSV pipelines.
 
 ## Phase 10 · Practical Projects ⏳
 

docs/learning-path.es.md

@@ -115,9 +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 🚧
 
-Planificado. Los enlaces directos a los capítulos aparecerán aquí cuando comience la fase.
+[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`
+3. ⏳ `requests`
+4. ⏳ `pytest`
+
+La Fase 9 está en progreso. El Capítulo 01 establece contratos de dependencias de terceros e introduce datos etiquetados/tabulares con pandas 3.0.x: `Series`, `DataFrame`, índices, alineación por labels, dtypes, selección, Copy-on-Write, datos ausentes, transformaciones vectorizadas, agrupaciones, joins validados, reshape y pipelines CSV deterministas.
 
 ## Fase 10 · Proyectos Prácticos ⏳
 

docs/learning-path.pt-BR.md

@@ -115,9 +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 🚧
 
-Planejado. Os links diretos dos capítulos aparecerão aqui quando a fase começar.
+[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`
+3. ⏳ `requests`
+4. ⏳ `pytest`
+
+A Fase 9 está em andamento. O Capítulo 01 estabelece contratos de dependências de terceiros e introduz dados rotulados/tabulares com pandas 3.0.x: `Series`, `DataFrame`, índices, alinhamento por labels, dtypes, seleção, Copy-on-Write, dados ausentes, transformações vetorizadas, agrupamentos, joins validados, reshape e pipelines CSV determinísticos.
 
 ## Fase 10 · Projetos Práticos ⏳
 

docs/localized/README.es.md

@@ -74,9 +74,11 @@ Explicaciones detalladas:
 
 ## Estado actual
 
-La base del proyecto y las **Fases 1–8 están completadas**. La [Fase 8: Biblioteca Estándar](../../standard-library/README.es.md) ahora reúne nueve capítulos revisados: [`pathlib`](../../standard-library/01-pathlib/README.es.md), [`datetime`](../../standard-library/02-datetime/README.es.md), [`json`](../../standard-library/03-json/README.es.md), [`csv`](../../standard-library/04-csv/README.es.md), [`logging`](../../standard-library/05-logging/README.es.md), [`collections`](../../standard-library/06-collections/README.es.md), [`itertools`](../../standard-library/07-itertools/README.es.md), [`decimal`](../../standard-library/08-decimal/README.es.md) y [`os` + `shutil`](../../standard-library/09-os-shutil/README.es.md).
+La base del proyecto y las **Fases 1–8 están completadas**. La **Fase 9: Bibliotecas Externas está ahora en progreso** con su primer capítulo de la ruta, [`pandas`](../../external-libraries/01-pandas/README.es.md), apuntando a pandas 3.0.x.
 
-En conjunto, los capítulos de la Fase 8 avanzan desde modelado de rutas por tiempo, datos estructurados, diagnóstico, contenedores especializados, iteración lazy, aritmética decimal y finalmente contratos de sistema operativo/filesystem para estado del entorno, recorrido, metadatos, copia, movimiento, eliminación, capacidades de plataforma y seguridad de archives. La Fase 9: Bibliotecas Externas es la siguiente fase planificada. Consulta el [roadmap](../roadmap.es.md) o la [ruta completa de aprendizaje](../learning-path.es.md) para enlaces directos y estado actualizado.
+La nueva fase añade un contrato explícito de dependencias de terceros mediante [`requirements-external.txt`](../../requirements-external.txt), y el CI del repositorio instala esas dependencias antes de ejecutar los ejemplos aprobados. El capítulo de pandas cubre datos tabulares etiquetados, índices y alineación, dtypes, selección, Copy-on-Write de pandas 3.0, política de datos ausentes, transformaciones vectorizadas, agrupaciones, joins validados, reshape y pipelines CSV deterministas.
+
+Los siguientes capítulos planificados de la Fase 9 son `openpyxl`, `requests` y `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.
 
 ## Identidad visual
 

docs/localized/README.pt-BR.md

@@ -74,9 +74,11 @@ Explicações detalhadas:
 
 ## Status atual
 
-A fundação do projeto e as **Fases 1–8 estão concluídas**. A [Fase 8: Biblioteca Padrão](../../standard-library/README.pt-BR.md) agora reúne nove capítulos revisados: [`pathlib`](../../standard-library/01-pathlib/README.pt-BR.md), [`datetime`](../../standard-library/02-datetime/README.pt-BR.md), [`json`](../../standard-library/03-json/README.pt-BR.md), [`csv`](../../standard-library/04-csv/README.pt-BR.md), [`logging`](../../standard-library/05-logging/README.pt-BR.md), [`collections`](../../standard-library/06-collections/README.pt-BR.md), [`itertools`](../../standard-library/07-itertools/README.pt-BR.md), [`decimal`](../../standard-library/08-decimal/README.pt-BR.md) e [`os` + `shutil`](../../standard-library/09-os-shutil/README.pt-BR.md).
+A fundação do projeto e as **Fases 1–8 estão concluídas**. A **Fase 9: Bibliotecas Externas agora está em andamento** com seu primeiro capítulo da trilha, [`pandas`](../../external-libraries/01-pandas/README.pt-BR.md), tendo pandas 3.0.x como alvo.
 
-Juntos, os capítulos da Fase 8 avançam de modelagem de caminhos por tempo, dados estruturados, diagnóstico, contêineres especializados, iteração lazy, aritmética decimal e finalmente contratos de sistema operacional/filesystem para estado do ambiente, travessia, metadados, cópia, movimentação, remoção, capacidades de plataforma e segurança de archives. A Fase 9: Bibliotecas Externas é a próxima fase planejada. Consulte o [roadmap](../roadmap.pt-BR.md) ou a [trilha completa de estudos](../learning-path.pt-BR.md) para links diretos e status atualizado.
+A nova fase acrescenta um contrato explícito de dependências de terceiros por meio de [`requirements-external.txt`](../../requirements-external.txt), e o CI do repositório instala essas dependências antes de executar os exemplos aprovados. O capítulo de pandas cobre dados tabulares rotulados, índices e alinhamento, dtypes, seleção, Copy-on-Write do pandas 3.0, política de dados ausentes, transformações vetorizadas, agrupamentos, joins validados, reshape e pipelines CSV determinísticos.
+
+Os próximos capítulos planejados da Fase 9 são `openpyxl`, `requests` e `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.
 
 ## Identidade visual
 

docs/project-structure.en.md

@@ -19,6 +19,7 @@ python-study-guide/
 ├── CONTRIBUTING.md
 ├── LICENSE
 ├── README.md
+├── requirements-external.txt
 ├── SECURITY.md
 ├── SUPPORT.md
 ├── assets/
@@ -189,6 +190,19 @@ python-study-guide/
 │               └── formatting.py
 ├── exercises/
 ├── external-libraries/
+│   ├── README.md
+│   ├── README.pt-BR.md
+│   ├── README.es.md
+│   └── 01-pandas/
+│       ├── README.md
+│       ├── README.pt-BR.md
+│       ├── README.es.md
+│       └── examples/
+│           ├── csv_pipeline.py
+│           ├── dataframe_basics.py
+│           ├── filter_and_assign.py
+│           ├── groupby_summary.py
+│           └── merge_tables.py
 ├── functions/
 │   ├── README.md
 │   ├── README.pt-BR.md
@@ -524,7 +538,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/`: future guides to third-party packages.
+- `external-libraries/`: Phase 9 learning path for third-party packages. It currently contains the multilingual pandas 3.0.x chapter and five deterministic executable examples, with `openpyxl`, `requests`, and `pytest` planned 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.

docs/project-structure.es.md

@@ -19,6 +19,7 @@ python-study-guide/
 ├── CONTRIBUTING.md
 ├── LICENSE
 ├── README.md
+├── requirements-external.txt
 ├── SECURITY.md
 ├── SUPPORT.md
 ├── assets/
@@ -189,6 +190,19 @@ python-study-guide/
 │               └── formatting.py
 ├── exercises/
 ├── external-libraries/
+│   ├── README.md
+│   ├── README.pt-BR.md
+│   ├── README.es.md
+│   └── 01-pandas/
+│       ├── README.md
+│       ├── README.pt-BR.md
+│       ├── README.es.md
+│       └── examples/
+│           ├── csv_pipeline.py
+│           ├── dataframe_basics.py
+│           ├── filter_and_assign.py
+│           ├── groupby_summary.py
+│           └── merge_tables.py
 ├── functions/
 │   ├── README.md
 │   ├── README.pt-BR.md
@@ -524,7 +538,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/`: futuras guías sobre paquetes de terceros.
+- `external-libraries/`: ruta de la Fase 9 para paquetes de terceros. Actualmente contiene el capítulo multilingüe de pandas 3.0.x y cinco ejemplos ejecutables deterministas, con `openpyxl`, `requests` y `pytest` planificados 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.