Add lang from so example

docs/source/installation.rst

@@ -4,11 +4,9 @@ Installation
 
 To start using ``Albero``, first install it using pip:
 
-# TODO: get v0.0.1 done
-
 .. code-block:: console
 
-    $ pip install Albero
+    $ pip install albero
 
 And it's installed! Congratulations on giving your code editors syntax highlighting and allowing yourself to not pull out hair in the process!
 

examples/example_so_file_usage.py

@@ -0,0 +1,29 @@
+
+from tree_sitter import Language
+
+from albero import Token, TreeSitterHighlighter, lang_from_so, get_mapping
+
+py_lang: Language = lang_from_so("./examples/languages-darwin.so", "python")
+mapping: dict[str, str] = get_mapping("python")
+
+
+highlighter = TreeSitterHighlighter()
+
+highlighter.add_language("python", py_lang, mapping)
+highlighter.add_file(
+    "test", "python"
+)  # Trying to add a file with a language not in the system gives an AlberoException
+highlighter.update_file(
+    "test", "def test(): ..."
+)  # Trying to update a file not in the system gives an AlberoException
+
+tokens: list[Token] = highlighter.get_highlights(
+    "test"
+)  # Trying to use a file not in the system gives an AlberoException
+
+highlighter.remove_file("test")
+highlighter.remove_language(
+    "python"
+)  # Can be done first but it will already auto-close any files that use it
+
+print(tokens)

tests/test_usage.py

@@ -1,6 +1,6 @@
 from tree_sitter import Language
 
-from albero import Token, TreeSitterHighlighter, get_lang, get_mapping
+from albero import Token, TreeSitterHighlighter, get_lang, get_mapping, lang_from_so
 
 py_lang: Language = get_lang("python")
 mapping: dict[str, str] = get_mapping("python")
@@ -73,3 +73,6 @@ def test_mapping_update():
         "test"
     )  # Trying to use a file not in the system gives an AlberoException
     assert tokens == []
+
+def test_so_file():
+    lang_from_so("./examples/languages-darwin.so", "python")