toolslm 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

toolslm/__init__.py

@@ -1 +1 @@
-__version__ = "0.3.1"
+__version__ = "0.3.2"

toolslm/md_hier.py

@@ -1,75 +1,63 @@
 import re
 from fastcore.utils import *
-__all__ = ['markdown_to_dict', 'create_heading_dict']
+__all__ = ['create_heading_dict', 'HeadingDict']
 
-def markdown_to_dict(
-    markdown_content:str  # Markdown text including headings
-)->AttrDict: # Dictionary with dot-separated hierarchical keys and content values
-    "Parse markdown content into a hierarchical dictionary with dot-separated keys."
-    def clean_heading(text): return re.sub(r'[.]+', '', text).strip()  # Only remove dots (key separator)
+class HeadingDict(dict):
+    """A dictionary-like object that also stores the markdown text content."""
+    def __init__(self, text="", *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.text = text
 
-    lines = markdown_content.splitlines()
+
+def create_heading_dict(text, rm_fenced=True):
+    "Create a nested dictionary structure from markdown headings."
+    original_text = text
+    original_lines = text.splitlines()
+    
+    # Use fenced-removed text only for finding headings
+    text_for_headings = text
+    if rm_fenced: text_for_headings = re.sub(r'```[\s\S]*?```', '', text)
+
+    lines_for_headings = text_for_headings.splitlines()
     headings = []
-    in_code_block = False
 
     # Parse headings with their levels and line numbers
-    for idx, line in enumerate(lines):
-        # Toggle code block state when encountering fence
-        if line.strip().startswith('```'): in_code_block = not in_code_block
-        # Only detect headings when not in a code block
-        if in_code_block: continue
-        match = re.match(r'^(#{1,6})\s*(.*)', line)
+    for idx, line in enumerate(lines_for_headings):
+        match = re.match(r'^(#{1,6})\s+\S.*', line)
         if match:
             level = len(match.group(1))
-            text = match.group(2).strip()
-            headings.append({'level': level, 'text': text, 'line': idx})
+            title = line.strip('#').strip()
+            headings.append({'level': level, 'title': title, 'line': idx})
 
-    # Assign content to each heading, including subheadings
+    # Assign text content to each heading using original lines
     for i, h in enumerate(headings):
-        start = h['line']  # Include the heading line itself
+        start = h['line']
         # Find the end index: next heading of same or higher level
         for j in range(i + 1, len(headings)):
             if headings[j]['level'] <= h['level']:
                 end = headings[j]['line']
                 break
-        else: end = len(lines)
-        h['content'] = '\n'.join(lines[start:end]).strip()
-
-    # Build the dictionary with hierarchical keys
-    result,stack = {},[]
-    if not headings:
-        return dict2obj(result)
+        else:
+            end = len(original_lines)
+        h['content'] = '\n'.join(original_lines[start:end]).strip()
 
-    first_level = headings[0]['level']
-    for h in headings:
-        stack = stack[:h['level'] - first_level] + [clean_heading(h['text'])]
-        key = '.'.join(stack)
-        result[key] = h['content']
-    return dict2obj(result)
-
-def create_heading_dict(text, rm_fenced=True):
-    "Create a nested dictionary structure from markdown headings."
-    if rm_fenced: text = re.sub(r'```[\s\S]*?```', '', text)
-    headings = re.findall(r'^#+.*', text, flags=re.MULTILINE)
-    result = {}
+    # Build the nested structure
+    result = HeadingDict(original_text)
     stack = [result]
-    stack_levels = [0]  # Track the level at each stack position
-
-    for heading in headings:
-        level = heading.count('#')
-        title = heading.strip('#').strip()
+    stack_levels = [0]
 
+    for h in headings:
         # Pop stack until we find the right parent level
-        while len(stack) > 1 and stack_levels[-1] >= level:
+        while len(stack) > 1 and stack_levels[-1] >= h['level']:
             stack.pop()
             stack_levels.pop()
 
-        new_dict = {}
-        stack[-1][title] = new_dict
+        new_dict = HeadingDict(h['content'])
+        stack[-1][h['title']] = new_dict
         stack.append(new_dict)
-        stack_levels.append(level)
+        stack_levels.append(h['level'])
 
-    return dict2obj(result)
+    return result
 
 
 if __name__=='__main__':
@@ -101,63 +89,71 @@ Admin section.
 Admin users management.
 """
 
-    result = markdown_to_dict(md_content)
+    result = create_heading_dict(md_content)
     #for key, value in result.items(): print(f'Key: {key}\nValue:\n{value}\n{"-"*40}')
 
     def test_empty_content():
         md_content = "# Empty Heading"
-        result = markdown_to_dict(md_content)
-        assert result['Empty Heading'] == '# Empty Heading'
+        result = create_heading_dict(md_content)
+        assert 'Empty Heading' in result
+        assert result['Empty Heading'].text == '# Empty Heading'
+        assert result.text == md_content
 
     def test_special_characters():
         md_content = "# Heading *With* Special _Characters_!\nContent under heading."
-        result = markdown_to_dict(md_content)
+        result = create_heading_dict(md_content)
         assert 'Heading *With* Special _Characters_!' in result
-        assert result['Heading *With* Special _Characters_!'] == '# Heading *With* Special _Characters_!\nContent under heading.'
+        assert result['Heading *With* Special _Characters_!'].text == '# Heading *With* Special _Characters_!\nContent under heading.'
+        assert result.text == md_content
 
     def test_duplicate_headings():
         md_content = "# Duplicate\n## Duplicate\n### Duplicate\nContent under duplicate headings."
-        result = markdown_to_dict(md_content)
+        result = create_heading_dict(md_content)
         assert 'Duplicate' in result
-        assert 'Duplicate.Duplicate' in result
-        assert 'Duplicate.Duplicate.Duplicate' in result
-        assert result['Duplicate.Duplicate.Duplicate'] == '### Duplicate\nContent under duplicate headings.'
+        assert 'Duplicate' in result['Duplicate']
+        assert 'Duplicate' in result['Duplicate']['Duplicate']
+        assert result['Duplicate']['Duplicate']['Duplicate'].text == '### Duplicate\nContent under duplicate headings.'
+        assert result.text == md_content
 
     def test_no_content():
         md_content = "# No Content Heading\n## Subheading"
-        result = markdown_to_dict(md_content)
-        assert result['No Content Heading'] == '# No Content Heading\n## Subheading'
-        assert result['No Content Heading.Subheading'] == '## Subheading'
+        result = create_heading_dict(md_content)
+        assert result['No Content Heading'].text == '# No Content Heading\n## Subheading'
+        assert result['No Content Heading']['Subheading'].text == '## Subheading'
+        assert result.text == md_content
 
     def test_different_levels():
         md_content = "### Level 3 Heading\nContent at level 3.\n# Level 1 Heading\nContent at level 1."
-        result = markdown_to_dict(md_content)
+        result = create_heading_dict(md_content)
         assert 'Level 3 Heading' in result
         assert 'Level 1 Heading' in result
-        assert result['Level 3 Heading'] == '### Level 3 Heading\nContent at level 3.'
-        assert result['Level 1 Heading'] == '# Level 1 Heading\nContent at level 1.'
+        assert result['Level 3 Heading'].text == '### Level 3 Heading\nContent at level 3.'
+        assert result['Level 1 Heading'].text == '# Level 1 Heading\nContent at level 1.'
+        assert result.text == md_content
 
     def test_parent_includes_subheadings():
         md_content = "# Parent\nParent content.\n## Child\nChild content.\n### Grandchild\nGrandchild content."
-        result = markdown_to_dict(md_content)
-        assert result['Parent'] == '# Parent\nParent content.\n## Child\nChild content.\n### Grandchild\nGrandchild content.'
-        assert result['Parent.Child'] == '## Child\nChild content.\n### Grandchild\nGrandchild content.'
-        assert result['Parent.Child.Grandchild'] == '### Grandchild\nGrandchild content.'
+        result = create_heading_dict(md_content)
+        assert result['Parent'].text == '# Parent\nParent content.\n## Child\nChild content.\n### Grandchild\nGrandchild content.'
+        assert result['Parent']['Child'].text == '## Child\nChild content.\n### Grandchild\nGrandchild content.'
+        assert result['Parent']['Child']['Grandchild'].text == '### Grandchild\nGrandchild content.'
+        assert result.text == md_content
 
     def test_multiple_level2_siblings():
-        md_content = "##Sib 1\n##Sib 2\n##Sib 3\n##Sib 4\n##Sib 5'"
-        result = markdown_to_dict(md_content)
+        md_content = "## Sib 1\n## Sib 2\n## Sib 3\n## Sib 4\n## Sib 5'"
+        result = create_heading_dict(md_content)
         assert 'Sib 1' in result
         assert 'Sib 2' in result
         assert 'Sib 3' in result
         assert 'Sib 4' in result
-        assert "Sib 5'" in result  # Note the apostrophe is preserved
+        assert "Sib 5'" in result
+        assert result.text == md_content
 
     def test_code_chunks_escaped():
         md_content = "# Parent\nParent content.\n## Child\nChild content.\n```python\n# Code comment\nprint('Hello, world!')\n```"
-        result = markdown_to_dict(md_content)
-        assert 'Code comment' not in result
-        assert "# Code comment" in result['Parent.Child']
+        result = create_heading_dict(md_content)
+        assert 'Code comment' not in str(result)
+        assert result.text == md_content
 
     test_empty_content()
     test_special_characters()
@@ -180,8 +176,28 @@ Admin users management.
         result = create_heading_dict(md_content)
         assert 'Code comment' not in result
 
+    def test_fenced_blocks_preserved_in_text():
+        md_content = """# Section
+Content before code.
+
+```python
+# This heading should be ignored for structure
+def hello():
+    print("Hello, world!")
+```
+
+More content after code."""
+        result = create_heading_dict(md_content)
+        # Fenced code should be preserved in text content
+        assert '```python' in result['Section'].text
+        assert 'def hello():' in result['Section'].text
+        assert '```' in result['Section'].text
+        # But headings inside fenced blocks should not create structure
+        assert 'This heading should be ignored for structure' not in result['Section']
+
     test_nested_headings()
     test_code_chunks_escaped()
+    test_fenced_blocks_preserved_in_text()
 
     def test_multiple_h1s():
         md_content = "# First H1\n# Second H1\n# Third H1"
@@ -221,48 +237,38 @@ Admin users management.
     test_skip_levels_up()
     test_non_h1_start()
 
-    # Critical edge case tests
+    # Edge case tests
     def test_empty_input():
-        result = markdown_to_dict("")
-        assert result == {}
         result = create_heading_dict("")
         assert result == {}
+        assert result.text == ""
 
     def test_whitespace_only():
-        result = markdown_to_dict("   \n\t  \n   ")
-        assert result == {}
         result = create_heading_dict("   \n\t  \n   ")
         assert result == {}
+        assert result.text == "   \n\t  \n   "
 
     def test_malformed_headings():
-        # No space after # (actually works - regex allows it)
-        md_content = "#NoSpace\n###AlsoNoSpace\nContent"
-        result = markdown_to_dict(md_content)
-        assert 'NoSpace' in result
-        assert 'NoSpace.AlsoNoSpace' in result
-
-        # Too many #s (matches max 6, extra # preserved in text)
+        # Too many #s (matches max 6)
         md_content = "####### Too Many\nContent"
-        result = markdown_to_dict(md_content)
-        assert '# Too Many' in result  # Extra # now preserved in heading text
-
-        # Empty heading (actually creates empty key)
-        md_content = "##   \nContent after empty heading"
-        result = markdown_to_dict(md_content)
-        assert '' in result  # Empty heading creates empty key
+        result = create_heading_dict(md_content)
+        assert 'Too Many' not in result
+        assert result.text == md_content
 
     def test_unicode_and_emojis():
         # Unicode characters
         md_content = "# Café & Naïve\nContent with unicode\n## 中文标题\nChinese content"
-        result = markdown_to_dict(md_content)
+        result = create_heading_dict(md_content)
         assert 'Café & Naïve' in result
-        assert 'Café & Naïve.中文标题' in result
+        assert '中文标题' in result['Café & Naïve']
+        assert result.text == md_content
 
         # Emojis
         md_content = "# 🚀 Rocket Heading\nRocket content\n## 💻 Computer\nComputer content"
-        result = markdown_to_dict(md_content)
+        result = create_heading_dict(md_content)
         assert '🚀 Rocket Heading' in result
-        assert '🚀 Rocket Heading.💻 Computer' in result
+        assert '💻 Computer' in result['🚀 Rocket Heading']
+        assert result.text == md_content
 
     test_empty_input()
     test_whitespace_only()

{toolslm-0.3.1.dist-info → toolslm-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: toolslm
-Version: 0.3.1
+Version: 0.3.2
 Summary: Tools to make language models a bit easier to use
 Home-page: https://github.com/AnswerDotAI/toolslm
 Author: Jeremy Howard

toolslm-0.3.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+toolslm/__init__.py,sha256=vNiWJ14r_cw5t_7UDqDQIVZvladKFGyHH2avsLpN7Vg,22
+toolslm/_modidx.py,sha256=-D-B5o30VGs11gBKf96lpADVXnZhdiVEshJpLzmUnDs,4378
+toolslm/download.py,sha256=g3BxUSxylC_575M7RFSJ1GI3Co3EwPDdEeWzxaf2Czk,4451
+toolslm/funccall.py,sha256=7nPfbcvDRMWiVKBKMLlCOMInoUJgDs5e38ef2T7QBHY,8485
+toolslm/md_hier.py,sha256=Havk9Hf0t2Xt67n_r7ZxCsS0pciR85iLcE5quShvkTg,10032
+toolslm/shell.py,sha256=dGInuRKvexu21VmtZkw_0S3BGiTsbAongUG-yG4YHpc,1566
+toolslm/xml.py,sha256=D665Nk7NzyZlXyXrpnIRqfK2xQ-6Gf0bCSgocjF7zik,4061
+toolslm-0.3.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+toolslm-0.3.2.dist-info/METADATA,sha256=5lWEv7BWTwdd5cvXgGsQXqr0j6tk8UIcGpRTlcjV3V4,2404
+toolslm-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+toolslm-0.3.2.dist-info/entry_points.txt,sha256=xFz0Eymlo5X7BGpaO6DI9gMxvN5A7faebzrlr8ctp5I,95
+toolslm-0.3.2.dist-info/top_level.txt,sha256=4hRTrFWayz_Kz5221XjvlpCwVFrW3WPi1P0fllkTq9s,8
+toolslm-0.3.2.dist-info/RECORD,,

toolslm-0.3.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-toolslm/__init__.py,sha256=r4xAFihOf72W9TD-lpMi6ntWSTKTP2SlzKP1ytkjRbI,22
-toolslm/_modidx.py,sha256=-D-B5o30VGs11gBKf96lpADVXnZhdiVEshJpLzmUnDs,4378
-toolslm/download.py,sha256=g3BxUSxylC_575M7RFSJ1GI3Co3EwPDdEeWzxaf2Czk,4451
-toolslm/funccall.py,sha256=7nPfbcvDRMWiVKBKMLlCOMInoUJgDs5e38ef2T7QBHY,8485
-toolslm/md_hier.py,sha256=qvPjS3eRGcf4COnrGhdzqRF5_LGUqnu7LWixOy_280E,10076
-toolslm/shell.py,sha256=dGInuRKvexu21VmtZkw_0S3BGiTsbAongUG-yG4YHpc,1566
-toolslm/xml.py,sha256=D665Nk7NzyZlXyXrpnIRqfK2xQ-6Gf0bCSgocjF7zik,4061
-toolslm-0.3.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-toolslm-0.3.1.dist-info/METADATA,sha256=2-AJ1GSzVATnoJ6XHCAMp85oidTS-zbxS0vH6jJfIRE,2404
-toolslm-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-toolslm-0.3.1.dist-info/entry_points.txt,sha256=xFz0Eymlo5X7BGpaO6DI9gMxvN5A7faebzrlr8ctp5I,95
-toolslm-0.3.1.dist-info/top_level.txt,sha256=4hRTrFWayz_Kz5221XjvlpCwVFrW3WPi1P0fllkTq9s,8
-toolslm-0.3.1.dist-info/RECORD,,