Skip to main content

A Scratch API Wrapper

Project description

scratchattach is a Scratch API wrapper with support for almost all site features. Created by TimMcCool.

The library allows setting cloud variables, following users, updating your profile, and so much more! Additionally, it provides frameworks that simplify sending data through cloud variables.

PyPI status PyPI download month PyPI version shields.io GitHub license Documentation Status

Documentation

Helpful resources

Report bugs by opening an issue on this repository. If you need help or guideance, leave a comment in the official forum topic. Projects made using scratchattach can be added to this Scratch studio.

Helpful for contributors

Contribute code by opening a pull request on this repository.

️Example usage

Set a cloud variable:

import scratchattach as sa

session = sa.login("username", "password")
cloud = session.connect_cloud("project_id")

cloud.set_var("variable", value)

More examples

Getting started

Installation:

Run the following command in your command prompt / shell:

pip install -U scratchattach

If this doesn't work, try running:

python -m pip install -U scratchattach

Logging in with username / password:

import scratchattach as sa

session = sa.login("username", "password")

login() returns a Session object that saves your login and can be used to connect objects like users, projects, clouds etc.

Logging in with a sessionId: You can get your session id from your browser's cookies. More information

import scratchattach as sa

session = sa.login_by_id("sessionId", username="username") #The username field is case sensitive

Cloud variables:

cloud = session.connect_cloud("project_id") # connect to the cloud

value = cloud.get_var("variable")
cloud.set_var("variable", "value") # the variable name is specified without the cloud emoji

Cloud events:

cloud = session.connect_cloud('project_id')
events = cloud.events()

@events.event
def on_set(activity):
    print("variable", activity.var, "was set to", activity.value)
events.start()

Follow users, love their projects and comment:

user = session.connect_user('username')
user.follow()

project = user.projects()[0]
project.love()
project.post_comment('Great project!')

All scratchattach features are documented in the documentation.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scratchattach-2.1.13.tar.gz (118.6 kB view details)

Uploaded Source

Built Distribution

scratchattach-2.1.13-py3-none-any.whl (141.3 kB view details)

Uploaded Python 3

File details

Details for the file scratchattach-2.1.13.tar.gz.

File metadata

  • Download URL: scratchattach-2.1.13.tar.gz
  • Upload date:
  • Size: 118.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for scratchattach-2.1.13.tar.gz
Algorithm Hash digest
SHA256 04a4e1e960b5fd17228074ecc705ba53d21bed1e27fa70f1fd0761aa13c991ea
MD5 be33f74cf0a3962673874017dc003afe
BLAKE2b-256 75a2fdcad615438531b460329e67b592d86cb1a6109d6f487341bc1da4c5363d

See more details on using hashes here.

Provenance

The following attestation bundles were made for scratchattach-2.1.13.tar.gz:

Publisher: python-app.yml on TimMcCool/scratchattach

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scratchattach-2.1.13-py3-none-any.whl.

File metadata

  • Download URL: scratchattach-2.1.13-py3-none-any.whl
  • Upload date:
  • Size: 141.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for scratchattach-2.1.13-py3-none-any.whl
Algorithm Hash digest
SHA256 5ed5a3d0749926a79ff09212cca6010a8418adb4f207548072e534111bdae1ed
MD5 ef2092fab5eb8fdc10752175e90963ce
BLAKE2b-256 d82da78efd406f1fe848b1eaabe5bb3f7cc2184ddeda33bcf1dc67a238cfc09f

See more details on using hashes here.

Provenance

The following attestation bundles were made for scratchattach-2.1.13-py3-none-any.whl:

Publisher: python-app.yml on TimMcCool/scratchattach

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page