pyMyweblog 0.0.1__tar.gz

pymyweblog-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 faanskit
+
+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.

pymyweblog-0.0.1/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: pyMyweblog
+Version: 0.0.1
+Summary: A Python library for interacting with the MyWebLog API
+Author-email: Marcus Karlsson <marcus.karlsson@usa.net>
+License: MIT License
+        
+        Copyright (c) 2025 faanskit
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/faanskit/pyMyweblog
+Project-URL: Repository, https://github.com/faanskit/pyMyweblog
+Project-URL: Issues, https://github.com/faanskit/pyMyweblog/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Dynamic: license-file
+
+# pyMyweblog Python Library
+
+`pyMyweblog` is a Python library for interacting with the MyWebLog API, designed to fetch objects and bookings for aviation-related data. It is intended for use in Home Assistant integrations or other Python applications requiring access to MyWebLog services.
+
+## Installation
+
+Install the library via pip:
+
+```bash
+pip install pyMyweblog
+```
+
+Alternatively, for local development, clone the repository and install it in editable mode:
+
+```bash
+git clone https://github.com/faanskit/pyMyweblog.git
+cd pyMyweblog
+pip install -e .
+```
+
+## Prerequisites
+
+To use the library, you need:
+- A valid MyWebLog username and password.
+- A valid `app_token` for MyWebLog [Mobile API](https://api.myweblog.se/index.php?page=mobile)
+
+## Usage
+
+The `MyWebLogClient` class provides methods to interact with the MyWebLog API, such as fetching objects and bookings.
+
+### Example: Fetching Objects
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+# Initialize the client
+client = MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+)
+
+# Fetch objects
+objects = client.getObjects()
+print(objects)
+
+# Close the session
+client.close()
+
+# Alternatively, use as a context manager
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    objects = client.getObjects()
+    print(objects)
+```
+
+### Example: Fetching Bookings
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    bookings = client.getBookings(mybookings=True, includeSun=True)
+    print(bookings)
+```
+
+## Testing the API
+
+Before pushing any changes, please follow these steps to ensure everything works locally.
+
+1. **Set environment variables** (recommended for security):
+   ```bash
+   export MYWEBLOG_USERNAME="your_username"
+   export MYWEBLOG_PASSWORD="your_password"
+   export MYWEBLOG_APPTOKEN="your_apptoken"
+   ```
+
+2. **Run the test script**:
+   ```bash
+   python scripts/test_get_objects.py
+   ```
+
+   This will fetch objects and print the API response in a formatted way using `pprint`.
+
+## Development
+
+### Setting Up the Development Environment
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/faanskit/pyMyweblog.git
+   cd pyMyweblog
+   ```
+
+2. **Create and activate a virtual environment**:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: .\venv\Scripts\activate
+   ```
+
+3. **Install dependencies**:
+   ```bash
+   pip install -e .[dev]
+   ```
+
+### Running Tests Locally Before Pushing
+
+To ensure your code adheres to the standards and passes tests, follow these steps before you push your changes:
+
+1. **Install dependencies** (if not already done):
+   ```bash
+   pip install -e .[dev]
+   ```
+
+2. **Run format and lint checks**:
+   - **Black**: Automatically formats your code to conform to Python’s PEP 8 style.
+     ```bash
+     black .
+     ```
+
+   - **Flake8**: Lints your code for style issues, such as unused imports or incorrect indentation.
+     ```bash
+     flake8 .
+     ```
+
+3. **Run unit tests**:
+   - **Pytest**: Run all the tests in the `tests/` directory and verify they pass.
+     ```bash
+     pytest --ignore=scripts/test_get_objects.py --ignore=scripts/test_get_balance.py
+     ```
+
+   If all tests pass without errors, you're good to go!
+
+### Running Unit Tests
+
+Unit tests are located in the `tests/` directory and use `unittest`.
+
+```bash
+python -m unittest discover tests
+```
+
+### Modifying the Code
+
+- The main API client is in `pyMyweblog/client.py`.
+- Update `app_token` and `ac_id` in `MyWebLogClient` with valid values or make them configurable.
+- Add new methods to `MyWebLogClient` for additional API endpoints as needed.
+
+### Running Test Scripts
+
+Test scripts are located in the `scripts/` directory and use `python`.
+
+**Example #1**:
+To test the GetObjects function, you can run this script:
+```bash
+python -m scripts.test_get_objects
+```
+
+**Example #2**:
+To test the GetBalance function, you can run this script:
+```bash
+python -m scripts.test_get_balance
+```
+
+
+## Contributing
+
+Contributions are welcome! Please submit issues or pull requests to the [GitHub repository](https://github.com/faanskit/pyMyweblog).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+For support, contact the maintainer at [marcus.karlsson@usa.net].

pymyweblog-0.0.1/README.md

@@ -0,0 +1,180 @@
+# pyMyweblog Python Library
+
+`pyMyweblog` is a Python library for interacting with the MyWebLog API, designed to fetch objects and bookings for aviation-related data. It is intended for use in Home Assistant integrations or other Python applications requiring access to MyWebLog services.
+
+## Installation
+
+Install the library via pip:
+
+```bash
+pip install pyMyweblog
+```
+
+Alternatively, for local development, clone the repository and install it in editable mode:
+
+```bash
+git clone https://github.com/faanskit/pyMyweblog.git
+cd pyMyweblog
+pip install -e .
+```
+
+## Prerequisites
+
+To use the library, you need:
+- A valid MyWebLog username and password.
+- A valid `app_token` for MyWebLog [Mobile API](https://api.myweblog.se/index.php?page=mobile)
+
+## Usage
+
+The `MyWebLogClient` class provides methods to interact with the MyWebLog API, such as fetching objects and bookings.
+
+### Example: Fetching Objects
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+# Initialize the client
+client = MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+)
+
+# Fetch objects
+objects = client.getObjects()
+print(objects)
+
+# Close the session
+client.close()
+
+# Alternatively, use as a context manager
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    objects = client.getObjects()
+    print(objects)
+```
+
+### Example: Fetching Bookings
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    bookings = client.getBookings(mybookings=True, includeSun=True)
+    print(bookings)
+```
+
+## Testing the API
+
+Before pushing any changes, please follow these steps to ensure everything works locally.
+
+1. **Set environment variables** (recommended for security):
+   ```bash
+   export MYWEBLOG_USERNAME="your_username"
+   export MYWEBLOG_PASSWORD="your_password"
+   export MYWEBLOG_APPTOKEN="your_apptoken"
+   ```
+
+2. **Run the test script**:
+   ```bash
+   python scripts/test_get_objects.py
+   ```
+
+   This will fetch objects and print the API response in a formatted way using `pprint`.
+
+## Development
+
+### Setting Up the Development Environment
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/faanskit/pyMyweblog.git
+   cd pyMyweblog
+   ```
+
+2. **Create and activate a virtual environment**:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: .\venv\Scripts\activate
+   ```
+
+3. **Install dependencies**:
+   ```bash
+   pip install -e .[dev]
+   ```
+
+### Running Tests Locally Before Pushing
+
+To ensure your code adheres to the standards and passes tests, follow these steps before you push your changes:
+
+1. **Install dependencies** (if not already done):
+   ```bash
+   pip install -e .[dev]
+   ```
+
+2. **Run format and lint checks**:
+   - **Black**: Automatically formats your code to conform to Python’s PEP 8 style.
+     ```bash
+     black .
+     ```
+
+   - **Flake8**: Lints your code for style issues, such as unused imports or incorrect indentation.
+     ```bash
+     flake8 .
+     ```
+
+3. **Run unit tests**:
+   - **Pytest**: Run all the tests in the `tests/` directory and verify they pass.
+     ```bash
+     pytest --ignore=scripts/test_get_objects.py --ignore=scripts/test_get_balance.py
+     ```
+
+   If all tests pass without errors, you're good to go!
+
+### Running Unit Tests
+
+Unit tests are located in the `tests/` directory and use `unittest`.
+
+```bash
+python -m unittest discover tests
+```
+
+### Modifying the Code
+
+- The main API client is in `pyMyweblog/client.py`.
+- Update `app_token` and `ac_id` in `MyWebLogClient` with valid values or make them configurable.
+- Add new methods to `MyWebLogClient` for additional API endpoints as needed.
+
+### Running Test Scripts
+
+Test scripts are located in the `scripts/` directory and use `python`.
+
+**Example #1**:
+To test the GetObjects function, you can run this script:
+```bash
+python -m scripts.test_get_objects
+```
+
+**Example #2**:
+To test the GetBalance function, you can run this script:
+```bash
+python -m scripts.test_get_balance
+```
+
+
+## Contributing
+
+Contributions are welcome! Please submit issues or pull requests to the [GitHub repository](https://github.com/faanskit/pyMyweblog).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+For support, contact the maintainer at [marcus.karlsson@usa.net].

pymyweblog-0.0.1/pyMyweblog/__init__.py

@@ -0,0 +1,7 @@
+"""A Python library for interacting with the MyWebLog API."""
+
+__version__ = "0.1.0"
+
+from .client import MyWebLogClient
+
+__all__ = ["MyWebLogClient"]

pymyweblog-0.0.1/pyMyweblog/client.py

@@ -0,0 +1,194 @@
+import aiohttp
+import json
+from typing import Any, Dict
+from datetime import date
+
+
+class MyWebLogClient:
+    """Client for interacting with the MyWebLog API."""
+
+    def __init__(
+        self,
+        username: str,
+        password: str,
+        app_token: str,
+    ):
+        """Initialize the MyWebLog client.
+
+        Args:
+            username (str): Username for authentication.
+            password (str): Password for authentication.
+            app_token (str): Application token for API access.
+        """
+        self.username = username
+        self.password = password
+        self.app_token = app_token
+        self.ac_id = "TBD"
+        self.base_url = "https://api.myweblog.se/api_mobile.php?version=2.0.3"
+        self.session = None
+        print(
+            f"Connecting to MyWebLog API at {self.base_url} "
+            f"with user {self.username}"
+        )
+
+    async def __aenter__(self):
+        self.session = aiohttp.ClientSession()
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb):
+        if self.session:
+            await self.session.close()
+            self.session = None
+
+    async def _myWeblogPost(self, qtype: str, data: Dict[str, Any]) -> Dict[str, Any]:
+        """Send a POST request to the MyWebLog API.
+
+        Args:
+            qtype (str): Query type for the API request (e.g., 'GetObjects').
+            data (Dict[str, Any]): Data to include in the request body.
+
+        Returns:
+            Dict[str, Any]: Response from the API.
+        """
+        if not self.session:
+            raise RuntimeError(
+                "ClientSession is not initialized. Use 'async with' context."
+            )
+        payload = {
+            "qtype": qtype,
+            "mwl_u": self.username,
+            "mwl_p": self.password,
+            "returnType": "JSON",
+            "charset": "UTF-8",
+            "app_token": self.app_token,
+            "language": "se",
+            **data,
+        }
+        async with self.session.post(self.base_url, data=payload) as resp:
+            resp.raise_for_status()
+            # API returns text/plain; manually decode as JSON
+            response = await resp.text()
+            return json.loads(response)
+
+    async def getObjects(self) -> Dict[str, Any]:
+        """Get objects from the MyWebLog API.
+
+        Returns:
+            Dict[str, Any]: Response from the API.
+            Output example:
+            {
+                'APIVersion': str,
+                'qType': str,
+                'result': {
+                'Object': [
+                    {
+                    'ID': str,
+                    'regnr': str,
+                    'model': str,
+                    'club_id': str,
+                    'clubname': str,
+                    'bobject_cat': str (optional),
+                    'comment': str (optional),
+                    'activeRemarks': [
+                        {
+                        'remarkID': str,
+                        'remarkBy': str,
+                        'remarkCategory': str,
+                        'remarkDate': str,
+                        'remarkText': str
+                        },
+                        ...
+                    ] (optional),
+                    'flightData': {
+                        'initial': {...},
+                        'logged': {...},
+                        'total': {...}
+                    },
+                    'ftData': {...},
+                    'maintTimeDate': {...} (optional)
+                    },
+                    ...
+                ],
+                'Result': str
+                }
+            }
+            Notable fields per object:
+            - ID (str): Object ID
+            - regnr (str): Registration or name
+            - model (str): Model/type
+            - club_id (str): Club ID
+            - clubname (str): Club name
+            - bobject_cat (str, optional): Object category
+            - comment (str, optional): Comment/description
+            - activeRemarks (list, optional): List of active remarks
+            - flightData (dict): Flight time and usage data
+            - ftData (dict): Flight totals
+            - maintTimeDate (dict, optional): Maintenance info
+        """
+        data = {"includeObjectThumbnail": 0}
+        return await self._myWeblogPost("GetObjects", data)
+
+    async def getBookings(
+        self, mybookings: bool = True, includeSun: bool = True
+    ) -> Dict[str, Any]:
+        """Get bookings from the MyWebLog API.
+
+        Args:
+            mybookings (bool): Whether to fetch only user's bookings.
+            includeSun (bool): Whether to include sunrise/sunset data.
+
+        Returns:
+            Dict[str, Any]: Response from the API.
+            Output:
+                ID (int)
+                ac_id (int)
+                regnr (string)
+                bobject_cat (int)
+                club_id (int)
+                user_id (int)
+                bStart (timestamp)
+                bEnd (timestamp)
+                typ (string)
+                primary_booking (bool)
+                fritext (string)
+                elevuserid (int)
+                platserkvar (int)
+                fullname (string)
+                email (string)
+                completeMobile (string)
+                sunData (dict): Reference airport data and dates
+        """
+        today = date.today().strftime("%Y-%m-%d")
+        data = {
+            "ac_id": self.ac_id,
+            "mybookings": int(mybookings),
+            "from_date": today,
+            "to_date": today,
+            "includeSun": int(includeSun),
+        }
+        return await self._myWeblogPost("GetBookings", data)
+
+    async def getBalance(self) -> Dict[str, Any]:
+        """Get the balance of the current user from the MyWebLog API.
+
+        Returns:
+            Dict[str, Any]: Response from the API.
+            Output example:
+            {
+                'Fornamn': str,
+                'Partikel': str,
+                'Efternamn': str,
+                'fullname': str,
+                'Balance': float,
+                'currency_symbol': str,
+                'int_curr_symbol': str
+            }
+        """
+        data = {}
+        return await self._myWeblogPost("GetBalance", data)
+
+    async def close(self) -> None:
+        """Close the HTTP session."""
+        if self.session:
+            await self.session.close()
+            self.session = None

pymyweblog-0.0.1/pyMyweblog.egg-info/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: pyMyweblog
+Version: 0.0.1
+Summary: A Python library for interacting with the MyWebLog API
+Author-email: Marcus Karlsson <marcus.karlsson@usa.net>
+License: MIT License
+        
+        Copyright (c) 2025 faanskit
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/faanskit/pyMyweblog
+Project-URL: Repository, https://github.com/faanskit/pyMyweblog
+Project-URL: Issues, https://github.com/faanskit/pyMyweblog/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Dynamic: license-file
+
+# pyMyweblog Python Library
+
+`pyMyweblog` is a Python library for interacting with the MyWebLog API, designed to fetch objects and bookings for aviation-related data. It is intended for use in Home Assistant integrations or other Python applications requiring access to MyWebLog services.
+
+## Installation
+
+Install the library via pip:
+
+```bash
+pip install pyMyweblog
+```
+
+Alternatively, for local development, clone the repository and install it in editable mode:
+
+```bash
+git clone https://github.com/faanskit/pyMyweblog.git
+cd pyMyweblog
+pip install -e .
+```
+
+## Prerequisites
+
+To use the library, you need:
+- A valid MyWebLog username and password.
+- A valid `app_token` for MyWebLog [Mobile API](https://api.myweblog.se/index.php?page=mobile)
+
+## Usage
+
+The `MyWebLogClient` class provides methods to interact with the MyWebLog API, such as fetching objects and bookings.
+
+### Example: Fetching Objects
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+# Initialize the client
+client = MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+)
+
+# Fetch objects
+objects = client.getObjects()
+print(objects)
+
+# Close the session
+client.close()
+
+# Alternatively, use as a context manager
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    objects = client.getObjects()
+    print(objects)
+```
+
+### Example: Fetching Bookings
+
+```python
+from pyMyweblog.client import MyWebLogClient
+
+with MyWebLogClient(
+    username="your_username",
+    password="your_password",
+    app_token="your_apptoken",
+) as client:
+    bookings = client.getBookings(mybookings=True, includeSun=True)
+    print(bookings)
+```
+
+## Testing the API
+
+Before pushing any changes, please follow these steps to ensure everything works locally.
+
+1. **Set environment variables** (recommended for security):
+   ```bash
+   export MYWEBLOG_USERNAME="your_username"
+   export MYWEBLOG_PASSWORD="your_password"
+   export MYWEBLOG_APPTOKEN="your_apptoken"
+   ```
+
+2. **Run the test script**:
+   ```bash
+   python scripts/test_get_objects.py
+   ```
+
+   This will fetch objects and print the API response in a formatted way using `pprint`.
+
+## Development
+
+### Setting Up the Development Environment
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/faanskit/pyMyweblog.git
+   cd pyMyweblog
+   ```
+
+2. **Create and activate a virtual environment**:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: .\venv\Scripts\activate
+   ```
+
+3. **Install dependencies**:
+   ```bash
+   pip install -e .[dev]
+   ```
+
+### Running Tests Locally Before Pushing
+
+To ensure your code adheres to the standards and passes tests, follow these steps before you push your changes:
+
+1. **Install dependencies** (if not already done):
+   ```bash
+   pip install -e .[dev]
+   ```
+
+2. **Run format and lint checks**:
+   - **Black**: Automatically formats your code to conform to Python’s PEP 8 style.
+     ```bash
+     black .
+     ```
+
+   - **Flake8**: Lints your code for style issues, such as unused imports or incorrect indentation.
+     ```bash
+     flake8 .
+     ```
+
+3. **Run unit tests**:
+   - **Pytest**: Run all the tests in the `tests/` directory and verify they pass.
+     ```bash
+     pytest --ignore=scripts/test_get_objects.py --ignore=scripts/test_get_balance.py
+     ```
+
+   If all tests pass without errors, you're good to go!
+
+### Running Unit Tests
+
+Unit tests are located in the `tests/` directory and use `unittest`.
+
+```bash
+python -m unittest discover tests
+```
+
+### Modifying the Code
+
+- The main API client is in `pyMyweblog/client.py`.
+- Update `app_token` and `ac_id` in `MyWebLogClient` with valid values or make them configurable.
+- Add new methods to `MyWebLogClient` for additional API endpoints as needed.
+
+### Running Test Scripts
+
+Test scripts are located in the `scripts/` directory and use `python`.
+
+**Example #1**:
+To test the GetObjects function, you can run this script:
+```bash
+python -m scripts.test_get_objects
+```
+
+**Example #2**:
+To test the GetBalance function, you can run this script:
+```bash
+python -m scripts.test_get_balance
+```
+
+
+## Contributing
+
+Contributions are welcome! Please submit issues or pull requests to the [GitHub repository](https://github.com/faanskit/pyMyweblog).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+For support, contact the maintainer at [marcus.karlsson@usa.net].

pymyweblog-0.0.1/pyMyweblog.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+pyMyweblog/__init__.py
+pyMyweblog/client.py
+pyMyweblog.egg-info/PKG-INFO
+pyMyweblog.egg-info/SOURCES.txt
+pyMyweblog.egg-info/dependency_links.txt
+pyMyweblog.egg-info/requires.txt
+pyMyweblog.egg-info/top_level.txt
+tests/test_client.py

pymyweblog-0.0.1/pyMyweblog.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pymyweblog-0.0.1/pyMyweblog.egg-info/requires.txt

@@ -0,0 +1,6 @@
+aiohttp>=3.8.0
+
+[dev]
+pytest
+flake8
+black

pymyweblog-0.0.1/pyMyweblog.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyMyweblog

pymyweblog-0.0.1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyMyweblog"
+version = "0.0.1"
+description = "A Python library for interacting with the MyWebLog API"
+readme = "README.md"
+authors = [{ name = "Marcus Karlsson", email = "marcus.karlsson@usa.net" }]
+license = { file = "LICENSE" }
+requires-python = ">=3.8"
+dependencies = [
+    "aiohttp>=3.8.0"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[project.urls]
+Homepage = "https://github.com/faanskit/pyMyweblog"
+Repository = "https://github.com/faanskit/pyMyweblog"
+Issues = "https://github.com/faanskit/pyMyweblog/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "flake8",
+    "black"
+]
+
+[tool.setuptools.packages.find]
+include = ["pyMyweblog*"]

pymyweblog-0.0.1/setup.cfg

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

pymyweblog-0.0.1/tests/test_client.py

@@ -0,0 +1,339 @@
+import unittest
+from unittest.mock import patch, AsyncMock, Mock
+import json
+from datetime import date
+import aiohttp
+from pyMyweblog.client import MyWebLogClient
+
+
+class TestMyWebLogClient(unittest.IsolatedAsyncioTestCase):
+    """Test cases for MyWebLogClient (aiohttp/async version)."""
+
+    def setUp(self):
+        """Set up test parameters."""
+        self.username = "test_user"
+        self.password = "test_pass"
+        self.app_token = "test_token"
+        self.ac_id = "TBD"
+        self.base_url = "https://api.myweblog.se/api_mobile.php?version=2.0.3"
+
+    async def asyncTearDown(self):
+        """Clean up after each test (no manual session handling needed)."""
+        pass
+
+    @patch("aiohttp.ClientSession.post")
+    async def test_get_objects_success(self, mock_post):
+        """Test successful retrieval of objects."""
+        # Mock API response
+        mock_response = AsyncMock()
+        mock_response.status = 200
+        mock_response.text = AsyncMock(
+            return_value=json.dumps(
+                {
+                    "objects": [
+                        {
+                            "ID": 1,
+                            "regnr": "SE-ABC",
+                            "club_id": 123,
+                            "clubname": "Test Club",
+                            "model": "Cessna 172",
+                        }
+                    ]
+                }
+            )
+        )
+        # Mock raise_for_status to avoid RuntimeWarning
+        mock_response.raise_for_status = Mock()
+        mock_post.return_value.__aenter__.return_value = mock_response
+
+        # Use context manager to handle session
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            result = await client.getObjects()
+
+        # Verify response
+        self.assertEqual(
+            result,
+            {
+                "objects": [
+                    {
+                        "ID": 1,
+                        "regnr": "SE-ABC",
+                        "club_id": 123,
+                        "clubname": "Test Club",
+                        "model": "Cessna 172",
+                    }
+                ]
+            },
+        )
+
+        # Verify request
+        mock_post.assert_called_once_with(
+            self.base_url,
+            data={
+                "includeObjectThumbnail": 0,
+                "qtype": "GetObjects",
+                "mwl_u": self.username,
+                "mwl_p": self.password,
+                "returnType": "JSON",
+                "charset": "UTF-8",
+                "app_token": self.app_token,
+                "language": "se",
+            },
+        )
+
+    @patch("aiohttp.ClientSession.post")
+    async def test_get_bookings_success(self, mock_post):
+        """Test successful retrieval of bookings with default parameters."""
+        # Mock API response
+        mock_response = AsyncMock()
+        mock_response.status = 200
+        mock_response.text = AsyncMock(
+            return_value=json.dumps(
+                {
+                    "bookings": [
+                        {
+                            "ID": 101,
+                            "ac_id": self.ac_id,
+                            "regnr": "SE-ABC",
+                            "bStart": "2025-04-18 08:00:00",
+                            "bEnd": "2025-04-18 10:00:00",
+                            "fullname": "Test User",
+                        }
+                    ],
+                    "sunData": {
+                        "refAirport": {"name": "Test Airport"},
+                        "dates": {
+                            "2025-04-18": {"sunrise": "06:00", "sunset": "20:00"}
+                        },
+                    },
+                }
+            )
+        )
+        mock_response.raise_for_status = Mock()  # Mock raise_for_status
+        mock_post.return_value.__aenter__.return_value = mock_response
+
+        # Use context manager to handle session
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            today = date.today().strftime("%Y-%m-%d")
+            result = await client.getBookings(mybookings=True, includeSun=True)
+
+        # Verify response
+        self.assertEqual(
+            result,
+            {
+                "bookings": [
+                    {
+                        "ID": 101,
+                        "ac_id": self.ac_id,
+                        "regnr": "SE-ABC",
+                        "bStart": "2025-04-18 08:00:00",
+                        "bEnd": "2025-04-18 10:00:00",
+                        "fullname": "Test User",
+                    }
+                ],
+                "sunData": {
+                    "refAirport": {"name": "Test Airport"},
+                    "dates": {"2025-04-18": {"sunrise": "06:00", "sunset": "20:00"}},
+                },
+            },
+        )
+
+        # Verify request
+        mock_post.assert_called_once_with(
+            self.base_url,
+            data={
+                "ac_id": self.ac_id,
+                "mybookings": 1,
+                "from_date": today,
+                "to_date": today,
+                "includeSun": 1,
+                "qtype": "GetBookings",
+                "mwl_u": self.username,
+                "mwl_p": self.password,
+                "returnType": "JSON",
+                "charset": "UTF-8",
+                "app_token": self.app_token,
+                "language": "se",
+            },
+        )
+
+    @patch("aiohttp.ClientSession.post")
+    async def test_get_bookings_no_sun_data(self, mock_post):
+        """Test retrieval of bookings with includeSun=False."""
+        # Mock API response
+        mock_response = AsyncMock()
+        mock_response.status = 200
+        mock_response.text = AsyncMock(
+            return_value=json.dumps(
+                {
+                    "bookings": [
+                        {
+                            "ID": 102,
+                            "ac_id": self.ac_id,
+                            "regnr": "SE-XYZ",
+                            "bStart": "2025-04-18 09:00:00",
+                            "bEnd": "2025-04-18 11:00:00",
+                            "fullname": "Test User",
+                        }
+                    ]
+                }
+            )
+        )
+        mock_response.raise_for_status = Mock()  # Mock raise_for_status
+        mock_post.return_value.__aenter__.return_value = mock_response
+
+        # Use context manager to handle session
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            today = date.today().strftime("%Y-%m-%d")
+            result = await client.getBookings(mybookings=False, includeSun=False)
+
+        # Verify response
+        self.assertEqual(
+            result,
+            {
+                "bookings": [
+                    {
+                        "ID": 102,
+                        "ac_id": self.ac_id,
+                        "regnr": "SE-XYZ",
+                        "bStart": "2025-04-18 09:00:00",
+                        "bEnd": "2025-04-18 11:00:00",
+                        "fullname": "Test User",
+                    }
+                ]
+            },
+        )
+
+        # Verify request
+        mock_post.assert_called_once_with(
+            self.base_url,
+            data={
+                "ac_id": self.ac_id,
+                "mybookings": 0,
+                "from_date": today,
+                "to_date": today,
+                "includeSun": 0,
+                "qtype": "GetBookings",
+                "mwl_u": self.username,
+                "mwl_p": self.password,
+                "returnType": "JSON",
+                "charset": "UTF-8",
+                "app_token": self.app_token,
+                "language": "se",
+            },
+        )
+
+    @patch("aiohttp.ClientSession.post")
+    async def test_get_balance_success(self, mock_post):
+        """Test successful retrieval of user balance."""
+        # Mock API response
+        mock_response = AsyncMock()
+        mock_response.status = 200
+        mock_response.text = AsyncMock(
+            return_value=json.dumps(
+                {
+                    "Fornamn": "Test",
+                    "Partikel": "",
+                    "Efternamn": "User",
+                    "fullname": "Test User",
+                    "Balance": 1500.75,
+                    "currency_symbol": "SEK",
+                    "int_curr_symbol": "kr",
+                }
+            )
+        )
+        mock_response.raise_for_status = Mock()  # Mock raise_for_status
+        mock_post.return_value.__aenter__.return_value = mock_response
+
+        # Use context manager to handle session
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            result = await client.getBalance()
+
+        # Verify response
+        self.assertEqual(
+            result,
+            {
+                "Fornamn": "Test",
+                "Partikel": "",
+                "Efternamn": "User",
+                "fullname": "Test User",
+                "Balance": 1500.75,
+                "currency_symbol": "SEK",
+                "int_curr_symbol": "kr",
+            },
+        )
+
+        # Verify request
+        mock_post.assert_called_once_with(
+            self.base_url,
+            data={
+                "qtype": "GetBalance",
+                "mwl_u": self.username,
+                "mwl_p": self.password,
+                "returnType": "JSON",
+                "charset": "UTF-8",
+                "app_token": self.app_token,
+                "language": "se",
+            },
+        )
+
+    @patch("aiohttp.ClientSession.post")
+    async def test_myweblog_post_failure(self, mock_post):
+        """Test handling of HTTP request failure."""
+        # Mock API failure
+        mock_response = AsyncMock()
+        mock_response.status = 400
+        mock_response.text = AsyncMock(return_value="Bad Request")
+        mock_response.raise_for_status = Mock(
+            side_effect=aiohttp.ClientResponseError(
+                request_info=Mock(), history=(), status=400, message="Bad Request"
+            )
+        )
+        mock_post.return_value.__aenter__.return_value = mock_response
+
+        # Use context manager to handle session
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            with self.assertRaises(aiohttp.ClientResponseError):
+                await client.getObjects()
+
+    @patch("aiohttp.ClientSession")
+    async def test_close(self, mock_session):
+        """Test session closure."""
+        mock_session_instance = mock_session.return_value
+        mock_session_instance.close = AsyncMock()
+
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            pass  # No explicit close call; rely on context manager
+
+        mock_session_instance.close.assert_awaited_once()
+        # Verify session is None after closure
+        self.assertIsNone(client.session)
+
+    @patch("aiohttp.ClientSession")
+    async def test_context_manager(self, mock_session):
+        """Test context manager functionality."""
+        mock_session_instance = mock_session.return_value
+        mock_session_instance.close = AsyncMock()
+
+        async with MyWebLogClient(
+            self.username, self.password, self.app_token
+        ) as client:
+            self.assertIsInstance(client, MyWebLogClient)
+
+        mock_session_instance.close.assert_awaited_once()
+
+
+if __name__ == "__main__":
+    unittest.main()