onenote-enterprise 1.0.0__tar.gz

onenote_enterprise-1.0.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: onenote_enterprise
+Version: 1.0.0
+Summary: Production-grade Microsoft OneNote connector via Graph API
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=4.9.0
+
+# onenote_connector
+
+Production-grade Python module for extracting content from
+Microsoft OneNote via Microsoft Graph API.
+
+## Installation
+pip install -r requirements.txt
+
+## Quick Start
+from onenote_connector import OneNoteConnector
+
+connector = OneNoteConnector(access_token="your_bearer_token")
+result = connector.get_content_from_url("https://...sharepoint.com/...")
+
+## Methods
+- get_content_from_url(url) → list[dict]
+- get_all_notebooks() → list[dict]
+- get_notebook_by_name(name) → list[dict]
+
+## Output Fields Per Page
+| Field | Type | Description |
+|---|---|---|
+| id | str | Graph API page ID |
+| title | str | Page title |
+| content | str | Plain text content |
+| paragraphs | list | Text paragraphs |
+| headings | list | h1-h6 headings |
+| blocks | list | Ordered text blocks with type and heading level when applicable |
+| tables | list | Tables with rows |
+| lists | list | ul and ol lists |
+| tags | list | OneNote tags |
+| hyperlinks | list | Links |
+| attachments | list | File attachments |
+| loop_components | list | Loop / Fluid placeholders pointing to separate .loop files |
+| images | list | Base64 images |
+| permissions | list | Who has access |
+
+## Error Handling
+| Exception | When |
+|---|---|
+| AuthenticationError | Token expired or invalid |
+| InvalidURLError | URL cannot be parsed |
+| NotFoundError | Notebook/page not found |
+| RateLimitError | Graph API throttling |
+| ParseError | HTML parsing failed |
+| NetworkError | Connection timeout |

onenote_enterprise-1.0.0/README.md

@@ -0,0 +1,46 @@
+# onenote_connector
+
+Production-grade Python module for extracting content from
+Microsoft OneNote via Microsoft Graph API.
+
+## Installation
+pip install -r requirements.txt
+
+## Quick Start
+from onenote_connector import OneNoteConnector
+
+connector = OneNoteConnector(access_token="your_bearer_token")
+result = connector.get_content_from_url("https://...sharepoint.com/...")
+
+## Methods
+- get_content_from_url(url) → list[dict]
+- get_all_notebooks() → list[dict]
+- get_notebook_by_name(name) → list[dict]
+
+## Output Fields Per Page
+| Field | Type | Description |
+|---|---|---|
+| id | str | Graph API page ID |
+| title | str | Page title |
+| content | str | Plain text content |
+| paragraphs | list | Text paragraphs |
+| headings | list | h1-h6 headings |
+| blocks | list | Ordered text blocks with type and heading level when applicable |
+| tables | list | Tables with rows |
+| lists | list | ul and ol lists |
+| tags | list | OneNote tags |
+| hyperlinks | list | Links |
+| attachments | list | File attachments |
+| loop_components | list | Loop / Fluid placeholders pointing to separate .loop files |
+| images | list | Base64 images |
+| permissions | list | Who has access |
+
+## Error Handling
+| Exception | When |
+|---|---|
+| AuthenticationError | Token expired or invalid |
+| InvalidURLError | URL cannot be parsed |
+| NotFoundError | Notebook/page not found |
+| RateLimitError | Graph API throttling |
+| ParseError | HTML parsing failed |
+| NetworkError | Connection timeout |

