Classroom abilities + create studio + misc #294

FAReTek1 · 2024-12-08T13:03:18Z

New classroom abilities

Adds a wide array of capabilities for scratch's classroom system, including:

Creating classes
Loading closed classes using HTML web scraping
Checking if a class is closed
Setting thumbnails (also added the ability to set pfps of normal accounts as well)
Setting descriptions
Setting 'what we're working on'/status
Setting class title/name
Adding studios
Closing/Reopening classes
Registering students (NOT FROM CSV) should this be removed?
Generating signup link (This actually just uses the class token)
Fetching public activity (same format as user activity; loading from HTML)
Fetching private activity - things like comments or profile updates (in a bad format which is very improvable)
Registering users with simply a class token
Abilities to load stuff in classes in different sort modes

Other new abilities

create_studio()

Added the Session.create_studio() function to create studios to solve an issue (#277). I copy+pasted rate limit code from Session.create_project(). Also added title/desc settings to make it more convenient

exceptions

Now using the msg argument in exceptions.Unauthorized() so that you can add more detail to the exception if need be. When receiving a 403/401 status code in the requests wrapper, it will now print the request content which will sometimes be more descriptive than simply: "You are unauthorised"
Renamed ConnectionError to CloudConnectionError since ConnectionError is actually a builtin error

misc changes/features

added password reset email sender (since i was resetting passwords of a lot of my old accounts)
A few scratchtools endpoints (isonline, is beta user, scratchtools display name) in other_apis.py
Added class option to commons.webscrape_count

Extra Note(s)

In cloud_requests.py, I fixed a typo of self.call_even, changing it to self.call_event. In the rare case this is intentional, now you know
Also it looks like I pressed ctrl-alt-l again...
I added a lot of dosctrings at the start of when I made this, before I knew about from __future__ import annotations so that may need to be fixed

…or is a builtin so i renamed it, also i fixed a typo in cloud_requests.py

Signed-off-by: FA ReTek <107722825+FAReTek1@users.noreply.github.com>

fixed image in pypi info page

…tatus (wiwo for classes)

…ormat though

…commcraft

…brazilian)

…le attrs

FAReTek1 · 2024-12-21T14:09:33Z

more potential features:
actually parse the private activity

FAReTek1 · 2024-12-23T09:19:53Z

I will add the parser for private class activity first

FAReTek1 · 2024-12-23T12:24:43Z

there is now a parser for the private activity. no parser for alerts tho

FAReTek1 · 2024-12-23T12:25:46Z

here is the reference file i used to build that parser:

