Metadata-Version: 2.1
Name: lzdqesj
Version: 1.0.1
Summary: A practical Python utility package providing commonly used math operations and utility functions
Home-page: https://github.com/LzdqesjG/lzdqesj-pytest-pkg
Author: Lzdqesj
Author-email: Lzdqesj <lzdqesj@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/LzdqesjG/lzdqesj-pytest-pkg
Project-URL: Bug Tracker, https://github.com/LzdqesjG/lzdqesj-pytest-pkg/issues
Project-URL: Documentation, https://github.com/LzdqesjG/lzdqesj-pytest-pkg#readme
Project-URL: Source Code, https://github.com/LzdqesjG/lzdqesj-pytest-pkg
Keywords: python,utilities,math,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"

# lzdqesj

[![Python](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.txt)

A practical Python utility package providing commonly used math operations and utility functions.

## Features

- **Basic Math Operations**: Addition, subtraction, multiplication, division
- **Number Theory**: Even check, prime check
- **Sequence Generation**: Fibonacci sequence
- **Combinatorics**: Factorial calculation

## Installation

### Install from PyPI (Recommended)

```bash
pip install lzdqesj
```

### Install from Source

```bash
git clone https://github.com/LzdqesjG/lzdqesj-pytest-pkg.git
cd lzdqesj-pytest-pkg
pip install -e .
```

### Development Install (with test dependencies)

```bash
pip install -e ".[dev]"
```

## Quick Start

```python
import lzdqesj

# Basic operations
print(lzdqesj.add(1, 2))       # 3
print(lzdqesj.subtract(5, 3))  # 2
print(lzdqesj.multiply(3, 4))  # 12
print(lzdqesj.divide(10, 2))   # 5.0

# Number theory checks
print(lzdqesj.is_even(4))      # True
print(lzdqesj.is_prime(17))    # True

# Sequence generation
print(lzdqesj.fibonacci(5))    # [0, 1, 1, 2, 3]

# Factorial calculation
print(lzdqesj.factorial(5))    # 120
```

## API Reference

### `add(a, b)`
Calculate the sum of two numbers.

### `subtract(a, b)`
Calculate the difference of two numbers.

### `multiply(a, b)`
Calculate the product of two numbers.

### `divide(a, b)`
Calculate the quotient of two numbers. Raises `ValueError` when the divisor is 0.

### `is_even(n)`
Check if a number is even.

### `is_prime(n)`
Check if a number is prime.

### `fibonacci(n)`
Get the first n terms of the Fibonacci sequence.

### `factorial(n)`
Calculate the factorial of a number.

### `rickroll(play_type="bilibili")`
Play a Rick Roll video. Supports "bilibili" and "youtube".

## Running Tests

```bash
# Install test dependencies
pip install -e ".[dev]"

# Run tests
pytest
```

## Project Structure

```
lzdqesj/
├── lzdqesj/
│   ├── __init__.py    # Package entry point and public API exports
│   └── core.py        # Core functionality module
├── tests/
│   ├── __init__.py
│   └── test_core.py   # Unit tests
├── setup.py           # Package configuration
├── pyproject.toml     # Modern build configuration
├── README.md          # Project documentation
└── LICENSE.txt        # MIT License
```

## License

This project is licensed under the [MIT License](LICENSE.txt).
