layrz-sdk 3.0.9__tar.gz → 3.0.10__tar.gz

layrz_sdk-3.0.10/.github/workflows/checks.yml

@@ -0,0 +1,54 @@
+name: "Checks before merging"
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+    branches:
+      - '*'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/goldenm-software/python-builder:3.11
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dev dependencies
+        run: |
+          pip3 install -U -r requirements-dev.txt
+
+      - name: Lint
+        run: |
+          ruff check
+
+  uniitest:
+    needs: lint
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/goldenm-software/python-builder:3.11
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Install dependencies
+        run: |
+          pip install -U pip -r requirements.txt
+        
+      - name: Run unit tests
+        run: |
+          python3 -m unittest discover -s tests -v

layrz_sdk-3.0.10/.github/workflows/deploy.yml

@@ -0,0 +1,36 @@
+name: "Deploy package"
+
+on:
+  push:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    permissions:
+      id-token: write
+      contents: read
+      repository-projects: read
+      packages: read
+
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/goldenm-software/python-builder:3.11
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Build
+        run: |
+          pip install --upgrade pip build twine
+          python3 -m build
+        
+      - name: Upload to Python Package Index
+        uses: pypa/gh-action-pypi-publish@v1.8.10
+        with:
+          user: ${{ secrets.LAYRZ_PYPI_USERNAME }}
+          password: ${{ secrets.LAYRZ_PYPI_PASSWORD }}

layrz_sdk-3.0.10/.gitignore

@@ -0,0 +1,13 @@
+/dist
+/build
+/*.egg-info
+/.pypirc
+/test.py
+/**/*.pyc
+/.venv
+/site
+
+/**/*/__pycache__
+
+tests.py
+*.xlsx

layrz_sdk-3.0.10/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "charliermarsh.ruff",
+    "ms-python.vscode-pylance",
+    "njpwerner.autodocstring",
+    "oderwat.indent-rainbow"
+  ]
+}

layrz_sdk-3.0.10/.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "[python]": {
+    "editor.codeActionsOnSave": {
+      "source.organizeImports": "explicit",
+      "source.fixAll": "explicit"
+    },
+    "editor.rulers": [120],
+    "editor.formatOnSaveMode": "file",
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "editor.tabSize": 2,
+  "editor.insertSpaces": true,
+  "editor.detectIndentation": true
+}

layrz_sdk-3.0.10/CHANGELOG.md

