spio 0.0.6.post12__tar.gz

spio-0.0.6.post12/LICENSE.md

@@ -0,0 +1,19 @@
+MIT License
+
+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.

spio-0.0.6.post12/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.1
+Name: spio
+Version: 0.0.6.post12
+Summary: Magical Marvin SharePoint Library
+Author: Roeland Maes
+Author-email: roeland.maes@vito.be
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: full
+Provides-Extra: pandas
+Provides-Extra: pandas-parquet
+Provides-Extra: pandas-xlsx
+Requires-Dist: Office365-REST-Python-Client (>=2.3,<3.0)
+Requires-Dist: msal_extensions (>=0.3,<0.4)
+Description-Content-Type: text/markdown
+
+
+# Spio
+
+## Description
+
+Spio is a Python package that provides functionalities for reading and writing data to a SharePoint.
+It can also handle various types of spatial and non-spatial data formats such as GeoTIFF, GeoPackage, NetCDF, CSV, Excel, and more.
+
+## Installation
+
+To install the package, you can use the following command:
+
+```bash
+    pip config set global.extra-index-url https://repo.vito.be/artifactory/api/pypi/marvin-projects-pypi-local/simple
+    pip install spio 
+```
+
+If you want to install the package with all the dependencies, you can use the following command:
+
+```bash
+    pip install spio[full]
+```
+
+## Building from Source
+
+To build the package from source you can use the following commands:
+
+```bash
+    git clone https://git.vito.be/projects/MARVIN/repos/sharepoint_tools
+    cd sharepoint_tools
+    conda create -f conda_env.yml
+    conda activate spio 
+    poetry install
+```
+
+## Configuration
+
+Before using the package, you need to configure the settings to match your environment. 
+The configuration is managed through a `settings` module which should include all the necessary configurations.
+
+### **Settings Configuration**:
+   Ensure you have a `settings` file (e.g., `.secrets.yaml` or `settings.yaml`) that provides the necessary configuration options. Example:
+
+```python
+    from dynaconf import Dynaconf
+
+    settings = Dynaconf(
+        settings_files=['settings.yaml', '.secrets.yaml']
+    )
+```
+   
+   The settings file should include the following configurations:
+    
+```yaml
+    user_account: your.name@vito.be
+```
+
+### **Initialize Spio with Settings**:
+   You need to initialize Spio with your settings before using any functionalities.
+
+```python
+    from config import settings
+    from marvin.tools import spio
+
+    spio.init_spio(settings)
+```
+
+## Usage
+
+Here are some example usages of the package:
+
+### Reading Data
+
+- **Read GeoTIFF using Rasterio**:
+
+```python
+    from marvin.tools.spio import read_geotiff_rasterio
+
+    geotiff_data = read_geotiff_rasterio('path/to/your/geotiff/file.tif')
+```
+
+- **Read GeoPackage**:
+
+```python
+    from marvin.tools.spio import read_geopackage
+
+    geopackage_data = read_geopackage('path/to/your/geopackage/file.gpkg')
+```
+
+- **Read NetCDF**:
+
+```python
+    from marvin.tools.spio import read_netcdf
+
+    netcdf_data = read_netcdf('path/to/your/netcdf/file.nc')
+```
+
+- **Read CSV**:
+
+```python
+    from marvin.tools.spio import read_csv
+
+    csv_data = read_csv('path/to/your/csv/file.csv')
+```
+
+### Writing Data
+
+- **Write CSV**:
+
+```python
+    from marvin.tools.spio import write_csv
+
+    write_csv('path/to/your/output/file.csv', csv_data)
+```
+
+- **Write Excel**:
+
+```python
+    from marvin.tools.spio import write_excel
+
+    write_excel('path/to/your/output/file.xlsx', excel_data)
+```
+
+### Additional Functionalities
+
+Spio also provides additional functions to handle different data formats and processes.
+You can explore these in the https://git.vito.be/projects/MARVIN/repos/sharepoint_tools/browse/test/tst_spio.py file for more complex scenarios such as writing to OneDrive, processing NetCDF4 files, and more.
+
+
+## Contributing
+
+If you want to contribute to spio, please follow the standard contributing guidelines and push your changes to a new branch in
+https://git.vito.be/projects/MARVIN/repos/sharepoint_tools
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE.md file for details.
+

spio-0.0.6.post12/README.md