<script type="text/template" id="template-activity-list-item">
    <% switch(type)
    { case 0: %>
    <span class="icon-xs black follow"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    followed user
    <a href="/users/<%- followed_username %>"><%- followed_username %></a>

    <% break; case 1:  %>
    <span class="icon-xs black follow"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    followed studio
    <a href="/studios/<%- gallery %>"><%- title %></a>

    <% break; case 2:  %>
    <span class="icon-xs black love"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    loved the project
    <a href="/projects/<%- project %>"><%- title %></a>

    <% break; case 3:  %>
    <span class="icon-xs black favorite"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    favorited the project
    <a href="/projects/<%- project %>"><%- project_title %></a>

    <% break; case 7:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    added the project
    <a href="/projects/<%- project %>"><%- project_title %></a>
    to studio
    <a href="/studios/<%- gallery %>"><%- gallery_title %></a>

    <% break; case 8:  %>

    <% break; case 9:  %>

    <% break; case 10:  %>

    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>

    <% if (is_reshare) { %>

    shared the project

    <% } else { %>

    reshared the project

    <% } %>

    <a href="/projects/<%- project %>"><%- title %></a>

    <% break; case 11:  %>

    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    remixed the project
    <a href="/projects/<%- project %>"><%- title %></a>

    <% break; case 13:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    added the studio
    <a href="/studios/<%- gallery %>">Untitled Studio</a>

    <% break; case 15:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    updated the studio
    <a href="/studios/<%- gallery %>"><%- title %></a>

    <% break; case 16:  %>

    <% break; case 17:  %>

    <% break; case 18:  %>

    <% break; case 19:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    removed the project
    <a href="/projects/<%- project %>"><%- project_title %></a>
    from studio
    <a href="/studios/<%- gallery %>"><%- gallery_title %></a>

    <% break; case 20:  %>

    <% break; case 21:  %>

    <% break; case 22:  %>
    <span class="icon-xs black follow"></span>
    <a href="/users/<%- recipient_username %>"><%- recipient_username %></a>
    was promoted to manager by
    <a href="/users/<%- actor_username %>"><%- actor_username %></a>
    for studio
    <a href="/studios/<%- gallery %>"><%- gallery_title %></a>

    <% break; case 23:  %>

    <% break; case 24:  %>

    <% break; case 25:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    made a profile update. <em></em>

    <% break; case 26:  %>

    <% break; case 27:  %>
    <span class="icon-xs black comment"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    <% if (comment_type === 0) { %>
        commented on the project
        <a href="/projects/<%- comment_obj_id %>"><%- comment_obj_title %></a>
        <%
        // format the direct link to the comment (used in the comment block below)
        var comment_reply_link = '/projects/' + comment_obj_id + '/#comments-' + comment_id
        %>
    <% } %>

    <% if (comment_type === 1) { %>
        commented on user
        <a href="/users/<%- comment_obj_title %>"><%- comment_obj_title %></a>
        <%
        // format the direct link to the comment (used in the comment block below)
        var comment_reply_link = '/users/' + comment_obj_title + '/#comments-' + comment_id
        %>
        <% } %>

    <% if (comment_type === 2) { %>
        commented on the studio
        <a href="/studios/<%- comment_obj_id %>"><%- comment_obj_title %></a>
        <%
        // format the direct link to the comment (used in the comment block below)
        var comment_reply_link = '/studios/' + comment_obj_id + '/#comments-' + comment_id
        %>
        <% } %>

    <% break; default:  %>
    <span class="icon-xs black project"></span>
    <a href="/users/<%- actor.username %>"><%- actor.username %></a>
    performed an action. <em> <%- type %></em>
    <% break;} %>

    <span class="time"><span class="media-info-item date shortDateFormat last"><%- $.format.date(datetime_created, "MM/dd/yyyy") %></span></span>


    <% if (typeof comment_fragment !== 'undefined') { %>
    <div class="comment-block">
        <span class="comment-text"><%- comment_fragment %></span>
        <a class="reply" href="<%= comment_reply_link %>"> <span>Reply</span> </a>
    </div>
    <% } %>
</script>


