Metadata-Version: 2.1
Name: bloxnickgenerator
Version: 0.1.2
Summary: A simple nickname generator for Roblox
Home-page: https://github.com/realkayo/Roblox-Nickname-Generator
Author: Kayon
Author-email: kayop621@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: Faker

# BloxNickGenerator
## Introduction
BloxNickGenerator is a Python package that allows you to generate available usernames for Roblox. It checks the availability of usernames and ensures that the generated usernames do not contain profanity.

## Features
- Generate a specified number of usernames.
- Check for profanity using an external API.
- Verify if usernames are already taken on Roblox.
- Customize generated usernames with optional prefixes, suffixes, and length constraints.


# Usage
You can generate nicknames with various customization options. Here are some examples:

### Basic Usage
Generate a specified number of nicknames:

```python
from bloxnickgenerator.generator import genNicknames

generated_nicks = genNicknames(3) # Generate 3 nicknames
print("Generated Nicknames:", generated_nicks)
```

### Using Prefixes and Suffixes
You can add prefixes and suffixes to the generated nicknames:

```python
generated_nicks = genNicknames(3, prefix='Cool_', suffix='_2024') # Generate nicknames with a prefix and suffix 
print("Generated Nicknames:", generated_nicks)
```

### Length Constraints
Set minimum and maximum lengths for the nicknames:

```python
generated_nicks = genNicknames(3, min_length=5, max_length=16) # Generate nicknames within specific length constraints 
print("Generated Nicknames:", generated_nicks)
```

### Example
```python
nicks = genNicknames(3, prefix='Xx_', suffix='_Xx', min_length=5, max_length=16) 
print("Generated Nicknames:", nicks) 
# Result: Xx_examplee_xX
```

- Note: Depending on the number of nicknames you want to generate, it may take a while.

## Installation
# You can install BloxNickGenerator using pip:

```bash
pip install bloxnickgenerator
```

- https://pypi.org/project/bloxnickgenerator/0.1.1/

## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
