From 1516fe68ea4ea508456e9e83aa1fcc24536d11ba Mon Sep 17 00:00:00 2001 From: C-3PO Date: Fri, 16 Nov 2018 04:53:14 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=84=20Add=20list=20of=20SSN=20reposito?= =?UTF-8?q?ries?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/setup-environment.md | 12 +++++++----- repositories/ssn.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+), 5 deletions(-) create mode 100644 repositories/ssn.md diff --git a/docs/setup-environment.md b/docs/setup-environment.md index 50cb096..6146163 100644 --- a/docs/setup-environment.md +++ b/docs/setup-environment.md @@ -1,19 +1,21 @@ -All tools are intended to be run on either WSL or Linux. +# Setting up the environment -# Setup +This page describes what you need to install before you can run the tools from the various repositories. We expect that you use Windows 10. + +## Steps 1. On Windows 10, install the Windows Subsystem for Linux (WSL) with either the Ubuntu or Debian distribution. 2. Open a command line shell: Press Win+R and enter `bash`. -2. Install Node.js ([source](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions)): +3. Install Node.js ([source](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions)): ```bash - wget -qO- https://deb.nodesource.com/setup_10.x | sudo -E bash - + wget -qO- https://deb.nodesource.com/setup_11.x | sudo -E bash - sudo apt-get install -y nodejs ``` -3. Install npm modules: +4. Install npm modules: ```bash sudo npm install -g typescript diff --git a/repositories/ssn.md b/repositories/ssn.md new file mode 100644 index 0000000..56e78a5 --- /dev/null +++ b/repositories/ssn.md @@ -0,0 +1,28 @@ +# SSN repositories + +An overview of all repositories related to the patcher (SSN). + +```plaintext + ssn-database + | + |------------| + ssn-auto ssn-manager ssn-tools + |------------|-------------| + | + ssn + | + ssn-installer +``` + +## Libraries + +- `argument-parser`: Abstracts parsing and verification of command line arguments. Used by `ssn-tools`. +- `ssn`: A Node.js library that exports various functions to download and parse SSN files, both low-level and high-level. +- `ssn-database`: Abstracts the data storage from `ssn-auto` and `ssn-manager`. +- `ssn-installer`: A low-level tool for extracting patch files. Used by `ssn` and not recommended to call on its own; better to use the higher-level functions from `ssn`. + +## Endpoints + +- `ssn-auto`: A command line tool that automatically checks for and installs new patches. Intended to be run as a cron job. +- `ssn-manager`: A GUI version of `ssn-auto` for debugging patch failures. +- `ssn-tools`: Various command line tools for debugging SSN without writing code. More low-level than `ssn-manager`.