fishertools 0.2.1__py3-none-any.whl → 0.4.0__py3-none-any.whl

fishertools-0.2.1.dist-info/METADATA

@@ -1,256 +0,0 @@
-Metadata-Version: 2.4
-Name: fishertools
-Version: 0.2.1
-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
-
-**Инструменты, которые делают Python удобнее и безопаснее для новичков**
-
-Fishertools - это Python библиотека, созданная специально для начинающих разработчиков. Она предоставляет понятные объяснения ошибок, безопасные утилиты и обучающие инструменты.
-
-## 🎯 Основные возможности
-
-### 🚨 Объяснение ошибок Python
-Получайте понятные объяснения ошибок на русском языке с советами по исправлению:
-
-```python
-from fishertools import explain_error
-
-try:
-    numbers = [1, 2, 3]
-    print(numbers[10])
-except Exception as e:
-    explain_error(e)
-```
-
-**Вывод:**
-```
-🚨 Ошибка Python: IndexError
-
-═══ Сообщение об ошибке ═══
-  list index out of range
-
-═══ Что это означает ═══
-  Вы пытаетесь получить элемент списка по индексу, которого не существует.
-  Индексы в Python начинаются с 0, а максимальный индекс равен длине списка минус 1.
-
-═══ Как исправить ═══
-  Проверьте длину списка перед обращением к элементу или используйте
-  безопасные методы получения элементов.
-
-═══ Пример ═══
-┌─ Правильный код ─┐
-    numbers = [1, 2, 3]
-    if len(numbers) > 10:
-        print(numbers[10])
-    else:
-        print("Индекс слишком большой!")
-└───────────────────┘
-```
-
-### 🛡️ Безопасные утилиты
-Функции, которые предотвращают типичные ошибки новичков:
-
-```python
-from fishertools.safe import safe_get, safe_divide, safe_read_file
-
-# Безопасное получение элемента
-numbers = [1, 2, 3]
-result = safe_get(numbers, 10, "не найден")  # "не найден"
-
-# Безопасное деление
-result = safe_divide(10, 0, 0)  # 0 вместо ошибки
-
-# Безопасное чтение файла
-content = safe_read_file("file.txt", default="файл не найден")
-```
-
-### 📚 Обучающие инструменты
-Изучайте Python на примерах и лучших практиках:
-
-```python
-from fishertools.learn import show_best_practice, generate_example
-
-# Показать лучшие практики
-show_best_practice("variables")
-
-# Сгенерировать пример кода
-example = generate_example("functions")
-print(example)
-```
-
-### 🔄 Обратная совместимость
-Все полезные функции из предыдущих версий сохранены:
-
-```python
-from fishertools.legacy import hash_string, generate_password, QuickConfig
-
-# Старые функции работают как прежде
-password = generate_password(12)
-hash_value = hash_string("my_string")
-config = QuickConfig({"debug": True})
-```
-
-## 📦 Установка
-
-```bash
-pip install fishertools
-```
-
-Или из исходников:
-```bash
-git clone https://github.com/f1sherFM/My_1st_library_python.git
-cd My_1st_library_python
-pip install -e .
-```
-
-## 🚀 Быстрый старт
-
-```python
-from fishertools import explain_error
-
-# Основная функция - объяснение ошибок
-try:
-    result = 10 / 0
-except Exception as e:
-    explain_error(e)
-
-# Безопасные утилиты
-from fishertools.safe import safe_get, safe_divide
-safe_result = safe_get([1, 2, 3], 5, "default")
-
-# Обучающие инструменты  
-from fishertools.learn import show_best_practice
-show_best_practice("functions")
-```
-
-## 📖 Документация
-
-### Поддерживаемые типы ошибок
-
-Fishertools объясняет следующие типы ошибок Python:
-
-- **TypeError** - ошибки типов данных
-- **ValueError** - неправильные значения
-- **AttributeError** - отсутствующие атрибуты
-- **IndexError** - выход за границы списка
-- **KeyError** - отсутствующие ключи словаря
-- **ImportError** - проблемы с импортом модулей
-- **SyntaxError** - синтаксические ошибки
-
-### Безопасные утилиты
-
-- `safe_get(collection, index, default)` - безопасное получение элемента
-- `safe_divide(a, b, default)` - деление без ошибки на ноль
-- `safe_max(collection, default)` - максимум из коллекции
-- `safe_min(collection, default)` - минимум из коллекции
-- `safe_sum(collection, default)` - сумма элементов
-- `safe_read_file(path, default)` - чтение файла без ошибок
-
-### Обучающие функции
-
-- `show_best_practice(topic)` - показать лучшие практики
-- `generate_example(concept)` - сгенерировать пример кода
-- `list_available_concepts()` - список доступных концепций
-- `list_available_topics()` - список доступных тем
-
-## 🧪 Тестирование
-
-Библиотека покрыта comprehensive тестами:
-
-```bash
-# Запуск всех тестов
-pytest
-
-# Запуск property-based тестов
-pytest -k "property"
-
-# Запуск с покрытием
-pytest --cov=fishertools
-```
-
-## 🛠️ Разработка
-
-```bash
-# Установка для разработки
-pip install -e ".[dev]"
-
-# Форматирование кода
-black fishertools tests
-
-# Проверка типов
-mypy fishertools
-
-# Линтинг
-ruff check fishertools
-```
-
-## 📋 Требования
-
-- Python 3.8+
-- requests >= 2.25.0
-- click >= 8.0.0
-
-Для разработки:
-- pytest >= 8.0.0
-- hypothesis >= 6.0.0 (для property-based тестов)
-- black >= 24.0.0
-- ruff >= 0.1.0
-- mypy >= 1.8.0
-
-## 🤝 Вклад в проект
-
-Мы приветствуем вклад в развитие проекта! Пожалуйста:
-
-1. Форкните репозиторий
-2. Создайте ветку для новой функции
-3. Добавьте тесты для новой функциональности
-4. Убедитесь, что все тесты проходят
-5. Создайте Pull Request
-
-## 📄 Лицензия
-
-MIT License - см. файл [LICENSE](LICENSE)
-
-## 🙏 Благодарности
-
-Спасибо всем, кто помогает делать Python более доступным для новичков!
-
----
-
-**Fishertools** - потому что каждый заслуживает понятные инструменты для изучения программирования! 🐍✨

