explicit backend_type in tests

install optional deps for workflows

fix tests

leave ovos and neon backends to a follow up PR

oauth api for offline backend - companion PR to OpenVoiceOS/ovos-personal-backend#36

add oauth, companion PR OpenVoiceOS/ovos-personal-backend#36

fix oauth endpoint url

fix device/admin endpoint urls

split oauth api from device api, only selene implements it

neon_utils dependency only, not neon_api_proxy

better support both ww upload device endpoints

fix default upload url value

make func signatures match

upload_url for wakeword param

upload_url for wakeword param

split metrics api from device api

split dataset api from device api

split email api from device api

offline backend email sending support

requirements.txt

add offline STT endpoint

fix token refresh

fix ovos weather

missing pairing utils

stt endpoints

continue adding endpoints

cleanup code

split backends into their own modules for cleanliness

rename again to ovos-backend-client + improve personal backend UI compat

cleanup docstrs and rename stuff

add database helper + compat with device db personal backend UI

wakeword metadata compat - UI tagger

comparison table in readme

no_backend support

metrics / ww offline backend ui compat

offline backend - skill settings handling

device meta json_database

backwards compat admin/device api neon+ovos

optional requirements.txt

initial support for offline device api

admin_api support for offline backend

handle offline detect better

handle missing timezone data

no_backend geolocation

add neon backend

rename + OVOS "Fake" Backend support

api registry concept

signal breaking change in versioning

.github/workflows/build_tests.yml

@@ -7,7 +7,7 @@ on:
     branches:
       - dev
     paths-ignore:
-      - 'selene_api/version.py'
+      - 'ovos_backend_client/version.py'
       - 'test/**'
       - 'examples/**'
       - '.github/**'

.github/workflows/notify_matrix.yml

@@ -20,4 +20,4 @@ jobs:
           token: ${{ secrets.MATRIX_TOKEN }}
           channel: '!WjxEKjjINpyBRPFgxl:krbel.duckdns.org'
           message: |
-            new selene_api PR merged! https://github.com/OpenVoiceOS/selene_api/pull/${{ github.event.number }}
+            new ovos_backend_client PR merged! https://github.com/OpenVoiceOS/ovos-backend-client/pull/${{ github.event.number }}

.github/workflows/publish_alpha.yml

@@ -6,7 +6,7 @@ on:
     branches:
       - dev
     paths-ignore:
-      - 'selene_api/version.py'
+      - 'ovos_backend_client/version.py'
       - 'test/**'
       - 'examples/**'
       - '.github/**'

.github/workflows/unit_tests.yml

@@ -6,7 +6,7 @@ on:
     branches:
       - dev
     paths-ignore:
-      - 'selene_api/version.py'
+      - 'ovos_backend_client/version.py'
       - 'requirements/**'
       - 'examples/**'
       - '.github/**'
@@ -20,7 +20,7 @@ on:
     branches:
       - master
     paths-ignore:
-      - 'selene_api/version.py'
+      - 'ovos_backend_client/version.py'
       - 'requirements/**'
       - 'examples/**'
       - '.github/**'
@@ -52,13 +52,13 @@ jobs:
           python -m pip install build wheel
       - name: Install core repo
         run: |
-          pip install .
+          pip install .[offline]
       - name: Install test dependencies
         run: |
           pip install pytest pytest-timeout pytest-cov
       - name: Run unittests
         run: |
-          pytest --cov=selene_api --cov-report xml test/unittests
+          pytest --cov=ovos_backend_client --cov-report xml test/unittests
           # NOTE: additional pytest invocations should also add the --cov-append flag
           #       or they will overwrite previous invocations' coverage reports
           #       (for an example, see OVOS Skill Manager's workflow)

README.md

@@ -1,9 +1,31 @@
-# Selene Api
+# OVOS Backend Api
 
