arc-utils 1.3__tar.gz → 1.4.0__tar.gz

{arc_utils-1.3 → arc_utils-1.4.0}/LICENSE.txt

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2018 Grant Herbert
-
-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
+MIT License
+
+Copyright (c) 2018 Grant Herbert
+
+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.

{arc_utils-1.3 → arc_utils-1.4.0}/PKG-INFO

@@ -1,117 +1,117 @@
-Metadata-Version: 2.4
-Name: arc-utils
-Version: 1.3
-Summary: Python utilities for use with Esri ArcGIS Pro software
-Author-email: Grant Herbert <gdherbert@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/gdherbert/arc_utils
-Project-URL: Download, https://github.com/gdherbert/arc_utils/tree/1.3
-Keywords: esri,arcpy,arcgis
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Operating System :: Microsoft :: Windows
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Dynamic: license-file
-
-# README #
-
-
-### What is this repository for? ###
-* A collection of (mostly) arcpy related utilities for use within ArcGIS Pro (Python 3).
-Shortcuts for accessing elements of a map document, performing various data discovery tasks on a table or geodatabase
-
-### How do I get set up? ###
-
-Install from PyPI:
-
-```bash
-pip install arc-utils
-```
-
-For local development and editable usage from clone:
-
-```bash
-python -m pip install -e .
-```
-
-To use the utilities:
-
-* in the python window in ArcGIS Pro
-
-``import arc_utils as au``
-
-* typing ``au.`` will now reveal the modules and functions available to you if you have autocomplete on
-
-* Depends on arcpy (only available with Esri license)
-
-### Example usage ###
-
-``import arc_utils as au``
-
-``tbl = au.table.TableObj(path to featureclass)``
-
-# list all fields 
-
-``print(tbl.fields)``
-
-``pro_doc = au.aprx.AprxObj(“CURRENT”)``
-
-``pro_doc.maps`` >> [<arcpy._mp.Map object at 0x000001A4AECBF108>, <arcpy._mp.Map object at 0x000001A4AEBB6608>]
-
-``pro_doc.maps[0].name`` >> ‘Map’
-
-### Accepted Input Types ###
-
-Most path parameters now accept:
-
-* string path
-* ``pathlib.Path`` / other path-like objects
-* wrapper objects with ``.path``
-* ArcGIS layer/table objects with ``.catalogPath`` or ``.dataSource`` (where applicable)
-
-Invalid paths raise ``ValueError("invalid path")``.
-
-Constructor acceptance is preserved (for example, passing path-like and wrapper objects directly to ``TableObj``, ``GDBObj``, and ``AprxObj``).
-
-### Exporting field values to Excel ###
-
-```python
-import arc_utils as au
-from openpyxl import Workbook
-
-# Single table export with class method
-tbl = au.table.TableObj(r"C:\path\to\featureclass")
-wb = Workbook()
-ws = wb.active
-tbl.export_fields_to_worksheet(ws)
-wb.save(r"C:\path\to\schema_values.xlsx")
-```
-
-```python
-# Multi-layer export with module function
-layers = [r"C:\path\to\layer1", r"C:\path\to\layer2"]
-au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx")
-```
-
-```python
-# Worksheet naming behavior:
-# use_lyr_alias=True -> prefer alias/name (human-readable)
-# use_lyr_alias=False -> use full table path (traceable)
-au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx", use_lyr_alias=True)
-au.table.export_field_sets(layers, r"C:\path\to\all_layers_by_path.xlsx", use_lyr_alias=False)
-```
-
-```python
-# Duplicate detection outputs
-tbl = au.table.TableObj(r"C:\path\to\featureclass")
-dup_values = tbl.find_duplicate_field_values("STATUS", output="set")
-dup_rows_df = tbl.find_duplicate_field_values(["STATUS", "TYPE"], output="df")
-```
-
-### Contribution guidelines ###
-
-Contributions welcomed, this is a starting point for various utilities that I think could be useful within ArcGIS Pro.
+Metadata-Version: 2.4
+Name: arc-utils
+Version: 1.4.0
+Summary: Python utilities for use with Esri ArcGIS Pro software
+Author-email: Grant Herbert <gdherbert@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/gdherbert/arc_utils
+Project-URL: Download, https://github.com/gdherbert/arc_utils/tree/1.3
+Keywords: esri,arcpy,arcgis
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+# README #
+
+
+### What is this repository for? ###
+* A collection of (mostly) arcpy related utilities for use within ArcGIS Pro (Python 3).
+Shortcuts for accessing elements of a map document, performing various data discovery tasks on a table or geodatabase
+
+### How do I get set up? ###
+
+Install from PyPI:
+
+```bash
+pip install arc-utils
+```
+
+For local development and editable usage from clone:
+
+```bash
+python -m pip install -e .
+```
+
+To use the utilities:
+
+* in the python window in ArcGIS Pro
+
+``import arc_utils as au``
+
+* typing ``au.`` will now reveal the modules and functions available to you if you have autocomplete on
+
+* Depends on arcpy (only available with Esri license)
+
+### Example usage ###
+
+``import arc_utils as au``
+
+``tbl = au.table.TableObj(path to featureclass)``
+
+# list all fields 
+
+``print(tbl.fields)``
+
+``pro_doc = au.aprx.AprxObj(“CURRENT”)``
+
+``pro_doc.maps`` >> [<arcpy._mp.Map object at 0x000001A4AECBF108>, <arcpy._mp.Map object at 0x000001A4AEBB6608>]
+
+``pro_doc.maps[0].name`` >> ‘Map’
+
+### Accepted Input Types ###
+
+Most path parameters now accept:
+
+* string path
+* ``pathlib.Path`` / other path-like objects
+* wrapper objects with ``.path``
+* ArcGIS layer/table objects with ``.catalogPath`` or ``.dataSource`` (where applicable)
+
+Invalid paths raise ``ValueError("invalid path")``.
+
+Constructor acceptance is preserved (for example, passing path-like and wrapper objects directly to ``TableObj``, ``GDBObj``, and ``AprxObj``).
+
+### Exporting field values to Excel ###
+
+```python
+import arc_utils as au
+from openpyxl import Workbook
+
+# Single table export with class method
+tbl = au.table.TableObj(r"C:\path\to\featureclass")
+wb = Workbook()
+ws = wb.active
+tbl.export_fields_to_worksheet(ws)
+wb.save(r"C:\path\to\schema_values.xlsx")
+```
+
+```python
+# Multi-layer export with module function
+layers = [r"C:\path\to\layer1", r"C:\path\to\layer2"]
+au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx")
+```
+
+```python
+# Worksheet naming behavior:
+# use_lyr_alias=True -> prefer alias/name (human-readable)
+# use_lyr_alias=False -> use full table path (traceable)
+au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx", use_lyr_alias=True)
+au.table.export_field_sets(layers, r"C:\path\to\all_layers_by_path.xlsx", use_lyr_alias=False)
+```
+
+```python
+# Duplicate detection outputs
+tbl = au.table.TableObj(r"C:\path\to\featureclass")
+dup_values = tbl.find_duplicate_field_values("STATUS", output="set")
+dup_rows_df = tbl.find_duplicate_field_values(["STATUS", "TYPE"], output="df")
+```
+
+### Contribution guidelines ###
+
+Contributions welcomed, this is a starting point for various utilities that I think could be useful within ArcGIS Pro.

