feat(parser): реализован парсинг новых файлов

- Добавлена поддержка формата *.xyz, что расширило возможности анализа проектов. - Реализована функция `parse_xyz` в файле [`archdoc-core/src/parser.rs`](archdoc-core/src/parser.rs:42) для чтения и валидации содержимого. - Обновлены тесты в [`archdoc-core/tests/parser_tests.rs`](archdoc-core/tests/parser_tests.rs:15) для покрытия нового формата. - Обновлена документация в `README.md` с примерами использования нового парсера.
2026-01-25 22:26:34 +03:00
parent b7d3e3e488
commit f7e08aad0e
19 changed files with 1422 additions and 46 deletions
--- a/archdoc-cli/docs/architecture/files/.._test-project_src_init.py.md
+++ b/archdoc-cli/docs/architecture/files/.._test-project_src_init.py.md
@@ -0,0 +1,28 @@
+# File: ../test-project/src/__init__.py
+
+- **Module:** ../test-project/src/__init__.py
+- **Defined symbols:** 0
+- **Imports:** 0
+
+<!-- MANUAL:BEGIN -->
+## File intent (manual)
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+
+---
+
+## Imports & file-level dependencies
+<!-- ARCHDOC:BEGIN section=file_imports -->
+> Generated. Do not edit inside this block.
+<!-- ARCHDOC:END section=file_imports -->
+
+---
+
+## Symbols index
+<!-- ARCHDOC:BEGIN section=symbols_index -->
+> Generated. Do not edit inside this block.
+<!-- ARCHDOC:END section=symbols_index -->
+
+---
+
+## Symbol details
--- a/archdoc-cli/docs/architecture/files/.._test-project_src_core.py.md
+++ b/archdoc-cli/docs/architecture/files/.._test-project_src_core.py.md
@@ -0,0 +1,276 @@
+# File: ../test-project/src/core.py
+
+- **Module:** ../test-project/src/core.py
+- **Defined symbols:** 6
+- **Imports:** 2
+
+<!-- MANUAL:BEGIN -->
+## File intent (manual)
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+
+---
+
+## Imports & file-level dependencies
+<!-- ARCHDOC:BEGIN section=file_imports -->
+> Generated. Do not edit inside this block.
+- sqlite3
+- requests
+<!-- ARCHDOC:END section=file_imports -->
+
+---
+
+## Symbols index
+<!-- ARCHDOC:BEGIN section=symbols_index -->
+> Generated. Do not edit inside this block.
+- [DatabaseManager](.._test-project_src_core.py#DatabaseManager)
+- [__init__](.._test-project_src_core.py#__init__)
+- [connect](.._test-project_src_core.py#connect)
+- [execute_query](.._test-project_src_core.py#execute_query)
+- [fetch_external_data](.._test-project_src_core.py#fetch_external_data)
+- [process_user_data](.._test-project_src_core.py#process_user_data)
+<!-- ARCHDOC:END section=symbols_index -->
+
+---
+
+## Symbol details
+
+<!-- ARCHDOC:BEGIN symbol id=DatabaseManager --><a id="DatabaseManager"></a>
+
+### `DatabaseManager`
+- **Kind:** Class
+- **Signature:** `class DatabaseManager`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: yes
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=DatabaseManager -->
+
+<!-- ARCHDOC:BEGIN symbol id=__init__ --><a id="__init__"></a>
+
+### `__init__`
+- **Kind:** Function
+- **Signature:** `def __init__(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=__init__ -->
+
+<!-- ARCHDOC:BEGIN symbol id=connect --><a id="connect"></a>
+
+### `connect`
+- **Kind:** Function
+- **Signature:** `def connect(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: yes
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=connect -->
+
+<!-- ARCHDOC:BEGIN symbol id=execute_query --><a id="execute_query"></a>
+
+### `execute_query`
+- **Kind:** Function
+- **Signature:** `def execute_query(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=execute_query -->
+
+<!-- ARCHDOC:BEGIN symbol id=fetch_external_data --><a id="fetch_external_data"></a>
+
+### `fetch_external_data`
+- **Kind:** Function
+- **Signature:** `def fetch_external_data(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: yes
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=fetch_external_data -->
+
+<!-- ARCHDOC:BEGIN symbol id=process_user_data --><a id="process_user_data"></a>
+
+### `process_user_data`
+- **Kind:** Function
+- **Signature:** `def process_user_data(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 1
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=process_user_data -->
--- a/archdoc-cli/docs/architecture/files/.._test-project_src_utils.py.md
+++ b/archdoc-cli/docs/architecture/files/.._test-project_src_utils.py.md
@@ -0,0 +1,194 @@
+# File: ../test-project/src/utils.py
+
+- **Module:** ../test-project/src/utils.py
+- **Defined symbols:** 4
+- **Imports:** 2
+
+<!-- MANUAL:BEGIN -->
+## File intent (manual)
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+
+---
+
+## Imports & file-level dependencies
+<!-- ARCHDOC:BEGIN section=file_imports -->
+> Generated. Do not edit inside this block.
+- json
+- os
+<!-- ARCHDOC:END section=file_imports -->
+
+---
+
+## Symbols index
+<!-- ARCHDOC:BEGIN section=symbols_index -->
+> Generated. Do not edit inside this block.
+- [load_config](.._test-project_src_utils.py#load_config)
+- [save_config](.._test-project_src_utils.py#save_config)
+- [get_file_size](.._test-project_src_utils.py#get_file_size)
+- [format_bytes](.._test-project_src_utils.py#format_bytes)
+<!-- ARCHDOC:END section=symbols_index -->
+
+---
+
+## Symbol details
+
+<!-- ARCHDOC:BEGIN symbol id=load_config --><a id="load_config"></a>
+
+### `load_config`
+- **Kind:** Function
+- **Signature:** `def load_config(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=load_config -->
+
+<!-- ARCHDOC:BEGIN symbol id=save_config --><a id="save_config"></a>
+
+### `save_config`
+- **Kind:** Function
+- **Signature:** `def save_config(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=save_config -->
+
+<!-- ARCHDOC:BEGIN symbol id=get_file_size --><a id="get_file_size"></a>
+
+### `get_file_size`
+- **Kind:** Function
+- **Signature:** `def get_file_size(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=get_file_size -->
+
+<!-- ARCHDOC:BEGIN symbol id=format_bytes --><a id="format_bytes"></a>
+
+### `format_bytes`
+- **Kind:** Function
+- **Signature:** `def format_bytes(...)`
+- **Docstring:** `No documentation available`
+
+#### What it does
+<!-- ARCHDOC:BEGIN section=purpose -->
+extracted from AST
+<!-- ARCHDOC:END section=purpose -->
+
+#### Relations
+<!-- ARCHDOC:BEGIN section=relations -->
+**Outbound calls (best-effort):**
+
+**Inbound (used by) (best-effort):**
+<!-- ARCHDOC:END section=relations -->
+
+#### Integrations (heuristic)
+<!-- ARCHDOC:BEGIN section=integrations -->
+- HTTP: no
+- DB: no
+- Queue/Tasks: no
+<!-- ARCHDOC:END section=integrations -->
+
+#### Risk / impact
+<!-- ARCHDOC:BEGIN section=impact -->
+- fan-in: 0
+- fan-out: 0
+- cycle participant: no
+- critical: no
+<!-- ARCHDOC:END section=impact -->
+
+<!-- MANUAL:BEGIN -->
+#### Manual notes
+<FILL_MANUALLY>
+<!-- MANUAL:END -->
+<!-- ARCHDOC:END symbol id=format_bytes -->
--- a/archdoc-cli/docs/architecture/layout.md
+++ b/archdoc-cli/docs/architecture/layout.md
@@ -0,0 +1,18 @@
+# Repository layout
+
+<!-- MANUAL:BEGIN -->
+## Manual overrides
+- `src/app/` — <FILL_MANUALLY>
+<!-- MANUAL:END -->
+
+---
+
+## Detected structure
+<!-- ARCHDOC:BEGIN section=layout_detected -->
+> Generated. Do not edit inside this block.
+| Path | Purpose | Link |
+|------|---------|------|
+| ../test-project/src/utils.py | Source file | [details](files/.._test-project_src_utils.py.md) |
+| ../test-project/src/__init__.py | Source file | [details](files/.._test-project_src___init__.py.md) |
+| ../test-project/src/core.py | Source file | [details](files/.._test-project_src_core.py.md) |
+<!-- ARCHDOC:END section=layout_detected -->
--- a/archdoc-cli/docs/architecture/modules/.._test-project_src_init.py.md
+++ b/archdoc-cli/docs/architecture/modules/.._test-project_src_init.py.md
@@ -0,0 +1,27 @@
+# Module: ../test-project/src/__init__.py
+
+No summary available
+
+## Symbols
+
+
+## Dependencies
+
+### Imports
+
+### Outbound Modules
+
+### Inbound Modules
+
+## Integrations
+
+
+
+
+## Usage Examples
+
+```python
+// Example usage of module functions
+// TODO: Add real usage examples based on module analysis
+```
+
--- a/archdoc-cli/docs/architecture/modules/.._test-project_src_core.py.md
+++ b/archdoc-cli/docs/architecture/modules/.._test-project_src_core.py.md
@@ -0,0 +1,106 @@
+# Module: ../test-project/src/core.py
+
+No summary available
+
+## Symbols
+
+### DatabaseManager
+
+class DatabaseManager
+
+No documentation available
+
+**Type:** Class
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### __init__
+
+def __init__(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### connect
+
+def connect(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### execute_query
+
+def execute_query(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### fetch_external_data
+
+def fetch_external_data(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### process_user_data
+
+def process_user_data(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 1
+
+
+## Dependencies
+
+### Imports
+- sqlite3
+- requests
+
+### Outbound Modules
+
+### Inbound Modules
+
+## Integrations
+
+### Database Integrations
+- DatabaseManager
+- connect
+
+### HTTP/API Integrations
+- fetch_external_data
+
+
+## Usage Examples
+
+```python
+// Example usage of module functions
+// TODO: Add real usage examples based on module analysis
+```
+
--- a/archdoc-cli/docs/architecture/modules/.._test-project_src_utils.py.md
+++ b/archdoc-cli/docs/architecture/modules/.._test-project_src_utils.py.md
@@ -0,0 +1,77 @@
+# Module: ../test-project/src/utils.py
+
+No summary available
+
+## Symbols
+
+### load_config
+
+def load_config(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### save_config
+
+def save_config(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### get_file_size
+
+def get_file_size(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+### format_bytes
+
+def format_bytes(...)
+
+No documentation available
+
+**Type:** Function
+
+**Metrics:**
+- Fan-in: 0
+- Fan-out: 0
+
+
+## Dependencies
+
+### Imports
+- json
+- os
+
+### Outbound Modules
+
+### Inbound Modules
+
+## Integrations
+
+
+
+
+## Usage Examples
+
+```python
+// Example usage of module functions
+// TODO: Add real usage examples based on module analysis
+```
+