From 5d7d08f9c159883af39b9fadfc6c82b340fdc3e5 Mon Sep 17 00:00:00 2001 From: mya Date: Wed, 29 Jan 2025 18:40:52 -0500 Subject: [PATCH 1/7] Added issue tracking to team contrib --- docs/projMngmnt/Rev0_Team_Contrib.tex | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 47167b00..7148fb45 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -166,11 +166,11 @@ \section{Issue Tracker} \toprule \textbf{Student} & \textbf{Authored (O+C)} & \textbf{Assigned (C only)}\\ \midrule -Name 1 & Num & Num \\ -Name 2 & Num & Num \\ -Name 3 & Num & Num \\ -Name 4 & Num & Num \\ -Name 5 & Num & Num \\ +Tanveer Brar & 10 & 67 \\ +Mya Hussain & 18 & 70 \\ +Ayushi Amin & 20 & 79 \\ +Sevhena Walker & 106 & 96 \\ +Nivetha Kuruparan & 35 & 76 \\ \bottomrule \end{tabular} \end{table} From 75e74e0292dd9715d587c9b6a3d64c11a94cbf77 Mon Sep 17 00:00:00 2001 From: tbrar06 Date: Wed, 29 Jan 2025 19:11:34 -0500 Subject: [PATCH 2/7] Added team meeting, supervisor meeting and lecture attendance --- docs/projMngmnt/Rev0_Team_Contrib.tex | 43 +++++++++++++++------------ 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 7148fb45..2f0c38b6 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -28,6 +28,8 @@ \section{Demo Plans} \section{Team Meeting Attendance} +Our team stays in touch regularly through Discord and schedules a meeting when detailed discussion is needed. Below is the attendance of all format meetings that have taken place. + \wss{For each team member how many team meetings have they attended over the time period of interest. This number should be determined from the meeting issues in the team's repo. The first entry in the table should be the total @@ -39,12 +41,12 @@ \section{Team Meeting Attendance} \toprule \textbf{Student} & \textbf{Meetings}\\ \midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ +Total & 3\\ +Sevhena Walker & 3\\ +Mya Hussain & 3\\ +Ayushi Amin & 3\\ +Nivetha Kuruparan & 3\\ +Tanveer Brar & 3\\ \bottomrule \end{tabular} \end{table} @@ -60,18 +62,20 @@ \section{Supervisor/Stakeholder Meeting Attendance} team. If there is no supervisor, there will usually be meetings with stakeholders (potential users) that can serve a similar purpose.} +We prioritize having in person meetings with our supervisor Dr David to be able to effectively communicate our progress and concerns. We have a weekly slot open with the supervisor, but in case there is little to discuss, the meeting is cancelled for the week and our progress is communicated via Discord. + \begin{table}[H] \centering \begin{tabular}{ll} \toprule \textbf{Student} & \textbf{Meetings}\\ \midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ +Total & 4\\ +Sevhena Walker & 4\\ +Mya Hussain & 4\\ +Ayushi Amin & 4\\ +Nivetha Kuruparan & 4\\ +Tanveer Brar & 4\\ \bottomrule \end{tabular} \end{table} @@ -80,6 +84,8 @@ \section{Supervisor/Stakeholder Meeting Attendance} \section{Lecture Attendance} +We aim to have at least one person attend the lecture so the team is upto date with all information. In the rare case that no one goes to the lecture, we update through the lecture slides. + \wss{For each team member how many lectures have they attended over the time period of interest. This number should be determined from the lecture issues in the team's repo. The first entry in the table should be the total number of @@ -91,18 +97,17 @@ \section{Lecture Attendance} \toprule \textbf{Student} & \textbf{Lectures}\\ \midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ +Total & 2\\ +Sevhena Walker & 1\\ +Mya Hussain & 0\\ +Ayushi Amin & 0\\ +Nivetha Kuruparan & 0\\ +Tanveer Brar & 0\\ \bottomrule \end{tabular} \end{table} \wss{If needed, an explanation for the lecture attendance can be provided here.} - \section{TA Document Discussion Attendance} \wss{For each team member how many of the informal document discussion meetings From c57146936f0b9b67a1df45aa5cb25e6125929928 Mon Sep 17 00:00:00 2001 From: Sevhena Walker <83547364+Sevhena@users.noreply.github.com> Date: Wed, 29 Jan 2025 19:14:14 -0500 Subject: [PATCH 3/7] Added CI/CD section #361 --- docs/projMngmnt/Rev0_Team_Contrib.tex | 214 +++++++++++++++----------- 1 file changed, 120 insertions(+), 94 deletions(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 47167b00..c9a09581 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -29,24 +29,24 @@ \section{Demo Plans} \section{Team Meeting Attendance} \wss{For each team member how many team meetings have they attended over the -time period of interest. This number should be determined from the meeting -issues in the team's repo. The first entry in the table should be the total + time period of interest. This number should be determined from the meeting + issues in the team's repo. The first entry in the table should be the total number of team meetings held by the team.} \begin{table}[H] -\centering -\begin{tabular}{ll} -\toprule -\textbf{Student} & \textbf{Meetings}\\ -\midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{ll} + \toprule + \textbf{Student} & \textbf{Meetings}\\ + \midrule + Total & Num\\ + Name 1 & Num\\ + Name 2 & Num\\ + Name 3 & Num\\ + Name 4 & Num\\ + Name 5 & Num\\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the counts can be provided here.} @@ -54,26 +54,27 @@ \section{Team Meeting Attendance} \section{Supervisor/Stakeholder Meeting Attendance} \wss{For each team member how many supervisor/stakeholder team meetings have -they attended over the time period of interest. This number should be determined -from the supervisor meeting issues in the team's repo. The first entry in the -table should be the total number of supervisor and team meetings held by the -team. If there is no supervisor, there will usually be meetings with + they attended over the time period of interest. This number should + be determined + from the supervisor meeting issues in the team's repo. The first entry in the + table should be the total number of supervisor and team meetings held by the + team. If there is no supervisor, there will usually be meetings with stakeholders (potential users) that can serve a similar purpose.} \begin{table}[H] -\centering -\begin{tabular}{ll} -\toprule -\textbf{Student} & \textbf{Meetings}\\ -\midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{ll} + \toprule + \textbf{Student} & \textbf{Meetings}\\ + \midrule + Total & Num\\ + Name 1 & Num\\ + Name 2 & Num\\ + Name 3 & Num\\ + Name 4 & Num\\ + Name 5 & Num\\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the counts can be provided here.} @@ -81,24 +82,25 @@ \section{Supervisor/Stakeholder Meeting Attendance} \section{Lecture Attendance} \wss{For each team member how many lectures have they attended over the time -period of interest. This number should be determined from the lecture issues in -the team's repo. The first entry in the table should be the total number of + period of interest. This number should be determined from the + lecture issues in + the team's repo. The first entry in the table should be the total number of lectures since the beginning of the term.} \begin{table}[H] -\centering -\begin{tabular}{ll} -\toprule -\textbf{Student} & \textbf{Lectures}\\ -\midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{ll} + \toprule + \textbf{Student} & \textbf{Lectures}\\ + \midrule + Total & Num\\ + Name 1 & Num\\ + Name 2 & Num\\ + Name 3 & Num\\ + Name 4 & Num\\ + Name 5 & Num\\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the lecture attendance can be provided here.} @@ -109,19 +111,19 @@ \section{TA Document Discussion Attendance} with the TA were attended over the time period of interest.} \begin{table}[H] -\centering -\begin{tabular}{ll} -\toprule -\textbf{Student} & \textbf{Lectures}\\ -\midrule -Total & Num\\ -Name 1 & Num\\ -Name 2 & Num\\ -Name 3 & Num\\ -Name 4 & Num\\ -Name 5 & Num\\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{ll} + \toprule + \textbf{Student} & \textbf{Lectures}\\ + \midrule + Total & Num\\ + Name 1 & Num\\ + Name 2 & Num\\ + Name 3 & Num\\ + Name 4 & Num\\ + Name 5 & Num\\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the attendance can be provided here.} @@ -129,50 +131,54 @@ \section{TA Document Discussion Attendance} \section{Commits} \wss{For each team member how many commits to the main branch have been made -over the time period of interest. The total is the total number of commits for -the entire team since the beginning of the term. The percentage is the + over the time period of interest. The total is the total number of + commits for + the entire team since the beginning of the term. The percentage is the percentage of the total commits made by each team member.} \begin{table}[H] -\centering -\begin{tabular}{lll} -\toprule -\textbf{Student} & \textbf{Commits} & \textbf{Percent}\\ -\midrule -Total & Num & 100\% \\ -Name 1 & Num & \% \\ -Name 2 & Num & \% \\ -Name 3 & Num & \% \\ -Name 4 & Num & \% \\ -Name 5 & Num & \% \\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{lll} + \toprule + \textbf{Student} & \textbf{Commits} & \textbf{Percent}\\ + \midrule + Total & Num & 100\% \\ + Name 1 & Num & \% \\ + Name 2 & Num & \% \\ + Name 3 & Num & \% \\ + Name 4 & Num & \% \\ + Name 5 & Num & \% \\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the counts can be provided here. For -instance, if a team member has more commits to unmerged branches, these numbers -can be provided here. If multiple people contribute to a commit, git allows for + instance, if a team member has more commits to unmerged branches, + these numbers + can be provided here. If multiple people contribute to a commit, + git allows for multi-author commits.} \section{Issue Tracker} \wss{For each team member how many issues have they authored (including open and -closed issues (O+C)) and how many have they been assigned (only counting closed + closed issues (O+C)) and how many have they been assigned (only + counting closed issues (C only)) over the time period of interest.} \begin{table}[H] -\centering -\begin{tabular}{lll} -\toprule -\textbf{Student} & \textbf{Authored (O+C)} & \textbf{Assigned (C only)}\\ -\midrule -Name 1 & Num & Num \\ -Name 2 & Num & Num \\ -Name 3 & Num & Num \\ -Name 4 & Num & Num \\ -Name 5 & Num & Num \\ -\bottomrule -\end{tabular} + \centering + \begin{tabular}{lll} + \toprule + \textbf{Student} & \textbf{Authored (O+C)} & \textbf{Assigned (C only)}\\ + \midrule + Name 1 & Num & Num \\ + Name 2 & Num & Num \\ + Name 3 & Num & Num \\ + Name 4 & Num & Num \\ + Name 5 & Num & Num \\ + \bottomrule + \end{tabular} \end{table} \wss{If needed, an explanation for the counts can be provided here.} @@ -181,7 +187,27 @@ \section{CICD} \wss{Say how CICD is used in your project} -\wss{If your team has additional metrics of productivity, please feel free to -add them to this report.} - -\end{document} \ No newline at end of file +CI/CD was implemented in the project to automate essential +development and documentation tasks, improving efficiency and +maintaining code quality. The project utilises GitHub Actions +workflows to enforce coding standards, validate changes, and ensure +documentation integrity. + +A dedicated workflow formats and compiles \LaTeX{} documents whenever +changes are made to \texttt{.tex} files or their dependencies. This ensures that +only high quality documentation is pushed to the main branch. + +Another workflow is responsible for maintaining code consistency and +adhering to best practices. It uses \texttt{ruff} to lint and format +\texttt{.py} files, identifying potential issues such as syntax +errors, unused imports, and style inconsistencies. This workflow +allows the python scripts to be written with a uniform coding style. + +The final workflow ensures the correctness of the codebase. It runs +\texttt{pytest} to execute unit and integration tests, validating the +expected behaviour of the software. Additionally, it includes a code +coverage check, ensuring that newly introduced or modified code is +adequately tested. This helps prevent regressions and maintain the +reliability of the project. + +\end{document} From 48dc06936519a27aeb160069948e83948d5ad144 Mon Sep 17 00:00:00 2001 From: Ayushi Amin Date: Wed, 29 Jan 2025 20:38:13 -0500 Subject: [PATCH 4/7] Added sections 5,6 for #361 --- docs/projMngmnt/Rev0_Team_Contrib.tex | 32 ++++++++++++--------------- 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index bc3f7770..eea3777d 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -129,12 +129,12 @@ \section{TA Document Discussion Attendance} \toprule \textbf{Student} & \textbf{Lectures}\\ \midrule - Total & Num\\ - Name 1 & Num\\ - Name 2 & Num\\ - Name 3 & Num\\ - Name 4 & Num\\ - Name 5 & Num\\ + Total & 2\\ + Sevhena Walker & 2 \\ + Mya Hussain & 2 \\ + Ayushi Amin & 2 \\ + Nivetha Kuruparan & 2 \\ + Tanveer Brar & 2 \\ \bottomrule \end{tabular} \end{table} @@ -155,22 +155,18 @@ \section{Commits} \toprule \textbf{Student} & \textbf{Commits} & \textbf{Percent}\\ \midrule - Total & Num & 100\% \\ - Name 1 & Num & \% \\ - Name 2 & Num & \% \\ - Name 3 & Num & \% \\ - Name 4 & Num & \% \\ - Name 5 & Num & \% \\ + Total & 662 & 100\% \\ + Sevhena Walker & 277 & 41.8429\% \\ + Mya Hussain & 78 & 11.782485\% \\ + Ayushi Amin & 129 & 19.4864\% \\ + Nivetha Kuruparan & 102 & 15.407855\% \\ + Tanveer Brar & 76 & 11.48036\% \\ \bottomrule \end{tabular} \end{table} -\wss{If needed, an explanation for the counts can be provided here. For - instance, if a team member has more commits to unmerged branches, - these numbers - can be provided here. If multiple people contribute to a commit, - git allows for -multi-author commits.} +The number of commits does not necessarily reflect the amount of work done by each team member. Some members prefer to make frequent small commits while others make fewer but larger commits that include multiple changes. +Additionally, pair programming sessions often only let one person make the commit so it would only be under their name. \section{Issue Tracker} From 8002c8f1b11ba4765b97c92abab28e56368506d0 Mon Sep 17 00:00:00 2001 From: mya Date: Wed, 29 Jan 2025 21:01:49 -0500 Subject: [PATCH 5/7] Fixed issue tracking to team contrib --- docs/projMngmnt/Rev0_Team_Contrib.tex | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 7148fb45..a9a94f13 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -166,17 +166,17 @@ \section{Issue Tracker} \toprule \textbf{Student} & \textbf{Authored (O+C)} & \textbf{Assigned (C only)}\\ \midrule -Tanveer Brar & 10 & 67 \\ -Mya Hussain & 18 & 70 \\ -Ayushi Amin & 20 & 79 \\ -Sevhena Walker & 106 & 96 \\ -Nivetha Kuruparan & 35 & 76 \\ +Tanveer Brar & 1 & 47 \\ +Mya Hussain & 8 & 51 \\ +Ayushi Amin & 8 & 58 \\ +Sevhena Walker & 81 & 72 \\ +Nivetha Kuruparan & 17 & 53 \\ \bottomrule \end{tabular} \end{table} -\wss{If needed, an explanation for the counts can be provided here.} - +Counts are considered by taking the total counts over the year and subtracting the counts at the time of the POC Team Contribution. This is the period of intrest. +We did a lot of work over the winter break to exclude that period and only do "this term" would inaccurately represent the counts. \section{CICD} \wss{Say how CICD is used in your project} From fc55300845897e989b7b190b59ee00b1674c058c Mon Sep 17 00:00:00 2001 From: Nivetha Kuruparan Date: Wed, 29 Jan 2025 21:41:29 -0500 Subject: [PATCH 6/7] Added rev0 demo plans --- docs/projMngmnt/Rev0_Team_Contrib.tex | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 47717802..67d73dd9 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -24,7 +24,17 @@ \section{Demo Plans} -\wss{What will you be demonstrating} +For our \textbf{Rev 0 demonstration}, we will showcase the core functionality and usability of our \textbf{energy-efficient Python code refactoring tool}. This demonstration will highlight the following key aspects: + +\begin{enumerate} + + \item \textbf{Code Smell Detection:} We will demonstrate how our tool identifies inefficient coding patterns (\textit{code smells}) in Python source code that contribute to higher energy consumption. + \item \textbf{Automated Refactoring:} Our tool will apply targeted refactorings to optimize the detected code smells, improving energy efficiency. + \item \textbf{Energy Consumption Measurement:} Using \texttt{CodeCarbon}, we will measure and compare the energy consumption of the original code versus the refactored version, providing clear insights into energy savings. + \item \textbf{Functionality Preservation:} To ensure that optimizations do not alter program behaviour, we will run the original test suite against both the unoptimized and refactored versions. + \item \textbf{VS Code Integration:} We will showcase our \textbf{VS Code plugin}, where users can analyze a Python file for code smells, choose specific optimizations, and preview the refactored code with energy measurements. Users will have the option to accept or reject the proposed changes. + +\end{enumerate} \section{Team Meeting Attendance} From fadb0d6d21544b43d01a9d070c3f492cd0af8b85 Mon Sep 17 00:00:00 2001 From: Sevhena Walker <83547364+Sevhena@users.noreply.github.com> Date: Wed, 29 Jan 2025 21:45:52 -0500 Subject: [PATCH 7/7] Updated 'Commits' section #361 --- docs/projMngmnt/Rev0_Team_Contrib.tex | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/projMngmnt/Rev0_Team_Contrib.tex b/docs/projMngmnt/Rev0_Team_Contrib.tex index 67d73dd9..efe3fda8 100644 --- a/docs/projMngmnt/Rev0_Team_Contrib.tex +++ b/docs/projMngmnt/Rev0_Team_Contrib.tex @@ -176,7 +176,6 @@ \section{Commits} \end{table} The number of commits does not necessarily reflect the amount of work done by each team member. Some members prefer to make frequent small commits while others make fewer but larger commits that include multiple changes. -Additionally, pair programming sessions often only let one person make the commit so it would only be under their name. \section{Issue Tracker}