onenote_enterprise-1.0.0/onenote_enterprise.egg-info/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: onenote_enterprise
+Version: 1.0.0
+Summary: Production-grade Microsoft OneNote connector via Graph API
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=4.9.0
+
+# onenote_connector
+
+Production-grade Python module for extracting content from
+Microsoft OneNote via Microsoft Graph API.
+
+## Installation
+pip install -r requirements.txt
+
+## Quick Start
+from onenote_connector import OneNoteConnector
+
+connector = OneNoteConnector(access_token="your_bearer_token")
+result = connector.get_content_from_url("https://...sharepoint.com/...")
+
+## Methods
+- get_content_from_url(url) → list[dict]
+- get_all_notebooks() → list[dict]
+- get_notebook_by_name(name) → list[dict]
+
+## Output Fields Per Page
+| Field | Type | Description |
+|---|---|---|
+| id | str | Graph API page ID |
+| title | str | Page title |
+| content | str | Plain text content |
+| paragraphs | list | Text paragraphs |
+| headings | list | h1-h6 headings |
+| blocks | list | Ordered text blocks with type and heading level when applicable |
+| tables | list | Tables with rows |
+| lists | list | ul and ol lists |
+| tags | list | OneNote tags |
+| hyperlinks | list | Links |
+| attachments | list | File attachments |
+| loop_components | list | Loop / Fluid placeholders pointing to separate .loop files |
+| images | list | Base64 images |
+| permissions | list | Who has access |
+
+## Error Handling
+| Exception | When |
+|---|---|
+| AuthenticationError | Token expired or invalid |
+| InvalidURLError | URL cannot be parsed |
+| NotFoundError | Notebook/page not found |
+| RateLimitError | Graph API throttling |
+| ParseError | HTML parsing failed |
+| NetworkError | Connection timeout |

onenote_enterprise-1.0.0/onenote_enterprise.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+onenote_enterprise.egg-info/PKG-INFO
+onenote_enterprise.egg-info/SOURCES.txt
+onenote_enterprise.egg-info/dependency_links.txt
+onenote_enterprise.egg-info/requires.txt
+onenote_enterprise.egg-info/top_level.txt
+tests/test_client.py
+tests/test_content_parser.py
+tests/test_permissions.py
+tests/test_url_parser.py

onenote_enterprise-1.0.0/onenote_enterprise.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

onenote_enterprise-1.0.0/onenote_enterprise.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests>=2.31.0
+beautifulsoup4>=4.12.0
+lxml>=4.9.0

onenote_enterprise-1.0.0/onenote_enterprise.egg-info/top_level.txt

@@ -0,0 +1 @@
+

