pinginstaller 1.0.0__tar.gz

pinginstaller-1.0.0/LICENSE

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

pinginstaller-1.0.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.1
+Name: pinginstaller
+Version: 1.0.0
+Summary: Light-weight interface for running PING ecosystem (PINGMapper, etc.)
+Author: Cameron Bodine
+Author-email: bodine.cs@gmail.email
+Project-URL: Issues, https://github.com/CameronBodine/PINGInstaller/issues
+Project-URL: GitHub, https://github.com/CameronBodine/PINGInstaller
+Project-URL: Homepage, https://cameronbodine.github.io/PINGMapper/
+Keywords: pingmapper,sonar,ecology,remotesensing,sidescan,sidescan-sonar,aquatic,humminbird,lowrance,gis,oceanography,limnology
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Scientific/Engineering :: Oceanography
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Hydrology
+Requires-Python: >3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# PINGInstaller
+Light-weight application for installing [PINGMapper](https://github.com/CameronBodine/PINGMapper) and associated packages. `PINGInstaller` is designed to install a `conda` environment from a yml specified as a URL or localy hosted yml.
+
+Example yml file structure:
+
+```bash
+name: ping
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  - python < 3.13
+  - gdal
+  - numpy
+  - git
+  - pandas
+  - geopandas
+  - pyproj
+  - scikit-image
+  - joblib
+  - matplotlib
+  - rasterio
+  - h5py
+  - pip
+  - pip:
+      - pingverter
+      - pingmapper
+      - pingwizard
+      - pinginstaller
+      - doodleverse_utils
+      - psutil
+      - tensorflow
+      - tf-keras
+      - transformers
+      - pysimplegui == 5.0.*
+```
+
+The special thing about `PINGInstaller` is that it will install the `conda` environment based on the `conda` prompt it is launched from. This enables end-users with multiple `conda` installations to choose the flavor of `conda` as needed. 
+
+Supported prompts include (but may not be limited to):
+
+- [Miniforge](https://conda-forge.org/download/)
+- [Miniconda](https://docs.anaconda.com/miniconda/install/)
+- [Anaconda](https://www.anaconda.com/download)
+- [ArcGIS Python Command Prompt](https://pro.arcgis.com/en/pro-app/3.3/arcpy/get-started/installing-python-for-arcgis-pro.htm)
+
+`PINGInstaller` is also compatible with projects in the [Doodlevers](https://github.com/settings/organizations).
+
+## Installation & Usage
+
+### Step 1
+
+Open (download, if not already available) the `conda` prompt you want to use (ex: On Windows 11 - Start --> All --> Anaconda (miniconda3) --> Anaconda Powershell Prompt).
+
+### Step 2
+
+Install `PINGInstaller` in the `base` environment with:
+
+```bash
+pip install pinginstaller
+```
+
+### Step 3
+
+Then install the environment from a web or locally hosted yml with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+That's it! Your environment is now ready to use.
+
+If you want to update the environment, simply re-run the environment installation script with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+Ta-ta for now!
+

pinginstaller-1.0.0/README.md

@@ -0,0 +1,80 @@
+# PINGInstaller
+Light-weight application for installing [PINGMapper](https://github.com/CameronBodine/PINGMapper) and associated packages. `PINGInstaller` is designed to install a `conda` environment from a yml specified as a URL or localy hosted yml.
+
+Example yml file structure:
+
+```bash
+name: ping
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  - python < 3.13
+  - gdal
+  - numpy
+  - git
+  - pandas
+  - geopandas
+  - pyproj
+  - scikit-image
+  - joblib
+  - matplotlib
+  - rasterio
+  - h5py
+  - pip
+  - pip:
+      - pingverter
+      - pingmapper
+      - pingwizard
+      - pinginstaller
+      - doodleverse_utils
+      - psutil
+      - tensorflow
+      - tf-keras
+      - transformers
+      - pysimplegui == 5.0.*
+```
+
+The special thing about `PINGInstaller` is that it will install the `conda` environment based on the `conda` prompt it is launched from. This enables end-users with multiple `conda` installations to choose the flavor of `conda` as needed. 
+
+Supported prompts include (but may not be limited to):
+
+- [Miniforge](https://conda-forge.org/download/)
+- [Miniconda](https://docs.anaconda.com/miniconda/install/)
+- [Anaconda](https://www.anaconda.com/download)
+- [ArcGIS Python Command Prompt](https://pro.arcgis.com/en/pro-app/3.3/arcpy/get-started/installing-python-for-arcgis-pro.htm)
+
+`PINGInstaller` is also compatible with projects in the [Doodlevers](https://github.com/settings/organizations).
+
+## Installation & Usage
+
+### Step 1
+
+Open (download, if not already available) the `conda` prompt you want to use (ex: On Windows 11 - Start --> All --> Anaconda (miniconda3) --> Anaconda Powershell Prompt).
+
+### Step 2
+
+Install `PINGInstaller` in the `base` environment with:
+
+```bash
+pip install pinginstaller
+```
+
+### Step 3
+
+Then install the environment from a web or locally hosted yml with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+That's it! Your environment is now ready to use.
+
+If you want to update the environment, simply re-run the environment installation script with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+Ta-ta for now!
+

pinginstaller-1.0.0/pinginstaller/Install_Update_PINGMapper.py

@@ -0,0 +1,103 @@
+import os, sys
+import subprocess, re
+import json
+
+def install_housekeeping(conda_key):
+
+    subprocess.run('''"{}" update -y conda'''.format(conda_key), shell=True)
+    subprocess.run('''"{}" clean -y --all'''.format(conda_key), shell=True)
+    subprocess.run('''python -m pip install --upgrade pip''', shell=True)
+
+def conda_env_exists(conda_key, env_name):
+
+    result = subprocess.run('''"{}" env list'''.format(conda_key), shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+    envs = result.stdout.splitlines()
+    for env in envs:
+        if re.search(rf'^{env_name}\s', env):
+            return True
+    return False
+
+def install(conda_key, yml):
+
+    subprocess.run('''"{}" env create --file "{}"'''.format(conda_key, yml), shell=True)
+
+    subprocess.run('conda env list', shell=True)
+
+    return
+
+def update(conda_key, yml):
+
+    subprocess.run('''"{}" env update --file "{}" --prune'''.format(conda_key, yml), shell=True)
+
+    subprocess.run('conda env list', shell=True)
+
+    return
+
+
+# def install_update(conda_base, conda_key):
+def install_update(yml):
+
+    subprocess.run('conda env list', shell=True)
+
+    ####################
+    # Make the conda key
+    ## This is the 'base' of the currently used conda prompt
+    ## Tested with miniconda and miniforge.
+    ## Assume works for Anaconda.
+    env_dir = os.environ['CONDA_PREFIX']
+
+    conda_key = os.path.join(env_dir, 'Scripts', 'conda.exe')
+
+    # Above doesn't work for ArcGIS conda installs
+    ## Make sure conda exists, if not, change to CONDA
+    if not os.path.exists(conda_key):
+        conda_key = os.environ.get('CONDA_EXE', 'conda')
+
+    print('conda_key:', conda_key)
+
+    ##############
+    # Housekeeping
+    install_housekeeping(conda_key)
+
+    ##############
+    # Download yml
+
+    # Download yml if necessary
+    del_yml = False
+    if yml.startswith("https:") or yml.startswith("http:"):
+        print("Downloading:", yml)
+
+        # Make sure ?raw=true at end
+        if not yml.endswith("?raw=true"):
+            yml += "?raw=true"
+        from pinginstaller.download_yml import get_yml
+        yml = get_yml(yml)
+
+        print("Downloaded yml:", yml)
+        del_yml = True
+
+    ######################
+    # Get environment name
+    with open(yml, 'r') as f:
+        for line in f:
+            if line.startswith('name:'):
+                env_name = line.split('name:')[-1].strip()
+
+    ######################################
+    # Install or update `ping` environment
+    if conda_env_exists(conda_key, env_name):
+        print(f"Updating '{env_name}' environment ...")
+        # subprocess.run([os.path.join(directory, "Update.bat"), conda_base, conda_key, yml], shell=True)
+        update(conda_key, yml)
+        
+    else:
+        print(f"Creating '{env_name}' environment...")
+        # subprocess.run([os.path.join(directory, "Install.bat"), conda_base, conda_key, yml], shell=True)
+        install(conda_key, yml)
+
+    #########
+    # Cleanup
+    if del_yml:
+        os.remove(yml)
+
+    

pinginstaller-1.0.0/pinginstaller/__init__.py

@@ -0,0 +1,2 @@
+
+from .version import __version__

pinginstaller-1.0.0/pinginstaller/__main__.py

@@ -0,0 +1,25 @@
+
+import os, sys
+
+# Add 'pingwizard' to the path, may not need after pypi package...
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+PACKAGE_DIR = os.path.dirname(SCRIPT_DIR)
+sys.path.append(PACKAGE_DIR)
+
+# Get yml
+if len(sys.argv) == 1:
+    yml = "https://github.com/CameronBodine/PINGMapper/blob/dev_v4/pingmapper/conda/PINGMapper.yml"
+else:
+    yml = sys.argv[1]
+
+def main(yml):
+
+    print('Env yml:', yml)
+
+    from pinginstaller.Install_Update_PINGMapper import install_update
+    install_update(yml)
+
+    return
+
+if __name__ == '__main__':
+    main(yml)

pinginstaller-1.0.0/pinginstaller/download_yml.py

@@ -0,0 +1,20 @@
+import os, sys
+import urllib.request
+
+from pathlib import Path
+home_path = os.path.join(Path.home())
+
+def get_yml(url):
+
+    # Get yml data from github
+    with urllib.request.urlopen(url) as f:
+        yml_data = f.read().decode('utf-8')
+
+        # Make a temporary file
+        temp_file = os.path.join(home_path, 'pinginstaller_conda_file.yml')
+        
+        # Write yml data to temporary file
+        with open(temp_file, 'w') as t:
+            t.write(yml_data)
+
+    return temp_file

pinginstaller-1.0.0/pinginstaller/version.py

@@ -0,0 +1 @@
+__version__ = '1.0.0'

pinginstaller-1.0.0/pinginstaller.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.1
+Name: pinginstaller
+Version: 1.0.0
+Summary: Light-weight interface for running PING ecosystem (PINGMapper, etc.)
+Author: Cameron Bodine
+Author-email: bodine.cs@gmail.email
+Project-URL: Issues, https://github.com/CameronBodine/PINGInstaller/issues
+Project-URL: GitHub, https://github.com/CameronBodine/PINGInstaller
+Project-URL: Homepage, https://cameronbodine.github.io/PINGMapper/
+Keywords: pingmapper,sonar,ecology,remotesensing,sidescan,sidescan-sonar,aquatic,humminbird,lowrance,gis,oceanography,limnology
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Scientific/Engineering :: Oceanography
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Hydrology
+Requires-Python: >3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# PINGInstaller
+Light-weight application for installing [PINGMapper](https://github.com/CameronBodine/PINGMapper) and associated packages. `PINGInstaller` is designed to install a `conda` environment from a yml specified as a URL or localy hosted yml.
+
+Example yml file structure:
+
+```bash
+name: ping
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  - python < 3.13
+  - gdal
+  - numpy
+  - git
+  - pandas
+  - geopandas
+  - pyproj
+  - scikit-image
+  - joblib
+  - matplotlib
+  - rasterio
+  - h5py
+  - pip
+  - pip:
+      - pingverter
+      - pingmapper
+      - pingwizard
+      - pinginstaller
+      - doodleverse_utils
+      - psutil
+      - tensorflow
+      - tf-keras
+      - transformers
+      - pysimplegui == 5.0.*
+```
+
+The special thing about `PINGInstaller` is that it will install the `conda` environment based on the `conda` prompt it is launched from. This enables end-users with multiple `conda` installations to choose the flavor of `conda` as needed. 
+
+Supported prompts include (but may not be limited to):
+
+- [Miniforge](https://conda-forge.org/download/)
+- [Miniconda](https://docs.anaconda.com/miniconda/install/)
+- [Anaconda](https://www.anaconda.com/download)
+- [ArcGIS Python Command Prompt](https://pro.arcgis.com/en/pro-app/3.3/arcpy/get-started/installing-python-for-arcgis-pro.htm)
+
+`PINGInstaller` is also compatible with projects in the [Doodlevers](https://github.com/settings/organizations).
+
+## Installation & Usage
+
+### Step 1
+
+Open (download, if not already available) the `conda` prompt you want to use (ex: On Windows 11 - Start --> All --> Anaconda (miniconda3) --> Anaconda Powershell Prompt).
+
+### Step 2
+
+Install `PINGInstaller` in the `base` environment with:
+
+```bash
+pip install pinginstaller
+```
+
+### Step 3
+
+Then install the environment from a web or locally hosted yml with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+That's it! Your environment is now ready to use.
+
+If you want to update the environment, simply re-run the environment installation script with:
+
+```bash
+python -m pinginstaller https://github.com/CameronBodine/PINGMapper/blob/main/conda/PINGMapper.yml
+```
+
+Ta-ta for now!
+

pinginstaller-1.0.0/pinginstaller.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+setup.py
+pinginstaller/Install_Update_PINGMapper.py
+pinginstaller/__init__.py
+pinginstaller/__main__.py
+pinginstaller/download_yml.py
+pinginstaller/version.py
+pinginstaller.egg-info/PKG-INFO
+pinginstaller.egg-info/SOURCES.txt
+pinginstaller.egg-info/dependency_links.txt
+pinginstaller.egg-info/top_level.txt

pinginstaller-1.0.0/pinginstaller.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pinginstaller-1.0.0/pinginstaller.egg-info/top_level.txt

@@ -0,0 +1 @@
+pinginstaller

pinginstaller-1.0.0/setup.cfg

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

pinginstaller-1.0.0/setup.py

@@ -0,0 +1,51 @@
+
+from setuptools import setup, find_packages
+from pathlib import Path
+
+DESCRIPTION = 'Light-weight interface for running PING ecosystem (PINGMapper, etc.)'
+LONG_DESCRIPTION = Path('README.md').read_text()
+
+exec(open('pinginstaller/version.py').read())
+
+setup(
+    name="pinginstaller",
+    version=__version__,
+    author="Cameron Bodine",
+    author_email="bodine.cs@gmail.email",
+    description=DESCRIPTION,
+    long_description=LONG_DESCRIPTION,
+    long_description_content_type='text/markdown',
+    packages=find_packages(),
+    # data_files=[("pingmapper_config", ["pinginstaller/PINGMapper.yml"])],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Scientific/Engineering",
+        "Topic :: Scientific/Engineering :: Visualization",
+        "Topic :: Scientific/Engineering :: Oceanography",
+        "Topic :: Scientific/Engineering :: GIS",
+        "Topic :: Scientific/Engineering :: Hydrology"
+        ],
+    keywords=[
+        "pingmapper",
+        "sonar",
+        "ecology",
+        "remotesensing",
+        "sidescan",
+        "sidescan-sonar",
+        "aquatic",
+        "humminbird",
+        "lowrance",
+        "gis",
+        "oceanography",
+        "limnology",],
+    python_requires=">3",
+    install_requires=[],
+    project_urls={
+        "Issues": "https://github.com/CameronBodine/PINGInstaller/issues",
+        "GitHub":"https://github.com/CameronBodine/PINGInstaller",
+        "Homepage":"https://cameronbodine.github.io/PINGMapper/",
+    },
+)