Early Access

The VSLoad shedding notifier extension for Visual Studio Code is currently in early access. This means that the extension is still under development and may contain bugs or unfinished features. While we strive to make the extension as stable and functional as possible, we ask for your understanding and patience as we continue to improve the extension. Your feedback and suggestions are greatly appreciated and will help us shape the extension into a valuable tool for all users. Thank you for trying VSLoad shedding notifier!

Eskom Extension README

"Eskom loadShedding Notifier: This VSCode extension uses the EskomSePush API to retrieve the next loadShedding schedule for your area and sends a notification 15 minutes before the scheduled slot. Never be caught off guard by power outages again!" - thanks ChatGPT

You will need to subscribe to the EskomSePush (Free for 50 requests per day extension polls every 60mins and caches) and find your area code(eg. capetown-7-greenpoint)

Usage

To update the area to receive alerts from, open the Command pallet (shift + ctrl + p by default) and select Eskom: Update area.

To find out when the next load shedding slot ends or begins, open the Command pallet and select Eskom: Next load shedding slot.

Features

• Set load shedding warning time.
• Search for your area in the command palette
• 

Requirements

• EskomSePush API key (Free)

Extension Settings

This extension contributes the following settings:

• eskom.token: EskomSePush API key.
• eskom.area: EskomSePush Area id.
• eskom.warningTimeMins: Sets the number of minutes to warn before loadShedding
• eskom.provider: WIP sets the Provider (EskomSePush, Eskom, Satrix)

Known Issues

Providers are still a WIP although Eskom is implemented it has not been tested fully and is still in development Satrix has not been implemented yet (Awaiting api key)

Apis don't have clear documentation on no loadShedding responses so if the "No loadShedding" messaging may be a bit flaky

Release Notes

1.1.0

Adds Eskom as a data provider Adds Caching on eskomSePush provider to preserve api limits

1.0.0

Initial release of Eskom loadShedding notifier Adds a 15 minute warning Provides a command 'Next loadShedding' that gives information on the end time of the current loadShedding slot or the start time of the next slot.

Contributing

We welcome and appreciate any contributions to the Eskom loadShedding Notifier extension. Whether you are a beginner or an experienced developer, there is always a way for you to contribute. Here are a few ways you can help:

Reporting Bugs: If you encounter any bugs while using the extension, please open an issue on GitHub so that we can fix them.

Suggesting Features: If you have an idea for a new feature that would improve the extension, please open an issue on GitHub to share your suggestions.

Fixing Bugs and Implementing Features: If you would like to contribute by fixing bugs or implementing new features, please fork the repository, make the changes, and submit a pull request.

Documentation: If you find any inaccuracies or missing information in the documentation, please feel free to update it and submit a pull request.

Development

Before you begin, please ensure that you have the following installed on your machine:

• Visual Studio Code
• Node.js

To get started with development, please follow these steps:

1. Fork the repository
2. Clone the repository to your machine
3. Open the repository in Visual Studio Code
4. Run the command npm install to install all dependencies
5. Make your changes
6. Test your changes by running the extension in the VS Code Extension Development Host
7. Submit a pull request

Please make sure to follow the VS Code extension guidelines when developing the extension. Extension Guidelines

Thanks for considering contributing to the Eskom loadShedding Notifier extension. We look forward to working with you!

You can find the repository at https://github.com/bryn-hill/Eskom-vscode-extension

Disclaimer

The Eskom loadShedding Notifier extension is a third-party tool and is not endorsed by, affiliated with, or supported by Eskom or EskomSePush. The extension uses the EskomSePush development API to provide load shedding schedule updates, but the accuracy of the information cannot be guaranteed.

Eskom and EskomSePush take no responsibility for any errors or inaccuracies in the load shedding schedule provided by the extension. Users should consult the official Eskom website for the most up-to-date and accurate load shedding schedule.

The developers of the Eskom loadShedding Notifier extension are not responsible for any damages or losses that may occur as a result of using the extension. Use of the extension is at your own risk.

Credits

• Data provided by EskomSePush, Eskom
• Status information from EWN