<script type="text/template" id="template-alert-list-item">
    <div class="alert-item-content" data-alert-id="<%- id %>">
        <span class="alert-icon small"></span>
        <% switch(admin_action.type)
            { case 0: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            banned.

            <% break; case 1: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            unbanned.

            <% break; case 2: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            excluded from homepage.

            <% break; case 3: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            excluded from homepage.

            <% break; case 4: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            notified by a Scratch Administrator. Notification Type: <%- admin_action.extra_data.notification_type ||
            'Unknown' %>

            <% break; case 5: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            banned automatically.

            <% break; case 6: %>
            <a href='/projects/<%- admin_action.object_id %>'><%- admin_action.extra_data.project_title %></a> by <a
                href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            removed automatically.

            <% break; case 7: %>

            <% case 20: %>
            <a href='/projects/<%- admin_action.object_id %>'><%- admin_action.extra_data.project_title %></a> by <a
                href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            censored.

            <% break; case 8: %>
            <a href='/projects/<%- admin_action.object_id %>'><%- admin_action.extra_data.project_title %></a> by <a
                href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            uncensored.

            <% break; case 9: %>

            <% case 10: %>
            <a href='/projects/<%- admin_action.object_id %>'><%- admin_action.extra_data.project_title %></a> by <a
                href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            reviewed by a Scratch Administrator.

            <% break; case 11: %>
            <a href='/projects/<%- admin_action.object_id %>'><%- admin_action.extra_data.project_title %></a> by <a
                href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            deleted by a Scratch Administrator.

            <% break; case 12: %>
            <% case 17: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
            deleted by a Scratch Administrator.

            <% break; case 13: %>

            <% case 14: %>
            <a href='/studios/<%- admin_action.object_id %>'><%- admin_action.extra_data.gallery_title %></a> was reviewed
            by a Scratch Administrator.

            <% break; case 15: %>
            <a href='/studios/<%- admin_action.object_id %>'><%- admin_action.extra_data.gallery_title %></a> was deleted by
            a Scratch Administrator.

            <% break; case 16: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> deleted
            their own account.

            <% break; case 18: %>
            The email address of <a href='/users/<%- admin_action.target_user.username %>'><%-
            admin_action.target_user.username %></a> was confirmed by a Scratch Administrator

            <% break; case 19: %>
            The email address of <a href='/users/<%- admin_action.target_user.username %>'><%-
            admin_action.target_user.username %></a> was set as not confirmed by a Scratch Administrator

            <% break; case 22: %>
            <% if(typeof admin_action.extra_data.comment_content == 'undefined'){ %>
                <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
                automatically muted by our comment filters.
            <% } else { %>
                <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> was
                automatically muted by our comment filters. The comment they tried to post was: <i><%-
                admin_action.extra_data.comment_content.content %></i>
            <% } %>

            <% break; default: %>
            <a href='/users/<%- admin_action.target_user.username %>'><%- admin_action.target_user.username %></a> had an
            admin action performed. <em><%- admin_action.type %></em>

            <% break;} %>

            <span class="time"><span class="media-info-item date shortDateFormat last"><%- $.format.date(admin_action.datetime_created, "MM/dd/yyyy") %></span></span>
            <% if(typeof classroom_names !== 'undefined'){ %>
                <div class="alert-classroom-data">Classes: <em><%- classroom_names %></em></div>
            <% } %>
            <% if(this.allowHideAlerts) { %>
                <span data-control="hide-alert" data-message-id="<%= admin_action.message %>" class="delete">x</span>
        <% } %>
    </div>
</script>

Signed-off-by: faretek <107722825+FAReTek1@users.noreply.github.com>

FAReTek1 · 2024-12-24T16:41:06Z

I think that some tester code should be written to make sure that scratchattach is running fine. It makes me very scared whenever I make large merges like this, especially with all of the conflicts that I have to solve

FAReTek1 · 2024-12-24T16:49:38Z

well, as long as it isn't pushed to pypi yet, it is safe to debug and fix?

FAReTek1 · 2024-12-24T16:49:56Z

merging it now reduces the chances of more issues to crop up

FAReTek1 · 2024-12-24T16:56:39Z

i now want to make some tester algorithm that asserts that everything is functioning as usual. however it will be quite complicated to code

FAReTek1 · 2025-04-13T20:57:41Z

i realise now, the empty cases are actually relaying onto the next case statement. this needs to be fixed

FAReTek1 · 2025-04-13T21:12:12Z

fixed in my upcoming pr

FAReTek1 and others added 30 commits November 9, 2024 20:02

Added create_studio and did a little with exceptions. - ConnectionErr…

645606a

…or is a builtin so i renamed it, also i fixed a typo in cloud_requests.py

typo

07a69c2

Signed-off-by: FA ReTek <107722825+FAReTek1@users.noreply.github.com>

A ton of UNTESTED docstrings

f9922af

Merge remote-tracking branch 'origin/main'

253f88a

More UNTESTED type hints

92344ed

More UNTESTED type hints

4e23734

More UNTESTED type hints

8a53174

