Sync Settings for Atom

IMPORTANT NOTE: This is a fork from sync-settings for private usage with EOL bug fix.

Synchronize settings, keymaps, user styles, init script, snippets and installed packages across Atom instances.

Features

Sync Atom's and package settings
Sync installed packages
Sync user keymaps
Sync user styles
Sync user init script
Sync snippets
Sync user defined text files

Installation

$ apm install sync-settings-fork or using the Install button from Atom.io.

Backup locations

By default your backup will be stored in a gist, but you may also install other location packages.

Some other locations:

Local Folder: sync-settings-folder-location
Git Repo: sync-settings-git-location

Gist Setup

Open Sync Settings configuration in Atom Settings.
Create a new personal access token which has the gist scope and be sure to activate permissions: Gist -> create gists.
Copy the access token to Sync Settings configuration or set it as an environmental variable GITHUB_TOKEN.
Create a new gist:

The description can be left empty. It will be set when invoking the backup command the first time.
Use packages.json as the filename.
Put some arbitrary non-empty content into the file. It will be overwritten by the first invocation of the backup command
Save the gist.

Copy the gist id (last part of url after the username) to Sync Settings configuration or set it as an environmental variable GIST_ID.

Disclaimer: GitHub Gists are by default public. If you don't want other people to easily find your gist (i.e. if you use certain packages, storing auth-tokens, a malicious party could abuse them), you should make sure to create a secret gist.

Alternative Sync Settings configuration using Atom's config.cson

Click on Menu "Open Your Config" to edit Atom's config.cson
Use these keys:

  "sync-settings":
    gistId: "b3025...88c41c"
    personalAccessToken: "6a10cc207b....7a67e871"

Cloning a backup to a fresh Atom install

Install the package from the command line: apm install sync-settings
Launch Atom passing in GITHUB_TOKEN and GIST_ID. For example:

GITHUB_TOKEN=6a10cc207b....7a67e871 GIST_ID=b3025...88c41c atom

You will still need to make sure you add your gist id and github token to the Sync Settings configuration in Atom Settings OR set them as environment variables in your shell configuration.

Usage

Open the Atom Command Palette where you can search for the following list of commands.

Backup or restore all settings from the Packages menu or use one of the following commands:

sync-settings:backup
sync-settings:restore

View your online backup using the following command:

sync-settings:view-backup

Check the latest backup is applied:

sync-settings:check-backup

You can also fork existing settings from a different GitHub user using the following command:

sync-settings:fork
In the following input field enter the Gist ID to fork

Create a new backup:

sync-settings:create-backup

Delete the current backup:

sync-settings:delete-backup

Running the tests

Create a new personal access token which has the gist scope and will be used for testing purposes.
Export it with export GITHUB_TOKEN=YOUR_TOKEN
Run apm test

Contributing

If you're going to submit a pull request, please try to follow the official contribution guidelines of Atom.

Fork it.
Create your feature branch (git checkout -b my-new-feature).
Ensure tests are passing. See running-the-tests.
Commit your changes (git commit -am 'Add some feature').
Push to the branch (git push origin my-new-feature).
Create new Pull Request.

See all contributors.

Location Service

Packages can provide a location service using Atom's Service's API

Example:

Add the keywords sync-settings and location and add the providedServices property to your package.json file.

// package.json
  ...
  "main": "./main.js",
  ...
  "keywords": [
    ...
    "sync-settings",
    "location"
  ],
  ...
  "providedServices": {
    "sync-settings-location": {
      "versions": {
        "1.0.0": "provideLocationService"
      }
    }
  },
  ...

Then add the provideLocationService function to your main.js file (where your activate function is for Atom to activate your package)

// main.js
  ...
  activate () {
    ...
  },

  provideLocationService () {
    return require('./locationService.js')
  },
  ...

Return an object that provides the functions for your service.

// locationService.js

module.exports = {
  /**
   * Get URL for the backup
   * @return {string} Backup URL. Return null if no URL exists
   */
  async getUrl () {
    ...
  },

  /**
   * Create new backup location
   * @return {Object} Returns empty object on success. Falsey value on silent error
   */
  async create () {
    ...
  },

  /**
   * Get backup files and time
   * @return {Object} Returns object with `files` and `time` on success. Falsey value on silent error
   */
  async get () {
    ...
    return {
      files: {
        'filename.txt': {
          content: '...'
        }
      },
      time: new Date().toISOString(), // ISO string, (e.g. 2020-01-01T00:00:00.000Z)
    }
  },

  /**
   * Delete backup
   * @return {Object} Returns empty object on success. Falsey value on silent error
   */
  async delete () {
    ...
  },

  /**
   * Update backup and get time
   * @param  {Object} files Files to update
   * @return {Object} Returns object with `time` on success. Falsey value on silent error
   */
  async update (files) {
    ...
    return {
      time: new Date().toISOString(),
    }
  },

  /**
   * Fork backup
   * @return {Object} Returns empty object on success. Falsey value on silent error
   */
  async fork () {
    ...
  },
}

garyyeap/sync-settings