@@ -0,0 +1,137 @@
+
+# Spio
+
+## Description
+
+Spio is a Python package that provides functionalities for reading and writing data to a SharePoint.
+It can also handle various types of spatial and non-spatial data formats such as GeoTIFF, GeoPackage, NetCDF, CSV, Excel, and more.
+
+## Installation
+
+To install the package, you can use the following command:
+
+```bash
+    pip config set global.extra-index-url https://repo.vito.be/artifactory/api/pypi/marvin-projects-pypi-local/simple
+    pip install spio 
+```
+
+If you want to install the package with all the dependencies, you can use the following command:
+
+```bash
+    pip install spio[full]
+```
+
+## Building from Source
+
+To build the package from source you can use the following commands:
+
+```bash
+    git clone https://git.vito.be/projects/MARVIN/repos/sharepoint_tools
+    cd sharepoint_tools
+    conda create -f conda_env.yml
+    conda activate spio 
+    poetry install
+```
+
+## Configuration
+
+Before using the package, you need to configure the settings to match your environment. 
+The configuration is managed through a `settings` module which should include all the necessary configurations.
+
+### **Settings Configuration**:
+   Ensure you have a `settings` file (e.g., `.secrets.yaml` or `settings.yaml`) that provides the necessary configuration options. Example:
+
+```python
+    from dynaconf import Dynaconf
+
+    settings = Dynaconf(
+        settings_files=['settings.yaml', '.secrets.yaml']
+    )
+```
+   
+   The settings file should include the following configurations:
+    
+```yaml
+    user_account: your.name@vito.be
+```
+
+### **Initialize Spio with Settings**:
+   You need to initialize Spio with your settings before using any functionalities.
+
+```python
+    from config import settings
+    from marvin.tools import spio
+
+    spio.init_spio(settings)
+```
+
+## Usage
+
+Here are some example usages of the package:
+
+### Reading Data
+
+- **Read GeoTIFF using Rasterio**:
+
+```python
+    from marvin.tools.spio import read_geotiff_rasterio
+
+    geotiff_data = read_geotiff_rasterio('path/to/your/geotiff/file.tif')
+```
+
+- **Read GeoPackage**:
+
+```python
+    from marvin.tools.spio import read_geopackage
+
+    geopackage_data = read_geopackage('path/to/your/geopackage/file.gpkg')
+```
+
+- **Read NetCDF**:
+
+```python
+    from marvin.tools.spio import read_netcdf
+
+    netcdf_data = read_netcdf('path/to/your/netcdf/file.nc')
+```
+
+- **Read CSV**:
+
+```python
+    from marvin.tools.spio import read_csv
+
+    csv_data = read_csv('path/to/your/csv/file.csv')
+```
+
+### Writing Data
+
+- **Write CSV**:
+
+```python
+    from marvin.tools.spio import write_csv
+
+    write_csv('path/to/your/output/file.csv', csv_data)
+```
+
+- **Write Excel**:
+
+```python
+    from marvin.tools.spio import write_excel
+
+    write_excel('path/to/your/output/file.xlsx', excel_data)
+```
+
+### Additional Functionalities
+
+Spio also provides additional functions to handle different data formats and processes.
+You can explore these in the https://git.vito.be/projects/MARVIN/repos/sharepoint_tools/browse/test/tst_spio.py file for more complex scenarios such as writing to OneDrive, processing NetCDF4 files, and more.
+
+
+## Contributing
+
+If you want to contribute to spio, please follow the standard contributing guidelines and push your changes to a new branch in
+https://git.vito.be/projects/MARVIN/repos/sharepoint_tools
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE.md file for details.

spio-0.0.6.post12/pyproject.toml

@@ -0,0 +1,26 @@
+
+[tool.poetry]
+name = "spio"
+version = "0.0.0"
+description = "Magical Marvin SharePoint Library"
+authors = ["Roeland Maes <roeland.maes@vito.be>", "Thomas Danckaert <thomas.danckaert@vito.be>"]
+packages = [
+    { include = "src/marvin" }
+]
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+msal_extensions = "^0.3"
+Office365-REST-Python-Client = "^2.3"
+
+[tool.poetry.extras]
+pandas = ["pandas"]
+pandas_xlsx = ["pandas", "xlsxwriter"]
+pandas_parquet = ["pandas", "pyarrow"]
+full = ["numpy", "pyproj", "gdal", "cfgrib", "dynaconf", "pandas", "netcdf4", "h5netcdf", "pyarrow", "geopandas", "fiona", "rasterio", "matplotlib", "openpyxl", "xlsxwriter", "pyexcelerate"]
+
+[tool.poetry-git-version-plugin]
+make_alpha_version = true
+
+

spio-0.0.6.post12/src/marvin/tools/default_config.ini

@@ -0,0 +1,11 @@
+
+[default]
+graph_url=https://graph.microsoft.com/
+sharepoint_host=yourhost.sharepoint.com
+user_account=some.user@mail.abc
+
+[msal]
+client_id=xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+authority=https://login.microsoftonline.com/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+auth_method=device
+scopes=["Files.ReadWrite", "User.ReadWrite"]