unctools 0.1.0__py3-none-any.whl

unctools-0.1.0.dist-info/METADATA

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: unctools
+Version: 0.1.0
+Summary: A comprehensive toolkit for handling UNC paths, network drives, and substituted drives
+Home-page: https://github.com/djdacy/unctools
+Author: Dustin Darcy
+Author-email: Dustin Darcy <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/djdarcy/unctools
+Project-URL: Bug Reports, https://github.com/djdarcy/unctools/issues
+Project-URL: Source, https://github.com/djdarcy/unctools
+Project-URL: Documentation, https://github.com/djdarcy/unctools#readme
+Keywords: unc,network,windows,path,file,share,subst
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pathlib; python_version < "3.4"
+Provides-Extra: windows
+Requires-Dist: pywin32>=223; extra == "windows"
+Requires-Dist: pypiwin32>=223; extra == "windows"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.10.0; extra == "dev"
+Requires-Dist: flake8>=3.8.0; extra == "dev"
+Requires-Dist: black>=20.8b1; extra == "dev"
+Requires-Dist: tox>=3.20.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=4.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=0.5.0; extra == "docs"
+Requires-Dist: myst-parser>=0.15.0; extra == "docs"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# UNCtools
+
+A comprehensive toolkit for handling UNC paths, network drives, and substituted drives across different environments.
+
+## Features
+
+- Convert between UNC paths (\\\\server\\share) and local drive paths (Z:\\)
+- Detect UNC paths, network drives, and substituted drives
+- Handle Windows security zones for improved UNC path access
+- Provide high-level file operations that work seamlessly with UNC paths
+- Cross-platform compatibility with graceful degradation
+
+## Installation
+
+### Standard Installation
+
+```bash
+pip install unctools
+```
+
+### With Windows-specific Support
+
+```bash
+pip install unctools[windows]
+```
+
+### Development Mode
+
+For development and testing:
+
+```bash
+git clone https://github.com/yourusername/unctools.git
+cd unctools
+pip install -e .[dev]
+```
+
+## Usage
+
+### Basic Path Conversion
+
+```python
+from unctools import convert_to_local, convert_to_unc
+
+# Convert UNC path to local drive path
+local_path = convert_to_local("\\\\server\\share\\folder\\file.txt")
+# Result (if mapped): "Z:\\folder\\file.txt"
+
+# Convert local drive path back to UNC
+unc_path = convert_to_unc("Z:\\folder\\file.txt")
+# Result: "\\\\server\\share\\folder\\file.txt"
+```
+
+### Path Detection
+
+```python
+from unctools import is_unc_path, is_network_drive, is_subst_drive, get_path_type
+
+# Check if a path is a UNC path
+if is_unc_path("\\\\server\\share\\file.txt"):
+    print("This is a UNC path")
+
+# Check if a drive is a network drive
+if is_network_drive("Z:"):
+    print("Z: is a network drive")
+
+# Get the type of a path
+path_type = get_path_type("C:\\Users\\")
+# Result: "local", "network", "subst", "unc", etc.
+```
+
+### Safe File Operations
+
+```python
+from unctools import safe_open, safe_copy, batch_convert
+
+# Open a file, handling UNC paths automatically
+with safe_open("\\\\server\\share\\file.txt", "r") as f:
+    content = f.read()
+
+# Copy a file, handling path conversions
+safe_copy("\\\\server\\share\\file.txt", "local_copy.txt")
+
+# Convert multiple paths at once
+paths = ["\\\\server\\share\\file1.txt", "\\\\server\\share\\file2.txt"]
+converted = batch_convert(paths, to_unc=False)
+```
+
+### Windows Security Zones
+
+```python
+from unctools.windows import fix_security_zone, add_to_intranet_zone
+
+# Fix security zone issues for a server
+fix_security_zone("server")
+
+# Add a server to the Local Intranet zone
+add_to_intranet_zone("server")
+```
+
+### Network Drive Management
+
+```python
+from unctools.windows import create_network_mapping, remove_network_mapping
+
+# Create a network drive mapping
+success, drive = create_network_mapping("\\\\server\\share", "Z:")
+
+# Remove a network drive mapping
+remove_network_mapping("Z:")
+```
+
+## Platform Compatibility
+
+UNCtools is designed to work across various platforms:
+
+- **Windows**: Full functionality including security zones and network drive management
+- **Linux/macOS**: Basic path conversion and detection, with graceful degradation for Windows-specific features
+
+## Development
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Code Style
+
+```bash
+black unctools
+flake8 unctools
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

unctools-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+unctools/__init__.py,sha256=cji_gJGF-01x-ucOrQG0fU1YJ7FM8NlGGA8MoXGbCAA,3220
+unctools/converter.py,sha256=k1sm7Ltlss3XxK3hNypyG_5ltwwhaGn8MUN9UCIcC6U,13193
+unctools/detector.py,sha256=gQtXgXlH-hTsG3DJdDIUqDvN5To-cQNdwD-aoKK8INQ,16772
+unctools/operations.py,sha256=CCjHl8bIzaNHr0WaGYaUYdDkkKp6i1GQaMuumYDbf5c,22320
+unctools/utils/__init__.py,sha256=n_6aZ2-_5WtdBsHGJwK_MF_sTJaChVhy4Qpm4pGA8ls,1126
+unctools/utils/compat.py,sha256=bBUxLx9tJ0hjDgdcZE22GQYx3-Cqr7FOtQGxlAPkz5E,10452
+unctools/utils/logger.py,sha256=OGG01fDH5jImYeKHQb_VWEUelmKA4aoTGZDTyLNM21U,7117
+unctools/utils/validation.py,sha256=qBejCmdZSnCoiTTpX9YosAECe4W4tHMu9E1sY2Gq0Ds,10181
+unctools/windows/__init__.py,sha256=u770IPv5AJYeRwp_voMu_l9EBFhemw30CwVL1CFwTKM,1314
+unctools/windows/network.py,sha256=NbPqgagUB2PzPFOavIkJ3KeWS6y0g-wPOmgjslmmj8U,17601
+unctools/windows/registry.py,sha256=h8ZpkXJC9O13OacTmtgTIg6KQG6OGr3QnkRKpeGVNf4,14382
+unctools/windows/security.py,sha256=ZPa3OhimL5MSXereAQuEn5cnaKCHPTsAyj6MLCWolY8,20930
+unctools-0.1.0.dist-info/licenses/LICENSE,sha256=RQAVi2YlNpQjw2D-MUYldWco2xlAN5aIlfmAL4aNwzI,1069
+unctools-0.1.0.dist-info/METADATA,sha256=se4QQ_R8BQ0As94arQEE3FSHWcWSL4sblPqZP8IpFQo,5204
+unctools-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+unctools-0.1.0.dist-info/top_level.txt,sha256=h-Q1zzHpAbeMS7Rc121tixFXL-3ddudlbbzvkTJ1uFg,9
+unctools-0.1.0.dist-info/RECORD,,

unctools-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

unctools-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dustin Darcy
+
+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.

unctools-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+unctools