-Unofficial python api for interaction with https://api.mycroft.ai , also compatible
-with [ovos-local-backend](https://github.com/OpenVoiceOS/OVOS-local-backend)
+Python client library for interaction with several supported backends under a single unified interface
+
+- Personal backend - [self hosted](https://github.com/OpenVoiceOS/OVOS-local-backend)
+- Selene - https://api.mycroft.ai
+- Offline - support for setting your own api keys and query services directly
+
+## Backend Overview
+
+| API       | Offline | Personal | Selene | 
+|-----------|---------|----------|--------|
+| Admin     | yes [1] | yes      | no     |
+| Device    | yes [2] | yes      | yes    | 
+| Metrics   | yes [2] | yes      | yes    | 
+| Dataset   | yes [2] | yes      | yes    |
+| OAuth     | yes [2] | yes      | yes    |
+| Wolfram   | yes [3] | yes      | yes    | 
+| Geolocate | yes     | yes      | yes    | 
+| STT       | yes [3] | yes      | yes    | 
+| Weather   | yes [3] | yes      | yes    |
+| Email     | yes [3] | yes      | yes    |
+
+
+    [1] will update user level mycroft.conf
+    [2] shared json database with personal backend for UI compat
+    [3] needs additional configuration (eg. credentials)
 
-Will only work if running in a device paired with mycroft, a valid identity2.json must exist
 
 ## STT
 
@@ -12,7 +34,7 @@ a companion stt plugin is available - [ovos-stt-plugin-selene](https://github.co
 ## Geolocation
 
 ```python
-from selene_api.api import GeolocationApi
+from ovos_backend_client.api import GeolocationApi
 
 geo = GeolocationApi()
 data = geo.get_geolocation("Lisbon Portugal")
@@ -26,7 +48,7 @@ data = geo.get_geolocation("Lisbon Portugal")
 ## OpenWeatherMap Proxy
 
 ```python
-from selene_api.api import OpenWeatherMapApi
+from ovos_backend_client.api import OpenWeatherMapApi
 
 owm = OpenWeatherMapApi()
 data = owm.get_weather()
@@ -36,7 +58,7 @@ data = owm.get_weather()
 ## Wolfram Alpha proxy
 
 ```python
-from selene_api.api import WolframAlphaApi
+from ovos_backend_client.api import WolframAlphaApi
 
 wolf = WolframAlphaApi()
 answer = wolf.spoken("what is the speed of light")
@@ -51,7 +73,7 @@ data = wolf.full_results("2+2")
 To interact with skill settings on selene
 
 ```python
-from selene_api.settings import RemoteSkillSettings
+from ovos_backend_client.settings import RemoteSkillSettings
 
 # in ovos-core skill_id is deterministic and safe
 s = RemoteSkillSettings("skill.author")
@@ -78,7 +100,7 @@ s.upload()
 by hijacking skill settings we allows storing arbitrary data in selene and use it across devices and skills
 
 ```python
-from selene_api.cloud import SeleneCloud
+from ovos_backend_client.cloud import SeleneCloud
 
 cloud = SeleneCloud()
 cloud.add_entry("test", {"secret": "NOT ENCRYPTED MAN"})
@@ -88,7 +110,7 @@ data = cloud.get_entry("test")
 an encrypted version is also supported if you dont trust selene!
 
 ```python
-from selene_api.cloud import SecretSeleneCloud
+from ovos_backend_client.cloud import SecretSeleneCloud
 
 k = "D8fmXEP5VqzVw2HE"  # you need this to read back the data
 cloud = SecretSeleneCloud(k)
@@ -104,7 +126,7 @@ since local backend does not provide a web ui a [admin api](https://github.com/O
 can be used to manage your devices
 
 ```python
-from selene_api.api import AdminApi
+from ovos_backend_client.api import AdminApi
 
 admin = AdminApi("secret_admin_key")
 uuid = "..."  # check identity2.json in the device you want to manage

ovos_backend_client/__init__.py

@@ -0,0 +1,5 @@
+from ovos_backend_client.api import DeviceApi, WolframAlphaApi, OpenWeatherMapApi, STTApi, GeolocationApi
+from ovos_backend_client.cloud import SeleneCloud, SecretSeleneCloud
+from ovos_backend_client.config import RemoteConfigManager
+from ovos_backend_client.pairing import is_paired, has_been_paired, check_remote_pairing, PairingManager
+from ovos_backend_client.settings import RemoteSkillSettings