Added (smart) translation api

6cb631f

Merge pull request #2 from TimMcCool/main

69e697f

fixed image in pypi info page

Added tts api

f3ce6a2

Merge remote-tracking branch 'origin/main'

47b0257

added an enum i guess?

1a9e4d8

using languages enum now + kitten improvement

765b068

more classroom stuff. lets you actually edit title, description and s…

dbe7c32

…tatus (wiwo for classes)

classroom alerts, simplified code for wiwo/bio setting

7434255

added setting pfp! wow that was confusing! bruh

1904ee1

find ended classes, reopen/close classes & set thumbnail

680640e

activity for classes. private activity is in a weird non-normalised f…

0ee943a

…ormat though

added more parameters for the functions

c569235

register by class token

a2b87ef

smarter language evaluation in translate function. some credit to the…

51d3422

…commcraft

dataclasses = conciseness & clean

cec1a12

docstrings and removing use of kwarg for all_of

a5c48a0

merge tts chinese with translate versions, same with portuguese (not …

6ce4ff7

…brazilian)

using enums for tts genders asw + enum wrapper with finding by multip…

a6c6168

…le attrs

make sure language has code for translation

7d71d96

1 docstring

24c7f1f

removed json.dumps, using json in requests.post instead

d0f9356

added support for closed classes using bs4

7752050

studio adding and code simplification

9f8f727

reset email thing

0064dba

This was referenced Dec 21, 2024

(not important) session __str__ typo #300

Closed

Type safe? #259

Closed

various basic scratchtools endpoints

9c2f6c4

FAReTek1 changed the title ~~Classroom abilities + create studio~~ Classroom abilities + create studio + misc Dec 21, 2024

FAReTek1 mentioned this pull request Dec 21, 2024

basic scratchtools features (enhancement) #298

Closed

FAReTek1 added 3 commits December 21, 2024 15:56

get emoji status

9b63c3e

get pinned comment

decbf69

ctrl alt l (reformat)

0daab14

FAReTek1 added the enhancement New feature or request label Dec 23, 2024

FAReTek1 added 4 commits December 23, 2024 11:28

actually parse private class activity (analyzed html/js to do so)

c0f2ee8

moved json activity parser to activity method

220c703

using datetime_created because it is more applicable??

f349826

add datetime_created as attribute for hinting

66f3782

Merge branch 'main' into classes

ae1002a

Signed-off-by: faretek <107722825+FAReTek1@users.noreply.github.com>

fix files param

4ba9ed0

FAReTek1 merged commit 9432bb1 into TimMcCool:main Dec 24, 2024

FAReTek1 deleted the classes branch December 24, 2024 16:57

FAReTek1 mentioned this pull request Apr 13, 2025

Classroom alerts parser & update Classroom private activity parser. solves #304 #383

Closed

5 tasks

FAReTek1 mentioned this pull request May 5, 2025

Classroom alerts parser & update Classroom private activity parser. solves #304 #396

Merged

5 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Classroom abilities + create studio + misc #294

Classroom abilities + create studio + misc #294

Uh oh!

FAReTek1 commented Dec 8, 2024 •

edited

Loading

Uh oh!

FAReTek1 commented Dec 21, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Apr 13, 2025

Uh oh!

FAReTek1 commented Apr 13, 2025

Uh oh!

Uh oh!

Classroom abilities + create studio + misc #294

Classroom abilities + create studio + misc #294

Uh oh!

Conversation

FAReTek1 commented Dec 8, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New classroom abilities

Other new abilities

create_studio()

exceptions

misc changes/features

Extra Note(s)

Uh oh!

FAReTek1 commented Dec 21, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 23, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Dec 24, 2024

Uh oh!

FAReTek1 commented Apr 13, 2025

Uh oh!

FAReTek1 commented Apr 13, 2025

Uh oh!

Uh oh!

FAReTek1 commented Dec 8, 2024 •

edited

Loading