An open API service indexing awesome lists of open source software.

https://github.com/michael-free/freedadjokes

Get Dad Jokes on the PowerShell Command Line!
https://github.com/michael-free/freedadjokes

humor humour joke jokes-api l powershell powershell-module

Last synced: 23 days ago
JSON representation

Get Dad Jokes on the PowerShell Command Line!

Awesome Lists containing this project

README

        

# FreeDadJokes
Get Dad Jokes on the PowerShell Command Line!

By installing this PowerShell module, you'll be able to scale stupid jokes at a scale that was never possible before!

## Prerequisites
- Paternity test:
- Be a dad.
- Have a dad (biological, step dad or otherwise).
- Powershell access:
- Have Powershell available on your machine (Windows, MacOS or Linux).
- Basic Knowledge:
- Familiarity with PowerShell.
- Access to install modules locally.

## Installation

There are two ways to install the `FreeDadJokes` module:

1. **Using PowerShell Gallery**
- Open PowerShell as an administrator and run the following command to install the module from the PowerShell Gallery:
```powershell
Install-Module -Name FreeDadJokes -Scope CurrentUser
```
2. **Manual Installation**
- Clone this repository using Git or download the ZIP file.
- Extract the contents of the ZIP file to a directory on your computer.
- Open PowerShell as an administrator and navigate to the directory where you extracted the module files.
- Run the following command to install the module:

```powershell
Import-Module -Name .\FreeDadJokes.psm1
```
Note that the manual installation method requires you to have Git installed on your computer, as well as the ability to extract ZIP files. If you do not have these tools installed, you can use the PowerShell Gallery method instead.

## Usage

### Examples
```powershell
Get-DadJoke
```
This command will return two lines of output. The leadup, and the joke.

## License

Free Custom License (FCL) v1.0

Copyright 2025, Michael Free. All Rights Reserved.

## Contributions

### Reporting Bugs

If you encounter any issues while using the tool, please report them in the issue tracker on GitHub. Be sure to include the following information in your bug report:

- The steps to reproduce the issue
- The expected behavior
- The actual behavior
- Any error messages or stack traces associated with the issue

### Requesting Features

If you have an idea for a new feature, please let me know by creating an issue in the issue tracker on GitHub. Be sure to explain why this feature would be useful and how it could benefit the project.

### Contributing Code

If you're a developer interested in contributing code to the project, I encourage you to submit a pull request through GitHub. Before submitting your code, please make sure it adheres to my coding standards and passes any automated tests.

### Providing Feedback

Your feedback is valuable to me. If you have any suggestions or ideas for improving the tool, please share them with me through the issue tracker on GitHub or by reaching out to me on Mastodon: https://mastodon.social/@MichaelFree

### Testing and Quality Assurance

I appreciate any help testing the project and reporting issues. If you have experience in testing, please let me know by creating an issue in the issue tracker on GitHub or by contacting me directly.

Thank you for your interest in contributing to my project! Your contributions will help make it even better.

## Description
Introducing the latest breakthrough in software development: JaaS—Joke as a Service. Not only is this concept ready to disrupt computing - it will disrupt everyone trying to work around you, too.

By installing this PowerShell module, you'll be able to scale stupid jokes at a scale that was never possible before!

## Installation
Install the module from the Powershell Gallery:
```
Install-Module -Name FreeDadJokes -Force
```

## Usage
Import the module for usage:
```
Import-Module -Name FreeDadJokes
```
Utilize the futuristic JaaS:
```
Get-DadJoke
```

## Coming Soon
k8s Dad Joke Microservices:
- Horizontally scale eye rolling while simultaneously wasting everyones time (and cloud-compute resources).

## Author
Michael Free