@@ -0,0 +1,260 @@
+# Changelog
+
+## 3.0.10
+
+- Removed Self type annotation from all classes
+
+## 3.0.9
+
+- Added different return data of Report when password is set
+
+## 3.0.8
+
+- New linter and formatter using ruff
+- Added typings on all classes and functions available
+- New Report export format PDF (Not implemented yet)
+- Added new way to encrypt .xslx files directly using the 
+
+## 3.0.7
+
+- Added the value of `AssetOperationMode.ZONE`
+- Added a check for `Asset.operation_mode == ASSETMULTIPLE` while savind the list of child's
+- Clarified the deprecation of `ReportRow.height`
+
+## 3.0.6
+
+- Changed print in `LineChart` to a `log.warning` and `log.fatal` in case of error
+
+## 3.0.3
+
+- Implemented new chart rendering library `syncfusion_flutter_charts` for Flutter.
+- Changed rendering method for `LineChart`, now you should provide the `technology` to select the rendering library.
+
+## 3.0.2
+
+- Fixed issue with `IF()` LCL function, now only validates the nullability of the first argument.
+- Added new `VERSION()` LCL Function to get the current version of the package
+
+## 3.0.1
+
+- Added None validation on every LCL function, when any of the arguments is None, the function will return None
+- Added unit tests for all LCL functions
+
+## 3.0.0
+
+- Removed shared namespace to improve compatibility with other packages
+
+## 2.2.4
+
+- Defined new class `ReportConfiguration` to handle the configuration of the report in Python scripts
+
+## 2.2.3
+
+- Property `text_color` deprectated in `ReportCol`, replaced by a luminance-based color using the background color
+- Property `text_color` deprectated in `ReportHeader`, replaced by a luminance-based color using the background color
+- Property `width` deprectated in `ReportHeader`, replaced by the function `autofit()` to automatically fit the header width
+- New entity `CustomReportPage` that receives a custom builder function to build the page
+- Property `export_format` deprecated in `Report`, replaced to an argument of the function `export()`
+
+## 2.2.2
+
+- Updated `AssetOperationMode` to support `STATIC` and removal of `FAILOVER` mode
+
+## 2.2.1
+
+- Bug fixes related to removing __ from all classes
+
+## 2.2.0
+
+- Removed support to Python 3.12 due to a shared namespace issue.
+- Reorganized classes to better support.
+- Added typings to all classes and functions.
+
+## 2.1.5
+- Added declarative typing on all LCL functions
+- Added support for timezone in `UNIX_TO_STR` LCL function
+
+## 2.1.3
+- Changed build mode to pyproject.toml
+- Updated `LcLCore.perform()` function to receive additional globals and locals in their arguments
+
+## v2.1.2
+- Add UNIX_TO_STR LCL function
+
+## v2.1.1
+- Added `compact` in the json return format in reports
+
+## v2.1.0
+- Add bold format option to Col class
+- Add freeze header option to Page class
+
+## v2.0.1
+- Fixes on package namespace
+
+## v2.0.0
+* Deprecated `lcl.core` module
+* Changed `layrzsdk` to `layrz.sdk` package (With unified Layrz namespace)
+
+## v1.4.5
+* Added CaseIgnoredStatus to init file
+
+## v1.4.4
+* Added CaseIgnoredStatus to Case entity
+
+## v1.4.3
+* Added new ChartType: TableChart and NumberChart
+* Starting to replace documentation format from unstructured to a structured format
+
+## v1.4.2
+* Fix, added SUBSTRING LCL to global functions
+
+## v1.4.1
+* Fixed LineChart xAxis Datetime conversion for CanvasJS, now will multiply the timestamp by 1000 to use milliseconds
+
+## v1.4.0
+* Added support for Flutter `graphic` library
+  * LineChart
+  * AreaChart (Replaced previous AreaChart to a temporal extend of LineChart)
+  * BarChart
+  * ColumnChart
+  * PieChart
+  * MapChart
+  * ScatterChart
+  * RadialBarChart
+* Future deprecations:
+  * HTMLChart
+  * TimelineChart
+  * RadarChart
+
+## v1.3.9
+* Internal changes related to GitLab CI automation
+
+## v1.3.8
+* Added SUBSTRING LCL function
+
+## v.1.3.7
+* Added sequence in cases
+
+## v1.3.6
+* Added new Map Chart
+  - Added required entity MapPoint
+  - Added required enum MapCenterType
+* Added new HTML Chart
+
+
+## v1.3.5
+* Bug fix related to formula perform, added PRIMARY_DEVICE to simulation environment
+
+## v1.3.4
+* Added Transaction entity for REPCOM reports
+
+## v1.3.3
+- Added PRIMARY_DEVICE() function to Layrz Compute Language
+
+## v1.3.2
+- Updated styles of charts return object to ApexCharts or CanvasJS
+- Replaced all .rst files to .md files
+
+## v1.3.1
+* Removed markerSize (in CanvasJS) for dashed series
+
+## v1.3.0
+* Added support for CanvasJS Javascript Library
+* Deprecated to_apexcharts property in charts.
+* New method render() in charts with support for multiple Javascript rendering library
+* Added color helpers in layrzsdk.helpers
+
+## v1.2.6
+* Removed dataLabels in almost all charts (Except Pie and RadialBar) 
+
+## v1.2.5
+* Optimizations for Javascript renderer
+
+## v1.2.4
+* Added dashed attribute to ChartDataSerie
+* Added the Possibility to mix charts, only available for:
+  - LineChart
+  - AreaChart
+  - ColumnChart
+  - ScatterChart (Only as serie, not as main chart) 
+
+## v1.2.3
+* Added new value in BroadcastStatus
+
+## v1.2.2
+* Updated ReportCol entity to set new default values
+* New entity ReportDataType
+* Possibility to export directly to the Report class
+* Re-organized entities/ folder
+* Added Broadcasts entities 
+
+## v1.2.1
+* Added Report Col entity
+
+## v1.2.0
+* Added reports entities
+
+## v1.1.4
+* Bug fixes
+
+## v1.1.3
+* Bug fixes
+
+## v1.1.2
+* Bug fixes
+
+## v1.1.1
+* Bug fixes
+
+## v1.1.0
+* Reorganized files
+* Added new Charts entities
+
+## v1.0.14
+* Added CONTAINS, STARTS_WITH, ENDS_WITH functions to the Layrz Computed Language
+
+## v1.0.13
+* Fixed missing import into `layrzsdk.entities.__init__.py`
+
+## v1.0.12
+* Added Geofence, Comment, Waypoint and Checkpoint entities
+
+## v1.0.11
+* Added User, Comment and Case entities
+
+## v1.0.10
+* Fixes
+
+## v1.0.9
+* Added Event and Trigger entities
+* Renamed file `mesage.py` to `message.py`
+
+## v1.0.8
+* Added title getter of all charts entities
+
+## v1.0.7
+* Added PieChart, BarChart, and RadialBarChart entities
+
+## v1.0.6
+* Fixed STING to STRING bug in ChartDataType enum
+
+## v1.0.5
+* Bug fixes
+
+## v1.0.4
+* Added data_type argument of ChartDataSerie
+
+## v1.0.3
+* Added Chart configuration entity
+
+## v1.0.2
+* Added entities for Range Charts:
+  - Line Charts
+  - Area Charts
+  - Column Charts
+
+## v1.0.1
+* Added entities for Sensors and Triggers
+
+## v1.0.0
+* Initial release