fishertools-0.2.1.dist-info/RECORD

@@ -1,81 +0,0 @@
-fishertools/__init__.py,sha256=vvsR-fPtFTR1zizj3lDr5NHuq0V6VZ2_nCDjiPqlY1k,2754
-fishertools/decorators.py,sha256=DKWLy_USqTOUFGRyWllznYJ61jvRyXLDZ3iKOj6u-6k,3719
-fishertools/helpers.py,sha256=qhSIY4ooZqCM5bKnku5XKjhONy9h1kMnrIEb4uRRZE4,4081
-fishertools/integration.py,sha256=m8oaKPENdS9aOck4gR8ooUqUa7EIdH7r7aOGaVEFWHw,19763
-fishertools/utils.py,sha256=6tUnCsHoHUoIpOYGgHAdqIqQ7FZhWzN3kCavgKKw1Uc,2159
-fishertools/config/__init__.py,sha256=8slBbZSDgQeUIcEmkpZD9o30CMKd8pbJ2bJV3t01j5M,508
-fishertools/config/manager.py,sha256=EPRjqYDcllanPA9w8PLjkanoi5ox38sVsuytz00ROhY,9095
-fishertools/config/models.py,sha256=TXfFTee68B7VK7BFBorHQDPas8sFJacdUQVH61AKSDA,2594
-fishertools/config/parser.py,sha256=oxf-LXf-7qr3aHKDZRFPsinwjSxI0gSY3kEEHALcwhk,10168
-fishertools/documentation/__init__.py,sha256=kA7s2hssDLxxlJPxMeHQIuHm-BPYaS86EXERe4ZcRuU,806
-fishertools/documentation/api.py,sha256=pn3K-3-xygpUfsNml6yAZeIhnGFPJyoL4c4AQJrxWCk,8718
-fishertools/documentation/generator.py,sha256=mOduCARUboSs5Wmai0PCwpmNyNCjQGN756xmouzZtSI,18063
-fishertools/documentation/models.py,sha256=8l2VC8dAib-c5jzuySnuOfKlM7Q1ITxV8phhBZDGd5Y,2884
-fishertools/documentation/visual.py,sha256=JxyFrhkmuHxpIaBMbLtuP3a24FYIwyoT3_mKPV-oZPE,19307
-fishertools/errors/__init__.py,sha256=yo6sd5MvY3jA6QE0G_-zXWAIvMs5Vyod81CTjCZNJEI,1248
-fishertools/errors/exceptions.py,sha256=ocBgqCMw8f_rJ2Rp_3uxlJFc-NphebdM0dizFQoAQcc,7301
-fishertools/errors/explainer.py,sha256=jMxXizmouvDGNLxTB9MCER9fjq1f8lZAE9ggeHWLGuo,14346
-fishertools/errors/formatters.py,sha256=khdiXGx4Lil5cqd3WWkh8ZLrQea0S8u90hbZgKnFsMo,13790
-fishertools/errors/models.py,sha256=v9_dIdiljK0j2ksPu403vei6COlgurtzvDiX8niB1MI,8427
-fishertools/errors/patterns.py,sha256=sbB51eR3JxD_DKWkiqelxnNuJh3X20mcTXL2nnwo6k0,12276
-fishertools/errors/recovery.py,sha256=7-3qd1uIv32vNltjvbVS2O5QJPixBLQVivU17f3Lxwo,17165
-fishertools/examples/__init__.py,sha256=1D6EezNPBqY5blM_SfK0C3dxSnPOnfXOaqnjbCMlH0Y,457
-fishertools/examples/models.py,sha256=gmOIdz29qnbWKMNAQ6r1i4BE7rZHK8Hv5jtF9Z0MYP0,2845
-fishertools/examples/repository.py,sha256=HO-rB2CCnMQBdEQuyfJbDF8PelMecyoltMs3hPUpjFM,31204
-fishertools/learn/__init__.py,sha256=ctPUYBaV_5uMMLgbBssbvs5tLvizIXE3TjhPmmCwgzA,508
-fishertools/learn/examples.py,sha256=Fkt5gA6XUA_QbPq0hRAefMkHB1bz4v8q4oOxonpLa8Y,19907
-fishertools/learn/tips.py,sha256=lGxheuvKe0QgFOn7CDpW2XppZ7bW7a1jYysSghibkUU,9697
-fishertools/learning/__init__.py,sha256=fBwvqElVmhaUnRBwXfwQQSm7A0lzyrZihSNA91cnm_U,780
-fishertools/learning/core.py,sha256=azR7rQLdSglSPZ-q-rZj5DEJ-2Ms0XyA0VV8KUvp1O0,14138
-fishertools/learning/models.py,sha256=eLB9w-lSC0SKRkl-HwYRjfmxhDANtQXdogPFyiuD8cc,2861
-fishertools/learning/progress.py,sha256=Nju1wei_UVYFW7LqYgMjKdLI8jiqHomH97gp-3d2ZOY,12761
-fishertools/learning/session.py,sha256=9ZE-UJpd9tFph0ZaEl8FN1VDJIU-fmTF9CsDyBbpVng,19837
-fishertools/learning/tutorial.py,sha256=jiRcOm0kDTHSMUzNw-1bNlzC9aOMJwHbXn8lW0IQHTc,28325
-fishertools/legacy/__init__.py,sha256=9NYb7gfwtp-4o5TJyUFvFapY1SnDPezfdyrcI-gU97g,2156
-fishertools/legacy/deprecated.py,sha256=rR4Z7eo42LFklkKBkrA05wzkes2IsjayeKzWZV27wI4,10033
-fishertools/legacy/deprecation.py,sha256=2EPKgix0N-F7limO9cirurXvApDJGVxNfh2jCfMZ9uc,5068
-fishertools/safe/__init__.py,sha256=_EtvxjCU2C1GDzVwfAjtsZ3P8a1UjKONvhgZB2Acpbw,638
-fishertools/safe/collections.py,sha256=NTfqVv4alPNr0wrcO5IGYSYk3FSSZYMIaYN3iFnOJlc,9738
-fishertools/safe/files.py,sha256=FNZafMdlBjeM05GIxVxNRyA0s2PlMsDZ7XjGmjWfPqs,9589
-fishertools/safe/strings.py,sha256=8kyN0ajwWBV4VE19LDspoVNFCTjghwx63aADZoX-6j8,315
-fishertools-0.2.1.dist-info/licenses/LICENSE,sha256=eLEqXLzyplfeaqnVJgjvQUsaFYxAPJ38xNpFhlntZrw,1084
-tests/__init__.py,sha256=09o34ess27Hp5ZJ9H6bqAiBkFWsp3cjy6hiT0kUH58E,139
-tests/conftest.py,sha256=DAnUXhbJvYWj8XLuggM3JdL19R8-XJjbZeNYeiWXjik,828
-tests/test_integration.py,sha256=5fmubUAKDCiNfIg-SJAWYeZlLPjgsky8ZmT0BUbd8kI,12236
-tests/test_integration_enhancements.py,sha256=DHHUAn271QZlN-BDsOQNBpEoktQhZvHJKOLwisOyQqw,18708
-tests/test_structure.py,sha256=Lhes-TH2TgbqW4K_G2KOjYPwHQW9dLT4mqLbm6Nc-w4,2015
-tests/test_structure_enhancements.py,sha256=8_6hCYc_jOJVdO3O1dhFFNPc5TCE2kbNkP2LaWS5q98,4760
-tests/test_config/__init__.py,sha256=9_IIF-3DZE06DR388NQp8WPEon2XZLR-VdoQXePkBCw,56
-tests/test_config/test_basic_config.py,sha256=oIwfjhRz1pcZQcAADect9x705cOPFvNQFWFo1QThzAA,2195
-tests/test_config/test_config_error_handling.py,sha256=aa0eviMv1MowPEnf9FK9iE2Ec19rdm-bZYNYxx-KIf0,12163
-tests/test_config/test_config_properties.py,sha256=4wAwc8bAMzqdYqBDndi7nqugwJ1teG4Vdj2Ijj0THWg,20789
-tests/test_documentation/__init__.py,sha256=xsEvmyIlWI3HnTTwr3Go3jGtmw4A0NboXxVYPpSA-tA,56
-tests/test_documentation/test_documentation_properties.py,sha256=5bVq-vUDfM2035jBf5tozTKouS21p_1R0PNncNTZqgA,10742
-tests/test_documentation/test_visual_documentation_properties.py,sha256=Z4LR5LBDlQTwTuDXJej8Itltmw_9NqYZG5uXWEE3lzA,19349
-tests/test_errors/__init__.py,sha256=TgRhzGojrbDYRs4YD4yz7U0YeffhDn8ZO-1C0IS0Hpo,49
-tests/test_errors/test_api.py,sha256=TGUoMKG5oNb6Im8rpXxPdFWEaV0Hu4kuYrDoDpUl5cs,12327
-tests/test_errors/test_error_handling.py,sha256=6D2ak6FXR9PQaakPSEx5kepbra9_MP38g13STuq3OH8,15342
-tests/test_errors/test_explainer.py,sha256=50O9oHOPNmCasp5MR9i2ql-py4HHN48s7nnv5Ck-hkM,7449
-tests/test_errors/test_formatters.py,sha256=D7dHAonDe0Q-uqNvKnccNrMEazgHlV99YrDo54anAfw,16267
-tests/test_errors/test_models.py,sha256=LMg86PO9F5qIrmVIqbWd4tr4zjLu-Tq6m4h95VGkGuM,10566
-tests/test_errors/test_patterns.py,sha256=30unn0-XIkAkvP5gNoskNAlnLDtOZinzV1Iiu6i4Qok,12791
-tests/test_examples/__init__.py,sha256=gf_sI2CD9TaM_mony0sUPEqBsOxXLqXE6WPau7bysWE,51
-tests/test_examples/test_example_repository_properties.py,sha256=ksQgL5oEaJM-tUjOcwVmEBeDEGLqUAVKTXw766NZgJU,10361
-tests/test_examples/test_specific_examples.py,sha256=VjDHvVrheGI2M7UiZVrnoD2qyJ9Q6uQFjG7qbD2zLpk,14698
-tests/test_learn/__init__.py,sha256=Bw7w8u9uiRrvtIg3k9Ac-0gYoE_3_hFvDbEetpZaNFA,35
-tests/test_learn/test_examples.py,sha256=IQtYcVbe1pspiRasLY6JN1MQ20kWoxWCbOetbqMYXAs,8615
-tests/test_learn/test_tips.py,sha256=fRZ8U0jXnpZFkVFbDnLKBoVayXhXJx3qIn0YUgojguc,11201
-tests/test_learning/__init__.py,sha256=h-oxqKnBXNlK_AB8SP1aTP4sChfYDdydpxU6XQUOufc,47
-tests/test_learning/test_interactive_learning_properties.py,sha256=EaCABbHSHFde4E_gyC6vAns1paSE_2dergKxAx_f5jM,17528
-tests/test_learning/test_learning_system_properties.py,sha256=09Ir-s1v7FM9uD6hqprEjLN6JvligxjFDoRdLQ5wPiI,8396
-tests/test_learning/test_progress_tracking_properties.py,sha256=xLwIk_a9Xfhw1WFOO2NxjuC63Fa_KiXmBWWJnhmbB8A,13290
-tests/test_legacy/__init__.py,sha256=ofWG_WJXsOheTEbGn_5Y0wvppcN0kKb2E6aUFL98a_s,62
-tests/test_legacy/test_backward_compatibility.py,sha256=svdImGaTMAyAWoyF_Qm8nCbVrxnT9klg3u-OEVlXaUo,9786
-tests/test_legacy/test_deprecation_warnings.py,sha256=lSFLTDXfTjZcpqczPlxrO6Sw0CErMepxIhuNHdv36PU,9890
-tests/test_safe/__init__.py,sha256=ZEQlbeYtDtcBYqkE7sZbwkjKgqbPOwXI3S5U_2gjo0w,35
-tests/test_safe/test_collections_properties.py,sha256=DYQ542pwoacsTRS3-TMdgtcqLj6SyUnag7gZoK4dFDc,8359
-tests/test_safe/test_files.py,sha256=QSKyImlyIfVqWk_xh2LpD5znZGrJi9HCOrP-ACz3hjE,4162
-fishertools-0.2.1.dist-info/METADATA,sha256=cyBSPWKhxy2ynp-yFDwnAiI0P7QZPPvqd9uOCQELgF0,9049
-fishertools-0.2.1.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-fishertools-0.2.1.dist-info/top_level.txt,sha256=rZDacVWxcOzBe1B5mCXYqOShQ1KJyzXIPAAJNZ5OYv4,18
-fishertools-0.2.1.dist-info/RECORD,,