educabiz 0.0.1__py3-none-any.whl

educabiz/__init__.py

@@ -0,0 +1,16 @@
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '0.0.1'
+__version_tuple__ = version_tuple = tuple(map(int, version.split('.')))

educabiz/__main__.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env -S python3 -u
+
+import requests
+import dotenv
+import os
+from datetime import datetime, date
+
+
+class Client(requests.Session):
+    URL = 'https://mobile.educabiz.com'
+
+    def request(self, method, url, *a, **b):
+        if url[0] == '/':
+            url = f'{self.URL}{url}'
+        return super().request(method, url, *a, **b)
+
+    def login(self, username, password):
+        r = self.post('/mobile/login', data={'username': username, 'password': password})
+        r.raise_for_status()
+        r = r.json()
+        assert r['status'] == 'ok'
+        return r
+
+    def home(self):
+        r = self.get('/educators/home')
+        r.raise_for_status()
+        return r.json()
+
+    def notifications(self):
+        r = self.get('/educators/notifications')
+        r.raise_for_status()
+        return r.json()
+
+    def child_payments(self, child):
+        r = self.get(f'/child/{child}/payments')
+        r.raise_for_status()
+        return r.json()
+
+    def child_report(self, child, page=0, build_page=False):
+        r = self.post(f'/child/{child}/report', data={'page': page, 'buildPage': build_page})
+        r.raise_for_status()
+        return r.json()
+
+    def child_messages(self, child, page=1):
+        r = self.get(f'/child/{child}/messages/income', params={'page': page})
+        r.raise_for_status()
+        return r.json()
+
+    def child_services(self, child):
+        r = self.get(f'/child/{child}/services')
+        r.raise_for_status()
+        return r.json()
+
+    def child_timetable(self, child):
+        r = self.get(f'/child/{child}/timetable')
+        r.raise_for_status()
+        return r.json()
+
+    def child_gallery(self, child, page=1, build_page=False):
+        r = self.get(
+            f'/child/{child}/gallery',
+            params={
+                'page': page,
+                'buildPage': build_page,
+                'childId': child,
+                'serviceId': '',
+            },
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def school_qrcodeinfo(self):
+        r = self.get(
+            '/school/qrcodeinfo',
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def _bool(self, b):
+        return 'true' if b else 'false'
+
+    def _schoolctrl_save_presence(
+        self,
+        path: str,
+        child_id: str,
+        date: date,
+        notes='',
+        absent=False,
+        is_checked=True,
+        is_enter=False,
+        number_day=1,
+    ):
+        r = self.post(
+            f'/schoolctrl/{path}',
+            data={
+                'colabId': '',
+                'date': date.strftime('%d-%m-%Y'),
+                'notes': notes,
+                'absent': self._bool(absent),
+                'isChecked': self._bool(is_checked),
+                'isEnter': self._bool(is_enter),
+                'numberDay': number_day,
+                'childId': child_id,
+            },
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def schoolctrl_save_presence_note(self, child_id: str, date: datetime.date, notes=''):
+        return self._schoolctrl_save_presence('savepresencesinglenote', child_id, date, notes=notes, absent=True)
+
+    def schoolctrl_save_presence_out(self, child_id: str, date: datetime.date):
+        return self._schoolctrl_save_presence('savepresenceout', child_id, date)
+
+    def schoolctrl_save_presence_in(self, child_id: str, date: datetime.date):
+        return self._schoolctrl_save_presence('savepresencein', child_id, date, is_enter=True)
+
+
+def cli():
+    dotenv.load_dotenv()
+    c = Client()
+    c.login(os.getenv('EDUCA_USERNAME'), os.getenv('EDUCA_PASSWORD'))
+    data = c.home()
+    print(f'School: {data["schoolname"]}')
+    for child_id, child in data['children'].items():
+        print(f'{child_id}:')
+        print(f'* Name: {child["name"]}')
+
+
+if __name__ == '__main__':
+    cli()

educabiz/client.py

@@ -0,0 +1,112 @@
+from datetime import date
+import requests
+
+
+class Client(requests.Session):
+    URL = 'https://mobile.educabiz.com'
+
+    def request(self, method, url, *a, **b):
+        if url[0] == '/':
+            url = f'{self.URL}{url}'
+        return super().request(method, url, *a, **b)
+
+    def login(self, username, password):
+        r = self.post('/mobile/login', data={'username': username, 'password': password})
+        r.raise_for_status()
+        r = r.json()
+        assert r['status'] == 'ok'
+        return r
+
+    def home(self):
+        r = self.get('/educators/home')
+        r.raise_for_status()
+        return r.json()
+
+    def notifications(self):
+        r = self.get('/educators/notifications')
+        r.raise_for_status()
+        return r.json()
+
+    def child_payments(self, child):
+        r = self.get(f'/child/{child}/payments')
+        r.raise_for_status()
+        return r.json()
+
+    def child_report(self, child, page=0, build_page=False):
+        r = self.post(f'/child/{child}/report', data={'page': page, 'buildPage': build_page})
+        r.raise_for_status()
+        return r.json()
+
+    def child_messages(self, child, page=1):
+        r = self.get(f'/child/{child}/messages/income', params={'page': page})
+        r.raise_for_status()
+        return r.json()
+
+    def child_services(self, child):
+        r = self.get(f'/child/{child}/services')
+        r.raise_for_status()
+        return r.json()
+
+    def child_timetable(self, child):
+        r = self.get(f'/child/{child}/timetable')
+        r.raise_for_status()
+        return r.json()
+
+    def child_gallery(self, child, page=1, build_page=False):
+        r = self.get(
+            f'/child/{child}/gallery',
+            params={
+                'page': page,
+                'buildPage': build_page,
+                'childId': child,
+                'serviceId': '',
+            },
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def school_qrcodeinfo(self):
+        r = self.get(
+            '/school/qrcodeinfo',
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def _bool(self, b):
+        return 'true' if b else 'false'
+
+    def _schoolctrl_save_presence(
+        self,
+        path: str,
+        child_id: str,
+        date: date,
+        notes='',
+        absent=False,
+        is_checked=True,
+        is_enter=False,
+        number_day=1,
+    ):
+        r = self.post(
+            f'/schoolctrl/{path}',
+            data={
+                'colabId': '',
+                'date': date.strftime('%d-%m-%Y'),
+                'notes': notes,
+                'absent': self._bool(absent),
+                'isChecked': self._bool(is_checked),
+                'isEnter': self._bool(is_enter),
+                'numberDay': number_day,
+                'childId': child_id,
+            },
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def schoolctrl_save_presence_note(self, child_id: str, date: date, notes=''):
+        return self._schoolctrl_save_presence('savepresencesinglenote', child_id, date, notes=notes, absent=True)
+
+    def schoolctrl_save_presence_out(self, child_id: str, date: date):
+        return self._schoolctrl_save_presence('savepresenceout', child_id, date)
+
+    def schoolctrl_save_presence_in(self, child_id: str, date: date):
+        return self._schoolctrl_save_presence('savepresencein', child_id, date, is_enter=True)

educabiz-0.0.1.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Filipe Pina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

educabiz-0.0.1.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.1
+Name: educabiz
+Version: 0.0.1
+Summary: API client for *.educabiz.com 
+Author-email: Filipe Pina <shelf-corncob-said@duck.com>
+Project-URL: Homepage, https://github.com/fopina/python-educabiz
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# python package template
+
+## Content
+
+* `pytest` for tests: `make test`
+* `ruff` for linting/formatting: `make lint` (replaces both `black` and `isort`)
+* `.github` with actions ready to test PRs and publish releases
+
+## New project checklist
+
+* [ ] Replace `example` with *the* package
+* [ ] Replace `LICENSE` if MIT does not apply
+* [ ] Search the project for `# TODO` to find the (minimum list of) places that need to be changed.
+* [ ] Add PYPI credentials to secrets
+

educabiz-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+educabiz/__init__.py,sha256=h_raVwYsn76uDMIDjYlCzRXsHWvegpSDl4iUhWlySTU,368
+educabiz/__main__.py,sha256=vQuK8jerWSua1NCcJ6W17DG_mn_F7mDwvAUrG4S3pUc,3830
+educabiz/client.py,sha256=rwVz0VXs8ZdcBAPgff8f2iD44pA_CBcAAAN4L-q69tM,3387
+educabiz-0.0.1.dist-info/LICENSE,sha256=VhFKvmhFGR5Zd6R5B2Nnq2qISn_ZpvhVwZHt_0MllMA,1067
+educabiz-0.0.1.dist-info/METADATA,sha256=z1BI740sYpyUi1wqXkWPMa5cGsdBfd-zcVvTcyQF694,773
+educabiz-0.0.1.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+educabiz-0.0.1.dist-info/entry_points.txt,sha256=1GW-T98D-ULaawcYU44y08vHLJt1NAb_nFSn4Dt1lKo,56
+educabiz-0.0.1.dist-info/top_level.txt,sha256=w6VYjSREBu7MGSXHYC5aXXzyLkgWh3Msl1pUpeOEx7g,9
+educabiz-0.0.1.dist-info/RECORD,,

educabiz-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.44.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

educabiz-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+admindocs-cli = educabiz.__main__:cli

educabiz-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+educabiz