onlyone 2.4.3__tar.gz

onlyone-2.4.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 initumX (initum.x@gmail.com)
+
+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.

onlyone-2.4.3/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: onlyone
+Version: 2.4.3
+Summary: Fast duplicate file finder with optional GUI
+Author-email: initumX <initum.x@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: xxhash>=3.0.0
+Requires-Dist: send2trash>=1.8.0
+Provides-Extra: gui
+Requires-Dist: PySide6; extra == "gui"
+Requires-Dist: Pillow>=9.0.0; extra == "gui"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+
+# [OnlyOne](https://initumx.github.io/onlyone/)
+
+![screenshot](/deduplicator224.png "Main Window")
+
+A PyQt-based tool for finding and removing duplicate files with advanced filtering and progress tracking.
+
+*Note: GUI-version is "extra"(not mandatory part), so to install app with gui, use:
+
+`pip install onlyone[gui]`
+
+### How to install and run
+    ### First Way - use venv (virtual environment)
+    1. Create python virtual environment and go there: 
+    python3 venv ~/onlyone && cd ~/onlyone
+    -----
+    2. Activate it:
+    source ~/onlyone/bin/activate
+    -----
+    3.Install onlyone into it: 
+    pip install onlyone[gui]
+    -----
+    Done.
+    Now you can run `onlyone` or `onlyone-gui` commands from your virtual environment
+
+    ### Second Way - wait for build release :)
+
+### Features
+      Filters files by file size and extension
+      -------
+      Sorts files inside duplicate groups by path depth and filename length
+      ------
+      Supports deduplication modes: fast, normal, full
+      ------
+      Preview images directly in the interface (in gui-version)
+      ------
+      Progress tracking both for searching duplicates and deleting them (in gui-version)
+      -------
+      Statistics/report
+      ------
+      Context menu (open, reveal in explorer and delete file(s) options)
+      ------
+      One click deletion (delete all duplicates at once)
+      ------
+      Manage priority directories
+
+### How does it work?
+    1. Recursively scans folder using filters (min/max size, extension)
+    2. Apply the cheapest check first (compare by size)
+    3. Further checking depends on mode: 
+      a) "fast": checks hash-sum of first 64+ KB of files (false positives very possible)
+      b) "normal": checks hash-sum of 3 parts of the file: front -> middle -> end (generally reliable)
+      c) "full": checks hash-sum of front -> middle -> entire file (very slow for large files)
+    4. Shows the list of groups sorted in descending order (groups with larger files come first). 
+    --------
+    Files inside a group are sorted by path/filename length (you can regulate this).
+
+### Deleting all duplicates at once
+    The main principle: ALL files moved to trash EXCEPT the FIRST file in each group.
+    ---
+    Which file is "first" depends on sorting:
+      Priority files(files from "Priority Folders", if set) always come first
+      Among priorities: file with shortest path (by default) comes first
+      Among non-priorities: same rule (shortest path is used by default for in-group sorting)
+      If both files have the same path depth, the file with shortest filename wins the first place.
+
+      REMEMBER: In the end, there can be only one file/per group :)
+---
+
+
+### How to use cli-version
+    Examples:
+    ----------
+    Basic usage - find duplicates in Downloads folder
+    `onlyone -i ~/Downloads`
+
+    Filter files by size and extensions and find duplicates
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png`
+
+    Same as above + move duplicates to trash (with confirmation prompt)
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png --keep-one`
+
+    Same as above but without confirmation and with output to a file (for scripts)
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png --keep-one --force > ~/Downloads/report.txt`
+    
+    Options:
+    ---------
+    -i, --input          input folder
+    -m, --min-size       min size filter
+    -M, --max-size       max size filter
+    -x, --extensions,    extension filter(comma separated)
+    -p, --priority-dirs  priority dirs(comma or space separated)
+
+    --mode [fast, normal, full]                   searching mode (normal by default)
+    --sort [shortest-path, shortest-filename]     sorting inside a group (shortest-path by default)
+
+    --keep-one            Keep one file/per group and move the rest to trash (one confirmation)
+    --keep-one --force    Keep one file/per group and move the rest to trash (no confirmation)
+    --verbose, -v         Show detailed statistics and progress
+    --help, -h            Show help file
+---
+
+### Boring stuff
+
+    ## Built With
+        - Python 3.x
+        - PySide6 (Qt)
+        - send2trash
+        - PIL/Pillow (for image handling)
+        - xxhash
+
+    ## TESTS
+        pytest tests/ -v
+
+    ## How to build with Pyinstaller
+    `pyinstaller --noconfirm --clean --noconsole \
+                --onefile --exclude-module=PySide6.QtNetwork main_window.py`
+
+    Or just download binary from [realeases](https://github.com/initumX/onlyone/releases)   
+
+    Check out [website](https://initumx.github.io/onlyone/)
+
+© 2026 initumX (initum.x@gmail.com)
+
+
+
+
+
+
+

onlyone-2.4.3/README.md

@@ -0,0 +1,130 @@
+
+# [OnlyOne](https://initumx.github.io/onlyone/)
+
+![screenshot](/deduplicator224.png "Main Window")
+
+A PyQt-based tool for finding and removing duplicate files with advanced filtering and progress tracking.
+
+*Note: GUI-version is "extra"(not mandatory part), so to install app with gui, use:
+
+`pip install onlyone[gui]`
+
+### How to install and run
+    ### First Way - use venv (virtual environment)
+    1. Create python virtual environment and go there: 
+    python3 venv ~/onlyone && cd ~/onlyone
+    -----
+    2. Activate it:
+    source ~/onlyone/bin/activate
+    -----
+    3.Install onlyone into it: 
+    pip install onlyone[gui]
+    -----
+    Done.
+    Now you can run `onlyone` or `onlyone-gui` commands from your virtual environment
+
+    ### Second Way - wait for build release :)
+
+### Features
+      Filters files by file size and extension
+      -------
+      Sorts files inside duplicate groups by path depth and filename length
+      ------
+      Supports deduplication modes: fast, normal, full
+      ------
+      Preview images directly in the interface (in gui-version)
+      ------
+      Progress tracking both for searching duplicates and deleting them (in gui-version)
+      -------
+      Statistics/report
+      ------
+      Context menu (open, reveal in explorer and delete file(s) options)
+      ------
+      One click deletion (delete all duplicates at once)
+      ------
+      Manage priority directories
+
+### How does it work?
+    1. Recursively scans folder using filters (min/max size, extension)
+    2. Apply the cheapest check first (compare by size)
+    3. Further checking depends on mode: 
+      a) "fast": checks hash-sum of first 64+ KB of files (false positives very possible)
+      b) "normal": checks hash-sum of 3 parts of the file: front -> middle -> end (generally reliable)
+      c) "full": checks hash-sum of front -> middle -> entire file (very slow for large files)
+    4. Shows the list of groups sorted in descending order (groups with larger files come first). 
+    --------
+    Files inside a group are sorted by path/filename length (you can regulate this).
+
+### Deleting all duplicates at once
+    The main principle: ALL files moved to trash EXCEPT the FIRST file in each group.
+    ---
+    Which file is "first" depends on sorting:
+      Priority files(files from "Priority Folders", if set) always come first
+      Among priorities: file with shortest path (by default) comes first
+      Among non-priorities: same rule (shortest path is used by default for in-group sorting)
+      If both files have the same path depth, the file with shortest filename wins the first place.
+
+      REMEMBER: In the end, there can be only one file/per group :)
+---
+
+
+### How to use cli-version
+    Examples:
+    ----------
+    Basic usage - find duplicates in Downloads folder
+    `onlyone -i ~/Downloads`
+
+    Filter files by size and extensions and find duplicates
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png`
+
+    Same as above + move duplicates to trash (with confirmation prompt)
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png --keep-one`
+
+    Same as above but without confirmation and with output to a file (for scripts)
+    `onlyone -i .~/Downloads -m 500KB -M 10MB -x .jpg,.png --keep-one --force > ~/Downloads/report.txt`
+    
+    Options:
+    ---------
+    -i, --input          input folder
+    -m, --min-size       min size filter
+    -M, --max-size       max size filter
+    -x, --extensions,    extension filter(comma separated)
+    -p, --priority-dirs  priority dirs(comma or space separated)
+
+    --mode [fast, normal, full]                   searching mode (normal by default)
+    --sort [shortest-path, shortest-filename]     sorting inside a group (shortest-path by default)
+
+    --keep-one            Keep one file/per group and move the rest to trash (one confirmation)
+    --keep-one --force    Keep one file/per group and move the rest to trash (no confirmation)
+    --verbose, -v         Show detailed statistics and progress
+    --help, -h            Show help file
+---
+
+### Boring stuff
+
+    ## Built With
+        - Python 3.x
+        - PySide6 (Qt)
+        - send2trash
+        - PIL/Pillow (for image handling)
+        - xxhash
+
+    ## TESTS
+        pytest tests/ -v
+
+    ## How to build with Pyinstaller
+    `pyinstaller --noconfirm --clean --noconsole \
+                --onefile --exclude-module=PySide6.QtNetwork main_window.py`
+
+    Or just download binary from [realeases](https://github.com/initumX/onlyone/releases)   
+
+    Check out [website](https://initumx.github.io/onlyone/)
+
+© 2026 initumX (initum.x@gmail.com)
+
+
+
+
+
+
+

onlyone-2.4.3/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "onlyone"
+version = "2.4.3"
+description = "Fast duplicate file finder with optional GUI"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    {name = "initumX", email = "initum.x@gmail.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities"
+]
+dependencies = [
+    "xxhash>=3.0.0",
+    "send2trash>=1.8.0"
+]
+
+[project.optional-dependencies]
+gui = [
+    "PySide6",
+    "Pillow>=9.0.0"
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-qt>=4.0",
+    "pytest-cov>=4.0"
+]
+
+[project.scripts]
+onlyone = "onlyone.cli:main"
+onlyone-gui = "onlyone.gui.launcher:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["onlyone*"]

onlyone-2.4.3/setup.cfg

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

onlyone-2.4.3/src/onlyone/__init__.py

@@ -0,0 +1,43 @@
+"""
+OnlyOne — fast duplicate file finder with optional GUI.
+
+Core features:
+- Three deduplication modes: FAST (size + front hash), NORMAL (size + 3 partial hashes), FULL (size + full content hash)
+- Safe deletion to system trash (via send2trash)
+- Optional GUI with PySide6 (install with [gui] extra)
+- CLI interface for headless/server usage
+"""
+
+# Get version
+try:
+    from importlib.metadata import version as _version
+    __version__ = _version("onlyone")
+except Exception:
+    try:
+        import tomllib  # Python 3.11+
+    except ImportError:
+        import tomli as tomllib  # Python < 3.11: pip install tomli
+
+    with open("pyproject.toml", "rb") as f:
+        __version__ = tomllib.load(f)["project"]["version"]
+
+# Public API — only what users should import directly
+from onlyone.commands import DeduplicationCommand
+#from .cli import main as cli_main
+from onlyone.core import DeduplicationParams, DeduplicationMode, SortOrder, File, DuplicateGroup
+from onlyone.utils.convert_utils import ConvertUtils
+from onlyone.services import DuplicateService
+from onlyone.services.file_service import FileService
+
+__all__ = [
+    "DeduplicationCommand",
+    "DeduplicationParams",
+    "DeduplicationMode",
+    "SortOrder",
+    "File",
+    "DuplicateGroup",
+    "ConvertUtils",
+    "DuplicateService",
+    "FileService",
+    "__version__",
+]