fspachinko 0.0.2__py3-none-any.whl

fspachinko-0.0.2.dist-info/METADATA

@@ -0,0 +1,322 @@
+Metadata-Version: 2.4
+Name: fspachinko
+Version: 0.0.2
+Summary: Transfer random files from directory A to directory B.
+Author: Wonyoung Jang
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: cyclopts>=4.4.5
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyinstaller>=6.18.0
+Requires-Dist: pyside6>=6.10.1
+Requires-Dist: qt-material>=2.17
+Requires-Python: >=3.14
+Project-URL: Documentation, https://wonyoung-jang.github.io/fspachinko/
+Project-URL: Repository, https://github.com/wonyoung-jang/fspachinko
+Project-URL: Issues, https://github.com/wonyoung-jang/fspachinko/issues
+Description-Content-Type: text/markdown
+
+# fspachinko
+
+Transfer random files from point A to point B. Customize what and how to transfer with various filters. Supports copy, move, symlink (shortcut), and hardlink transfer operations.
+
+## Installation (uv)
+
+```bash
+uv add fspachinko
+```
+
+or
+
+```bash
+uv tool install fspachinko
+```
+
+![Setup](resources/images/tab_output.png)
+![Filter](resources/images/tab_filters.png)
+![Options](resources/images/tab_options.png)
+
+## Usage
+
+fspachinko can be used via command-line interface (CLI) or graphical user interface (GUI).
+
+## Command Line Interface
+
+### Basic Usage
+
+```bash
+# Use configuration file
+fspachinko-cli --config your-fspachinko.json
+```
+
+## Graphical User Interface
+
+### Launch GUI
+
+```bash
+fspachinko-gui
+```
+
+Or simply:
+
+```bash
+fspachinko
+```
+
+### GUI Profiles
+
+Save frequently used configurations as profiles:
+
+1. Configure settings in the GUI
+2. Click **File → Save Profile As**
+3. Name your profile (e.g., "music_copy")
+4. Load later with **File → Load Profile**
+
+## Configuration File
+
+Create a `fspachinko.json` file for reusable configurations. Pass this to the CLI after the `--config` flag. The default (for Windows) is shown below:
+
+```json
+{
+    "root": "C:/",
+    "dest": "fspachinko_output/",
+    "filecount": {
+        "count": 20,
+        "is_rand_enabled": false,
+        "rand_min": 1,
+        "rand_max": 12
+    },
+    "folder": {
+        "should_create": true,
+        "is_unique": true,
+        "name": "test_folder_output",
+        "count": 10
+    },
+    "filename": {
+        "template": "{original}"
+    },
+    "transfermode": {
+        "transfer_mode": "Symlink",
+        "trash_empty_folder_enabled": false
+    },
+    "keyword": {
+        "is_enabled": true,
+        "should_include": true,
+        "text": ""
+    },
+    "extension": {
+        "is_enabled": true,
+        "should_include": true,
+        "text": "wav"
+    },
+    "filesize": {
+        "is_enabled": false,
+        "minimum": 0.0,
+        "maximum": 0.0
+    },
+    "duration": {
+        "is_enabled": false,
+        "minimum": 0.0,
+        "maximum": 0.0
+    },
+    "folder_size_limit": {
+        "is_enabled": false,
+        "size_limit": 500.0
+    },
+    "total_size_limit": {
+        "is_enabled": false,
+        "size_limit": 500.0
+    },
+    "options": {
+        "max_per_folder": 3,
+        "should_follow_symlink": false,
+        "is_dry_run": true
+    }
+}
+```
+
+## Example Configurations
+
+### Random Music Playlist
+
+```json
+{
+    "root": "~/Music",
+    "dest": "~/Playlists/Random",
+    "filecount": {
+        "count": 50,
+        ...
+    },
+    ...
+    "extension": {
+        "is_enabled": true,
+        "should_include": true,
+        "text": "wav,flac,m4a"
+    },
+    ...
+    "options": {
+        "max_per_folder": 2,
+        ...
+    }
+}
+```
+
+### Photo Gallery Selection
+
+```json
+{
+    "root": "~/Photos",
+    "dest": "~/Gallery",
+    "filecount": {
+        "count": 20,
+        ...
+    },
+    ...
+    "extension": {
+        "is_enabled": true,
+        "should_include": true,
+        "text": "jpg,png"
+    },
+    "filesize": {
+        "is_enabled": true,
+        "is_enabled": true,
+        "minimum": 1.0,
+        ...
+    },
+    "keyword": {
+        "should_include": false,
+        "text": "thumbnail,draft"
+    },
+    ...
+}
+```
+
+### Video Highlights
+
+```json
+{
+    "root": "~/Videos",
+    "dest": "~/Highlights",
+    "filecount": {
+        "count": 10,
+        ...
+    },
+    ...
+    "extension": {
+        "is_enabled": true,
+        "should_include": true,
+        "text": "mp4"
+    },
+    "duration": {
+        "is_enabled": true,
+        "minimum": 30.0,
+        "maximum": 600.0
+    },
+    ...
+}
+```
+
+### Safe Preview (Dry Run)
+
+```json
+{
+    "root": "/important/files",
+    "dest": "/backup",
+    "filecount": {
+        "count": 100,
+        ...
+    },
+    ...
+    "options": {
+        ...
+        "is_dry_run": true
+    }
+}
+```
+
+## Advanced Features
+
+### Output Filename Templates
+
+Use template variables in filenames:
+
+- `{original}`: Original filename
+- `{index}`: Sequential number
+- `{date}`: Current date (YYYY-MM-DD)
+- `{time}`: Current time (HH-MM-SS)
+- `{datetime}`: Combined date and time
+- `{parent}`: Parent folder name
+- `{parentstoroot}`: Full parent path separated by `-`
+
+Example: `{index}_{original}_{date}`: `photo.jpg` -> `1_photo_2026-01-25.jpg`
+
+### Logging
+
+Configure logging in a `json` file. Here is the default `fspachinko_configs/logging.json` provided:
+
+```json
+{
+    "version": 1,
+    "disable_existing_loggers": false,
+    "formatters": {
+        "file": {
+            "format": "[%(asctime)s] %(levelname)s[%(module)s] %(message)s"
+        },
+        "console": {
+            "format": "[%(asctime)s] %(levelname)s[%(module)s] %(message)s"
+        }
+    },
+    "handlers": {
+        "console": {
+            "class": "logging.StreamHandler",
+            "formatter": "console",
+            "level": "INFO",
+            "stream": "ext://sys.stdout"
+        },
+        "file": {
+            "class": "logging.FileHandler",
+            "formatter": "file",
+            "level": "DEBUG",
+            "filename": "fspachinko.log",
+            "mode": "w",
+            "encoding": "utf-8",
+            "delay": true
+        }
+    },
+    "root": {
+        "level": "DEBUG",
+        "handlers": [
+            "console",
+            "file"
+        ]
+    }
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**No files found:**
+
+- Check your filters (extension, keyword, size)
+- Verify source path exists and contains matching files
+- Try `--dry-run` to see what would be selected
+
+**Permission errors:**
+
+- Ensure read access to source directory
+- Ensure write access to destination directory
+- Try running with appropriate permissions
+
+**Hardlink errors:**
+
+- Source and destination must be on same filesystem
+- Not supported on all filesystems (e.g., FAT32)
+- Falls back to symlink automatically
+
+**Duration filter not working:**
+
+- Requires ffmpeg installed on system
+- Only works with media files (video/audio)
+- Check file format is supported by ffmpeg

fspachinko-0.0.2.dist-info/RECORD

@@ -0,0 +1,56 @@
+fspachinko/__init__.py,sha256=y70y6RtQXs-1isj4yhUZ5Cpx_NDXy09j9mmqeYmDaxo,149
+fspachinko/_data/configs/fspachinko.json,sha256=58Bee1oNAFoUWkhCAUpqaIhCRbLJy8pmCHtq9O3zmKE,1345
+fspachinko/_data/configs/logging.json,sha256=8qpFJUh4JKZieaXtvzygYZpgxGcjGu_rhvNxAm0yyr0,924
+fspachinko/_data/icons/add_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=nOgT_oGW2anAKuDsUyTDOENHo5SIMQqJh8ZEpIEZtLM,182
+fspachinko/_data/icons/close_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=hm9fnCle5muBGKgnpA_j-mW_59SLpG0KzmWroUwMNx4,222
+fspachinko/_data/icons/file_open_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=vwa_l1960SRIYaCnbd9bUcZsZJDFFPQbHYz9_5bKjkM,309
+fspachinko/_data/icons/folder_open_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=72ZHCcc-KFoKmz9zAIj5qb-RiCqhwDMO4PR_Xbd0eDg,353
+fspachinko/_data/icons/icon.icns,sha256=7oCQiX8t71yRLpxj8Bb0rg_jvpO2mxPA-xNxk2tLedE,40748
+fspachinko/_data/icons/icon.ico,sha256=wON-KKyX6VZP8JjtkudDy4GsHHnyq1fiBOEg1cWZVAY,74814
+fspachinko/_data/icons/play_arrow_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=wfcPR-6XCE5ZVjIqiZudbWHpxbqiQV50C0bGzHLLIo4,190
+fspachinko/_data/icons/remove_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=E21NyskQ_zG4Dxk-qeif5hqqwqGOzRu0_dgeEV9gAWs,149
+fspachinko/_data/icons/save_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=SaS4uoFP4F0d69MWBoZNIyoLHsRC6OHBZmdvTfajfIk,388
+fspachinko/_data/icons/save_as_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=b-MHohaDYZpUVm0kYMIu-a1K-6-toIqLGLYG_NC4Gw8,578
+fspachinko/_data/icons/stop_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=T8H9WTg95TcqQxmkLwjgm03EiNx7mfdJGvMAeMqasSg,192
+fspachinko/_data/icons/sync_24dp_E3E3E3_FILL0_wght400_GRAD0_opsz24.svg,sha256=iidUlXTe9JerwNGTiTfKr8ZJH9mszfy3rv_BQyXQ4R8,407
+fspachinko/_data/icons/windowIcon.png,sha256=2ZEQYqXCwbPBRWkGe3M3Sucu92MX25UaJuuFO1chl3c,54159
+fspachinko/cli/__init__.py,sha256=SCk8yOKuiusfPBi_7bioX9S4e7aC9Gb8CHQCJiJCJQk,35
+fspachinko/cli/__main__.py,sha256=c_bV8_7GU5AWk9fI5YgNY4xZShX5RW19baZQACmGYAA,325
+fspachinko/cli/app.py,sha256=pwlBtOBj72qSr4BN-MvYY8RlJcYq9QhknnndemJI2os,1651
+fspachinko/cli/observer.py,sha256=3bxSf1CszusEVPEcUx67rtKKJOZNW0RcZEWHj3JYg4Y,1095
+fspachinko/config/__init__.py,sha256=Ysjw8gyZv8hHwqNxL6Y2WmYGVtThWP6eiy8oMKXipQw,706
+fspachinko/config/config.py,sha256=DI4yzQdocFdQ8i_vJVjU3NRRqnFpLpE9KSmXeJHmJFo,6699
+fspachinko/config/converter.py,sha256=p4lS24h4iKfZQiYMRRQ0pDYbT60s_75g_LuImX-pyzQ,7568
+fspachinko/config/schemas.py,sha256=0BGEdKUWv6By03OglzqDb9Ruw5LEg8XvHaOl5LZv80I,2171
+fspachinko/core/__init__.py,sha256=z9JPaP4G22crswwVZqhLuCcC_65nV5ElboPrmFQpgf8,508
+fspachinko/core/builder.py,sha256=CDGwOfpzwzj3wL0x5ORN5e12ZlENS-NM9hxoAH1_7mo,3031
+fspachinko/core/engine.py,sha256=9eFjT-O8MPeMfrbOrfNkjwRsqRd-TlqhNRNhBkbKQOY,4223
+fspachinko/core/quota.py,sha256=M-Juyk3Rynfw7Eo61XzCqDLUGe2OrJmQA1QwidbUJb8,1451
+fspachinko/core/reporter.py,sha256=DXuZgQXsFYlab33KT4MidKylrSo2jtFQMHDaS6WvMig,2229
+fspachinko/core/state.py,sha256=491Nbd6PvoHiCtyTfWZQhku4Kkehj7tfFZAWkQFk3-Q,9551
+fspachinko/core/transfer.py,sha256=2X5OPe8lpsUAvgZVRaqycyVG4D-oISIRbVZ6vyHyHaI,3294
+fspachinko/core/validator.py,sha256=fnIGyWs5eyfQkaQQ9aQDte6McoUsxMkZBWnoTSlzWFQ,2240
+fspachinko/core/walker.py,sha256=gfIu0C3dLFFrPbYp6RoOSbjnxY3QkjHrBhuUNW-g_lk,5769
+fspachinko/gui/__init__.py,sha256=KDO53ikj1SljEnSNow9dDWScyExXadyQMIpqV_fl63U,20
+fspachinko/gui/__main__.py,sha256=9eAkAMjufR6u7d4B5vA4odF515EdG-QvqtZ-j547Km8,1200
+fspachinko/gui/actions.py,sha256=02r5SduGr1ZJLtV4z3jOn3RMcJE18QQVRuUob57P1nI,2427
+fspachinko/gui/centralwidget.py,sha256=R_sPDbTAjFUv88AVCwt65YssO_F1IrAQQu2SawUYl8c,2447
+fspachinko/gui/components.py,sha256=-qsPLoGbrEBqS0Zw97qDsKBMmHa8X6Y1UDYJ49G4g1c,22132
+fspachinko/gui/mainwindow.py,sha256=JaAIOlYHzeeEnt4JyJMmbrYXHm1dTbm6qKwCoG1duhA,5716
+fspachinko/gui/observer.py,sha256=ut3NGx2bEvzNfulJ7jpq_LoG3pYJUe_KfH7FtyyVRas,1380
+fspachinko/gui/qthelpers.py,sha256=xJRg9PhOPIhMelhISTljJ_zHkQeCbauh4iBkwrVL46A,2870
+fspachinko/gui/settings.py,sha256=-LW0d7PKh0WMr0zoV3ilynZZQ6I7fsqrOc_580-j4dk,1865
+fspachinko/gui/uibuilder.py,sha256=T9DTAgJCJg31Y8ag6Fzu6ypBxywTrIa4dzdTJ-izQk0,4950
+fspachinko/gui/workers.py,sha256=OoLOc9A3jRBXZ3ct39AE-rqGL0S79DqdlWnF4gpu1bE,1386
+fspachinko/utils/__init__.py,sha256=eT1vizibScj8srVkmCSaBZzVo3Kt2Pi9Ph4dWTNpSJo,1823
+fspachinko/utils/constants.py,sha256=haQIYWQ7lN-jYlfHm1kFgz4ntKoQvGAbLhBLZKpV88U,5193
+fspachinko/utils/helpers.py,sha256=CaBAt9pArvj0WYfPwHEZZLr8SZH4xaeKyo6twa92hyY,4293
+fspachinko/utils/interfaces.py,sha256=QTN8-LYUsClLrWRe-uRf9HClZd92lS5xx3VInlXzMkE,963
+fspachinko/utils/loggers.py,sha256=rCi7_zgEPS1RJRD2jN9gZnUsqv-dphKzNZ7kjs2Jg04,403
+fspachinko/utils/paths.py,sha256=kULkQImy0BUYHHdLUMhPgwmm744vbLcSGLhlUxQB8co,1004
+fspachinko/utils/timestamp.py,sha256=hFuis7cqFseMNoc6ACQUtuIkdh0PsA3WG6z9OA2mEFk,893
+fspachinko-0.0.2.dist-info/licenses/LICENSE,sha256=F1FWVuT7zcubFaT9Ht6LSJibItfcN4lRb3jZJYFUlRQ,1091
+fspachinko-0.0.2.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+fspachinko-0.0.2.dist-info/entry_points.txt,sha256=18_kvn_YIWGCFdLaKAO4kb4FabHnNj8Kb7ZyiBPKB7M,153
+fspachinko-0.0.2.dist-info/METADATA,sha256=ER704Gq053PEECGtn91gmuGNZaecFlRoBg17xHrg6Fo,6630
+fspachinko-0.0.2.dist-info/RECORD,,

fspachinko-0.0.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.30
+Root-Is-Purelib: true
+Tag: py3-none-any

fspachinko-0.0.2.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+fspachinko = fspachinko.gui.__main__:main
+fspachinko-cli = fspachinko.cli.__main__:main
+fspachinko-gui = fspachinko.gui.__main__:main
+

fspachinko-0.0.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wonyoung Jang
+
+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.