ms-file-toolkit 0.4.0__tar.gz

ms_file_toolkit-0.4.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: ms-file-toolkit
+Version: 0.4.0
+Summary: Microsoft fayllarni (DOCX/XLSX/PPTX) o'qish va yozish uchun AI function-calling Python toolkit
+Author: muslihiddinlive
+License: MIT
+Project-URL: Homepage, https://github.com/muslihiddinlive/ms-file-toolkit
+Project-URL: Repository, https://github.com/muslihiddinlive/ms-file-toolkit
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: python-docx>=1.1.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: python-pptx>=0.6.23
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: pdfplumber>=0.11.0
+Requires-Dist: reportlab>=4.0.0
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.40.0; extra == "ai"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# ms-file-toolkit
+
+Microsoft fayllarni va PDF'larni **o'qish va yozish** uchun Python toolkit — **AI function calling** (Claude, GPT va h.k.) uchun tayyor tool schemalari, **xavfsizlik nazorati**, **avtomatik format aniqlash** va **CLI** bilan.
+
+## O'rnatish
+
+```bash
+pip install -r requirements.txt
+```
+
+Yoki paket sifatida (PyPI'ga chiqarishga tayyor, CLI bilan birga o'rnatiladi):
+
+```bash
+pip install -e ".[ai,dev]"
+```
+
+## Qo'llab-quvvatlanadigan formatlar
+
+| Format                        | O'qish                                        | Yozish                                                                             |
+| ------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------- |
+| `.docx`                         | matn, jadvallar, metama'lumot                     | yaratish, matn qo'shish/almashtirish, sarlavha, rasm, sahifa bo'linishi                |
+| `.xlsx`                         | varaq nomlari, ma'lumotlar, o'lcham xulosasi      | yaratish, varaq/qator qo'shish, formula, formatlash, panellarni muzlatish, **diagramma** |
+| `.pptx`                         | slayd matnlari, slaydlar soni, notes              | yaratish, slayd/rasm qo'shish, fon rangi, **diagramma**                                 |
+| `.pdf`                          | matn, jadvallar, metama'lumot                     | yaratish, birlashtirish (merge), bo'lish (split)                                        |
+| `.doc` / `.xls` / `.ppt` (eski) | `read_legacy_file` — LibreOffice orqali            | —                                                                                          |
+| **Har qanday (avtomatik)**       | `read_any_file`, `get_file_info`                   | —                                                                                          |
+
+> Eski formatlar uchun tizimda **LibreOffice** (`soffice`) kerak: `apt-get install libreoffice`
+
+## Xavfsizlik
+
+Fayl yo'llari AI tomonidan tanlanadi, shuning uchun **path traversal** himoyasi o'rnatilgan (`ms_toolkit/security.py`):
+
+```bash
+export MS_TOOLKIT_BASE_DIR=/home/bot/user_files   # faqat shu papka ichidagi fayllarga ruxsat
+```
+
+```python
+dispatch("read_docx_text", {"file_path": "../../etc/passwd"})
+# -> {"error": "Xavfsizlik xatosi: ..."}
+```
+
+## CLI (terminal orqali)
+
+```bash
+ms-toolkit list                                                    # barcha tool'lar ro'yxati
+ms-toolkit run create_docx '{"file_path": "a.docx", "title": "Salom", "overwrite": true}'
+ms-toolkit run read_any_file '{"file_path": "hujjat.xlsx"}'
+```
+
+## Tez boshlash (API kalitisiz)
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v          # 23 ta test
+python test_toolkit.py    # tezkor smoke-test
+```
+
+## Function calling bilan (Claude API)
+
+```python
+from ms_toolkit import TOOLS, dispatch
+import anthropic
+
+client = anthropic.Anthropic()
+response = client.messages.create(
+    model="claude-sonnet-5",
+    max_tokens=1024,
+    tools=TOOLS,
+    messages=[{"role": "user", "content": "test.xlsx faylida nechta qator bor?"}],
+)
+
+for block in response.content:
+    if block.type == "tool_use":
+        print(dispatch(block.name, block.input))
+```
+
+To'liq agentic misol: [`example.py`](example.py).
+
+## Diagramma qo'shish misoli
+
+```python
+from ms_toolkit import dispatch
+
+dispatch("add_xlsx_chart", {
+    "file_path": "hisobot.xlsx", "chart_type": "bar",
+    "data_range": "B1:B5", "categories_range": "A2:A5", "title": "Oylik savdo",
+})
+
+dispatch("add_pptx_chart", {
+    "file_path": "taqdimot.pptx", "chart_type": "pie",
+    "categories": ["A", "B", "C"], "series": {"2026": [40, 35, 25]},
+})
+```
+
+## Barcha tool'lar ro'yxati (36 ta)
+
+**DOCX (9):** `read_docx_text`, `read_docx_tables`, `get_docx_metadata`, `create_docx`, `append_docx_text`, `replace_docx_text`, `add_docx_heading`, `add_docx_image`, `add_docx_page_break`
+**XLSX (10):** `get_xlsx_sheet_names`, `read_xlsx_data`, `get_xlsx_summary`, `create_xlsx`, `add_xlsx_sheet`, `append_xlsx_rows`, `set_xlsx_formula`, `format_xlsx_cells`, `freeze_xlsx_panes`, `add_xlsx_chart`
+**PPTX (8):** `read_pptx_text`, `get_pptx_slide_count`, `extract_pptx_notes`, `create_pptx`, `add_pptx_slide`, `add_pptx_image`, `set_pptx_background_color`, `add_pptx_chart`
+**PDF (6):** `read_pdf_text`, `read_pdf_tables`, `get_pdf_metadata`, `create_pdf`, `merge_pdfs`, `split_pdf`
+**Eski formatlar (1):** `read_legacy_file`
+**Auto-detect (2):** `read_any_file`, `get_file_info`
+
+## Struktura
+
+```
+ms_toolkit/
+  __init__.py       # TOOLS, dispatch export qiladi
+  docx_tool.py / docx_writer.py     # Word
+  xlsx_tool.py / xlsx_writer.py     # Excel (+ chart)
+  pptx_tool.py / pptx_writer.py     # PowerPoint (+ chart)
+  pdf_tool.py / pdf_writer.py        # PDF
+  legacy_tool.py                       # Eski formatlar
+  auto_tool.py                          # Avtomatik format aniqlash
+  security.py                            # Path-traversal himoyasi
+  cli.py                                   # Terminal interfeysi (ms-toolkit)
+  schemas.py                                # AI uchun tool schemalari
+  registry.py                                 # tool_name -> funksiya dispatcher
+example.py, test_toolkit.py, tests/            # Misollar va testlar
+pyproject.toml                                    # pip/PyPI paketlash + CLI entry point
+```
+
+## PyPI'ga chiqarish
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## Litsenziya
+
+MIT

ms_file_toolkit-0.4.0/README.md

@@ -0,0 +1,134 @@
+# ms-file-toolkit
+
+Microsoft fayllarni va PDF'larni **o'qish va yozish** uchun Python toolkit — **AI function calling** (Claude, GPT va h.k.) uchun tayyor tool schemalari, **xavfsizlik nazorati**, **avtomatik format aniqlash** va **CLI** bilan.
+
+## O'rnatish
+
+```bash
+pip install -r requirements.txt
+```
+
+Yoki paket sifatida (PyPI'ga chiqarishga tayyor, CLI bilan birga o'rnatiladi):
+
+```bash
+pip install -e ".[ai,dev]"
+```
+
+## Qo'llab-quvvatlanadigan formatlar
+
+| Format                        | O'qish                                        | Yozish                                                                             |
+| ------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------- |
+| `.docx`                         | matn, jadvallar, metama'lumot                     | yaratish, matn qo'shish/almashtirish, sarlavha, rasm, sahifa bo'linishi                |
+| `.xlsx`                         | varaq nomlari, ma'lumotlar, o'lcham xulosasi      | yaratish, varaq/qator qo'shish, formula, formatlash, panellarni muzlatish, **diagramma** |
+| `.pptx`                         | slayd matnlari, slaydlar soni, notes              | yaratish, slayd/rasm qo'shish, fon rangi, **diagramma**                                 |
+| `.pdf`                          | matn, jadvallar, metama'lumot                     | yaratish, birlashtirish (merge), bo'lish (split)                                        |
+| `.doc` / `.xls` / `.ppt` (eski) | `read_legacy_file` — LibreOffice orqali            | —                                                                                          |
+| **Har qanday (avtomatik)**       | `read_any_file`, `get_file_info`                   | —                                                                                          |
+
+> Eski formatlar uchun tizimda **LibreOffice** (`soffice`) kerak: `apt-get install libreoffice`
+
+## Xavfsizlik
+
+Fayl yo'llari AI tomonidan tanlanadi, shuning uchun **path traversal** himoyasi o'rnatilgan (`ms_toolkit/security.py`):
+
+```bash
+export MS_TOOLKIT_BASE_DIR=/home/bot/user_files   # faqat shu papka ichidagi fayllarga ruxsat
+```
+
+```python
+dispatch("read_docx_text", {"file_path": "../../etc/passwd"})
+# -> {"error": "Xavfsizlik xatosi: ..."}
+```
+
+## CLI (terminal orqali)
+
+```bash
+ms-toolkit list                                                    # barcha tool'lar ro'yxati
+ms-toolkit run create_docx '{"file_path": "a.docx", "title": "Salom", "overwrite": true}'
+ms-toolkit run read_any_file '{"file_path": "hujjat.xlsx"}'
+```
+
+## Tez boshlash (API kalitisiz)
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v          # 23 ta test
+python test_toolkit.py    # tezkor smoke-test
+```
+
+## Function calling bilan (Claude API)
+
+```python
+from ms_toolkit import TOOLS, dispatch
+import anthropic
+
+client = anthropic.Anthropic()
+response = client.messages.create(
+    model="claude-sonnet-5",
+    max_tokens=1024,
+    tools=TOOLS,
+    messages=[{"role": "user", "content": "test.xlsx faylida nechta qator bor?"}],
+)
+
+for block in response.content:
+    if block.type == "tool_use":
+        print(dispatch(block.name, block.input))
+```
+
+To'liq agentic misol: [`example.py`](example.py).
+
+## Diagramma qo'shish misoli
+
+```python
+from ms_toolkit import dispatch
+
+dispatch("add_xlsx_chart", {
+    "file_path": "hisobot.xlsx", "chart_type": "bar",
+    "data_range": "B1:B5", "categories_range": "A2:A5", "title": "Oylik savdo",
+})
+
+dispatch("add_pptx_chart", {
+    "file_path": "taqdimot.pptx", "chart_type": "pie",
+    "categories": ["A", "B", "C"], "series": {"2026": [40, 35, 25]},
+})
+```
+
+## Barcha tool'lar ro'yxati (36 ta)
+
+**DOCX (9):** `read_docx_text`, `read_docx_tables`, `get_docx_metadata`, `create_docx`, `append_docx_text`, `replace_docx_text`, `add_docx_heading`, `add_docx_image`, `add_docx_page_break`
+**XLSX (10):** `get_xlsx_sheet_names`, `read_xlsx_data`, `get_xlsx_summary`, `create_xlsx`, `add_xlsx_sheet`, `append_xlsx_rows`, `set_xlsx_formula`, `format_xlsx_cells`, `freeze_xlsx_panes`, `add_xlsx_chart`
+**PPTX (8):** `read_pptx_text`, `get_pptx_slide_count`, `extract_pptx_notes`, `create_pptx`, `add_pptx_slide`, `add_pptx_image`, `set_pptx_background_color`, `add_pptx_chart`
+**PDF (6):** `read_pdf_text`, `read_pdf_tables`, `get_pdf_metadata`, `create_pdf`, `merge_pdfs`, `split_pdf`
+**Eski formatlar (1):** `read_legacy_file`
+**Auto-detect (2):** `read_any_file`, `get_file_info`
+
+## Struktura
+
+```
+ms_toolkit/
+  __init__.py       # TOOLS, dispatch export qiladi
+  docx_tool.py / docx_writer.py     # Word
+  xlsx_tool.py / xlsx_writer.py     # Excel (+ chart)
+  pptx_tool.py / pptx_writer.py     # PowerPoint (+ chart)
+  pdf_tool.py / pdf_writer.py        # PDF
+  legacy_tool.py                       # Eski formatlar
+  auto_tool.py                          # Avtomatik format aniqlash
+  security.py                            # Path-traversal himoyasi
+  cli.py                                   # Terminal interfeysi (ms-toolkit)
+  schemas.py                                # AI uchun tool schemalari
+  registry.py                                 # tool_name -> funksiya dispatcher
+example.py, test_toolkit.py, tests/            # Misollar va testlar
+pyproject.toml                                    # pip/PyPI paketlash + CLI entry point
+```
+
+## PyPI'ga chiqarish
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## Litsenziya
+
+MIT

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: ms-file-toolkit
+Version: 0.4.0
+Summary: Microsoft fayllarni (DOCX/XLSX/PPTX) o'qish va yozish uchun AI function-calling Python toolkit
+Author: muslihiddinlive
+License: MIT
+Project-URL: Homepage, https://github.com/muslihiddinlive/ms-file-toolkit
+Project-URL: Repository, https://github.com/muslihiddinlive/ms-file-toolkit
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: python-docx>=1.1.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: python-pptx>=0.6.23
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pypdf>=4.0.0
+Requires-Dist: pdfplumber>=0.11.0
+Requires-Dist: reportlab>=4.0.0
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.40.0; extra == "ai"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# ms-file-toolkit
+
+Microsoft fayllarni va PDF'larni **o'qish va yozish** uchun Python toolkit — **AI function calling** (Claude, GPT va h.k.) uchun tayyor tool schemalari, **xavfsizlik nazorati**, **avtomatik format aniqlash** va **CLI** bilan.
+
+## O'rnatish
+
+```bash
+pip install -r requirements.txt
+```
+
+Yoki paket sifatida (PyPI'ga chiqarishga tayyor, CLI bilan birga o'rnatiladi):
+
+```bash
+pip install -e ".[ai,dev]"
+```
+
+## Qo'llab-quvvatlanadigan formatlar
+
+| Format                        | O'qish                                        | Yozish                                                                             |
+| ------------------------------ | ------------------------------------------------ | --------------------------------------------------------------------------------------- |
+| `.docx`                         | matn, jadvallar, metama'lumot                     | yaratish, matn qo'shish/almashtirish, sarlavha, rasm, sahifa bo'linishi                |
+| `.xlsx`                         | varaq nomlari, ma'lumotlar, o'lcham xulosasi      | yaratish, varaq/qator qo'shish, formula, formatlash, panellarni muzlatish, **diagramma** |
+| `.pptx`                         | slayd matnlari, slaydlar soni, notes              | yaratish, slayd/rasm qo'shish, fon rangi, **diagramma**                                 |
+| `.pdf`                          | matn, jadvallar, metama'lumot                     | yaratish, birlashtirish (merge), bo'lish (split)                                        |
+| `.doc` / `.xls` / `.ppt` (eski) | `read_legacy_file` — LibreOffice orqali            | —                                                                                          |
+| **Har qanday (avtomatik)**       | `read_any_file`, `get_file_info`                   | —                                                                                          |
+
+> Eski formatlar uchun tizimda **LibreOffice** (`soffice`) kerak: `apt-get install libreoffice`
+
+## Xavfsizlik
+
+Fayl yo'llari AI tomonidan tanlanadi, shuning uchun **path traversal** himoyasi o'rnatilgan (`ms_toolkit/security.py`):
+
+```bash
+export MS_TOOLKIT_BASE_DIR=/home/bot/user_files   # faqat shu papka ichidagi fayllarga ruxsat
+```
+
+```python
+dispatch("read_docx_text", {"file_path": "../../etc/passwd"})
+# -> {"error": "Xavfsizlik xatosi: ..."}
+```
+
+## CLI (terminal orqali)
+
+```bash
+ms-toolkit list                                                    # barcha tool'lar ro'yxati
+ms-toolkit run create_docx '{"file_path": "a.docx", "title": "Salom", "overwrite": true}'
+ms-toolkit run read_any_file '{"file_path": "hujjat.xlsx"}'
+```
+
+## Tez boshlash (API kalitisiz)
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v          # 23 ta test
+python test_toolkit.py    # tezkor smoke-test
+```
+
+## Function calling bilan (Claude API)
+
+```python
+from ms_toolkit import TOOLS, dispatch
+import anthropic
+
+client = anthropic.Anthropic()
+response = client.messages.create(
+    model="claude-sonnet-5",
+    max_tokens=1024,
+    tools=TOOLS,
+    messages=[{"role": "user", "content": "test.xlsx faylida nechta qator bor?"}],
+)
+
+for block in response.content:
+    if block.type == "tool_use":
+        print(dispatch(block.name, block.input))
+```
+
+To'liq agentic misol: [`example.py`](example.py).
+
+## Diagramma qo'shish misoli
+
+```python
+from ms_toolkit import dispatch
+
+dispatch("add_xlsx_chart", {
+    "file_path": "hisobot.xlsx", "chart_type": "bar",
+    "data_range": "B1:B5", "categories_range": "A2:A5", "title": "Oylik savdo",
+})
+
+dispatch("add_pptx_chart", {
+    "file_path": "taqdimot.pptx", "chart_type": "pie",
+    "categories": ["A", "B", "C"], "series": {"2026": [40, 35, 25]},
+})
+```
+
+## Barcha tool'lar ro'yxati (36 ta)
+
+**DOCX (9):** `read_docx_text`, `read_docx_tables`, `get_docx_metadata`, `create_docx`, `append_docx_text`, `replace_docx_text`, `add_docx_heading`, `add_docx_image`, `add_docx_page_break`
+**XLSX (10):** `get_xlsx_sheet_names`, `read_xlsx_data`, `get_xlsx_summary`, `create_xlsx`, `add_xlsx_sheet`, `append_xlsx_rows`, `set_xlsx_formula`, `format_xlsx_cells`, `freeze_xlsx_panes`, `add_xlsx_chart`
+**PPTX (8):** `read_pptx_text`, `get_pptx_slide_count`, `extract_pptx_notes`, `create_pptx`, `add_pptx_slide`, `add_pptx_image`, `set_pptx_background_color`, `add_pptx_chart`
+**PDF (6):** `read_pdf_text`, `read_pdf_tables`, `get_pdf_metadata`, `create_pdf`, `merge_pdfs`, `split_pdf`
+**Eski formatlar (1):** `read_legacy_file`
+**Auto-detect (2):** `read_any_file`, `get_file_info`
+
+## Struktura
+
+```
+ms_toolkit/
+  __init__.py       # TOOLS, dispatch export qiladi
+  docx_tool.py / docx_writer.py     # Word
+  xlsx_tool.py / xlsx_writer.py     # Excel (+ chart)
+  pptx_tool.py / pptx_writer.py     # PowerPoint (+ chart)
+  pdf_tool.py / pdf_writer.py        # PDF
+  legacy_tool.py                       # Eski formatlar
+  auto_tool.py                          # Avtomatik format aniqlash
+  security.py                            # Path-traversal himoyasi
+  cli.py                                   # Terminal interfeysi (ms-toolkit)
+  schemas.py                                # AI uchun tool schemalari
+  registry.py                                 # tool_name -> funksiya dispatcher
+example.py, test_toolkit.py, tests/            # Misollar va testlar
+pyproject.toml                                    # pip/PyPI paketlash + CLI entry point
+```
+
+## PyPI'ga chiqarish
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## Litsenziya
+
+MIT

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+README.md
+pyproject.toml
+ms_file_toolkit.egg-info/PKG-INFO
+ms_file_toolkit.egg-info/SOURCES.txt
+ms_file_toolkit.egg-info/dependency_links.txt
+ms_file_toolkit.egg-info/entry_points.txt
+ms_file_toolkit.egg-info/requires.txt
+ms_file_toolkit.egg-info/top_level.txt
+ms_toolkit/__init__.py
+ms_toolkit/auto_tool.py
+ms_toolkit/cli.py
+ms_toolkit/docx_tool.py
+ms_toolkit/docx_writer.py
+ms_toolkit/legacy_tool.py
+ms_toolkit/pdf_tool.py
+ms_toolkit/pdf_writer.py
+ms_toolkit/pptx_tool.py
+ms_toolkit/pptx_writer.py
+ms_toolkit/registry.py
+ms_toolkit/schemas.py
+ms_toolkit/security.py
+ms_toolkit/xlsx_tool.py
+ms_toolkit/xlsx_writer.py
+tests/test_toolkit.py

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ms-toolkit = ms_toolkit.cli:main

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/requires.txt

@@ -0,0 +1,13 @@
+python-docx>=1.1.0
+openpyxl>=3.1.0
+python-pptx>=0.6.23
+Pillow>=10.0.0
+pypdf>=4.0.0
+pdfplumber>=0.11.0
+reportlab>=4.0.0
+
+[ai]
+anthropic>=0.40.0
+
+[dev]
+pytest>=8.0.0

ms_file_toolkit-0.4.0/ms_file_toolkit.egg-info/top_level.txt

@@ -0,0 +1 @@
+ms_toolkit

ms_file_toolkit-0.4.0/ms_toolkit/__init__.py

@@ -0,0 +1,5 @@
+from .schemas import TOOLS
+from .registry import dispatch, REGISTRY
+
+__all__ = ["TOOLS", "dispatch", "REGISTRY"]
+__version__ = "0.4.0"

ms_file_toolkit-0.4.0/ms_toolkit/auto_tool.py

@@ -0,0 +1,61 @@
+"""Fayl turini avtomatik aniqlab, mos reader'ni chaqiradigan yordamchi modul."""
+
+import os
+
+_EXT_MAP = {
+    ".docx": "docx",
+    ".xlsx": "xlsx",
+    ".pptx": "pptx",
+    ".pdf": "pdf",
+    ".doc": "legacy",
+    ".xls": "legacy",
+    ".ppt": "legacy",
+}
+
+
+def get_file_info(file_path: str) -> dict:
+    """Fayl haqida asosiy ma'lumot: mavjudmi, kengaytmasi, hajmi, aniqlangan turi."""
+    ext = os.path.splitext(file_path)[1].lower()
+    exists = os.path.exists(file_path)
+    return {
+        "file_path": file_path,
+        "exists": exists,
+        "extension": ext,
+        "detected_type": _EXT_MAP.get(ext, "unknown"),
+        "size_bytes": os.path.getsize(file_path) if exists else None,
+    }
+
+
+def read_any_file(file_path: str) -> dict:
+    """Fayl kengaytmasiga qarab mos o'qish funksiyasini avtomatik tanlab chaqiradi.
+
+    Foydalanuvchi/AI fayl turini oldindan bilmasa yoki noaniq bo'lsa foydali —
+    .docx/.xlsx/.pptx va eski .doc/.xls/.ppt formatlarni avtomatik aniqlaydi.
+    """
+    from .docx_tool import read_docx_text
+    from .xlsx_tool import read_xlsx_data
+    from .pptx_tool import read_pptx_text
+    from .pdf_tool import read_pdf_text
+    from .legacy_tool import read_legacy_file
+
+    if not os.path.exists(file_path):
+        return {"error": f"Fayl topilmadi: {file_path}"}
+
+    ext = os.path.splitext(file_path)[1].lower()
+    kind = _EXT_MAP.get(ext)
+
+    if kind == "docx":
+        result = read_docx_text(file_path)
+    elif kind == "xlsx":
+        result = read_xlsx_data(file_path)
+    elif kind == "pptx":
+        result = read_pptx_text(file_path)
+    elif kind == "pdf":
+        result = read_pdf_text(file_path)
+    elif kind == "legacy":
+        result = read_legacy_file(file_path)
+    else:
+        return {"error": f"Qo'llab-quvvatlanmaydigan yoki noma'lum fayl turi: {ext or '(kengaytmasiz)'}"}
+
+    result["detected_type"] = kind
+    return result

ms_file_toolkit-0.4.0/ms_toolkit/cli.py

@@ -0,0 +1,61 @@
+"""
+ms_toolkit uchun komandalar qatori (CLI) interfeysi.
+
+Ishlatish:
+    ms-toolkit list
+    ms-toolkit run create_docx '{"file_path": "test.docx", "title": "Salom"}'
+    ms-toolkit run read_docx_text '{"file_path": "test.docx"}'
+    ms-toolkit run read_any_file '{"file_path": "hujjat.xlsx"}'
+
+MS_TOOLKIT_BASE_DIR muhit o'zgaruvchisi bilan fayl amallarini bitta papkaga
+cheklash mumkin (xavfsizlik uchun tavsiya etiladi).
+"""
+
+import sys
+import json
+import argparse
+
+from .registry import REGISTRY, dispatch
+from .schemas import TOOLS
+
+
+def cmd_list(args):
+    for t in TOOLS:
+        print(f"{t['name']:<28} {t['description'][:80]}")
+
+
+def cmd_run(args):
+    if args.tool_name not in REGISTRY:
+        print(f"Xato: noma'lum tool '{args.tool_name}'. Ro'yxat uchun: ms-toolkit list", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        tool_input = json.loads(args.json_input)
+    except json.JSONDecodeError as e:
+        print(f"Xato: JSON noto'g'ri formatda: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    result = dispatch(args.tool_name, tool_input)
+    print(json.dumps(result, ensure_ascii=False, indent=2, default=str))
+
+    if "error" in result:
+        sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(prog="ms-toolkit", description="MS fayllar (DOCX/XLSX/PPTX/PDF) uchun CLI")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("list", help="Barcha mavjud tool'larni ro'yxatini chiqaradi").set_defaults(func=cmd_list)
+
+    run_parser = sub.add_parser("run", help="Bitta tool'ni ishga tushiradi")
+    run_parser.add_argument("tool_name", help="Ishga tushiriladigan tool nomi (masalan: create_docx)")
+    run_parser.add_argument("json_input", help="Tool uchun JSON formatidagi kirish, masalan '{\"file_path\": \"a.docx\"}'")
+    run_parser.set_defaults(func=cmd_run)
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

ms_file_toolkit-0.4.0/ms_toolkit/docx_tool.py

@@ -0,0 +1,41 @@
+"""DOCX (Word) fayllarni o'qish va tahlil qilish funksiyalari."""
+
+from docx import Document
+
+
+def read_docx_text(file_path: str) -> dict:
+    """Word hujjatidagi barcha matnni paragraflar bo'yicha o'qiydi."""
+    doc = Document(file_path)
+    paragraphs = [p.text for p in doc.paragraphs if p.text.strip()]
+    return {
+        "file_path": file_path,
+        "paragraph_count": len(paragraphs),
+        "text": "\n".join(paragraphs),
+    }
+
+
+def read_docx_tables(file_path: str) -> dict:
+    """Word hujjatidagi barcha jadvallarni o'qiydi."""
+    doc = Document(file_path)
+    tables = []
+    for table in doc.tables:
+        rows = []
+        for row in table.rows:
+            rows.append([cell.text for cell in row.cells])
+        tables.append(rows)
+    return {"file_path": file_path, "table_count": len(tables), "tables": tables}
+
+
+def get_docx_metadata(file_path: str) -> dict:
+    """Word hujjatining metama'lumotlarini (muallif, sarlavha va h.k.) qaytaradi."""
+    doc = Document(file_path)
+    props = doc.core_properties
+    return {
+        "file_path": file_path,
+        "title": props.title,
+        "author": props.author,
+        "created": str(props.created) if props.created else None,
+        "modified": str(props.modified) if props.modified else None,
+        "paragraph_count": len(doc.paragraphs),
+        "table_count": len(doc.tables),
+    }