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
3 changes: 3 additions & 0 deletions .github/workflows/quality-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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/' .

Expand Down
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
11 changes: 9 additions & 2 deletions docs/learning-path.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 ⏳

Expand Down
11 changes: 9 additions & 2 deletions docs/learning-path.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 ⏳

Expand Down
11 changes: 9 additions & 2 deletions docs/learning-path.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 ⏳

Expand Down
6 changes: 4 additions & 2 deletions docs/localized/README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 4 additions & 2 deletions docs/localized/README.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
16 changes: 15 additions & 1 deletion docs/project-structure.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ python-study-guide/
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── requirements-external.txt
├── SECURITY.md
├── SUPPORT.md
├── assets/
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down
16 changes: 15 additions & 1 deletion docs/project-structure.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ python-study-guide/
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── requirements-external.txt
├── SECURITY.md
├── SUPPORT.md
├── assets/
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down
Loading