Compare commits

8 Commits
Author SHA1 Message Date
koffeejava abb09e1394 inplemented error handler. 2026-01-30 21:26:14 -07:00
koffeejava 0ccdb364d2 updated error handler. added it to all functions. 2026-01-30 21:26:10 -07:00
koffeejava 3c661d53c8 Created error handler. 2026-01-30 21:00:07 -07:00
koffeejava eded6cb0c3 Fixed "getFeatured" and added getStats 2026-01-30 20:42:25 -07:00
koffeejava 9f879d902c ddededodediamante 2026-01-29 22:05:42 -07:00
koffeejava 9e33b54742 added instalation to readme 2026-01-29 21:47:30 -07:00
koffeejava 586be77201 updated readme 2026-01-29 20:17:36 -07:00
KoffeeJava 19ad2840b8 Inital Commit! 2026-01-29 19:41:22 -07:00
9 changed files with 352 additions and 0 deletions
+7
View File
@@ -0,0 +1,7 @@
dist/
__pycache__/
src/macaronipm/__pycache__
src/test.py
+21
View File
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 KoffeeJava
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+21
View File
@@ -0,0 +1,21 @@
# MacaroniPM | A PenguinMod API wrapper
## Instalation
You can download the latest version of macaronipm via `pip install macaronipm`
## New functions
`macaronipm.user.UserExist()`
`macaronipm.user.IsBanned()`
`macaronipm.user.logout()`
`macaronipm.user.GetMessages()`
`macaronipm.user.getUnreadMessages()`
`macaronipm.IsOnline()`
`macaronipm.project.hasLovedVoted()`
+22
View File
@@ -0,0 +1,22 @@
[build-system]
requires = ["uv_build >= 0.9.26, <0.10.0"]
build-backend = "uv_build"
[project]
name = "macaronipm"
version = "3.0.0"
authors = [
{ name="KoffeeJava", email="koffeejava@tuta.io" },
]
description = "A PenguinMod API Wrapper"
readme = "README.md"
requires-python = ">=3.9"
classifiers = [
"Programming Language :: Python :: 3",
"Operating System :: OS Independent",
]
license = "MIT"
license-files = ["LICEN[CS]E*"]
[project.urls]
Homepage = "https://www.koffeejava.us/macaroni"
+17
View File
@@ -0,0 +1,17 @@
import requests
from . import misc
from . import project
from . import user
def isOnline():
url = f"https://projects.penguinmod.com/api/v1/ping"
response = requests.get(url)
if not response.status_code == 200:
return -1
return 0
def ddededodediamante():
print("ddededodediamante mode on")
+20
View File
@@ -0,0 +1,20 @@
import json
from colorist import Color
from colorist import Effect
from colorist import ColorHex
ORANGE = ColorHex("#ff8800")
def rerror(code, jsonr):
error_ = json.loads(jsonr.decode())["error"]
print(f"{Color.RED}MacaroniPM: An error has occured!")
print(f"Status code: {code}")
print(f"Response from url: {Effect.BOLD}{Effect.UNDERLINE}{error_}{Effect.OFF}")
if error_ == "Project not found":
print(f"{ORANGE}{Effect.BOLD}Hint: Try checking to see if the PID is correct!{Effect.OFF}")
elif error_ == "NotFound":
print(f"{ORANGE}{Effect.BOLD}Hint: Try checking to see if the username is correct{Effect.OFF}")
elif error_ == "Reauthenticate":
print(f"{ORANGE}{Effect.BOLD}Hint: Try checking to see if the token is correct or try to get a new token.{Effect.OFF}")
+52
View File
@@ -0,0 +1,52 @@
from. import error
import requests
import json
from colorist import Effect
from colorist import ColorHex
ORANGE = ColorHex("#ff8800")
def setToken(settoken):
global TOKEN
TOKEN = settoken
def setProject(projectid):
global PID
PID = projectid
def follow(target, toggle):
url = "https://projects.penguinmod.com/api/v1/users/follow"
data = f'{{"token":"{TOKEN}","target":"{target}","toggle":{toggle}}}'
headers = {'Content-type': 'application/json'}
response = requests.post(url, headers=headers, data=data)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return 0
def getFeatured():
print(f"{ORANGE}MacaroniPM: The featured function is stil being worked on. It is recomended {Effect.BOLD}{Effect.UNDERLINE}NOT{Effect.OFF}{ORANGE} to use this.{Effect.OFF}")
url = f"https://projects.penguinmod.com/api/v1/projects/searchprojects?page=0&query=&type=featured&token={TOKEN}&reverse=false"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return response.text.split()
def getStats():
url = f"https://projects.penguinmod.com/api/v1/misc/getStats"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
+89
View File
@@ -0,0 +1,89 @@
from . import misc
from. import error
import io
import requests
import json
import base64
def getThumbnail():
url = f"https://projects.penguinmod.com/api/v1/projects/getproject?projectID={misc.PID}&requestType=thumbnail"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
base64_data = base64.b64encode(io.BytesIO(response.content).read()).decode('utf-8')
return f"data:image/jpeg;base64,{base64_data}"
def getMeta():
url = f"https://projects.penguinmod.com/api/v1/projects/getproject?projectID={misc.PID}&requestType=metadata"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
def loveToggle(toggle):
url = "https://projects.penguinmod.com/api/v1/projects/interactions/loveToggle"
data = f'{{"projectId":"{misc.PID}","token":"{misc.TOKEN}","toggle":{toggle}}}'
headers = {'Content-type': 'application/json'}
response = requests.post(url, headers=headers, data=data)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return 0
def voteToggle(toggle):
url = "https://projects.penguinmod.com/api/v1/projects/interactions/voteToggle"
data = f'{{"projectId":"{misc.PID}","token":"{misc.TOKEN}","toggle":{toggle}}}'
headers = {'Content-type': 'application/json'}
response = requests.post(url, headers=headers, data=data)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return 0
def getRankedProjects(page):
url = f"https://projects.penguinmod.com/api/v1/projects/getprojects?page={page}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
def hasLovedVoted():
url = f"https://projects.penguinmod.com/api/v1/projects/getuserstatewrapper?projectId={misc.PID}&token={misc.TOKEN}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
def getFrontpage():
url = f"https://projects.penguinmod.com/api/v1/projects/frontpage"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
+103
View File
@@ -0,0 +1,103 @@
from . import misc
from . import error
import io
import requests
import json
import base64
def getMeta(target):
url = f"https://projects.penguinmod.com/api/v1/users/profile?target={target}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)
def isBlocking(target):
url = f"https://projects.penguinmod.com/api/v1/users/hasblocked?target={target}&token={misc.TOKEN}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
jsons = json.loads(response.content.decode())
return jsons['has_blocked']
def getPfp(target):
url = f"https://projects.penguinmod.com/api/v1/users/getpfp?username={target}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
base64_data = base64.b64encode(io.BytesIO(response.content).read()).decode('utf-8')
return f"data:image/jpeg;base64,{base64_data}"
def userExist(target):
url = f"https://projects.penguinmod.com/api/v1/users/userexists?username={target}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)['exists']
def isBanned(target):
url = f"https://projects.penguinmod.com/api/v1/users/isBanned?username={target}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return json.loads(response.content)['isBanned']
def logout():
url = "https://projects.penguinmod.com/api/v1/users/logout"
data = f'{{"token":"{misc.TOKEN}"}}'
headers = {'Content-type': 'application/json'}
response = requests.post(url, headers=headers, data=data)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
return 0
def getMessages():
url = f"https://projects.penguinmod.com/api/v1/users/getmessages?token={misc.TOKEN}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
jsons = json.loads(response.content.decode())
return jsons
def getUnreadMessages():
url = f"https://projects.penguinmod.com/api/v1/users/getunreadmessages?token={misc.TOKEN}"
response = requests.get(url)
if not response.status_code == 200:
error.rerror(response.status_code, response.content)
return -1
jsons = json.loads(response.content.decode())
return jsons