layrz-sdk 3.0.13__tar.gz → 3.1.0__tar.gz

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

@@ -0,0 +1,50 @@
+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:uv-3.13-x86
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Lint
+        run: |
+          uv sync --only-group dev
+          uv run ruff check
+          uv run mypy .
+
+  uniitest:
+    needs: lint
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/goldenm-software/python-builder:uv-3.13-x86
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Install dependencies
+        run: |
+          uv sync
+          uv run pytest ./tests/
+

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

@@ -0,0 +1,37 @@
+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:uv-3.13-x86
+      options: --user root
+      credentials:
+        username: ${{ github.repository_owner }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Build
+        run: |
+          uv venv --python 3.13
+          uv sync --only-group dev
+          uv run python -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.1.0/.gitignore

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

layrz_sdk-3.1.0/.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.1.0/.vscode/settings.json

@@ -0,0 +1,21 @@
+{
+  "[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,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true
+}

layrz_sdk-3.1.0/CHANGELOG.md

@@ -0,0 +1,334 @@
+# Changelog
+
+## 3.1.0
+
+- Migrated all models to Pydantic
+- Removed models `Transaction`.
+- Added `mypy` to the project to enforce type checking
+- Migrated from `uniitest` to `pytest` to the project to enforce unit testing
+
+## 3.0.14
+
+- Fixes on `GET_CUSTOM_FIELD` LCL function, now accepts a default value as the second argument (Fallback as '')
+
+## 3.0.13
+
+- Added `LastMessage` entity to be used in `Trigger`s
+
+## 3.0.12
+
+- Moved `Geofence` model from `checkpoints` to `general`
+- Added `PresenceType` enum to be used in `Event` model
+
+## 3.0.11
+
+- Added way to standarize the `int` and `float` arguments to `float`. Allowing comparison between `int` and `float` values in LCL formulas
+
+## 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 `Report` class
+
+## 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.1.0/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.1.0/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# 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.13 → layrz_sdk-3.1.0}/LICENSE

@@ -1,7 +1,7 @@
-Copyright 2020-2024 Layrz Limited
-
-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.
-
+Copyright 2020-2024 Layrz Limited
+
+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.

{layrz_sdk-3.0.13 → layrz_sdk-3.1.0}/PKG-INFO

@@ -1,45 +1,48 @@
-Metadata-Version: 2.1
-Name: layrz-sdk
-Version: 3.0.13
-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>
-License: MIT License
-Project-URL: Repository, https://github.com/goldenm-software/layrz-sdk
-Project-URL: Changelog, https://github.com/goldenm-software/layrz-sdk/blob/main/CHANGELOG.md
-Keywords: sdk,goldenm,lcl,layrz compute language,layrz
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: xlsxwriter
-Requires-Dist: tzdata
-
-# Layrz SDK
-
-Managed by Golden M, Inc.
-
-## Description
-It's a group of tools/classes/SDKs that can be help you to implement scripts into Layrz modules, or
-incorporate them into your own projects.
-
-## Requirements
-This library uses at least Python 3.10 or higher to work.
-
-If you want to encrypt MS Excel files, you need to have the [`msoffice`](https://github.com/herumi/msoffice) utility installed in your system.
-
-## Documentation
-It's available in our documentation site [developers.layrz.com](https://developers.layrz.com/Kits/Sdk)
-
-## Work with us
-Golden M is a software/hardware development company what is working on
-a new, innovative and disruptive technologies.
-
-For more information, contact us at [sales@goldenm.com](mailto:sales@goldenm.com)
-
-## License
-This project is under MIT License, for more information, check out the `LICENCE`
+Metadata-Version: 2.2
+Name: layrz-sdk
+Version: 3.1.0
+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>
+License: MIT License
+Project-URL: Repository, https://github.com/goldenm-software/layrz-sdk
+Project-URL: Changelog, https://github.com/goldenm-software/layrz-sdk/blob/main/CHANGELOG.md
+Keywords: sdk,goldenm,lcl,layrz compute language,layrz
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <3.14,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: xlsxwriter
+Requires-Dist: tzdata
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: typing-extensions>=4.10.0
+
+# Layrz SDK
+
+Managed by Golden M, Inc.
+
+## Description
+It's a group of tools/classes/SDKs that can be help you to implement scripts into Layrz modules, or
+incorporate them into your own projects.
+
+## Requirements
+This library uses at least Python 3.10 or higher to work.
+
+If you want to encrypt MS Excel files, you need to have the [`msoffice`](https://github.com/herumi/msoffice) utility installed in your system.
+
+## Documentation
+It's available in our documentation site [developers.layrz.com](https://developers.layrz.com/Kits/Sdk)
+
+## Work with us
+Golden M is a software/hardware development company what is working on
+a new, innovative and disruptive technologies.
+
+For more information, contact us at [sales@goldenm.com](mailto:sales@goldenm.com)
+
+## License
+This project is under MIT License, for more information, check out the `LICENCE`

{layrz_sdk-3.0.13 → layrz_sdk-3.1.0}/README.md

@@ -1,24 +1,24 @@
-# Layrz SDK
-
-Managed by Golden M, Inc.
-
-## Description
-It's a group of tools/classes/SDKs that can be help you to implement scripts into Layrz modules, or
-incorporate them into your own projects.
-
-## Requirements
-This library uses at least Python 3.10 or higher to work.
-
-If you want to encrypt MS Excel files, you need to have the [`msoffice`](https://github.com/herumi/msoffice) utility installed in your system.
-
-## Documentation
-It's available in our documentation site [developers.layrz.com](https://developers.layrz.com/Kits/Sdk)
-
-## Work with us
-Golden M is a software/hardware development company what is working on
-a new, innovative and disruptive technologies.
-
-For more information, contact us at [sales@goldenm.com](mailto:sales@goldenm.com)
-
-## License
-This project is under MIT License, for more information, check out the `LICENCE`
+# Layrz SDK
+
+Managed by Golden M, Inc.
+
+## Description
+It's a group of tools/classes/SDKs that can be help you to implement scripts into Layrz modules, or
+incorporate them into your own projects.
+
+## Requirements
+This library uses at least Python 3.10 or higher to work.
+
+If you want to encrypt MS Excel files, you need to have the [`msoffice`](https://github.com/herumi/msoffice) utility installed in your system.
+
+## Documentation
+It's available in our documentation site [developers.layrz.com](https://developers.layrz.com/Kits/Sdk)
+
+## Work with us
+Golden M is a software/hardware development company what is working on
+a new, innovative and disruptive technologies.
+
+For more information, contact us at [sales@goldenm.com](mailto:sales@goldenm.com)
+
+## License
+This project is under MIT License, for more information, check out the `LICENCE`

{layrz_sdk-3.0.13 → layrz_sdk-3.1.0}/layrz_sdk/__init__.py

@@ -1 +1 @@
-""" Layrz SDK Namespace """
+""" Layrz SDK Namespace """