layrz_sdk-3.0.10/CODE_OF_CONDUCT.md

@@ -0,0 +1,24 @@
+# Code of conduct
+
+## Be friendly and patient.
+Our objective is contribute to community and help us together to create better code.
+
+## Be welcoming
+We strive to be a community that welcomes and supports people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, colour, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability.
+
+## Be considerate
+Your work will be used by other people, and you in turn will depend on the work of others. Any decision you take will affect users and colleagues, and you should take those consequences into account when making decisions. Remember that we're a world-wide community, so you might not be communicating in someone else's primary language.
+
+## Be respectful
+Not all of us will agree all the time, but disagreement is no excuse for poor behavior and poor manners. We might all experience some frustration now and then, but we cannot allow that frustration to turn into a personal attack. It’s important to remember that a community where people feel uncomfortable or threatened is not a productive one.
+
+## Be careful in the words that you choose
+We are a community of professionals, and we conduct ourselves professionally. Be kind to others. Do not insult or put down other participants. Harassment and other exclusionary behavior aren't acceptable. This includes, but is not limited to:
+  * Violent threats or language directed against another person.
+  * Discriminatory jokes and language.
+  * Posting sexually explicit or violent material.
+  * Posting (or threatening to post) other people's personally identifying information ("doxing").
+  * Personal insults, especially those using racist or sexist terms.
+  * Unwelcome sexual attention.
+  * Advocating for, or encouraging, any of the above behavior.
+  * Repeated harassment of others. In general, if someone asks you to stop, then stop.

layrz_sdk-3.0.10/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+As an open source project, we welcomes contributions of many forms.
+
+## To request a Merge Request
+Please follow the next structure of your request:
+
+### Title
+A short description of your feature/fix
+
+Also, add this prefix in the title according to the scenario:
+
+| Prefix/Tag | Meaning |
+|-|-|
+| `feature/` | New feature, like new methods, classes, etc. |
+| `fix/` | Bug fix or documentation related fix |
+| `docs/` | Documentation related changes |
+
+### Description
+Explain your feature/fix request and why we should be approve.
+
+Be explicit and precise with your submission, that helps us to review and approve your request.
+
+## Code of Conduct
+
+As a contributor, you can help us keep the Layrz community open and inclusive.
+Please read and follow our code of conduct in `CODE_OF_CONDUCT.md`.