{arc_utils-1.3 → arc_utils-1.4.0}/README.md

@@ -1,98 +1,98 @@
-# README #
-
-
-### What is this repository for? ###
-* A collection of (mostly) arcpy related utilities for use within ArcGIS Pro (Python 3).
-Shortcuts for accessing elements of a map document, performing various data discovery tasks on a table or geodatabase
-
-### How do I get set up? ###
-
-Install from PyPI:
-
-```bash
-pip install arc-utils
-```
-
-For local development and editable usage from clone:
-
-```bash
-python -m pip install -e .
-```
-
-To use the utilities:
-
-* in the python window in ArcGIS Pro
-
-``import arc_utils as au``
-
-* typing ``au.`` will now reveal the modules and functions available to you if you have autocomplete on
-
-* Depends on arcpy (only available with Esri license)
-
-### Example usage ###
-
-``import arc_utils as au``
-
-``tbl = au.table.TableObj(path to featureclass)``
-
-# list all fields 
-
-``print(tbl.fields)``
-
-``pro_doc = au.aprx.AprxObj(“CURRENT”)``
-
-``pro_doc.maps`` >> [<arcpy._mp.Map object at 0x000001A4AECBF108>, <arcpy._mp.Map object at 0x000001A4AEBB6608>]
-
-``pro_doc.maps[0].name`` >> ‘Map’
-
-### Accepted Input Types ###
-
-Most path parameters now accept:
-
-* string path
-* ``pathlib.Path`` / other path-like objects
-* wrapper objects with ``.path``
-* ArcGIS layer/table objects with ``.catalogPath`` or ``.dataSource`` (where applicable)
-
-Invalid paths raise ``ValueError("invalid path")``.
-
-Constructor acceptance is preserved (for example, passing path-like and wrapper objects directly to ``TableObj``, ``GDBObj``, and ``AprxObj``).
-
-### Exporting field values to Excel ###
-
-```python
-import arc_utils as au
-from openpyxl import Workbook
-
-# Single table export with class method
-tbl = au.table.TableObj(r"C:\path\to\featureclass")
-wb = Workbook()
-ws = wb.active
-tbl.export_fields_to_worksheet(ws)
-wb.save(r"C:\path\to\schema_values.xlsx")
-```
-
-```python
-# Multi-layer export with module function
-layers = [r"C:\path\to\layer1", r"C:\path\to\layer2"]
-au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx")
-```
-
-```python
-# Worksheet naming behavior:
-# use_lyr_alias=True -> prefer alias/name (human-readable)
-# use_lyr_alias=False -> use full table path (traceable)
-au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx", use_lyr_alias=True)
-au.table.export_field_sets(layers, r"C:\path\to\all_layers_by_path.xlsx", use_lyr_alias=False)
-```
-
-```python
-# Duplicate detection outputs
-tbl = au.table.TableObj(r"C:\path\to\featureclass")
-dup_values = tbl.find_duplicate_field_values("STATUS", output="set")
-dup_rows_df = tbl.find_duplicate_field_values(["STATUS", "TYPE"], output="df")
-```
-
-### Contribution guidelines ###
-
-Contributions welcomed, this is a starting point for various utilities that I think could be useful within ArcGIS Pro.
+# README #
+
+
+### What is this repository for? ###
+* A collection of (mostly) arcpy related utilities for use within ArcGIS Pro (Python 3).
+Shortcuts for accessing elements of a map document, performing various data discovery tasks on a table or geodatabase
+
+### How do I get set up? ###
+
+Install from PyPI:
+
+```bash
+pip install arc-utils
+```
+
+For local development and editable usage from clone:
+
+```bash
+python -m pip install -e .
+```
+
+To use the utilities:
+
+* in the python window in ArcGIS Pro
+
+``import arc_utils as au``
+
+* typing ``au.`` will now reveal the modules and functions available to you if you have autocomplete on
+
+* Depends on arcpy (only available with Esri license)
+
+### Example usage ###
+
+``import arc_utils as au``
+
+``tbl = au.table.TableObj(path to featureclass)``
+
+# list all fields 
+
+``print(tbl.fields)``
+
+``pro_doc = au.aprx.AprxObj(“CURRENT”)``
+
+``pro_doc.maps`` >> [<arcpy._mp.Map object at 0x000001A4AECBF108>, <arcpy._mp.Map object at 0x000001A4AEBB6608>]
+
+``pro_doc.maps[0].name`` >> ‘Map’
+
+### Accepted Input Types ###
+
+Most path parameters now accept:
+
+* string path
+* ``pathlib.Path`` / other path-like objects
+* wrapper objects with ``.path``
+* ArcGIS layer/table objects with ``.catalogPath`` or ``.dataSource`` (where applicable)
+
+Invalid paths raise ``ValueError("invalid path")``.
+
+Constructor acceptance is preserved (for example, passing path-like and wrapper objects directly to ``TableObj``, ``GDBObj``, and ``AprxObj``).
+
+### Exporting field values to Excel ###
+
+```python
+import arc_utils as au
+from openpyxl import Workbook
+
+# Single table export with class method
+tbl = au.table.TableObj(r"C:\path\to\featureclass")
+wb = Workbook()
+ws = wb.active
+tbl.export_fields_to_worksheet(ws)
+wb.save(r"C:\path\to\schema_values.xlsx")
+```
+
+```python
+# Multi-layer export with module function
+layers = [r"C:\path\to\layer1", r"C:\path\to\layer2"]
+au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx")
+```
+
+```python
+# Worksheet naming behavior:
+# use_lyr_alias=True -> prefer alias/name (human-readable)
+# use_lyr_alias=False -> use full table path (traceable)
+au.table.export_field_sets(layers, r"C:\path\to\all_layers.xlsx", use_lyr_alias=True)
+au.table.export_field_sets(layers, r"C:\path\to\all_layers_by_path.xlsx", use_lyr_alias=False)
+```
+
+```python
+# Duplicate detection outputs
+tbl = au.table.TableObj(r"C:\path\to\featureclass")
+dup_values = tbl.find_duplicate_field_values("STATUS", output="set")
+dup_rows_df = tbl.find_duplicate_field_values(["STATUS", "TYPE"], output="df")
+```
+
+### Contribution guidelines ###
+
+Contributions welcomed, this is a starting point for various utilities that I think could be useful within ArcGIS Pro.

arc_utils-1.4.0/arc_utils/__init__.py

@@ -0,0 +1,16 @@
+"""A collection of python utilities for ArcGIS Pro
+"""
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+	__version__ = version('arc-utils')
+except PackageNotFoundError:
+	__version__ = '0+unknown'
+
+__author__ = 'Grant Herbert'
+
+__all__ = ['aprx.py', 'gdb.py', 'table.py']
+
+from arc_utils import gdb
+from arc_utils import table
+from arc_utils import aprx