onenote_enterprise-1.0.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "onenote_enterprise"
+version = "1.0.0"
+description = "Production-grade Microsoft OneNote connector via Graph API"
+readme = "README.md"         
+license = { text = "MIT" }
+requires-python = ">=3.8"
+dependencies = [
+    "requests>=2.31.0",
+    "beautifulsoup4>=4.12.0",
+    "lxml>=4.9.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["onenote_enterprise*"]

onenote_enterprise-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

onenote_enterprise-1.0.0/tests/test_client.py

@@ -0,0 +1,115 @@
+import unittest
+from unittest.mock import patch, MagicMock
+import requests
+
+from onenote_connector.client import GraphClient
+from onenote_connector.exceptions import (
+    AuthenticationError,
+    NotFoundError,
+    RateLimitError,
+    NetworkError,
+)
+
+
+class TestGraphClient(unittest.TestCase):
+
+    def setUp(self) -> None:
+        self.valid_token = (
+            "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9."
+            "eyJzdWIiOiIxMjM0NTY3ODkwIn0."
+            "dQw4w9WgXcQ"
+        )
+
+    def test_init_valid_token(self) -> None:
+        client = GraphClient(self.valid_token)
+        self.assertIsNotNone(client)
+
+    def test_init_empty_token_raises_error(self) -> None:
+        with self.assertRaises(AuthenticationError):
+            GraphClient("")
+
+    def test_init_none_token_raises_error(self) -> None:
+        with self.assertRaises(AuthenticationError):
+            GraphClient(None)  # type: ignore
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_get_returns_json(self, mock_get: MagicMock) -> None:
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {"key": "value"}
+        mock_get.return_value = mock_response
+
+        client = GraphClient(self.valid_token)
+        result = client.get("/me")
+        self.assertEqual(result, {"key": "value"})
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_get_404_raises_not_found(self, mock_get: MagicMock) -> None:
+        mock_response = MagicMock()
+        mock_response.status_code = 404
+        mock_response.text = "Not Found"
+        mock_get.return_value = mock_response
+
+        client = GraphClient(self.valid_token)
+        with self.assertRaises(NotFoundError):
+            client.get("/me/onenote/notebooks/nonexistent")
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_get_429_raises_rate_limit(self, mock_get: MagicMock) -> None:
+        mock_response = MagicMock()
+        mock_response.status_code = 429
+        mock_response.text = "Too Many Requests"
+        mock_response.headers = {"Retry-After": "30"}
+        mock_get.return_value = mock_response
+
+        client = GraphClient(self.valid_token)
+        with self.assertRaises(RateLimitError) as ctx:
+            client.get("/me/onenote/notebooks")
+        self.assertEqual(ctx.exception.retry_after, 30)
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_get_401_raises_auth_error(self, mock_get: MagicMock) -> None:
+        mock_response = MagicMock()
+        mock_response.status_code = 401
+        mock_response.text = "Unauthorized"
+        mock_get.return_value = mock_response
+
+        client = GraphClient(self.valid_token)
+        with self.assertRaises(AuthenticationError):
+            client.get("/me")
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_timeout_raises_network_error(self, mock_get: MagicMock) -> None:
+        mock_get.side_effect = requests.exceptions.Timeout("Connection timed out")
+
+        client = GraphClient(self.valid_token)
+        with self.assertRaises(NetworkError):
+            client.get("/me")
+
+    @patch("onenote_connector.client.GraphClient.get")
+    def test_get_paginated_follows_next_link(self, mock_get: MagicMock) -> None:
+        mock_get.side_effect = [
+            {"value": [{"id": "1"}], "@odata.nextLink": "https://graph.microsoft.com/v1.0/next"},
+            {"value": [{"id": "2"}], "@odata.nextLink": None},
+        ]
+
+        client = GraphClient(self.valid_token)
+        result = client.get_paginated("/me/onenote/notebooks")
+        self.assertEqual(len(result), 2)
+        self.assertEqual(result[0]["id"], "1")
+        self.assertEqual(result[1]["id"], "2")
+
+    @patch("onenote_connector.client.requests.Session.get")
+    def test_get_raw_returns_bytes(self, mock_get: MagicMock) -> None:
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.content = b"\x89PNG\r\n\x1a\n"
+        mock_get.return_value = mock_response
+
+        client = GraphClient(self.valid_token)
+        result = client.get_raw("https://example.com/image.png")
+        self.assertEqual(result, b"\x89PNG\r\n\x1a\n")
+
+
+if __name__ == "__main__":
+    unittest.main()

onenote_enterprise-1.0.0/tests/test_content_parser.py

@@ -0,0 +1,138 @@
+import unittest
+from unittest.mock import MagicMock, patch
+from onenote_connector.parsers.content_parser import ContentParser
+
+
+class TestContentParser(unittest.TestCase):
+
+    def setUp(self) -> None:
+        self.access_token = "test_token"
+        self.parser = ContentParser(self.access_token)
+
+    def test_empty_html_returns_empty_fields(self) -> None:
+        mock_client = MagicMock()
+        result = self.parser.parse("", mock_client)
+        self.assertEqual(result["content"], "")
+        self.assertEqual(result["paragraphs"], [])
+        self.assertEqual(result["headings"], [])
+        self.assertEqual(result["blocks"], [])
+        self.assertEqual(result["tables"], [])
+        self.assertEqual(result["lists"], [])
+        self.assertEqual(result["tags"], [])
+        self.assertEqual(result["loop_components"], [])
+
+    def test_none_html_returns_empty_fields(self) -> None:
+        mock_client = MagicMock()
+        result = self.parser.parse(None, mock_client)  # type: ignore
+        self.assertEqual(result["content"], "")
+
+    def test_paragraphs_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = "<html><body><p>First paragraph</p><p>Second paragraph</p></body></html>"
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["paragraphs"]), 2)
+        self.assertIn("First paragraph", result["paragraphs"])
+        self.assertIn("Second paragraph", result["paragraphs"])
+
+    def test_headings_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = "<html><body><h1>Title</h1><h2>Subtitle</h2></body></html>"
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["headings"]), 2)
+        self.assertEqual(result["headings"][0]["level"], "h1")
+        self.assertEqual(result["headings"][0]["text"], "Title")
+        self.assertEqual(result["headings"][1]["level"], "h2")
+        self.assertEqual(result["headings"][1]["text"], "Subtitle")
+        self.assertIn("Title", result["content"])
+        self.assertIn("Subtitle", result["content"])
+
+    def test_content_keeps_paragraph_and_heading_text_together(self) -> None:
+        mock_client = MagicMock()
+        html = """
+        <html>
+        <body>
+            <h1>Project Notes</h1>
+            <p>First paragraph</p>
+            <p>Second paragraph</p>
+        </body>
+        </html>
+        """
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(result["paragraphs"], ["First paragraph", "Second paragraph"])
+        self.assertEqual(result["headings"], [{"level": "h1", "text": "Project Notes"}])
+        self.assertEqual(
+            result["content"],
+            "Project Notes\nFirst paragraph\nSecond paragraph",
+        )
+        self.assertEqual(
+            result["blocks"],
+            [
+                {"type": "heading", "level": "h1", "text": "Project Notes"},
+                {"type": "paragraph", "text": "First paragraph"},
+                {"type": "paragraph", "text": "Second paragraph"},
+            ],
+        )
+
+    def test_lists_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = """
+        <html>
+        <body>
+            <ul><li>Item 1</li><li>Item 2</li></ul>
+            <ol><li>Step 1</li><li>Step 2</li></ol>
+        </body>
+        </html>
+        """
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["lists"]), 2)
+        self.assertEqual(result["lists"][0]["type"], "ul")
+        self.assertEqual(result["lists"][1]["type"], "ol")
+
+    def test_hyperlinks_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = '<html><body><a href="https://example.com">Example</a></body></html>'
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["hyperlinks"]), 1)
+        self.assertEqual(result["hyperlinks"][0]["href"], "https://example.com")
+        self.assertEqual(result["hyperlinks"][0]["text"], "Example")
+
+    def test_tags_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = '<html><body><p data-tag="to-do">Submit timesheet</p></body></html>'
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["tags"]), 1)
+        self.assertEqual(result["tags"][0]["tag_type"], "to-do")
+        self.assertEqual(result["tags"][0]["completed"], False)
+        self.assertEqual(result["tags"][0]["text"], "Submit timesheet")
+
+    def test_completed_tag(self) -> None:
+        mock_client = MagicMock()
+        html = '<html><body><p data-tag="to-do:completed">Done</p></body></html>'
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["tags"]), 1)
+        self.assertEqual(result["tags"][0]["tag_type"], "to-do")
+        self.assertEqual(result["tags"][0]["completed"], True)
+
+    def test_attachments_extracted(self) -> None:
+        mock_client = MagicMock()
+        html = '<html><body><object data-attachment="report.pdf" type="application/pdf"></object></body></html>'
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["attachments"]), 1)
+        self.assertEqual(result["attachments"][0]["filename"], "report.pdf")
+        self.assertEqual(result["attachments"][0]["mime_type"], "application/pdf")
+
+    def test_loop_component_detected(self) -> None:
+        mock_client = MagicMock()
+        html = (
+            '<html><body>'
+            '<object data-app-id="Loop" data-src="https://my.sharepoint.com/sites/demo/file.loop"></object>'
+            '</body></html>'
+        )
+        result = self.parser.parse(html, mock_client)
+        self.assertEqual(len(result["loop_components"]), 1)
+        self.assertEqual(result["loop_components"][0]["type"], "loop_component")
+        self.assertTrue(result["loop_components"][0]["src"].endswith(".loop"))
+
+
+if __name__ == "__main__":
+    unittest.main()

