Home - matifaro/pandas GitHub Wiki

🐼 matifaro/pandas

This repository is a custom fork of the official [pandas] project — a powerful, flexible, and high-performance open-source library for data analysis and manipulation in Python.

📘 Educational Purpose: This fork is maintained as part of a graduate-level project for the course Comprehension and Evolution of Software, in the Master’s in Software Engineering program. It is intended for studying the structure, evolution, maintainability, and extensibility of a large, real-world software system.

👥 Maintainers and Self-Assessment

This fork is maintained for academic purposes by:

Cláudia Moreira (202107100) @claudmoreira(https://github.com/claudmoreira) - 33%
Isabel Moutinho (202108767) @isabelmoutinho(https://github.com/isabelmoutinho) - 33%
Matilde Faro (202108853) @matifaro(https://github.com/matifaro) - 33%

🎯 Project Goals

This fork is used to:

Analyze and assess the maintainability of a widely-used open-source library.
Study the evolution of its architecture and contributions over time.
Prototype and evaluate experimental features or local modifications.
Gain hands-on experience with Cython extensions, CI tooling, and contributor workflows.

If you're looking for the official, production-ready pandas library, go to [pandas-dev/pandas].

📦 Installation

To install and run this fork locally:

git clone https://github.com/matifaro/pandas.git
cd pandas
pip install -r requirements-dev.txt
python setup.py develop

⚠️ Note: This fork may not be compatible with all PyPI-based tools or environments. Use in isolated, experimental setups.

🛠 Development Quickstart

The structure of this repository mirrors the upstream pandas project.

# Create and activate dev environment (using conda recommended)
conda env create -f environment.yml
conda activate pandas-dev

# Build extension modules
python setup.py build_ext --inplace

# Run test suite
pytest pandas

For more details, see the [official pandas contributing guide](https://pandas.pydata.org/docs/dev/development/contributing.html).

🤝 Contributions

This fork is not intended for public contributions, but we welcome feedback from peers and instructors.

If you're a student or reviewer:

Open an issue if you have feedback on the structure or documentation.
Refer to our [Improved README Draft](README_improved.md) for a proposed revision.

📄 License

This repository is licensed under the same terms as the upstream [pandas project](https://github.com/pandas-dev/pandas), available under the [BSD 3-Clause License](https://github.com/pandas-dev/pandas/blob/main/LICENSE).