You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+23-11Lines changed: 23 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,6 @@
1
-
# About
2
-
The Python client API for LabKey Server lets you query, insert and update data on a LabKey Server from a Python client.
1
+
Python API for LabKey Server. Lets you query, insert, and update data on a LabKey Server using Python.
3
2
4
-
# Release Notes
3
+
##Release Notes
5
4
6
5
Changes in the current release:
7
6
@@ -14,7 +13,7 @@ Changes in the current release:
14
13
- PEP standards - the latest version follows PEP code styling standards
15
14
- New [samples](./samples)
16
15
17
-
# Installation
16
+
##Installation
18
17
To install, simply use `pip`:
19
18
20
19
```bash
@@ -23,10 +22,10 @@ $ pip install labkey
23
22
24
23
**Note:** For users who installed this package before it was published to PyPI (before v0.3.0) it is recommended you uninstall and reinstall the package rather than attempting to upgrade. This is due to a change in the package's versioning semantics.
25
24
26
-
# Credentials
25
+
##Credentials
27
26
As of v0.4.0 this API no longer supports using a ``.labkeycredentials.txt`` file, and now uses the .netrc files similar to the other labkey APIs. Additional .netrc [setup instructions](https://www.labkey.org/wiki/home/Documentation/page.view?name=netrc) can be found at the link.
28
27
29
-
## Set Up a netrc File
28
+
###Set Up a netrc File
30
29
31
30
On a Mac, UNIX, or Linux system the netrc file should be named ``.netrc`` (dot netrc) and on Windows it should be named ``_netrc`` (underscore netrc). The file should be located in your home directory and the permissions on the file must be set so that you are the only user who can read it, i.e. it is unreadable to everyone else.
32
31
@@ -49,7 +48,7 @@ password mypassword
49
48
```
50
49
Note that the netrc file only deals with connections at the machine level and should not include a port or protocol designation, meaning both "mymachine.labkey.org:8888" and "https://mymachine.labkey.org" are incorrect.
51
50
52
-
# Supported Functions
51
+
##Supported Functions
53
52
54
53
-**labkey.query.select_rows()** - Query and get results sets from LabKey Server.
55
54
-**labkey.query.execute_sql()** - Execute SQL (LabKey SQL dialect) through the query module on LabKey Server.
@@ -59,7 +58,7 @@ Note that the netrc file only deals with connections at the machine level and sh
59
58
-**labkey.experiment.load_batch()** - Retreive assay data (batch level) from LabKey Server.
60
59
-**labkey.experiment.save_batch()** - Save assay data (batch level) on LabKey Server.
61
60
62
-
# Examples
61
+
##Examples
63
62
64
63
Sample code is available in the [samples](https://github.com/LabKey/labkey-api-python/tree/experiment/samples) directory.
65
64
@@ -86,9 +85,22 @@ else:
86
85
print('select_rows: Failed to load results from '+ schema +'.'+ table)
87
86
```
88
87
89
-
# Supported Versions
88
+
##Supported Versions
90
89
Python 2.6+ and 3.4+ are fully supported.
91
90
LabKey Server v13.3 and later.
92
91
93
-
# Contributing
94
-
This library and the LabKey Server are maintained by the LabKey Software Foundation. If you have any questions or need support, please use the [LabKey Server support forum](https://www.labkey.org/wiki/home/page.view?name=support).
92
+
## Contributing
93
+
This library and the LabKey Server are maintained by the LabKey Software Foundation. If you have any questions or need support, please use the [LabKey Server support forum](https://www.labkey.org/wiki/home/page.view?name=support
94
+
95
+
### Testing
96
+
If you are looking to contribute please run the tests before issuing a PR. For now you need to manually get the dependencies:
0 commit comments