%global _empty_manifest_terminate_build 0
Name: python-pydexcom
Version: 0.2.3
Release: 1
Summary: Python API to interact with Dexcom Share API
License: MIT
URL: https://github.com/gagebenne/pydexcom
Source0: https://mirrors.nju.edu.cn/pypi/web/packages/3d/83/eef794b472bbb4a63a500f95fd5bf7ae40e46b9db313cf5c038ab245e4ae/pydexcom-0.2.3.tar.gz
BuildArch: noarch
Requires: python3-requests
%description
[](https://www.paypal.me/gagebenne)
[](https://www.pypi.org/project/pydexcom)
[](https://github.com/gagebenne/pydexcom/actions)
# pydexcom
A simple Python API to interact with Dexcom Share service. Used to get **real time** Dexcom GCM sensor data.
### Setup
1. Download the [Dexcom G6 / G5 / G4](https://www.dexcom.com/apps) mobile app and [enable the Share service](https://provider.dexcom.com/education-research/cgm-education-use/videos/setting-dexcom-share-and-follow).
*Note: the service requires setup of at least one follower to enable the share service, but `pydexcom` will use your credentials, not the follower's.*
2. Install the `pydexcom` package.
```python
pip3 install pydexcom
```
### Usage
```python
>>> from pydexcom import Dexcom
>>> dexcom = Dexcom("username", "password") # add ous=True if outside of US
>>> bg = dexcom.get_current_glucose_reading()
>>> bg.value
85
>>> bg.mmol_l
4.7
>>> bg.trend
4
>>> bg.trend_description
'steady'
>>> bg.trend_arrow
'→'
>>> bg.time
datetime.datetime(2020, 5, 6, 18, 18, 42)
```
### FAQ
What do I need to get started?
If you are currently on the Dexcom GCM system, all you need is the appropriate mobile app with the Dexcom Share service enabled.
Where is this package being used?
For now this package is mainly being used in the Dexcom home assistant integration, but is generic enough to be used in lots of applications.
In fact, reddit user paulcole710 used it to track glucose levels using a Raspberry Pi and e-ink display.
Why not use the official Dexcom Developer API?
The official Dexcom API is a great tool to view trends, statistics, and day-by-day data, but is not suitable for real time fetching of glucose readings.
How can I let you know of suggestions or issues?
By all means submit a pull request if you have a feature you'd like to see in the next release, alternatively you may leave a issue if you have a suggestion or bug you'd like to alert me of.
Are there any features in development?
Sure, I'm thinking of implementing a session status checker, or maybe an asynchronus version. That being said, simplicity - getting real time blood glucose information - is most important to this package.
### Development
##### Dexcom class
| Method | Input | Output | Description |
| --------------------------- | ------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------ |
| \_\_init\_\_ | `username:str`,
`password:str`,
`ous:bool=True` | `Dexcom` | Dexcom constructor, stores authentication information |
| create_session | | | Creates Dexcom Share API session by getting session id |
| verify_serial_number | `serial_number:str` | `bool` | Verifies if a transmitter serial number is assigned to you |
| get_glucose_readings | `minutes:int=1440`,
`max_count:int=288` | `[GlucoseReading]`/
`None` | Gets max_count glucose readings within the past minutes, None if no glucose reading in the past 24 hours |
| get_latest_glucose_reading | | `GlucoseReading`/
`None` | Gets latest available glucose reading, None if no glucose reading in the past 24 hours |
| get_current_glucose_reading | | `GlucoseReading`/`None` | Gets current available glucose reading, None if no glucose reading in the past 6 minutes |
##### GlucoseReading class
| Attribute | Definition | Example |
| ----------------- | ------------------------------------------------------------ | ------------------------------------------- |
| value | Blood glucose value in mg/dL. | `85` |
| mg_dl | Blood glucose value in mg/dL. | `85` |
| mmol_l | Blood glucose value in mmol/L. | `4.7` |
| trend | Blood glucose trend information as number 0 - 9 (see constants). | `4` |
| trend_description | Blood glucose trend information description (see constants). | `'steady'` |
| trend_arrow | Blood glucose trend information as unicode arrow (see constants). | `'→'` |
| time | Blood glucose recorded time as `datetime`. | `datetime.datetime(2020, 5, 6, 18, 18, 42)` |
##### Constants
| Trend | Trend description | Trend arrow |
| ----- | ----------------------------- | ----------- |
| 0 | `''` | `''` |
| 1 | `'rising quickly'` | `'↑↑'` |
| 2 | `'rising'` | `'↑'` |
| 3 | `'rising slightly'` | `'↗'` |
| 4 | `'steady'` | `'→'` |
| 5 | `'falling slightly'` | `'↘'` |
| 6 | `'falling'` | `'↓'` |
| 7 | `'falling quickly'` | `'↓↓'` |
| 8 | `'unable to determine trend'` | `'?'` |
| 9 | `'trend unavailable'` | `'-'` |
%package -n python3-pydexcom
Summary: Python API to interact with Dexcom Share API
Provides: python-pydexcom
BuildRequires: python3-devel
BuildRequires: python3-setuptools
BuildRequires: python3-pip
%description -n python3-pydexcom
[](https://www.paypal.me/gagebenne)
[](https://www.pypi.org/project/pydexcom)
[](https://github.com/gagebenne/pydexcom/actions)
# pydexcom
A simple Python API to interact with Dexcom Share service. Used to get **real time** Dexcom GCM sensor data.
### Setup
1. Download the [Dexcom G6 / G5 / G4](https://www.dexcom.com/apps) mobile app and [enable the Share service](https://provider.dexcom.com/education-research/cgm-education-use/videos/setting-dexcom-share-and-follow).
*Note: the service requires setup of at least one follower to enable the share service, but `pydexcom` will use your credentials, not the follower's.*
2. Install the `pydexcom` package.
```python
pip3 install pydexcom
```
### Usage
```python
>>> from pydexcom import Dexcom
>>> dexcom = Dexcom("username", "password") # add ous=True if outside of US
>>> bg = dexcom.get_current_glucose_reading()
>>> bg.value
85
>>> bg.mmol_l
4.7
>>> bg.trend
4
>>> bg.trend_description
'steady'
>>> bg.trend_arrow
'→'
>>> bg.time
datetime.datetime(2020, 5, 6, 18, 18, 42)
```
### FAQ
What do I need to get started?
If you are currently on the Dexcom GCM system, all you need is the appropriate mobile app with the Dexcom Share service enabled.
Where is this package being used?
For now this package is mainly being used in the Dexcom home assistant integration, but is generic enough to be used in lots of applications.
In fact, reddit user paulcole710 used it to track glucose levels using a Raspberry Pi and e-ink display.
Why not use the official Dexcom Developer API?
The official Dexcom API is a great tool to view trends, statistics, and day-by-day data, but is not suitable for real time fetching of glucose readings.
How can I let you know of suggestions or issues?
By all means submit a pull request if you have a feature you'd like to see in the next release, alternatively you may leave a issue if you have a suggestion or bug you'd like to alert me of.
Are there any features in development?
Sure, I'm thinking of implementing a session status checker, or maybe an asynchronus version. That being said, simplicity - getting real time blood glucose information - is most important to this package.
### Development
##### Dexcom class
| Method | Input | Output | Description |
| --------------------------- | ------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------ |
| \_\_init\_\_ | `username:str`,
`password:str`,
`ous:bool=True` | `Dexcom` | Dexcom constructor, stores authentication information |
| create_session | | | Creates Dexcom Share API session by getting session id |
| verify_serial_number | `serial_number:str` | `bool` | Verifies if a transmitter serial number is assigned to you |
| get_glucose_readings | `minutes:int=1440`,
`max_count:int=288` | `[GlucoseReading]`/
`None` | Gets max_count glucose readings within the past minutes, None if no glucose reading in the past 24 hours |
| get_latest_glucose_reading | | `GlucoseReading`/
`None` | Gets latest available glucose reading, None if no glucose reading in the past 24 hours |
| get_current_glucose_reading | | `GlucoseReading`/`None` | Gets current available glucose reading, None if no glucose reading in the past 6 minutes |
##### GlucoseReading class
| Attribute | Definition | Example |
| ----------------- | ------------------------------------------------------------ | ------------------------------------------- |
| value | Blood glucose value in mg/dL. | `85` |
| mg_dl | Blood glucose value in mg/dL. | `85` |
| mmol_l | Blood glucose value in mmol/L. | `4.7` |
| trend | Blood glucose trend information as number 0 - 9 (see constants). | `4` |
| trend_description | Blood glucose trend information description (see constants). | `'steady'` |
| trend_arrow | Blood glucose trend information as unicode arrow (see constants). | `'→'` |
| time | Blood glucose recorded time as `datetime`. | `datetime.datetime(2020, 5, 6, 18, 18, 42)` |
##### Constants
| Trend | Trend description | Trend arrow |
| ----- | ----------------------------- | ----------- |
| 0 | `''` | `''` |
| 1 | `'rising quickly'` | `'↑↑'` |
| 2 | `'rising'` | `'↑'` |
| 3 | `'rising slightly'` | `'↗'` |
| 4 | `'steady'` | `'→'` |
| 5 | `'falling slightly'` | `'↘'` |
| 6 | `'falling'` | `'↓'` |
| 7 | `'falling quickly'` | `'↓↓'` |
| 8 | `'unable to determine trend'` | `'?'` |
| 9 | `'trend unavailable'` | `'-'` |
%package help
Summary: Development documents and examples for pydexcom
Provides: python3-pydexcom-doc
%description help
[](https://www.paypal.me/gagebenne)
[](https://www.pypi.org/project/pydexcom)
[](https://github.com/gagebenne/pydexcom/actions)
# pydexcom
A simple Python API to interact with Dexcom Share service. Used to get **real time** Dexcom GCM sensor data.
### Setup
1. Download the [Dexcom G6 / G5 / G4](https://www.dexcom.com/apps) mobile app and [enable the Share service](https://provider.dexcom.com/education-research/cgm-education-use/videos/setting-dexcom-share-and-follow).
*Note: the service requires setup of at least one follower to enable the share service, but `pydexcom` will use your credentials, not the follower's.*
2. Install the `pydexcom` package.
```python
pip3 install pydexcom
```
### Usage
```python
>>> from pydexcom import Dexcom
>>> dexcom = Dexcom("username", "password") # add ous=True if outside of US
>>> bg = dexcom.get_current_glucose_reading()
>>> bg.value
85
>>> bg.mmol_l
4.7
>>> bg.trend
4
>>> bg.trend_description
'steady'
>>> bg.trend_arrow
'→'
>>> bg.time
datetime.datetime(2020, 5, 6, 18, 18, 42)
```
### FAQ
What do I need to get started?
If you are currently on the Dexcom GCM system, all you need is the appropriate mobile app with the Dexcom Share service enabled.
Where is this package being used?
For now this package is mainly being used in the Dexcom home assistant integration, but is generic enough to be used in lots of applications.
In fact, reddit user paulcole710 used it to track glucose levels using a Raspberry Pi and e-ink display.
Why not use the official Dexcom Developer API?
The official Dexcom API is a great tool to view trends, statistics, and day-by-day data, but is not suitable for real time fetching of glucose readings.
How can I let you know of suggestions or issues?
By all means submit a pull request if you have a feature you'd like to see in the next release, alternatively you may leave a issue if you have a suggestion or bug you'd like to alert me of.
Are there any features in development?
Sure, I'm thinking of implementing a session status checker, or maybe an asynchronus version. That being said, simplicity - getting real time blood glucose information - is most important to this package.
### Development
##### Dexcom class
| Method | Input | Output | Description |
| --------------------------- | ------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------ |
| \_\_init\_\_ | `username:str`,
`password:str`,
`ous:bool=True` | `Dexcom` | Dexcom constructor, stores authentication information |
| create_session | | | Creates Dexcom Share API session by getting session id |
| verify_serial_number | `serial_number:str` | `bool` | Verifies if a transmitter serial number is assigned to you |
| get_glucose_readings | `minutes:int=1440`,
`max_count:int=288` | `[GlucoseReading]`/
`None` | Gets max_count glucose readings within the past minutes, None if no glucose reading in the past 24 hours |
| get_latest_glucose_reading | | `GlucoseReading`/
`None` | Gets latest available glucose reading, None if no glucose reading in the past 24 hours |
| get_current_glucose_reading | | `GlucoseReading`/`None` | Gets current available glucose reading, None if no glucose reading in the past 6 minutes |
##### GlucoseReading class
| Attribute | Definition | Example |
| ----------------- | ------------------------------------------------------------ | ------------------------------------------- |
| value | Blood glucose value in mg/dL. | `85` |
| mg_dl | Blood glucose value in mg/dL. | `85` |
| mmol_l | Blood glucose value in mmol/L. | `4.7` |
| trend | Blood glucose trend information as number 0 - 9 (see constants). | `4` |
| trend_description | Blood glucose trend information description (see constants). | `'steady'` |
| trend_arrow | Blood glucose trend information as unicode arrow (see constants). | `'→'` |
| time | Blood glucose recorded time as `datetime`. | `datetime.datetime(2020, 5, 6, 18, 18, 42)` |
##### Constants
| Trend | Trend description | Trend arrow |
| ----- | ----------------------------- | ----------- |
| 0 | `''` | `''` |
| 1 | `'rising quickly'` | `'↑↑'` |
| 2 | `'rising'` | `'↑'` |
| 3 | `'rising slightly'` | `'↗'` |
| 4 | `'steady'` | `'→'` |
| 5 | `'falling slightly'` | `'↘'` |
| 6 | `'falling'` | `'↓'` |
| 7 | `'falling quickly'` | `'↓↓'` |
| 8 | `'unable to determine trend'` | `'?'` |
| 9 | `'trend unavailable'` | `'-'` |
%prep
%autosetup -n pydexcom-0.2.3
%build
%py3_build
%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .
%files -n python3-pydexcom -f filelist.lst
%dir %{python3_sitelib}/*
%files help -f doclist.lst
%{_docdir}/*
%changelog
* Tue May 30 2023 Python_Bot - 0.2.3-1
- Package Spec generated