Metadata-Version: 2.4
Name: cdquiz
Version: 2.0.2
Summary: CodeHouse Quiz Suite — AI-powered CLI learning platform for Python, AI, Machine Learning, Data Science, Cybersecurity, and more.
Author: Applinet Technology
Author-email: developers@applinet.com.ng
Maintainer: Godswill Moses Ikpotokin
Maintainer-email: gwill@applinet.com.ng
Project-URL: Homepage, https://cli.codehouse.cloud
Project-URL: Documentation, https://cli.codehouse.cloud/docs/
Project-URL: Leaderboard, https://cli.codehouse.cloud/leaderboard/
Project-URL: Classroom, https://classroom.codehouse.cloud/
Project-URL: Genius Community, https://genius.codehouse.cloud/
Project-URL: Applinet Technology, https://applinet.com.ng
Project-URL: CodeHouse Cloud, https://codehouse.cloud
Project-URL: WhatsApp Support, https://wa.me/+2348037137902
Project-URL: WhatsApp Community, https://chat.whatsapp.com/BYfgMwPZBpCEwr3piT77iE
Project-URL: LinkedIn, https://linkedin.com/company/applinet-technology
Project-URL: Facebook, https://facebook.com/applinetng/
Project-URL: GitHub Organization, https://github.com/Applinet-Technology
Project-URL: Source Code, https://github.com/Applinet-Technology/cdquiz
Project-URL: Repository, https://github.com/Applinet-Technology/cdquiz
Project-URL: Issue Tracker, https://github.com/applinet-technology/cdquiz/issues
Project-URL: Godswill Moses Ikpotokin, https://ikpotokin.ng
Keywords: education,quiz,cli,learning,python,ai,machine learning,data science,cybersecurity,django,developer tools,terminal learning,codehouse,applinet
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Education
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# CODEHOUSE QUIZ SUITE (cdquiz)

AI-powered CLI learning system for Programming Languages such as Python, Java, JavaScript, HTML, Artificial Intelligence, Machine Learning, Data Science, Cybersecurity, and more.

---

## Overview

**cdquiz** is a terminal-based interactive learning platform built by **Applinet Technology** under the **CodeHouse Cloud Initiative**.

It transforms your terminal into a smart classroom where users can:

- Learn interactively
- Practice real technical skills
- Earn QuizCoins
- Track learning progress
- Compete globally
- Receive AI-powered explanations

---

## Features

CodeHouse Quiz Suite provides a modern learning experience directly from the command line.

Features include:

- AI-powered answer explanations
- QuizCoin reward system
- Smart scoring and ranking engine
- Global leaderboard system
- Fast and lightweight CLI experience
- Secure quiz sessions
- Real-time progress tracking
- Resume unfinished quizzes
- Multi-category learning structure
- Anti-cheat and secure validation system

---

## Learning Categories

### Programming

Supported and expanding areas include:

- Python
- Java
- JavaScript
- HTML
- Django
- Flask
- APIs
- Backend Development
- Additional programming technologies

### Artificial Intelligence

- Artificial Intelligence
- Machine Learning
- Data Science

### Security

- Cybersecurity
- Ethical Hacking Basics
- Security Fundamentals

Additional categories continue to grow as the platform evolves.

---

## AI Learning Engine

The built-in AI engine improves learning through:

- Intelligent answer explanations
- Learning guidance
- Performance feedback
- Motivation system
- Smart progress analysis

The goal is not simply to test knowledge but to help learners understand concepts more effectively.

---

## QuizCoin Economy

CodeHouse Quiz Suite includes a reward-based learning economy.

Users can earn **QuizCoins** while learning and participating in quizzes.

QuizCoin features include:

- Wallet system
- QuizCoin tracking
- Reward-based engagement
- Learning incentives

---

## Smart Progress Tracking

Track performance in real time.

Metrics include:

- Accuracy
- Quiz score
- Completion rate
- Rank
- Speed
- Remaining attempts

This allows learners to monitor improvement and identify growth areas.

---

## Leaderboards

Compete globally with learners around the world.

Leaderboard system includes:

- Global ranking
- Course ranking
- Score tracking
- Performance comparison

The leaderboard creates healthy competition and encourages consistent improvement.

---

## Screenshots

### Welcome Dashboard

![Dashboard](https://downloads.codehouse.cloud/cdquiz.jpg)

### Quiz Interface

![Quiz](https://downloads.codehouse.cloud/quizq.jpg)

### Wallet System

![Wallet](https://downloads.codehouse.cloud/transact.jpg)

---

## Installation

Install directly from PyPI:

```bash
pip install cdquiz
```

---

## Run Application

Launch the application using:

```bash
python -m cdquiz.start
```

or simply:

```bash
cdquiz
```

---

## Upgrade

Upgrade to the latest version:

```bash
pip install --upgrade cdquiz
```

---

## Example Dashboard

```text
CDQuiz Dashboard

1. Start / Resume Quiz
2. View Leaderboard
3. Announcements
4. ...
```

---

## Quiz Flow

The learning structure follows a guided hierarchy:

```text
Category
   ↓
SubCategory
   ↓
Course
   ↓
Questions
```

Example:

```text
Python
   ↓
Django
   ↓
Authentication
   ↓
Quiz Questions
```

This structure helps learners move from broader concepts into specialized learning paths.

---

## Example Quiz Session

```text
Question 3 of 10

What keyword is used to define a Python function?

1. function
2. define
3. def
4. func

Your answer: 3
```

---

## Example Performance Feedback

```text
Correct!

Progress: 5/20
Score: 85%
Rank: #7
```

---

## Security Features

CodeHouse Quiz Suite includes multiple layers of quiz protection and validation.

Security mechanisms include:

- Active session validation
- Request verification
- Quiz tampering protection
- Question overflow protection
- Secure quiz access control
- Attempt limitation system

These protections help ensure fair participation and secure quiz delivery.

---

## Technologies Used

### Backend

- Python
- Django
- Django REST Framework

### CLI

- Rich
- Prompt Toolkit
- Requests

### Database

- PostgreSQL
- SQLite

---

## Vision

CodeHouse Quiz Suite is designed to empower developers and digital learners across the globe through:

- AI-enhanced education
- Practical technical learning
- Gamification
- Reward systems
- Real-world developer training

The platform aims to make technical education more accessible, engaging, and skill-oriented.

---

## About Applinet Technology

**Applinet Technology** is an African-centered technology company that combines innovation, modern technology, and African values to build impactful digital solutions.

Through initiatives like **CodeHouse Cloud**, the company focuses on solving real problems through technology, education, and digital empowerment.

---

## Author

**Godswill Moses Ikpotokin**  
Founder & CEO — Applinet Technology

---

## License

This project is released under the **MIT License**.

---

## Contributing

Contributions are welcome.

You can contribute by:

- Reporting bugs
- Suggesting new features
- Improving documentation
- Submitting pull requests

Community contributions help improve the ecosystem for everyone.

---

## Support

For support, partnerships, or collaborations:

**Email:** genius@codehouse.cloud

---


CodeHouse Quiz Suite is more than a quiz platform.

It is a developer growth ecosystem designed to help learners gain practical technical skills directly from the terminal through interactive learning, AI guidance, competition, and rewards.
