Index: README.md =================================================================== diff -u -ra89308cbb06b9d2052fe3d1b4ed210a03036a021 -r32e628abcbbd3fd70866505d9f2836a6f732ef06 --- README.md (.../README.md) (revision a89308cbb06b9d2052fe3d1b4ed210a03036a021) +++ README.md (.../README.md) (revision 32e628abcbbd3fd70866505d9f2836a6f732ef06) @@ -1,18 +1,18 @@ @@ -47,7 +47,7 @@ All release versions will eventually be placed on their own separate branch to facilitate backwards compatibility and a fully accessible and testable API version history. -How to install from the master branch, which contains the latest in-development changes (Available!) +How to install from the master branch ``` #!/bin/bash @@ -57,14 +57,14 @@ pip3 install git+ssh://git@dvm-linux02:7999/vv/dialin.git ``` -How to install a specific release version (Not yet available) +How to install a build from a specific branch. To change the branch, replace staging with the desired branch ``` #!/bin/bash virtualenv --python=python3 venv source venv/bin/activate -branch="0.0.1" # update the branch_name here +branch="staging" pip3 install git+ssh://git@dvm-linux02:7999/vv/dialin.git@$branch ``` @@ -75,48 +75,15 @@ virtualenv --python=python3 venv source venv/bin/activate -pip3 install dialin-0.0.1-py3-none-any.whl +pip3 install dialin--py3-none-any.whl ``` ### Modules -- See the tests directory for examples of how to use this API -- Also consult the Dialin API documentation which can be generated using the `tools/document.sh` script. +- Consult the Dialin API documentation which can be generated using the `tools/document.sh` script. +- See the tests directory for example usages of the API. -``` -from dialin.hd.alarms import HDAlarms -from dialin.hd.blood_flow import HDBloodFlow -from dialin.hd.buttons import HDButtons -from dialin.hd.constants import RESET, NO_RESET -from dialin.hd.dialysate_inlet_flow import HDDialysateInletFlow -from dialin.hd.dialysate_outlet_flow import HDDialysateOutletFlow -from dialin.hd.hemodialysis_device import HD -from dialin.hd.pressure_occlusion import HDPressureOcclusion -from dialin.hd.rtc import HDRTC -from dialin.hd.treatment import HDTreatment -from dialin.hd.ui_proxy import HDUIProxy -from dialin.hd.watchdog import HDWatchdog - - -from dialin.dg.dialysate_generator import DG - - -from dialin.protocols.CAN import (DenaliCanMessenger, - DenaliMessage, - DenaliChannels, - LongDenaliMessageBuilder) - - -from dialin.utils.conversions import (integer_to_bytearray, - float_to_bytearray) - - - -``` - - - ## Dialin API Internal Development Environment ### Linux @@ -131,33 +98,18 @@ ### Windows -Note that windows support for the python-can library has not been validated. -As a result, this API is not functional on windows and windows support may have to be removed -in the future. +Due to a limitation in the underlying python-can library, Dialin does not currently support Windows. -For a brand new setup, after cloning this repository: -``` -> setup_environment_windows.bat - -``` - -If the windows environment has been previously set up: - -``` -> activate_environment_windows.bat -``` - - ## Unit Testing -All internal tests of the dialin API can be found in the tests directory at the root of -this git repository: +All unit tests of the Dialin API can be found in tests/unit_tests. To run them: ``` -(venv) $ cd tests -(venv) $ python3 dialin_unit_test_example.py +$ cd tools +$ ./run_unit_tests.sh 127 ↵ ``` +If there is a failure, the script will indicate what failed. No output means all tests have passed. ## Building the Dialin package