jokes
v1.3.0generalCurated developer humor, AI jokes, compiler puns, and random punchline generators for NextViper applications.
jokes
A lightweight, zero-dependency collection of classic programmer jokes, compiler puns, AI humor, and developer one-liners for NextViper applications.
[](https://nextviper.nuratix.com/packages/jokes)
[](https://opensource.org/licenses/MIT)
📦 Installation
Install jokes with the NextViper package manager CLI:
nextviper add jokesOr declare it in your nextviper.toml:
[dependencies]
jokes = "^1.1.0"🚀 Quickstart & Usage
Basic Usage
import jokes
// Fetch a random programming joke
let joke = jokes.get_random_joke()
print(joke)
// Fetch specialized jokes
let compiler_pun = jokes.get_compiler_joke()
let ai_humor = jokes.get_ai_joke()
print("Compiler Humor:", compiler_pun)
print("AI Humor:", ai_humor)Functional Pipelines (`|>`)
NextViper's native pipeline operator lets you stream jokes directly to formatting utilities and output:
import jokes
// Stream joke into card formatter and print
jokes.get_random_joke()
|> jokes.format_joke_card
|> printIterating the Joke Catalog
import jokes
let catalog = jokes.list_jokes()
print("Total jokes available:", jokes.count_jokes())
for j in catalog {
print("• " + j)
}📚 API Reference
| Function | Signature | Description |
|---|---|---|
| `get_random_joke()` | `() -> String` | Returns a random programming punchline. |
| `get_compiler_joke()` | `() -> String` | Returns a compiler/type-system joke. |
| `get_ai_joke()` | `() -> String` | Returns an AI/neural network joke. |
| `tell_joke(index)` | `(Int) -> String` | Retrieves a joke by its catalog index (0–19). |
| `list_jokes()` | `() -> Array` | Returns the entire array of curated jokes. |
| `count_jokes()` | `() -> Int` | Returns total number of available jokes. |
| `format_joke_card(joke)` | `(String) -> String` | Wraps punchlines in a clean ASCII border box. |
📝 What's New in v1.1.0
get_compiler_joke() and get_ai_joke() category filters.format_joke_card() for clean terminal formatting.📜 License
MIT License • Maintained by [@nuratix](https://nextviper.nuratix.com/u/nuratix) (Nuratix LLC).