Metadata-Version: 2.4
Name: fishertools
Version: 0.4.0
Summary: Fishertools - инструменты, которые делают Python удобнее и безопаснее для новичков
Home-page: https://github.com/f1sherFM/My_1st_library_python
Author: f1sherFM
Author-email: f1sherFM <kirillka229top@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/f1sherFM/My_1st_library_python
Project-URL: Repository, https://github.com/f1sherFM/My_1st_library_python
Project-URL: Issues, https://github.com/f1sherFM/My_1st_library_python/issues
Classifier: Development Status :: 3 - Alpha
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.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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: click>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: hypothesis>=6.0.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Fishertools

**Tools that make Python easier and safer for beginners**

Fishertools is a Python library designed specifically for beginner developers. It provides clear error explanations, safe utilities, and learning tools to help you master Python.

## Quick Start

```bash
pip install fishertools
```

## Quick Reference

| Task | Function |
|------|----------|
| Explain an error | `explain_error(e)` |
| Get element safely | `safe_get(list, index, default)` |
| Divide safely | `safe_divide(a, b, default)` |
| Read file safely | `safe_read_file(path)` |
| Learn Python concepts | `explain(topic)` |

## Documentation

Complete documentation is available in the `docs/` folder:

- **[Getting Started](docs/getting-started.md)** - Quick start guide with installation and first example
- **[Features](docs/features.md)** - Overview of all features and capabilities
- **[Installation](docs/installation.md)** - Detailed installation instructions for different operating systems
- **[API Reference](docs/api-reference.md)** - Complete API documentation with all functions and classes
- **[Examples](docs/examples.md)** - Practical examples from basic to advanced usage
- **[Limitations](docs/limitations.md)** - Known limitations and performance considerations
- **[Contributing](docs/contributing.md)** - How to contribute to the project

## For Whom This Library?

- You're just starting to learn Python
- Error messages seem scary and confusing
- You want errors explained in plain language with examples

## Main Features

### Error Explanation
Get clear explanations of Python errors with suggestions for fixing them.

### Safe Utilities
Functions like `safe_get()`, `safe_divide()`, `safe_read_file()` that prevent typical beginner errors.

### Learning Tools
Structured explanations of Python concepts with examples and best practices.

### Ready-made Patterns
Templates for common tasks like menus, file storage, logging, and CLI applications.

## License

MIT License - see [LICENSE](LICENSE) file

## Contributing

We welcome contributions! See [Contributing](docs/contributing.md) for details.

---

**Fishertools** - Making Python easier and safer for beginners! 🐍✨