onenote_enterprise-1.0.0/tests/test_permissions.py

@@ -0,0 +1,79 @@
+import unittest
+from unittest.mock import MagicMock
+
+from onenote_connector.exporters import JsonExporter
+from onenote_connector.models import Notebook, Page, Section
+from onenote_connector.permissions import PermissionResolver
+
+
+class TestPermissions(unittest.TestCase):
+    def test_permission_resolver_maps_graph_response(self) -> None:
+        client = MagicMock()
+        client.get.side_effect = [
+            {"parentReference": {"driveId": "drive-1"}, "id": "item-1"},
+            {
+                "value": [
+                    {
+                        "roles": ["owner"],
+                        "grantedToV2": {
+                            "user": {
+                                "displayName": "Jhon DOE",
+                                "email": "jhon@example.com",
+                            }
+                        },
+                    }
+                ]
+            },
+        ]
+
+        resolver = PermissionResolver(client)
+        result = resolver.get_permissions("Quick Notes")
+
+        self.assertEqual(
+            result,
+            [
+                {
+                    "principal_name": "Jhon DOE",
+                    "principal_email": "jhon@example.com",
+                    "principal_type": "user",
+                    "roles": ["owner"],
+                    "source": "graph",
+                }
+            ],
+        )
+
+    def test_json_exporter_includes_top_level_permissions(self) -> None:
+        exporter = JsonExporter()
+        notebook = Notebook(id="nb-1", display_name="Quick Notes")
+        section = Section(id="sec-1", display_name="Section 1")
+        page = Page(id="page-1", title="Page 1")
+
+        data = exporter.to_list(
+            notebook=notebook,
+            sections=[section],
+            pages_by_section={"sec-1": [page]},
+            parsed_content={"page-1": exporter._empty_page_content()},
+            permissions=[
+                {
+                    "principal_email": "",
+                    "principal_name": "Jhon DOE",
+                    "principal_type": "direct_user",
+                    "roles": ["owner"],
+                    "source": "graph",
+                }
+            ],
+        )
+
+        self.assertEqual(
+            data[0]["sections"][0]["pages"][0]["notebook_permissions"][0]["principal_name"],
+            "Jhon DOE",
+        )
+        self.assertEqual(
+            data[0]["sections"][0]["pages"][0]["notebook_permissions"][0]["principal_type"],
+            "direct_user",
+        )
+        self.assertEqual(data[0]["sections"][0]["pages"][0]["blocks"], [])
+
+
+if __name__ == "__main__":
+    unittest.main()

