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.
@@ -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
@@ -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
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
@@ -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 *
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
@@ -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
studymaster/timer.py ADDED
@@ -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,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,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.2.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1 @@
1
+ studymaster