studymaster 0.1.0__py3-none-any.whl
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.
- studymaster/deadline.py +18 -0
- studymaster/exam.py +5 -0
- studymaster/gpa.py +19 -0
- studymaster/init.py +6 -0
- studymaster/planner.py +22 -0
- studymaster/quiz.py +10 -0
- studymaster/timer.py +10 -0
- studymaster-0.1.0.dist-info/METADATA +281 -0
- studymaster-0.1.0.dist-info/RECORD +11 -0
- studymaster-0.1.0.dist-info/WHEEL +5 -0
- studymaster-0.1.0.dist-info/top_level.txt +1 -0
studymaster/deadline.py
ADDED
|
@@ -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"
|
studymaster/exam.py
ADDED
studymaster/gpa.py
ADDED
|
@@ -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)
|
studymaster/init.py
ADDED
studymaster/planner.py
ADDED
|
@@ -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
|
studymaster/quiz.py
ADDED
studymaster/timer.py
ADDED
|
@@ -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,11 @@
|
|
|
1
|
+
studymaster/deadline.py,sha256=Y-Ni2Dt8_YnPRFejg3wi3wFzisLPESTnsIqZueddmqo,341
|
|
2
|
+
studymaster/exam.py,sha256=OdvlFfLinPGxj_AJLfYLdxZ_Jzj0bQf51ets_mzqeA4,137
|
|
3
|
+
studymaster/gpa.py,sha256=KUhgWnysd9rkJJ4gOP0Y2zTzkQjC5k4rWA4N3iSBTH0,295
|
|
4
|
+
studymaster/init.py,sha256=dfgDYphzg9HwUOCdCy2rk6_-MPfcsQRIRRSvKfqigyY,127
|
|
5
|
+
studymaster/planner.py,sha256=g7wZRPCtVDMWkJIdAcc-sSixfUBjXpe1_c9N0r7-ehM,362
|
|
6
|
+
studymaster/quiz.py,sha256=pTrlht9ej79hqgxt81zg3XR3Ci8jdE3mjGih1Xjifes,197
|
|
7
|
+
studymaster/timer.py,sha256=xoO-QiasgnP8Nl9XCl1IqzQXWogssGYqXqC-bZgxI2I,207
|
|
8
|
+
studymaster-0.1.0.dist-info/METADATA,sha256=coumDRklIOJ0YR5hczHlGHHxXx8fB6i3UOVCKS_jEXE,6440
|
|
9
|
+
studymaster-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
|
|
10
|
+
studymaster-0.1.0.dist-info/top_level.txt,sha256=iop840hLy5_uewwqmU7UCohL4wtEwHiYDxOaUZB48Aw,12
|
|
11
|
+
studymaster-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
studymaster
|