docs: use copy of sawiki instead of reference

Author: faretek1

docs/SA-Wiki/Cloud-Requests.md

@@ -0,0 +1,129 @@
+**Scratch API wrapper with support for almost all site features.** Created by [TimMcCool](https://scratch.mit.edu/users/TimMcCool/).
+
+This library can set cloud variables, follow Scratchers, post comments and do so much more! It has special features that make it easy to transmit data through cloud variables.
+
+<p align="left">
+  <img width="120" src="https://github.com/TimMcCool/scratchattach/blob/main/logos/logo.svg">
+</p>
+
+[![PyPI status](https://img.shields.io/pypi/status/scratchattach.svg)](https://pypi.python.org/pypi/scratchattach/)
+[![PyPI download month](https://img.shields.io/pypi/dm/scratchattach.svg)](https://pypi.python.org/pypi/scratchattach/)
+[![PyPI version shields.io](https://img.shields.io/pypi/v/scratchattach.svg)](https://pypi.python.org/pypi/scratchattach/)
+[![GitHub license](https://badgen.net/github/license/TimMcCool/scratchattach)](https://github.com/TimMcCool/scratchattach/blob/master/LICENSE)
+[![Documentation Status](https://readthedocs.org/projects/scratchattach/badge/?version=latest)](https://scratchattach.readthedocs.io/en/latest/?badge=latest)
+
+## It is *strongly* advised to learn Python before using scratchattach.
+
+# Documentation
+
+- **[Documentation](https://github.com/TimMcCool/scratchattach/wiki/Documentation)**
+
+- [Cloud Variables](https://github.com/TimMcCool/scratchattach/wiki/Documentation#cloud-variables)
+- [Cloud Requests](https://github.com/TimMcCool/scratchattach/wiki/Cloud-Requests)
+- [Cloud Storage](https://github.com/TimMcCool/scratchattach/wiki/Cloud-Storage)
+- [Filterbot](https://github.com/TimMcCool/scratchattach/wiki/Filterbot)
+- [Self-hosting a TW cloud websocket](https://github.com/TimMcCool/scratchattach/wiki/Documentation#hosting-a-cloud-server)
+
+# Helpful resources
+
+- [Get your session id](https://github.com/TimMcCool/scratchattach/wiki/Get-your-session-id)
+
+- [Examples](https://github.com/TimMcCool/scratchattach/wiki/Examples)
+- [Hosting](https://github.com/TimMcCool/scratchattach/wiki/Hosting)
+
+- [Migrating to v2](https://github.com/TimMcCool/scratchattach/wiki/Migrating-to-v2)
+
+Report bugs by opening an issue on this repository. If you need help or guideance, leave a comment in the [official forum topic](https://scratch.mit.edu/discuss/topic/603418/
+). Projects made using scratchattach can be added to [this Scratch studio](https://scratch.mit.edu/studios/31478892/).
+
+# Helpful for contributors
+
+- **[Structure of the library](https://github.com/TimMcCool/scratchattach/wiki/Structure-of-the-library)**
+
+- [Extended documentation (WIP)](https://scratchattach.readthedocs.io/en/latest/)
+
+- [Change log](https://github.com/TimMcCool/scratchattach/blob/main/CHANGELOG.md)
+
+Contribute code by opening a pull request on this repository.
+
+# ️Example usage
+
+Set a cloud variable:
+
+```py
+import scratchattach as sa
+
+session = sa.login("username", "password")
+cloud = session.connect_cloud("project_id")
+
+cloud.set_var("variable", value)
+```
+
+**[More examples](https://github.com/TimMcCool/scratchattach/wiki/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:**
+
+```python
+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](https://github.com/TimMcCool/scratchattach/wiki/Get-your-session-id)*
+```python
+import scratchattach as sa
+
+session = sa.login_by_id("sessionId", username="username") #The username field is case sensitive
+```
+
+**Cloud variables:**
+
+```py
+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:**
+
+```py
+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:**
+
+```py
+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](https://github.com/TimMcCool/scratchattach/wiki/Documentation).**

docs/SA-Wiki/Cloud-Storage.md

@@ -0,0 +1,26 @@
+Scratchattach v2 is not backwards compatible. But upgrading is worth it, because it comes with many new features.
+
+This page lists the main non-backwards-compatible changes to make it easier for you to upgrade. If you're running into unexpected errors, check the documentation to find out how the specific feature works in scratchattach v2.
+
+1. Generally, `scratchattach` is now imported as / referenced as `sa` (no longer as `scratch3`) in the docs.
+2. `session = scratch3.Session("session_id")` was changed to `session = sa.login_by_id("session_id")`
+3. `events = scratch3.CloudEvents("project_id")` was changed to `events = sa.get_cloud("project_id").events()`
+4. `client = scratch3.CloudRequests(conn)` was changed to `client = session.connect_cloud("project_id").requests()`
+5. `value = scratch3.get_var("project_id", "variable")` was changed to
+```py
+cloud = sa.get_cloud("project_id") # This function is ran once
+value = cloud.get_var("variable") # This function can safely be called in a loop without spamming an API
+```
+The same applies to getting TurboWarp cloud variables.
+
+6. All comments are now represented by `sa.Comment` objects
+7. All activites and messages are now represented by `sa.Activity` objects
+8. Projects and studios are now always represented by `sa.Project` and `sa.Studio` objects, never as dicts
+9. project.get_comment was changed to project.comment_by_id
+10. Generally, many functions that used to start with ".get_" had the "get_" removed from their names.
+11. If an attribute refers to a username, it is now always ".username" and not ".user"
+12. `CloudConnection` and `TwCloudConnection` don't exist anymore. Instead, there are now `Cloud` and `TwCloud` objects that not only handle setting cloud variables, but also have built in functions for getting variables very frequently without spamming the API (new CloudRecorder infrastracture).
+13. `TwCloudEvents` and `WsCloudEvents` were merged into `CloudEvents`. The formerly called `CloudEvents` are now `CloudLogEvents`
+14. `TwCloudRequests` and `CloudRequests` were merged into `CloudRequests`
+15. All events are now always ran in threads by default. You can disable this using `@events.event(thread=False)`
+16. Cloud Request Events don't use the `id` attribute anymore. Instead, they use the `request_id` attribute.

docs/SA-Wiki/Documentation.md

@@ -0,0 +1,73 @@
+Scratchattach provides a submodule `editor` for project parsing/editing. It is useful for extracting data from projects, or performing repetitive operations.
+
+> [!NOTE]
+> Scratchattach.editor is work-in-progress. If there is a feature missing or a strange bug, [please add an issue!](https://github.com/TimMcCool/scratchattach/issues)
+
+# Basic usage
+
+### import scratchattach.editor:
+```py
+from scratchattach import editor
+```
+
+### Load a project
+```py
+# from a sb3 filepath:
+proj = editor.Project.from_sb3("test proj.sb3")
+
+# from a binary file
+with open("test proj.sb3", "rb") as f: 
+    proj = editor.Project.from_sb3(f)
+
+# from a bytes
+with open("test proj.sb3", "rb") as f:
+    sb3_bytes = f.read()
+proj = editor.Project.from_sb3(sb3_bytes)
+
+# from a project id
+proj = editor.Project.from_id(104)  # Project<name=Weekend, meta=Meta<3.0.0 : 0.1.0 : scratchattach.editor by https://scratch.mit.edu/users/timmccool/>>
+```
+
+### View project attributes
+```py
+# print project name, if applicable (inferred from project title, or file name)
+print(proj.name)  # test proj
+
+# print project assets (costumes and sounds in all sprites)
+for asset in proj.assets:
+    print(asset)
+
+# View turbowarp configuration
+print(proj.tw_config)
+
+# Get comment instance storing twconfig
+print(proj.tw_config_comment)
+
+# Get a variable, list or broadcast (including for-this-sprite-only vars)
+print(proj.find_vlb("my variable"))
+
+# Get all variables/lists/broadcasts with name
+print(proj.find_vlb("my variable", multiple=True))  # if you have a variable and list called 'my variable' this will return a list including both
+
+# print project monitors (variable/list displays)
+print(proj.monitors)
+
+# print project metadata
+# prints in format {semver} : {vm} : {agent} : {Optional[Platform metadata (used by turbowarp)]}
+print(proj.meta)  # Meta<3.0.0 : 0.1.0 : scratchattach.editor by https://scratch.mit.edu/users/timmccool/: PlatformMeta(name='TurboWarp', url='https://turbowarp.org/')>
+
+# view extensions that are used by the project (this may not work with old scratch projects)
+print(proj.extensions)  # [Extension(code='pen', name='Pen Extension')]
+
+# SUBJECT TO CHANGE: Add a monitor to the project
+vlb = proj.find_vlb('var')
+m = editor.Monitor(vlb, visible=True, params={
+    "VARIABLE": vlb.name
+})
+
+proj.add_monitor(m)
+```
+
+> [!WARNING]
+> Loading scripts from the backpack requires a special function: editor.load_script_from_backpack, because the backpack uses a 
+> slightly different block syntax