sparq 0.1.0__py3-none-any.whl → 0.1.1__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,99 @@
1
+ Metadata-Version: 2.4
2
+ Name: sparq
3
+ Version: 0.1.1
4
+ Summary: Python client for the sparq api - automated degree planning for SJSU students + more
5
+ Author-email: Shiven Sheth <shivsbots@gmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/shiventi/sparq
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: Operating System :: OS Independent
10
+ Requires-Python: >=3.8
11
+ Description-Content-Type: text/markdown
12
+ License-File: LICENSE
13
+ Requires-Dist: requests>=2.25.0
14
+ Dynamic: license-file
15
+
16
+ # sparq Client
17
+
18
+ Python client library for the sparq API - automated degree planning for SJSU students.
19
+
20
+ ## Installation
21
+
22
+ ```bash
23
+ pip install sparq
24
+ ```
25
+
26
+ ## Quick Start
27
+
28
+ ### 1. Get Your API Key
29
+
30
+ First, run the authentication script to register and get your API key:
31
+
32
+ ```bash
33
+ python auth.py
34
+ ```
35
+
36
+ This will:
37
+ - Send a verification code to your email
38
+ - Generate your API key after verification
39
+ - Save it to `~/.sparq/config.txt`
40
+
41
+ ### 2. Generate a Degree Plan
42
+
43
+ Use the example script to test the API:
44
+
45
+ ```bash
46
+ python sparq.py
47
+ ```
48
+
49
+ Or use it in your own code:
50
+
51
+ ```python
52
+ from sparq import Sparq
53
+
54
+ # Initialize with your API key (automatically loaded from config)
55
+ client = Sparq()
56
+
57
+ # Generate a degree plan
58
+ plan = client.plan(
59
+ major="Computer Science",
60
+ cc_courses=[
61
+ {
62
+ "code": "COMSC 075",
63
+ "title": "Computer Science I",
64
+ "grade": "A",
65
+ "institution": "Evergreen Valley College"
66
+ }
67
+ ],
68
+ units_per_semester=15
69
+ )
70
+
71
+ print(plan)
72
+ ```
73
+
74
+ ### 3. Check Your API Usage
75
+
76
+ View your API usage statistics:
77
+
78
+ ```bash
79
+ python usage.py
80
+ ```
81
+
82
+ ### 4. Recover Lost API Key
83
+
84
+ If you lose your API key:
85
+
86
+ ```bash
87
+ python recover.py
88
+ ```
89
+
90
+ ## Features
91
+
92
+ - **Degree Planning**: Generate semester-by-semester plans for SJSU majors
93
+ - **Transfer Credit**: Support for community college and AP credits
94
+ - **Usage Tracking**: Monitor your API calls and history
95
+ - **API Key Recovery**: Recover lost API keys via email verification
96
+
97
+ ## Support
98
+
99
+ For issues or questions, visit: https://github.com/shiventi/sparq
@@ -3,8 +3,8 @@ client.py,sha256=V-2lY3-Bqf3OS57uDvld1pCJ0GgOAQCNQathZoAJbVI,2003
3
3
  recover.py,sha256=mytwHgfYqLXP8TTLpHA1MQuHSwqiXk5d3_0IlNOnTkQ,1362
4
4
  sparq.py,sha256=HDgQHUTEEQ9vzvL9NmQoNiSb5egBW_kcHMoy2D5MJWc,2387
5
5
  usage.py,sha256=O6fU-uRb7g-L_i2B3q1nQ6HpcvG6gBsmNRC0oF74tIo,1836
6
- sparq-0.1.0.dist-info/licenses/LICENSE,sha256=u3S2yd9hZVIlnAs1I1u7Dh7yvkF5UOD2ioaXRzuPqhQ,1068
7
- sparq-0.1.0.dist-info/METADATA,sha256=e_-QYJ4LwfqDznO2OA2iCUx6hAbwAzWTCoSKwwV2axI,616
8
- sparq-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
9
- sparq-0.1.0.dist-info/top_level.txt,sha256=8ohSeMkAXB1sxbHBoDcVpasI4M77v7tfPqP2Mu3Kjts,32
10
- sparq-0.1.0.dist-info/RECORD,,
6
+ sparq-0.1.1.dist-info/licenses/LICENSE,sha256=u3S2yd9hZVIlnAs1I1u7Dh7yvkF5UOD2ioaXRzuPqhQ,1068
7
+ sparq-0.1.1.dist-info/METADATA,sha256=8kuMVggfLZ1fGLp103JZtN8to0Kmtw1ssc8V4uV9xP0,2043
8
+ sparq-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
9
+ sparq-0.1.1.dist-info/top_level.txt,sha256=8ohSeMkAXB1sxbHBoDcVpasI4M77v7tfPqP2Mu3Kjts,32
10
+ sparq-0.1.1.dist-info/RECORD,,
@@ -1,23 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: sparq
3
- Version: 0.1.0
4
- Summary: Python client for the sparq api - automated degree planning for SJSU students + more
5
- Author: Shiven Sheth
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/shiventi/sparq
8
- Classifier: Programming Language :: Python :: 3
9
- Classifier: Operating System :: OS Independent
10
- Requires-Python: >=3.8
11
- Description-Content-Type: text/markdown
12
- License-File: LICENSE
13
- Requires-Dist: requests>=2.25.0
14
- Dynamic: license-file
15
-
16
- # sparq Client
17
-
18
- Python client library for the sparq API - automated degree planning for SJSU students.
19
-
20
- ## Installation
21
-
22
- ```bash
23
- pip install sparq
File without changes