https://github.com/dfinke/PSAdvantage

GitHub Actions at your Fingertips! ✨ - via PowerShell
https://github.com/dfinke/PSAdvantage

Last synced: about 1 month ago
JSON representation

GitHub Actions at your Fingertips! ✨ - via PowerShell

• Host: GitHub
• URL: https://github.com/dfinke/PSAdvantage
• Owner: dfinke
• License: bsd-3-clause
• Created: 2021-02-20T21:28:43.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-06-20T13:33:44.000Z (over 2 years ago)
• Last Synced: 2024-05-18T05:36:21.925Z (4 months ago)
• Language: PowerShell
• Homepage:
• Size: 3.77 MB
• Stars: 40
• Watchers: 5
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - dfinke/PSAdvantage - GitHub Actions at your Fingertips! ✨ - via PowerShell (PowerShell)

README

        
GitHub Actions at your Fingertips! ✨

via PowerShell




  

  

    

  

  

    

  

 

 



  Documentation •

  Usage •

  Getting Started



PSAdvantage is a GitHub Actions Automation Framework presented to you as a CLI! It leverages a powerful templating engine and the Actions REST API to perform various tasks. This enables you to make use the CI on a daily basis for heavy time-consuming tasks to game up your productivity to the next level.


Whether its parsing a dataset for research purposes or running a couple of custom scripts for your daily task, PSAdvantage _simplifies_ everything. Its very similar to a "shell on the web", except the fact that you can easily spin up new instances/workflows with complete control over the target machine on which it is running.

## Main Features

Here are some features which it offers so far:

- [x] Simple and customizable templating engine using PowerShell.

- [x] Can handle automatic repository creation/cloning/deletion.

- [x] Allows you to automatically/manually create, trigger, or cancel workflows.

- [x] Downloading logs from a finished run.

## Getting Started

- [Up and Running](https://github.com/dfinke/PSAdvantage/wiki/Setup)

- Read [how to use the tool](https://github.com/dfinke/PSAdvantage/wiki/Usage).

- Learn about [writing templates](https://github.com/dfinke/PSAdvantage/wiki/Templates).

- Look at some [example use-cases](https://github.com/dfinke/PSAdvantage/wiki/Use-Cases).

## Sample Usage

![](/media/InvokeAdvantage.png)

## Contribution & License

A few ways to contribute:

- Suggest a feature

- Report a bug

- Open a pull request

- Spread the word

PSAdvantage is licensed under the BSD 3-Clause License, see [LICENSE](LICENSE) for more information.

## Final Words

This tool was intended to make lives easier. Whether you are someone who cannot afford a VPS to run a monitoring setup on, or someone who just wants to multitask on a wholly different level, this tool is for everyone. If you know what you're doing, an entirely new world of possibilities to level up your productivity waits ahead of you!

P.S.: It is entirely the end-users' responsibility to comply with [GitHub's Terms](https://docs.github.com/en/github/site-policy/github-additional-product-terms#5-actions-and-packages).

PSAdvantage is inspired by the excellent work of [@0xInfection](https://twitter.com/0xInfection) and his [Bludger Python implementation](https://github.com/0xInfection/Bludger).







> On twitter: [@dfinke](https://twitter.com/dfinke)