Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pageton/denonator
https://github.com/pageton/denonator
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/pageton/denonator
- Owner: pageton
- License: mit
- Created: 2024-08-20T16:03:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-20T16:12:17.000Z (4 months ago)
- Last Synced: 2024-09-17T00:27:06.258Z (3 months ago)
- Language: TypeScript
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Akinator
Akinator is a Deno library for interacting with the Akinator web game. It allows you to play the Akinator game programmatically, answering questions and guessing the character.
## Installation
To use the Akinator library in Deno, you don't need to install anything using a package manager. Instead, you can directly import the library from the URL where it is hosted.
### Example Import:
```typescript
import {
Akinator,
AkinatorLanguage as Language
} from "https://deno.land/x/denonator/mod.ts";
```
## Usage
To use the Akinator library, import the `Akinator` class and create an instance:
```typescript
import {
Akinator,
AkinatorLanguage as Language
} from "https://deno.land/x/denonator/mod.ts";
const akinator = new Akinator(Language.English);
```
### Starting a New Game
To start a new game, call the `startGame()` method:
```typescript
const { ok, result } = await akinator.startGame();
if (ok) {
console.log(`New game started! Current question: ${result.question}`);
} else {
console.error("Error starting game:", result.error);
}
```
### Answering Questions
To answer a question, use the `answerQuestion()` method:
```typescript
const { ok, result } = await akinator.answerQuestion("y", akinator.id);
if (ok) {
console.log(
`Current progress: ${result.progress}, Current question: ${result.question}`
);
} else {
console.error("Error answering question:", result.error);
}
```
The `answerQuestion()` method takes the answer as the first argument and the game ID as the second argument.
### Going Back
To go back to the previous question, use the `back()` method:
```typescript
const { ok, result } = await akinator.back(akinator.id);
if (ok) {
console.log(
`Went back, current progress: ${result.progress}, current question: ${result.question}`
);
} else {
console.error("Error going back:", result.error);
}
```
### Handling the Result
When the Akinator game is finished, the `answerQuestion()` method will return the result:
```typescript
const { ok, result } = await akinator.answerQuestion("y", akinator.id);
if (ok && result.photo) {
console.log(`Akinator guessed: ${result.name}`);
console.log(`Description: ${result.description}`);
console.log(`Photo: ${result.photo}`);
} else {
console.error("Error getting result:", result.error);
}
```
## License
This project is licensed under the MIT License.
## Contributing
If you find any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the GitHub repository.