update docs

Author: jmosbacher

README.rst

@@ -64,7 +64,7 @@ this database is writable from the default analysis username/password
 
     import xedocs
 
-    db = xedocs.development_db
+    db = xedocs.development_db()
 
     docs = db.pmt_gains.find_docs(version='v1', pmt=[1,2,3,5], time='2021-01-01T00:00:00', detector='tpc')
     gains = [doc.value for doc in docs]
@@ -79,23 +79,20 @@ Read from the straxen processing database, this database is read-only for the de
 
     import xedocs
 
-    db = xedocs.straxen_db
+    db = xedocs.straxen_db()
 
     ...
-    
-You can also query documents directly from the schema class, 
-Schemas will query the straxen database by default, if no explicit datasource is given.
+
+Read from the the corrections gitub repository, this database is read-only
+
 
 .. code-block:: python
 
-    from xedocs.schemas import DetectorNumber
+    import xedocs
 
-    drift_velocity = DetectorNumber.straxen_db.find_one(field='drift_velocity', version='v1')
-    
-    # Returns a Bodega object with attributes value, description etc.
-    drift_velocity.value
+    db = xedocs.corrections_repo(branch="master")
 
-    all_v1_documents = DetectorNumber.straxen_db.find(version='v1')
+    ...
 
 
 

docs/api_server.rst

@@ -6,16 +6,14 @@ To use it you will need an http client initializaed with the correction URL and
 
 .. code-block:: python
 
-    import rframe
     import xedocs
 
-    datasource = rframe.RestClient(URL, headers={"Authorization": f"Bearer: {ACCESS_TOKEN}"})
+    db = xedocs.xedocs_api()
     
-    gain_docs = xedocs.PmtGains.find(datasource, pmt=1, version='v3')
+    df = db.posrec_models.find_df(version='v3', run_id=25000)
 
 
-to make things a bit easier, 
-there is a utility function that will create an API client for you `xedocs.get_api_client`
+there is also a utility function that will create an API client for you `xedocs.get_api_client`
 If you dont have a token, it will attempt to use the xeauth package to get one for you (if installed).
 
 You can install xeauth by running `pip install xeauth`
@@ -28,11 +26,6 @@ You can install xeauth by running `pip install xeauth`
 
     # The script will attempt to open a browser for authentication
     # if the broswer does not open automatically, follow the link printed out.
-    # Once you are authenticated as a xenon member, a readonly access token will be
-    # retrieved automatically. If you change xedocs.settings.API_WRITE to True, a token
-    # with write permissions will be retrieved.
-
-
     gain_docs = xedocs.PmtGains.find(datasource, pmt=1, version='v3')
 
 
@@ -46,23 +39,9 @@ Example:
 
     import xedocs
 
-    doc = xedocs.PmtGains(pmt=1, version='v3', value=1, ...)
-    doc.save(datasource)
+    doc = xedocs.PmtAreaToPE(pmt=1, version='v3', value=1, ...)
+    db.insert(doc)
 
 If all the conditions for insertion are met, e.g. the values for the given index not already being set, the insertion will be successful.
 
-Of course you must have write access to the datasource for any insertion to succeed. The default datasources are all read-only.
-When using the server to write values you must request a token with write permissions:
-
-.. code-block:: python
-
-    import xedocs
-
-    # If you have to correction roles defined (correction expert), you can request a token with
-    # extended scope i.e. write:all. This token will allow you to write to all correction collections
-    # If you do not have the proper permissions, you will just get back the default token scope of read:all
-    datasource = xedocs.get_api_client('pmt_gains')
-
-    doc = xedocs.PmtGains(pmt=1, version='v3', value=1, ...)
-    doc.save(datasource)
-
+Of course you must have write access to the datasource for any insertion to succeed.