npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

platform-chaos

v1.0.0

Published

A node sdk for building services capable of injecting chaos into PaaS offerings

Downloads

5

Readme

platform-chaos

Build Status

A node sdk for building services capable of injecting chaos into PaaS offerings. ⚙️ 🌩

hero image

Platform chaos is a collection of tools and sdks that enable engineers to experiement on distributed systems built atop PaaS offerings to ensure confidence in such a system's capabilities. It does so by defining a common interface for inducing chaos, through a construct we call chaos extensions. Given this common interface, we're able to provide tooling that can schedule, start, and stop chaotic events.

This project is the core sdk that enables chaos extension development using NodeJS.

The common interface mentioned above that all chaos extensions must implement is defined using OpenAPI docs here. As such, an extension can be developed using any language. SDKs to simplify creation of extensions using other languages may be added in the future.

How to use

To consume this sdk, install it from NPM:

npm install platform-chaos

Then consume the module in code, leveraging the following API.

API

This is the exported API from the platform-chaos NPM module.

validators

Request validation helpers. Useful to ensure data coming in is behaving as expecting.

const validate = require('azure-chaos-fn/validators')

accessToken

Validates that the body of a req object contains a valid accessToken.

try { require('azure-chaos-fn/validators').accessToken(req) } catch (ex) { console.error(`error: ${ex}`) }

resources

Validates that the body of a req object contains a valid resources array.

try { require('azure-chaos-fn/validators').resources(req) } catch (ex) { console.error(`error: ${ex}`) }

parsers

Note: these depend on the validators to ensure only valid data is parsed.

Request parser helpers. Useful to parse valid request data into models.

const parsers = require('azure-chaos-fn/parsers')

accessTokenToCredentials

Inflates the accessToken from a req objects body into a ms-rest-azure compatible credentials object.

const credentials = require('azure-chaos-fn/parsers').accessTokenToCredentials(req)

resourcesToObjects

Inflates the resources from a req objects body into a collection of objects containing the following properties:

  • subscriptionId - the azure subscription id to target
  • resourceGroupName - the azure resource group name to target
  • resourceName - the azure resource name to target
const objs = require('azure-chaos-fn/parsers').resourcesToObjects(req)

Related Projects

  • platform-chaos-api - An API for introducing chaos into Azure PaaS offerings using configurable extensions.
  • platform-chaos-cli - A tool for introducing chaos into Azure PaaS offerings using configurable extensions.

For a list of already built chaos extensions, please see The extensions document.

Contributing

This project welcomes contributions and suggestions! Here's what you need to know to get started.

Feedback and Feature Requests

When you're ready, you can open issues here!

To submit feedback or request features please do a quick search for similar issues, then open a new issue. If you're requesting a new feature, please briefly explain in the issue what scenario you're planning to use the feature for.

Development Requirements

To get started developing, you'll need to first ensure you have these tools installed:

Once you've installed those, clone this repository and install dependencies:

git clone https://github.com/Azure/platform-chaos.git
cd platform-chaos
npm install

Now you're ready to begin contributing!

Testing

To run the tests for this project, first ensure you've installed the requirements. Then use npm to run the tests locally:

npm test

Note that this command is meant to be run from the project directory. That is, the folder that you cloned the project into (likey platform-chaos).

Legal

Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Submitting Pull Requests

When you're ready, you can submit pull requests here!

We've defined a pull request template that should be filled out when you're submitting a pull request. You'll see it when you create your PR. Please fill it out to the best of your ability!

Further, your pull request should:

  • Include a description of what your change intends to do
  • Be a child commit of a reasonably recent commit in the master branch
    • Requests need not be a single commit, but should be a linear sequence of commits (i.e. no merge commits in your PR)
  • It is desirable, but not necessary, for the tests to pass at each commit
  • Have clear commit messages
    • e.g. "Refactor feature", "Fix issue", "Add tests for issue"
  • Include adequate tests
    • At least one test should fail in the absence of your non-test code changes. If your PR does not match this criteria, please specify why
    • Tests should include reasonable permutations of the target fix/change
    • Include baseline changes with your change

Note that once you've submitted a pull request you may need to sign a CLA - see the legal section for more information.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.