Adding documentation

Author: linkmluser

pyproject.toml

@@ -13,6 +13,13 @@ dependencies = [
     "typer>=0.9.0",
 ]
 
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+
 [project.scripts]
 linkml-browser = "linkml_browser:main"
 

src/linkml_browser/core.py

@@ -3,7 +3,7 @@
 import json
 import shutil
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, Set
 
 
 class BrowserGenerator:
@@ -35,12 +35,12 @@ def infer_schema(self,
             raise ValueError("Cannot infer schema from empty data")
 
         # Get all unique keys from all items
-        all_keys = set()
+        all_keys: Set[str] = set()
         for item in self.data:
             all_keys.update(item.keys())
 
         # Analyze field types from first few items
-        field_info = {}
+        field_info: Dict[str, Dict[str, Any]] = {}
         sample_size = min(100, len(self.data))
 
         for key in all_keys:
@@ -70,7 +70,7 @@ def infer_schema(self,
                         field_info[key]['unique_values'].add(value)
 
         # Build schema
-        schema = {
+        schema: Dict[str, Any] = {
             "title": title,
             "description": description,
             "searchPlaceholder": "Search...",
@@ -103,7 +103,7 @@ def infer_schema(self,
                         int_values = [int(v) for v in info['unique_values'] if v]
                         if len(int_values) == len(info['unique_values']):
                             facet_type = "integer"
-                    except:
+                    except ValueError:
                         pass
 
                 schema["facets"].append({

src/linkml_browser/main.py

@@ -106,7 +106,7 @@ def init_schema(
     save_schema(schema, output_file)
 
     typer.echo(f"\n✅ Schema written to: {output_file}")
-    typer.echo(f"Edit this file to customize facets, search fields, and display options.")
+    typer.echo("Edit this file to customize facets, search fields, and display options.")
     typer.echo(f"Then run: linkml-browser deploy {data_file} output/ --schema {output_file}")
 
 

tests/test_browser_generator.py

@@ -1,6 +1,5 @@
 """Unit tests for LinkML Browser generator functionality."""
 
-import json
 import tempfile
 from pathlib import Path