add tests and docs

Author: Anish9901

docs/docs/api/rpc.md

@@ -60,6 +60,7 @@ To use an RPC function:
     options:
       members:
       - list_
+      - get_
       - delete
       - TableInfo
 

mathesar/tests/rpc/test_endpoints.py

@@ -44,6 +44,11 @@
         "tables.list",
         [user_is_authenticated]
     ),
+    (
+        tables.get_,
+        "tables.get",
+        [user_is_authenticated]
+    ),
     (
         tables.delete,
         "tables.delete",

mathesar/tests/rpc/test_tables.py

@@ -64,6 +64,43 @@ def mock_table_info(_schema_oid, conn):
     assert actual_table_list == expect_table_list
 
 
+def test_tables_get(rf, monkeypatch):
+    request = rf.post('/api/rpc/v0', data={})
+    request.user = User(username='alice', password='pass1234')
+    schema_oid = 2200
+    database_id = 11
+
+    @contextmanager
+    def mock_connect(_database_id, user):
+        if _database_id == database_id and user.username == 'alice':
+            try:
+                yield True
+            finally:
+                pass
+        else:
+            raise AssertionError('incorrect parameters passed')
+
+    def mock_table_get(_schema_oid, conn):
+        if _schema_oid != schema_oid:
+            raise AssertionError('incorrect parameters passed')
+        return {
+            'oid': 17408,
+            'name': 'Authors',
+            'schema': schema_oid,
+            'description': 'a description on the authors table.'
+        }
+    monkeypatch.setattr(tables, 'connect', mock_connect)
+    monkeypatch.setattr(tables, 'get_table', mock_table_get)
+    expect_table_list = {
+        'oid': 17408,
+        'name': 'Authors',
+        'schema': schema_oid,
+        'description': 'a description on the authors table.'
+    }
+    actual_table_list = tables.list_(schema_oid=2200, database_id=11, request=request)
+    assert actual_table_list == expect_table_list
+
+
 def test_tables_delete(rf, monkeypatch):
     request = rf.post('/api/rpc/v0', data={})
     request.user = User(username='alice', password='pass1234')