{layrz_sdk-3.0.9 → layrz_sdk-3.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: layrz-sdk
-Version: 3.0.9
+Version: 3.0.10
 Summary: Layrz SDK for Python
 Author-email: "Golden M, Inc." <software@goldenm.com>
 Maintainer-email: Kenny Mochizuki <kenny@goldenm.com>, Luis Reyes <lreyes@goldenm.com>, Kasen Li <kli@goldenm.com>

layrz_sdk-3.0.10/layrz_sdk/entities/broadcasts/request.py

@@ -0,0 +1,30 @@
+"""Broadcast Result Request data"""
+
+from typing import Dict, List
+
+
+class BroadcastRequest:
+  """
+  Broadcast request data
+  ---
+  Attributes
+    - json : Parsed data
+    - raw : Raw data
+  """
+
+  def __init__(self, json: Dict | List, raw: str) -> None:
+    self.json = json
+    self.raw = raw
+
+  @property
+  def _readable(self) -> str | None | bool:
+    """Readable"""
+    return f'BroadcastRequest(json={self.json}, raw={self.raw})'
+
+  def __repr__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable
+
+  def __str__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable

layrz_sdk-3.0.10/layrz_sdk/entities/broadcasts/response.py

@@ -0,0 +1,30 @@
+"""Broadcast Result Response data"""
+
+from typing import Dict, List
+
+
+class BroadcastResponse:
+  """
+  Broadcast response data
+  ---
+  Attributes
+    - json (dict|list): Parsed data
+    - raw (str): Raw data
+  """
+
+  def __init__(self, json: Dict | List, raw: str) -> str | None | bool:
+    self.json = json
+    self.raw = raw
+
+  @property
+  def _readable(self) -> str | None | bool:
+    """Readable"""
+    return f'BroadcastResponse(json={self.json}, raw={self.raw})'
+
+  def __repr__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable
+
+  def __str__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable

{layrz_sdk-3.0.9 → layrz_sdk-3.0.10}/layrz_sdk/entities/broadcasts/result.py

@@ -1,6 +1,6 @@
-""" Broadcast result """
+"""Broadcast result"""
+
 from datetime import datetime
-from typing import Self
 
 from .request import BroadcastRequest
 from .response import BroadcastResponse
@@ -21,7 +21,7 @@ class BroadcastResult:
   """
 
   def __init__(
-    self: Self,
+    self,
     service_id: int,
     asset_id: int,
     status: BroadcastStatus,
@@ -37,15 +37,17 @@ class BroadcastResult:
     self.submitted_at = submitted_at
 
   @property
-  def _readable(self: Self) -> str | None | bool:
-    """ Readable """
-    return f'BroadcastResult(service_id={self.service_id}, asset_id={self.asset_id}, status={self.status}, ' +\
-           f'request={self.request}, response={self.response}, submitted_at={self.submitted_at})'
+  def _readable(self) -> str | None | bool:
+    """Readable"""
+    return (
+      f'BroadcastResult(service_id={self.service_id}, asset_id={self.asset_id}, status={self.status}, '
+      + f'request={self.request}, response={self.response}, submitted_at={self.submitted_at})'
+    )
 
-  def __repr__(self: Self) -> str | None | bool:
-    """ Readable property """
+  def __repr__(self) -> str | None | bool:
+    """Readable property"""
     return self._readable
 
-  def __str__(self: Self) -> str | None | bool:
-    """ Readable property """
+  def __str__(self) -> str | None | bool:
+    """Readable property"""
     return self._readable

layrz_sdk-3.0.10/layrz_sdk/entities/broadcasts/service.py

@@ -0,0 +1,28 @@
+"""Service entity"""
+
+
+class OutboundService:
+  """
+  Outbound service definition
+  ---
+  Attributes
+    - pk : Service ID
+    - name : Service Name
+  """
+
+  def __init__(self, pk: int, name: str) -> str | None | bool:
+    self.pk = pk
+    self.name = name
+
+  @property
+  def _readable(self) -> str | None | bool:
+    """Readable"""
+    return f'OutboundService(pk={self.pk}, name={self.name})'
+
+  def __repr__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable
+
+  def __str__(self) -> str | None | bool:
+    """Readable property"""
+    return self._readable

{layrz_sdk-3.0.9 → layrz_sdk-3.0.10}/layrz_sdk/entities/broadcasts/status.py

@@ -1,10 +1,11 @@
-""" Broadcast result Status """
+"""Broadcast result Status"""
+
 from enum import Enum
-from typing import Self
 
 
 class BroadcastStatus(Enum):
-  """ Broadcast result status """
+  """Broadcast result status"""
+
   OK = 'OK'
   BADREQUEST = 'BADREQUEST'
   INTERNALERROR = 'INTERNALERROR'
@@ -13,14 +14,14 @@ class BroadcastStatus(Enum):
   DISCONNECTED = 'DISCONNECTED'
 
   @property
-  def _readable(self: Self) -> str | None | bool:
-    """ Readable """
+  def _readable(self) -> str | None | bool:
+    """Readable"""
     return f'BroadcastStatus.{self.value}'
 
-  def __str__(self: Self) -> str | None | bool:
-    """ Readable property """
+  def __str__(self) -> str | None | bool:
+    """Readable property"""
     return self._readable
 
-  def __repr__(self: Self) -> str | None | bool:
-    """ Readable property """
+  def __repr__(self) -> str | None | bool:
+    """Readable property"""
     return self._readable