Code Monkey home page Code Monkey logo

vscode-ably's Introduction

Ably for Visual Studio Code

The Ably Apps Explorer

Use the Ably for VS Code extension to manage your Ably apps directly in VS Code.

The extension enables you to:

  • List all apps in your Ably account.
    • View API keys, queues and integration rules for each app.
    • Copy API keys to your clipboard.
  • Create an Ably app.

Prerequisites

The only prerequisite is an Ably account which is free to sign-up.

Installation

After installing this extension, you need to provide your Ably account ID and Control API access token in VS Code Settings to get started.

  • Admin access to the Ably account is required to create a Control API access token.
  • The Control API access token requires the following permissions:
    • read:app
    • write:app
    • read:key
    • read:rule
    • read:queue

Image of Ably settings

In case the extension does not work after providing the AccountID and Control API access token, please restart VSCode.

Features

View Ably apps & details

Click on the Ably icon in the Activity Bar to view the apps in your Ably account. Apps will be listed in alphabetical order.

Expand an app to view the API keys, queues, rules and namespaces associated with it.

Image of an Ably app expanded

Use the copy to clipboard icon to copy an API key to the clipboard.

Create an Ably app

  1. Open the command palette (CMD+SHIFT+P) and choose Ably: Create App.
  2. Enter a name for the app when prompted.
  3. Select whether to enforce TLS for connections or not.
  4. A new app will be created and appears in the list once the view has been automatically refreshed.

Creation of an Ably App

Issues & Features

If you find an issue ๐Ÿชฒ or have a feature request ๐Ÿš€ please file them here.

Note that this extension is still in preview.

Contributing

Want to help contributing to this project? Have a look at our contributing guide!

More info


Ably logo

vscode-ably's People

Contributors

dependabot[bot] avatar m-hulbert avatar marcduiker avatar peter-maguire avatar tomczoink avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

vscode-ably's Issues

Add labels to Ably App explorer view

At the moment the Ably app explorer view shows values in the tree view explorer but besides from the icon there is no indication what the values mean. Having labels for some items (e.g. key capabilities) would result in a clearer user experience.

image

Feature: Show only active and disabled apps

๐Ÿ“ Feature description

At the moment the Able App Explorer lists all apps, including the deleted ones. To avoid confusion and cluttering only the active and disabled apps should be shown.

Link Checker Report

Summary

Status Count
๐Ÿ” Total 49
โœ… Successful 25
โณ Timeouts 0
๐Ÿ”€ Redirected 0
๐Ÿ‘ป Excluded 19
โ“ Unknown 0
๐Ÿšซ Errors 5

Errors per input

Errors in README.md

Full Github Actions output

Feature: Scaffold new projects that use Ably

The extension could also help in getting started with Ably. The developer could use the Command Palette to scaffold a new project, choosing their preferred language / framework and even some hosting options (Azure Static Web Apps, Netlify).

Issue: Extension is not activated when Create App is used before the treeview is opened

๐Ÿ“ Current behavior

Error pops up when Create App is performed from the command prompt:

[Window Title]
Visual Studio Code

[Content]
Command 'Ably: Create App' resulted in an error (command 'ably.createApp' not found)

[OK]

๐Ÿ“ Expected behavior

Ably Create App command would start.

โš™๏ธ Context

OS Windows 11
VSCode version: 1.66.1
Ably extension version: 0.0.1

โš™๏ธ Steps to reproduce

  1. Open VSCode
  2. Do not click on the Ably icon
  3. CTRL+SHIFT+P => Ably: Create App
  4. Error

Add functionality to refresh the App Explorer manually

Currently, the App Explorer only loads the apps once. If apps are being added/changed outside VSCode the explorer does not reflect that. A button to refresh the explorer manually would be beneficial before a more advanced automated sync is considered.

Issue: Queue Stats do not show the correct child elements

๐Ÿ“ Current behavior

When Stats for a specific queue are expanded it lists the name of another app and some empty items and not the statistics.

image

๐Ÿ“ Expected behavior

The child items under Stats should contain:

  • publishRate
  • deliveryRate
  • acknowledgementRate

โš™๏ธ Context

Version: 1.67.1 (user setup)
Commit: da15b6fd3ef856477bf6f4fb29ba1b7af717770d
Date: 2022-05-06T12:37:03.389Z
Electron: 17.4.1
Chromium: 98.0.4758.141
Node.js: 16.13.0
V8: 9.8.177.13-electron.0
OS: Windows_NT x64 10.0.22000

Ably extension version: 0.0.4

โš™๏ธ Steps to reproduce

  1. Expand an Ably App (that has queues)
  2. Expand Queues
  3. Expand a specific queue
  4. Expand Stats

Feature: Allow signup to Ably via plugin

It'd be great if we could have the ability to signup via the plugin, to help remove barriers to entry. I would imagine this working by opening a link to signup on the Ably site (/signup), with the addition of metadata which would mean that:

  1. A control API key is created automatically as part of signup
  2. The account ID and control key is returned to VSCode and populated in the settings for the app

This would require the addition of some logic to the website, allowing for the creation + response of a control API key as part of the signup flow.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.