educabiz 0.0.1__tar.gz

educabiz-0.0.1/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,15 @@
+# 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/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-0.0.1/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-0.0.1/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/educabiz.egg-info/PKG-INFO

@@ -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/educabiz.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+educabiz/__init__.py
+educabiz/__main__.py
+educabiz/client.py
+educabiz.egg-info/PKG-INFO
+educabiz.egg-info/SOURCES.txt
+educabiz.egg-info/dependency_links.txt
+educabiz.egg-info/entry_points.txt
+educabiz.egg-info/top_level.txt
+tests/test_client.py

educabiz-0.0.1/educabiz.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

educabiz-0.0.1/educabiz.egg-info/entry_points.txt

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

educabiz-0.0.1/educabiz.egg-info/top_level.txt

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

educabiz-0.0.1/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0.0,<69.3.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "educabiz"
+authors = [{name="Filipe Pina", email="shelf-corncob-said@duck.com" }]
+dynamic = ["version"]
+description = "API client for *.educabiz.com "
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/fopina/python-educabiz"
+
+[project.scripts]
+admindocs-cli = "educabiz.__main__:cli"
+
+[tool.setuptools.packages.find]
+include = ["educabiz*"]
+
+[tool.setuptools.dynamic]
+version = {attr = "educabiz.__version__"}
+
+[tool.ruff]
+line-length = 120
+indent-width = 4
+
+target-version = "py310"
+
+[tool.ruff.lint]
+# Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`)  codes by default.
+# Unlike Flake8, Ruff doesn't enable pycodestyle warnings (`W`) or
+# McCabe complexity (`C901`) by default.
+select = ["E4", "E7", "E9", "F", "I"]
+ignore = []
+
+fixable = ["ALL"]
+unfixable = []
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.format]
+quote-style = "single"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra -q"
+testpaths = [
+    "tests",
+]
+
+[tool.coverage.run]
+source = ["educabiz"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

educabiz-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

educabiz-0.0.1/tests/test_client.py

@@ -0,0 +1,8 @@
+import unittest
+
+from educabiz.client import Client
+
+
+class Test(unittest.TestCase):
+    def test_client(self):
+        self.assertEqual(True, True)