studymaster 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,281 @@
1
+ Metadata-Version: 2.4
2
+ Name: studymaster
3
+ Version: 0.1.0
4
+ Summary: Academic productivity toolkit for students
5
+ Author: StudyMaster Team
6
+ Project-URL: Homepage, https://github.com/ken56966471abc-tech/StudyMaster
7
+ Requires-Python: >=3.8
8
+ Description-Content-Type: text/markdown
9
+
10
+ StudyMaster
11
+ An All-in-One Academic Productivity Toolkit for Students
12
+ StudyMaster is a Python package that helps students manage their academic responsibilities more effectively. Instead of using multiple applications, students can use a single package to calculate GPA, track deadlines, monitor study time, prepare for exams, generate quizzes, and prioritize assignments.
13
+
14
+ ๐Ÿ“– Motivation
15
+ Students often struggle with:
16
+
17
+ Tracking assignment deadlines
18
+ Managing exam schedules
19
+ Monitoring GPA performance
20
+ Recording study hours
21
+ Creating revision materials
22
+ Deciding which assignment to complete first
23
+ Many existing tools focus on only one of these tasks. StudyMaster combines multiple academic productivity tools into a single package, making student organization simpler and more efficient.
24
+
25
+ ๐Ÿš€ Features
26
+ StudyMaster includes six major features:
27
+
28
+ ๐Ÿ“Š GPA Calculator
29
+ Calculate GPA using a list of letter grades.
30
+
31
+ ๐Ÿ“… Exam Countdown
32
+ Track the number of days remaining before an exam.
33
+
34
+ ๐Ÿ“š Homework Deadline Manager
35
+ Monitor assignment deadlines and urgency levels.
36
+
37
+ โฑ๏ธ Study Timer
38
+ Track study sessions and total study hours.
39
+
40
+ โ“ Quiz Generator
41
+ Convert notes into quiz-style flashcards.
42
+
43
+ ๐ŸŽฏ Smart Task Prioritization
44
+ Automatically recommend which assignment should be completed first based on deadline urgency and difficulty.
45
+
46
+ ๐Ÿ’ก Innovation
47
+ Unlike traditional student productivity tools that perform only one task, StudyMaster integrates six academic functions into a single package.
48
+
49
+ The most innovative feature is Smart Task Prioritization, which evaluates:
50
+
51
+ Assignment difficulty
52
+ Deadline urgency
53
+ and automatically recommends the best order for completing assignments.
54
+
55
+ This helps students allocate their time more effectively and improve productivity.
56
+
57
+ ๐Ÿ“ฆ Installation
58
+ Install StudyMaster using pip:
59
+
60
+ pip install studymaster
61
+ ๐Ÿ–ฅ๏ธ Usage Examples
62
+ 1. GPA Calculator
63
+ Example
64
+ from studymaster import calculate_gpa
65
+
66
+ print(calculate_gpa(["A", "A-", "B+"]))
67
+ Output
68
+ 3.67
69
+ Explanation
70
+ The function converts letter grades into grade points and calculates the average GPA.
71
+
72
+ Grade Scale:
73
+
74
+ Grade Point
75
+ A 4.0
76
+ A- 3.7
77
+ B+ 3.3
78
+ B 3.0
79
+ B- 2.7
80
+ C+ 2.3
81
+ C 2.0
82
+ D 1.0
83
+ F 0.0
84
+ 2. Exam Countdown
85
+ Example
86
+ from studymaster import exam_countdown
87
+
88
+ print(exam_countdown("2026-12-20"))
89
+ Output
90
+ 38
91
+ Explanation
92
+ Returns the number of days before an upcoming exam.
93
+
94
+ 3. Homework Deadline Manager
95
+ Calculate Remaining Days
96
+ from studymaster import days_left
97
+
98
+ print(days_left("2026-12-01"))
99
+ Output
100
+ 19
101
+ Explanation
102
+ Returns the remaining number of days before a deadline.
103
+
104
+ Check Urgency
105
+ from studymaster import urgency_level
106
+
107
+ print(urgency_level("2026-11-15"))
108
+ Output
109
+ High Priority
110
+ Priority Levels
111
+ Days Remaining Priority
112
+ 0 โ€“ 3 High Priority
113
+ 4 โ€“ 7 Medium Priority
114
+ More than 7 Low Priority
115
+ 4. Study Timer
116
+ Example
117
+ from studymaster import StudySession
118
+
119
+ session = StudySession()
120
+
121
+ session.add_time(120)
122
+
123
+ print(session.total_hours())
124
+ Output
125
+ 2.0
126
+ Explanation
127
+ Converts total study minutes into hours.
128
+
129
+ In this example:
130
+
131
+ 120 minutes = 2 hours
132
+ 5. Quiz Generator
133
+ Example
134
+ from studymaster import create_quiz
135
+
136
+ notes = {
137
+ "Accounts Receivable":
138
+ "Money owed by customers"
139
+ }
140
+
141
+ print(create_quiz(notes))
142
+ Output
143
+ Q: What is Accounts Receivable?
144
+ A: Money owed by customers
145
+ Explanation
146
+ Converts notes into flashcard-style study questions.
147
+
148
+ Input Format:
149
+
150
+ {
151
+ "Topic": "Definition"
152
+ }
153
+ 6. Smart Task Prioritization
154
+ Purpose
155
+ Helps students determine which assignment should be completed first.
156
+
157
+ Example
158
+ from studymaster import add_task
159
+ from studymaster import recommend_tasks
160
+
161
+ add_task("CS Project", 3, 9)
162
+
163
+ add_task("Accounting Homework", 7, 4)
164
+
165
+ print(recommend_tasks())
166
+ Input Format
167
+ add_task(task_name, days_until_deadline, difficulty)
168
+ Input Example 1
169
+ add_task("CS Project", 3, 9)
170
+ Meaning:
171
+
172
+ Task Name: CS Project
173
+ Days Until Deadline: 3
174
+ Difficulty: 9/10
175
+ Input Example 2
176
+ add_task("Accounting Homework", 7, 4)
177
+ Meaning:
178
+
179
+ Task Name: Accounting Homework
180
+ Days Until Deadline: 7
181
+ Difficulty: 4/10
182
+ Priority Formula
183
+ priority_score = difficulty * 10 + (30 - days_left)
184
+ A higher score means a higher priority.
185
+
186
+ Score Calculation
187
+ CS Project
188
+ Difficulty = 9
189
+
190
+ 9 ร— 10 = 90
191
+
192
+ Days Remaining = 3
193
+
194
+ 30 - 3 = 27
195
+
196
+ Priority Score = 117
197
+ Accounting Homework
198
+ Difficulty = 4
199
+
200
+ 4 ร— 10 = 40
201
+
202
+ Days Remaining = 7
203
+
204
+ 30 - 7 = 23
205
+
206
+ Priority Score = 63
207
+ Output
208
+ [
209
+ {'name': 'CS Project', 'score': 117},
210
+ {'name': 'Accounting Homework', 'score': 63}
211
+ ]
212
+ Explanation
213
+ Since the CS Project:
214
+
215
+ Has a closer deadline
216
+ Has a higher difficulty level
217
+ it receives a higher priority score and should be completed first.
218
+
219
+ ๐Ÿงช Running Tests
220
+ Run tests using:
221
+
222
+ pytest
223
+ Example test file:
224
+
225
+ from studymaster import calculate_gpa
226
+
227
+ def test_gpa():
228
+ assert calculate_gpa(["A", "B"]) == 3.5
229
+ ๐Ÿ‘ฅ Team Contributions
230
+ Member Responsibility
231
+ Member 1 GPA Calculator
232
+ Member 2 Exam Countdown
233
+ Member 3 Homework Deadline Manager
234
+ Member 4 Study Timer
235
+ Member 5 Quiz Generator
236
+ Member 6 Smart Task Prioritization
237
+ ๐Ÿ”ฎ Future Improvements
238
+ Potential future enhancements:
239
+
240
+ GUI desktop application
241
+ Mobile application
242
+ Calendar integration
243
+ GPA prediction system
244
+ Study analytics dashboard
245
+ AI-powered quiz generation
246
+ Assignment reminders and notifications
247
+ Cloud data storage
248
+ ๐ŸŽฌ Demo
249
+ from studymaster import *
250
+
251
+ print(calculate_gpa(["A", "A-", "B+"]))
252
+
253
+ print(days_left("2026-12-01"))
254
+
255
+ session = StudySession()
256
+
257
+ session.add_time(120)
258
+
259
+ print(session.total_hours())
260
+
261
+ add_task("CS Project", 3, 9)
262
+
263
+ add_task("Accounting Homework", 7, 4)
264
+
265
+ print(recommend_tasks())
266
+ Expected Output:
267
+
268
+ 3.67
269
+
270
+ 19
271
+
272
+ 2.0
273
+
274
+ [
275
+ {'name': 'CS Project', 'score': 117},
276
+ {'name': 'Accounting Homework', 'score': 63}
277
+ ]
278
+ โœ… Conclusion
279
+ StudyMaster is a comprehensive academic productivity package that helps students manage GPA, exams, deadlines, study time, quizzes, and assignment priorities.
280
+
281
+ By combining multiple tools into one package, StudyMaster provides students with a simple, effective, and organized way to improve academic performance and productivity.
@@ -0,0 +1,272 @@
1
+ StudyMaster
2
+ An All-in-One Academic Productivity Toolkit for Students
3
+ StudyMaster is a Python package that helps students manage their academic responsibilities more effectively. Instead of using multiple applications, students can use a single package to calculate GPA, track deadlines, monitor study time, prepare for exams, generate quizzes, and prioritize assignments.
4
+
5
+ ๐Ÿ“– Motivation
6
+ Students often struggle with:
7
+
8
+ Tracking assignment deadlines
9
+ Managing exam schedules
10
+ Monitoring GPA performance
11
+ Recording study hours
12
+ Creating revision materials
13
+ Deciding which assignment to complete first
14
+ Many existing tools focus on only one of these tasks. StudyMaster combines multiple academic productivity tools into a single package, making student organization simpler and more efficient.
15
+
16
+ ๐Ÿš€ Features
17
+ StudyMaster includes six major features:
18
+
19
+ ๐Ÿ“Š GPA Calculator
20
+ Calculate GPA using a list of letter grades.
21
+
22
+ ๐Ÿ“… Exam Countdown
23
+ Track the number of days remaining before an exam.
24
+
25
+ ๐Ÿ“š Homework Deadline Manager
26
+ Monitor assignment deadlines and urgency levels.
27
+
28
+ โฑ๏ธ Study Timer
29
+ Track study sessions and total study hours.
30
+
31
+ โ“ Quiz Generator
32
+ Convert notes into quiz-style flashcards.
33
+
34
+ ๐ŸŽฏ Smart Task Prioritization
35
+ Automatically recommend which assignment should be completed first based on deadline urgency and difficulty.
36
+
37
+ ๐Ÿ’ก Innovation
38
+ Unlike traditional student productivity tools that perform only one task, StudyMaster integrates six academic functions into a single package.
39
+
40
+ The most innovative feature is Smart Task Prioritization, which evaluates:
41
+
42
+ Assignment difficulty
43
+ Deadline urgency
44
+ and automatically recommends the best order for completing assignments.
45
+
46
+ This helps students allocate their time more effectively and improve productivity.
47
+
48
+ ๐Ÿ“ฆ Installation
49
+ Install StudyMaster using pip:
50
+
51
+ pip install studymaster
52
+ ๐Ÿ–ฅ๏ธ Usage Examples
53
+ 1. GPA Calculator
54
+ Example
55
+ from studymaster import calculate_gpa
56
+
57
+ print(calculate_gpa(["A", "A-", "B+"]))
58
+ Output
59
+ 3.67
60
+ Explanation
61
+ The function converts letter grades into grade points and calculates the average GPA.
62
+
63
+ Grade Scale:
64
+
65
+ Grade Point
66
+ A 4.0
67
+ A- 3.7
68
+ B+ 3.3
69
+ B 3.0
70
+ B- 2.7
71
+ C+ 2.3
72
+ C 2.0
73
+ D 1.0
74
+ F 0.0
75
+ 2. Exam Countdown
76
+ Example
77
+ from studymaster import exam_countdown
78
+
79
+ print(exam_countdown("2026-12-20"))
80
+ Output
81
+ 38
82
+ Explanation
83
+ Returns the number of days before an upcoming exam.
84
+
85
+ 3. Homework Deadline Manager
86
+ Calculate Remaining Days
87
+ from studymaster import days_left
88
+
89
+ print(days_left("2026-12-01"))
90
+ Output
91
+ 19
92
+ Explanation
93
+ Returns the remaining number of days before a deadline.
94
+
95
+ Check Urgency
96
+ from studymaster import urgency_level
97
+
98
+ print(urgency_level("2026-11-15"))
99
+ Output
100
+ High Priority
101
+ Priority Levels
102
+ Days Remaining Priority
103
+ 0 โ€“ 3 High Priority
104
+ 4 โ€“ 7 Medium Priority
105
+ More than 7 Low Priority
106
+ 4. Study Timer
107
+ Example
108
+ from studymaster import StudySession
109
+
110
+ session = StudySession()
111
+
112
+ session.add_time(120)
113
+
114
+ print(session.total_hours())
115
+ Output
116
+ 2.0
117
+ Explanation
118
+ Converts total study minutes into hours.
119
+
120
+ In this example:
121
+
122
+ 120 minutes = 2 hours
123
+ 5. Quiz Generator
124
+ Example
125
+ from studymaster import create_quiz
126
+
127
+ notes = {
128
+ "Accounts Receivable":
129
+ "Money owed by customers"
130
+ }
131
+
132
+ print(create_quiz(notes))
133
+ Output
134
+ Q: What is Accounts Receivable?
135
+ A: Money owed by customers
136
+ Explanation
137
+ Converts notes into flashcard-style study questions.
138
+
139
+ Input Format:
140
+
141
+ {
142
+ "Topic": "Definition"
143
+ }
144
+ 6. Smart Task Prioritization
145
+ Purpose
146
+ Helps students determine which assignment should be completed first.
147
+
148
+ Example
149
+ from studymaster import add_task
150
+ from studymaster import recommend_tasks
151
+
152
+ add_task("CS Project", 3, 9)
153
+
154
+ add_task("Accounting Homework", 7, 4)
155
+
156
+ print(recommend_tasks())
157
+ Input Format
158
+ add_task(task_name, days_until_deadline, difficulty)
159
+ Input Example 1
160
+ add_task("CS Project", 3, 9)
161
+ Meaning:
162
+
163
+ Task Name: CS Project
164
+ Days Until Deadline: 3
165
+ Difficulty: 9/10
166
+ Input Example 2
167
+ add_task("Accounting Homework", 7, 4)
168
+ Meaning:
169
+
170
+ Task Name: Accounting Homework
171
+ Days Until Deadline: 7
172
+ Difficulty: 4/10
173
+ Priority Formula
174
+ priority_score = difficulty * 10 + (30 - days_left)
175
+ A higher score means a higher priority.
176
+
177
+ Score Calculation
178
+ CS Project
179
+ Difficulty = 9
180
+
181
+ 9 ร— 10 = 90
182
+
183
+ Days Remaining = 3
184
+
185
+ 30 - 3 = 27
186
+
187
+ Priority Score = 117
188
+ Accounting Homework
189
+ Difficulty = 4
190
+
191
+ 4 ร— 10 = 40
192
+
193
+ Days Remaining = 7
194
+
195
+ 30 - 7 = 23
196
+
197
+ Priority Score = 63
198
+ Output
199
+ [
200
+ {'name': 'CS Project', 'score': 117},
201
+ {'name': 'Accounting Homework', 'score': 63}
202
+ ]
203
+ Explanation
204
+ Since the CS Project:
205
+
206
+ Has a closer deadline
207
+ Has a higher difficulty level
208
+ it receives a higher priority score and should be completed first.
209
+
210
+ ๐Ÿงช Running Tests
211
+ Run tests using:
212
+
213
+ pytest
214
+ Example test file:
215
+
216
+ from studymaster import calculate_gpa
217
+
218
+ def test_gpa():
219
+ assert calculate_gpa(["A", "B"]) == 3.5
220
+ ๐Ÿ‘ฅ Team Contributions
221
+ Member Responsibility
222
+ Member 1 GPA Calculator
223
+ Member 2 Exam Countdown
224
+ Member 3 Homework Deadline Manager
225
+ Member 4 Study Timer
226
+ Member 5 Quiz Generator
227
+ Member 6 Smart Task Prioritization
228
+ ๐Ÿ”ฎ Future Improvements
229
+ Potential future enhancements:
230
+
231
+ GUI desktop application
232
+ Mobile application
233
+ Calendar integration
234
+ GPA prediction system
235
+ Study analytics dashboard
236
+ AI-powered quiz generation
237
+ Assignment reminders and notifications
238
+ Cloud data storage
239
+ ๐ŸŽฌ Demo
240
+ from studymaster import *
241
+
242
+ print(calculate_gpa(["A", "A-", "B+"]))
243
+
244
+ print(days_left("2026-12-01"))
245
+
246
+ session = StudySession()
247
+
248
+ session.add_time(120)
249
+
250
+ print(session.total_hours())
251
+
252
+ add_task("CS Project", 3, 9)
253
+
254
+ add_task("Accounting Homework", 7, 4)
255
+
256
+ print(recommend_tasks())
257
+ Expected Output:
258
+
259
+ 3.67
260
+
261
+ 19
262
+
263
+ 2.0
264
+
265
+ [
266
+ {'name': 'CS Project', 'score': 117},
267
+ {'name': 'Accounting Homework', 'score': 63}
268
+ ]
269
+ โœ… Conclusion
270
+ StudyMaster is a comprehensive academic productivity package that helps students manage GPA, exams, deadlines, study time, quizzes, and assignment priorities.
271
+
272
+ By combining multiple tools into one package, StudyMaster provides students with a simple, effective, and organized way to improve academic performance and productivity.
@@ -0,0 +1,20 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "studymaster"
7
+ version = "0.1.0"
8
+
9
+ description = "Academic productivity toolkit for students"
10
+
11
+ readme = "README.md"
12
+
13
+ requires-python = ">=3.8"
14
+
15
+ authors = [
16
+ {name = "StudyMaster Team"}
17
+ ]
18
+
19
+ [project.urls]
20
+ Homepage = "https://github.com/ken56966471abc-tech/StudyMaster"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,18 @@
1
+ from datetime import date
2
+
3
+ def days_left(deadline):
4
+ target = date.fromisoformat(deadline)
5
+ return (target - date.today()).days
6
+
7
+ def urgency_level(deadline):
8
+
9
+ days = days_left(deadline)
10
+
11
+ if days <= 3:
12
+ return "High Priority"
13
+
14
+ elif days <= 7:
15
+ return "Medium Priority"
16
+
17
+ else:
18
+ return "Low Priority"
@@ -0,0 +1,5 @@
1
+ from datetime import date
2
+
3
+ def exam_countdown(exam_date):
4
+ exam = date.fromisoformat(exam_date)
5
+ return (exam - date.today()).days
@@ -0,0 +1,19 @@
1
+ GRADE_POINTS = {
2
+ "A": 4.0,
3
+ "A-": 3.7,
4
+ "B+": 3.3,
5
+ "B": 3.0,
6
+ "B-": 2.7,
7
+ "C+": 2.3,
8
+ "C": 2.0,
9
+ "D": 1.0,
10
+ "F": 0.0
11
+ }
12
+
13
+ def calculate_gpa(grades):
14
+ total = 0
15
+
16
+ for grade in grades:
17
+ total += GRADE_POINTS[grade]
18
+
19
+ return round(total / len(grades), 2)
@@ -0,0 +1,6 @@
1
+ from .deadline import *
2
+ from .exam import *
3
+ from .gpa import *
4
+ from .timer import *
5
+ from .quiz import *
6
+ from .planner import *
@@ -0,0 +1,22 @@
1
+ tasks = []
2
+
3
+ def add_task(name, days_left, difficulty):
4
+
5
+ priority_score = difficulty * 10 + (30 - days_left)
6
+
7
+ tasks.append(
8
+ {
9
+ "name": name,
10
+ "score": priority_score
11
+ }
12
+ )
13
+
14
+ def recommend_tasks():
15
+
16
+ ordered = sorted(
17
+ tasks,
18
+ key=lambda x: x["score"],
19
+ reverse=True
20
+ )
21
+
22
+ return ordered
@@ -0,0 +1,10 @@
1
+ def create_quiz(notes):
2
+
3
+ questions = []
4
+
5
+ for term, definition in notes.items():
6
+ questions.append(
7
+ f"Q: What is {term}?\nA: {definition}"
8
+ )
9
+
10
+ return questions
@@ -0,0 +1,10 @@
1
+ class StudySession:
2
+
3
+ def __init__(self):
4
+ self.minutes = 0
5
+
6
+ def add_time(self, minutes):
7
+ self.minutes += minutes
8
+
9
+ def total_hours(self):
10
+ return round(self.minutes / 60, 2)
@@ -0,0 +1,281 @@
1
+ Metadata-Version: 2.4
2
+ Name: studymaster
3
+ Version: 0.1.0
4
+ Summary: Academic productivity toolkit for students
5
+ Author: StudyMaster Team
6
+ Project-URL: Homepage, https://github.com/ken56966471abc-tech/StudyMaster
7
+ Requires-Python: >=3.8
8
+ Description-Content-Type: text/markdown
9
+
10
+ StudyMaster
11
+ An All-in-One Academic Productivity Toolkit for Students
12
+ StudyMaster is a Python package that helps students manage their academic responsibilities more effectively. Instead of using multiple applications, students can use a single package to calculate GPA, track deadlines, monitor study time, prepare for exams, generate quizzes, and prioritize assignments.
13
+
14
+ ๐Ÿ“– Motivation
15
+ Students often struggle with:
16
+
17
+ Tracking assignment deadlines
18
+ Managing exam schedules
19
+ Monitoring GPA performance
20
+ Recording study hours
21
+ Creating revision materials
22
+ Deciding which assignment to complete first
23
+ Many existing tools focus on only one of these tasks. StudyMaster combines multiple academic productivity tools into a single package, making student organization simpler and more efficient.
24
+
25
+ ๐Ÿš€ Features
26
+ StudyMaster includes six major features:
27
+
28
+ ๐Ÿ“Š GPA Calculator
29
+ Calculate GPA using a list of letter grades.
30
+
31
+ ๐Ÿ“… Exam Countdown
32
+ Track the number of days remaining before an exam.
33
+
34
+ ๐Ÿ“š Homework Deadline Manager
35
+ Monitor assignment deadlines and urgency levels.
36
+
37
+ โฑ๏ธ Study Timer
38
+ Track study sessions and total study hours.
39
+
40
+ โ“ Quiz Generator
41
+ Convert notes into quiz-style flashcards.
42
+
43
+ ๐ŸŽฏ Smart Task Prioritization
44
+ Automatically recommend which assignment should be completed first based on deadline urgency and difficulty.
45
+
46
+ ๐Ÿ’ก Innovation
47
+ Unlike traditional student productivity tools that perform only one task, StudyMaster integrates six academic functions into a single package.
48
+
49
+ The most innovative feature is Smart Task Prioritization, which evaluates:
50
+
51
+ Assignment difficulty
52
+ Deadline urgency
53
+ and automatically recommends the best order for completing assignments.
54
+
55
+ This helps students allocate their time more effectively and improve productivity.
56
+
57
+ ๐Ÿ“ฆ Installation
58
+ Install StudyMaster using pip:
59
+
60
+ pip install studymaster
61
+ ๐Ÿ–ฅ๏ธ Usage Examples
62
+ 1. GPA Calculator
63
+ Example
64
+ from studymaster import calculate_gpa
65
+
66
+ print(calculate_gpa(["A", "A-", "B+"]))
67
+ Output
68
+ 3.67
69
+ Explanation
70
+ The function converts letter grades into grade points and calculates the average GPA.
71
+
72
+ Grade Scale:
73
+
74
+ Grade Point
75
+ A 4.0
76
+ A- 3.7
77
+ B+ 3.3
78
+ B 3.0
79
+ B- 2.7
80
+ C+ 2.3
81
+ C 2.0
82
+ D 1.0
83
+ F 0.0
84
+ 2. Exam Countdown
85
+ Example
86
+ from studymaster import exam_countdown
87
+
88
+ print(exam_countdown("2026-12-20"))
89
+ Output
90
+ 38
91
+ Explanation
92
+ Returns the number of days before an upcoming exam.
93
+
94
+ 3. Homework Deadline Manager
95
+ Calculate Remaining Days
96
+ from studymaster import days_left
97
+
98
+ print(days_left("2026-12-01"))
99
+ Output
100
+ 19
101
+ Explanation
102
+ Returns the remaining number of days before a deadline.
103
+
104
+ Check Urgency
105
+ from studymaster import urgency_level
106
+
107
+ print(urgency_level("2026-11-15"))
108
+ Output
109
+ High Priority
110
+ Priority Levels
111
+ Days Remaining Priority
112
+ 0 โ€“ 3 High Priority
113
+ 4 โ€“ 7 Medium Priority
114
+ More than 7 Low Priority
115
+ 4. Study Timer
116
+ Example
117
+ from studymaster import StudySession
118
+
119
+ session = StudySession()
120
+
121
+ session.add_time(120)
122
+
123
+ print(session.total_hours())
124
+ Output
125
+ 2.0
126
+ Explanation
127
+ Converts total study minutes into hours.
128
+
129
+ In this example:
130
+
131
+ 120 minutes = 2 hours
132
+ 5. Quiz Generator
133
+ Example
134
+ from studymaster import create_quiz
135
+
136
+ notes = {
137
+ "Accounts Receivable":
138
+ "Money owed by customers"
139
+ }
140
+
141
+ print(create_quiz(notes))
142
+ Output
143
+ Q: What is Accounts Receivable?
144
+ A: Money owed by customers
145
+ Explanation
146
+ Converts notes into flashcard-style study questions.
147
+
148
+ Input Format:
149
+
150
+ {
151
+ "Topic": "Definition"
152
+ }
153
+ 6. Smart Task Prioritization
154
+ Purpose
155
+ Helps students determine which assignment should be completed first.
156
+
157
+ Example
158
+ from studymaster import add_task
159
+ from studymaster import recommend_tasks
160
+
161
+ add_task("CS Project", 3, 9)
162
+
163
+ add_task("Accounting Homework", 7, 4)
164
+
165
+ print(recommend_tasks())
166
+ Input Format
167
+ add_task(task_name, days_until_deadline, difficulty)
168
+ Input Example 1
169
+ add_task("CS Project", 3, 9)
170
+ Meaning:
171
+
172
+ Task Name: CS Project
173
+ Days Until Deadline: 3
174
+ Difficulty: 9/10
175
+ Input Example 2
176
+ add_task("Accounting Homework", 7, 4)
177
+ Meaning:
178
+
179
+ Task Name: Accounting Homework
180
+ Days Until Deadline: 7
181
+ Difficulty: 4/10
182
+ Priority Formula
183
+ priority_score = difficulty * 10 + (30 - days_left)
184
+ A higher score means a higher priority.
185
+
186
+ Score Calculation
187
+ CS Project
188
+ Difficulty = 9
189
+
190
+ 9 ร— 10 = 90
191
+
192
+ Days Remaining = 3
193
+
194
+ 30 - 3 = 27
195
+
196
+ Priority Score = 117
197
+ Accounting Homework
198
+ Difficulty = 4
199
+
200
+ 4 ร— 10 = 40
201
+
202
+ Days Remaining = 7
203
+
204
+ 30 - 7 = 23
205
+
206
+ Priority Score = 63
207
+ Output
208
+ [
209
+ {'name': 'CS Project', 'score': 117},
210
+ {'name': 'Accounting Homework', 'score': 63}
211
+ ]
212
+ Explanation
213
+ Since the CS Project:
214
+
215
+ Has a closer deadline
216
+ Has a higher difficulty level
217
+ it receives a higher priority score and should be completed first.
218
+
219
+ ๐Ÿงช Running Tests
220
+ Run tests using:
221
+
222
+ pytest
223
+ Example test file:
224
+
225
+ from studymaster import calculate_gpa
226
+
227
+ def test_gpa():
228
+ assert calculate_gpa(["A", "B"]) == 3.5
229
+ ๐Ÿ‘ฅ Team Contributions
230
+ Member Responsibility
231
+ Member 1 GPA Calculator
232
+ Member 2 Exam Countdown
233
+ Member 3 Homework Deadline Manager
234
+ Member 4 Study Timer
235
+ Member 5 Quiz Generator
236
+ Member 6 Smart Task Prioritization
237
+ ๐Ÿ”ฎ Future Improvements
238
+ Potential future enhancements:
239
+
240
+ GUI desktop application
241
+ Mobile application
242
+ Calendar integration
243
+ GPA prediction system
244
+ Study analytics dashboard
245
+ AI-powered quiz generation
246
+ Assignment reminders and notifications
247
+ Cloud data storage
248
+ ๐ŸŽฌ Demo
249
+ from studymaster import *
250
+
251
+ print(calculate_gpa(["A", "A-", "B+"]))
252
+
253
+ print(days_left("2026-12-01"))
254
+
255
+ session = StudySession()
256
+
257
+ session.add_time(120)
258
+
259
+ print(session.total_hours())
260
+
261
+ add_task("CS Project", 3, 9)
262
+
263
+ add_task("Accounting Homework", 7, 4)
264
+
265
+ print(recommend_tasks())
266
+ Expected Output:
267
+
268
+ 3.67
269
+
270
+ 19
271
+
272
+ 2.0
273
+
274
+ [
275
+ {'name': 'CS Project', 'score': 117},
276
+ {'name': 'Accounting Homework', 'score': 63}
277
+ ]
278
+ โœ… Conclusion
279
+ StudyMaster is a comprehensive academic productivity package that helps students manage GPA, exams, deadlines, study time, quizzes, and assignment priorities.
280
+
281
+ By combining multiple tools into one package, StudyMaster provides students with a simple, effective, and organized way to improve academic performance and productivity.
@@ -0,0 +1,14 @@
1
+ README.md
2
+ pyproject.toml
3
+ studymaster/deadline.py
4
+ studymaster/exam.py
5
+ studymaster/gpa.py
6
+ studymaster/init.py
7
+ studymaster/planner.py
8
+ studymaster/quiz.py
9
+ studymaster/timer.py
10
+ studymaster.egg-info/PKG-INFO
11
+ studymaster.egg-info/SOURCES.txt
12
+ studymaster.egg-info/dependency_links.txt
13
+ studymaster.egg-info/top_level.txt
14
+ tests/test_studymaster.py
@@ -0,0 +1 @@
1
+ studymaster
@@ -0,0 +1,4 @@
1
+ from studymaster import calculate_gpa
2
+
3
+ def test_gpa():
4
+ assert calculate_gpa(["A", "B"]) == 3.5