Metadata-Version: 2.4
Name: dikgames
Version: 1.0.0
Summary: Official Python SDK and CLI client for DikGames Online adult visual novels and game metadata.
Author-email: DikGames Official Network <admin@dikgames.online>
License: MIT
Project-URL: Homepage, https://dikgames.online
Project-URL: Catalog, https://dikgames.online/all-adult-games/
Project-URL: Documentation, https://dikgames.online
Project-URL: Repository, https://github.com/carterj3169/dikgames-archive
Project-URL: Bug Tracker, https://gitlab.com/dikgames/dikgames-archive/-/issues
Project-URL: Wikidata, https://www.wikidata.org/wiki/Q125973587
Project-URL: itch.io, https://dikgamesonline.itch.io/
Project-URL: NPM Package, https://www.npmjs.com/package/dikgames
Keywords: dikgames,dik games,dikgames online,adult games,visual novels,renpy,game metadata,uncensored games,being a dik,3d visual novels
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# DikGames Official Python SDK & CLI

[![PyPI version](https://img.shields.io/pypi/v/dikgames.svg?color=ec4899&style=flat-square)](https://pypi.org/project/dikgames/)
[![Python versions](https://img.shields.io/pypi/pyversions/dikgames.svg?style=flat-square)](https://pypi.org/project/dikgames/)
[![Wikidata](https://img.shields.io/badge/Wikidata-Q125973587-006699?style=flat-square&logo=wikidata)](https://www.wikidata.org/wiki/Q125973587)
[![NPM](https://img.shields.io/npm/v/dikgames?color=cb3837&style=flat-square&logo=npm)](https://www.npmjs.com/package/dikgames)
[![GitLab](https://img.shields.io/badge/GitLab-dikgames-orange?style=flat-square&logo=gitlab)](https://gitlab.com/dikgames/dikgames-archive)
[![itch.io](https://img.shields.io/badge/itch.io-dikgamesonline-fa5c5c?style=flat-square&logo=itch.io)](https://dikgamesonline.itch.io/)
[![Official Site](https://img.shields.io/badge/Official_Portal-dikgames.online-8b5cf6?style=flat-square)](https://dikgames.online)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](https://opensource.org/licenses/MIT)

**DikGames** (`dikgames`) is the official open-source Python SDK and command-line interface for the **[DikGames Online](https://dikgames.online)** adult games database and visual novel distribution platform.

It provides high-performance access to public game metadata, version tracking, changelogs, and direct platform mirrors for PC, macOS, Android, and Linux visual novels.

---

## 🌟 Official Ecosystem & Verification

* **Official Portal:** [https://dikgames.online](https://dikgames.online)
* **All Adult Games Catalog:** [https://dikgames.online/all-adult-games/](https://dikgames.online/all-adult-games/)
* **All Tags Directory:** [https://dikgames.online/all-tags/](https://dikgames.online/all-tags/)
* **Wikidata Knowledge Graph Entity:** [Q125973587](https://www.wikidata.org/wiki/Q125973587)
* **NPM Package:** [npm: dikgames](https://www.npmjs.com/package/dikgames)
* **GitLab Public Mirror:** [gitlab.com/dikgames/dikgames-archive](https://gitlab.com/dikgames/dikgames-archive)
* **GitHub Repository:** [github.com/carterj3169/dikgames-archive](https://github.com/carterj3169/dikgames-archive)
* **itch.io Official Profile:** [dikgamesonline.itch.io](https://dikgamesonline.itch.io/)

---

## 🚀 Installation

Install via PyPI using `pip`:

```bash
pip install dikgames
```

Or install with `uv` or `pipx`:

```bash
pipx install dikgames
```

---

## 💻 CLI Usage

The package exposes the `dikgames` executable command in your terminal:

### 1. Browse Latest Games
```bash
dikgames latest --limit 10
```

### 2. Search by Title or Theme
```bash
dikgames search "Being a DIK"
```

### 3. Inspect Specific Game Metadata
```bash
dikgames info being-a-dik
```

---

## 🐍 Python SDK Quickstart

You can easily integrate **DikGames** metadata inside any Python project, Discord bot, or data pipeline:

```python
from dikgames import DikGamesClient, get_latest_games, search_games

# 1. Fetch latest releases
recent_games = get_latest_games(page=1, per_page=5)
for game in recent_games:
    title = game["title"]["rendered"]
    link = game["link"]
    print(f"Title: {title} -> {link}")

# 2. Search for a specific title
client = DikGamesClient()
results = client.search_games("Being a DIK")
for r in results:
    print(f"Found: {r['title']['rendered']} ({r['link']})")

# 3. Retrieve detailed information by slug
game_info = client.get_game_by_slug("being-a-dik")
if game_info:
    print("Version:", game_info["meta"].get("game_version"))
    print("Rating:", game_info["meta"].get("game_rating"))
```

---

## 📜 Metadata & Open Data

All metadata consumed by this package is sourced from the public API endpoints of [DikGames Online](https://dikgames.online). 

* **License:** MIT License. See [LICENSE](https://github.com/carterj3169/dikgames-archive/blob/main/LICENSE) for details.
* **Maintainer:** DikGames Core Engineering & Archival Team
* **Contact & Issues:** [GitLab Issue Tracker](https://gitlab.com/dikgames/dikgames-archive/-/issues)