onenote_enterprise-1.0.0/tests/test_url_parser.py

@@ -0,0 +1,65 @@
+import unittest
+from onenote_connector.discovery.url_parser import URLParser
+from onenote_connector.exceptions import InvalidURLError
+
+
+class TestURLParser(unittest.TestCase):
+
+    def setUp(self) -> None:
+        self.parser = URLParser()
+
+    def test_sharepoint_url(self) -> None:
+        url = (
+            "https://binaryrepublik-my.sharepoint.com/personal/"
+            "mayur_panchal_binaryrepublik_com/_layouts/15/Doc.aspx"
+            "?sourcedoc={0f150add-404d-4206-bbe4-1b666cee0f15}"
+            "&action=edit"
+            "&wd=target%28Timesheet.one%7Cd02e35d8-d8d3-4e5b-9b92-eef1320cce7f"
+            "%2FTimesheet%20From%2011-6-26%7Cd543efe0-4463-4307-8aeb-0d87e0c49109%2F%29"
+            "&wdorigin=NavigationUrl"
+        )
+        result = self.parser.parse(url)
+
+        self.assertEqual(result.hostname, "binaryrepublik-my.sharepoint.com")
+        self.assertEqual(result.user_path, "mayur_panchal_binaryrepublik_com")
+        self.assertEqual(result.sourcedoc_guid, "0f150add-404d-4206-bbe4-1b666cee0f15")
+        self.assertEqual(result.notebook_name, "Timesheet")
+        self.assertEqual(result.section_name, "Timesheet.one")
+        self.assertEqual(result.section_guid, "d02e35d8-d8d3-4e5b-9b92-eef1320cce7f")
+        self.assertEqual(result.page_title, "Timesheet From 11-6-26")
+        self.assertEqual(result.page_guid, "d543efe0-4463-4307-8aeb-0d87e0c49109")
+
+    def test_graph_api_url(self) -> None:
+        url = "https://graph.microsoft.com/v1.0/users/user123/onenote/notebooks/notebook456"
+        result = self.parser.parse(url)
+
+        self.assertEqual(result.hostname, "graph.microsoft.com")
+        self.assertEqual(result.user_path, "user123")
+        self.assertEqual(result.notebook_name, "")
+
+    def test_empty_url_raises_error(self) -> None:
+        with self.assertRaises(InvalidURLError):
+            self.parser.parse("")
+
+    def test_none_url_raises_error(self) -> None:
+        with self.assertRaises(InvalidURLError):
+            self.parser.parse(None)  # type: ignore
+
+    def test_invalid_url_format(self) -> None:
+        url = "not-a-valid-url"
+        result = self.parser.parse(url)
+        self.assertEqual(result.hostname, "")
+        self.assertEqual(result.sourcedoc_guid, "")
+
+    def test_sharepoint_sites_url(self) -> None:
+        url = (
+            "https://contoso.sharepoint.com/sites/MySite/"
+            "_layouts/15/Doc.aspx?sourcedoc={guid123}&action=edit"
+        )
+        result = self.parser.parse(url)
+        self.assertEqual(result.user_path, "MySite")
+        self.assertEqual(result.sourcedoc_guid, "guid123")
+
+
+if __name__ == "__main__":
+    unittest.main()