usekit 0.1.1__tar.gz → 0.1.2__tar.gz

usekit-0.1.2/PKG-INFO

@@ -0,0 +1,256 @@
+Metadata-Version: 2.4
+Name: usekit
+Version: 0.1.2
+Summary: Minimal input, auto path toolkit (mobile-first, Colab+Drive)
+Author: ropnfop
+Author-email: withropnfop@gmail.com
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: PyYAML>=5.1
+Requires-Dist: python-dotenv>=0.19.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# usekit
+
+A lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
+
+**Code is not function, but memory.**
+
+```python
+from usekit import u
+
+u.wjb({"hello": "world"}, "config")     # write json to base
+data = u.rjb("config")                  # read json from base
+u.ujb({"version": "0.1.2"}, "config")   # update json
+```
+
+**3-letter interface**: Verb + Format + Location  
+Minimal typing. Maximum clarity.
+
+---
+
+## Installation
+
+```bash
+pip install usekit
+```
+
+---
+
+## Quick Start
+
+```python
+from usekit import u, s
+
+# Basic operations
+u.wjb({"key": "value"}, "config")       # write
+data = u.rjb("config")                  # read
+u.ujb({"new": "data"}, "config")        # update
+u.djb("old")                            # delete
+
+# Safe mode (returns None on error)
+data = s.rjb("missing") or {}           # no exceptions
+```
+
+---
+
+## Status
+
+- **Version**: 0.1.2 (Alpha)
+- **API**: May change
+- **PyPI**: https://pypi.org/project/usekit
+
+---
+
+## Core Pattern
+
+### 3-Letter Interface
+
+`u.[action][format][location]`
+
+```
+u.rjb()  →  read json base
+u.wys()  →  write yaml sub
+u.dtb()  →  delete text base
+```
+
+### Actions
+- **DATA**: `r`ead, `w`rite, `u`pdate, `d`elete, `e`xists
+- **NAVI**: `f`ind, `l`ist, `p`ath
+- **EXEC**: e`x`ec, `i`mp (import)
+
+### Formats
+- **Basic**: `j`son, `y`aml, `t`xt, `c`sv, `m`d
+- **Advanced**: `s`ql, `d`dl, `p`yp, `a`ny
+
+### Locations
+- `b`ase, `s`ub, `t`mp, `n`ow, `d`ir, `c`ache
+
+---
+
+## Examples
+
+### File Operations
+
+```python
+# JSON
+data = u.rjb("config")
+u.wjb({"key": "val"}, "output")
+
+# Different locations
+u.rjs("config")                         # read json sub
+u.wyt({"temp": "data"}, "cache")        # write yaml tmp
+```
+
+### Pattern Matching
+
+```python
+# Find with wildcards
+users = u.fjb("user_*")
+for item in users:
+    print(item["file"], item["data"])
+
+# List files
+files = u.ljb()                         # list all json in base
+```
+
+### SQL & DDL
+
+```python
+# Execute SQL
+results = u.xsb("SELECT * FROM users WHERE age > :age", 
+                params={"age": 20})
+
+# DDL with auto table name
+u.wdb("CREATE TABLE users (id INT, name TEXT)")
+# → creates users.sql
+
+# Dict to DDL
+u.wdb({
+    "table": "products",
+    "records": [{"id": 1, "name": "Apple"}]
+})
+# → creates products.sql with CREATE + INSERT
+```
+
+### Python Import
+
+```python
+# Write module
+u.wpb("""
+def add(a, b):
+    return a + b
+""", "mymod")
+
+# Import and use
+u.ipd("mymod : add")
+result = add(10, 20)                    # auto-injected
+```
+
+### Safe Mode
+
+```python
+from usekit import s
+
+data = s.rjb("missing") or {}           # no exception
+results = s.xsb("SELECT * FROM users") or []
+```
+
+---
+
+## Google Colab
+
+```python
+from google.colab import drive
+drive.mount("/content/drive")
+
+!pip install usekit
+from usekit import u, s
+
+data = "work_path = /content/drive/MyDrive/PROJECT"
+u.wtd(data, "output")
+print(u.rtd("output"))
+print(u.ftd("output"))
+
+# SQLite3
+s.xdb("CREATE TABLE items (id INT, name TEXT)")
+s.xsb("INSERT INTO items VALUES (?, ?)", pa=[(1, "apple")])
+results = u.xsb("SELECT * FROM items")
+print(results[0].id)
+```
+
+---
+
+## Configuration
+
+usekit auto-configures via `sys_const.yaml`:
+
+```yaml
+BASE_PATH: /content/drive/MyDrive/PROJECT
+
+DATA_PATH:
+  root: data
+  json: json/json_main
+  sql: table/sql/sql_main
+  ddl: table/ddl/ddl_main
+
+SYS_PATH:
+  tmp: data/tmp
+  cache: data/.cache
+```
+
+---
+
+## Philosophy: MOSA
+
+**Memory-Oriented Software Architecture**
+
+- Code is memory, not function
+- Semantic names over physical paths
+- Mobile-first design
+- Token economy (~65% savings)
+
+Built entirely on mobile devices from bed.
+
+---
+
+## Help
+
+```python
+u.help()                # overview
+u.help("quick")         # quick start
+u.help("examples")      # usage examples
+```
+
+---
+
+## Requirements
+
+**Core**: Python 3.7+, PyYAML, python-dotenv  
+**Optional**: pandas, sqlalchemy, beautifulsoup4
+
+---
+
+## Roadmap
+
+**v0.1.x (Alpha)**: Core DATA/NAVI, basic EXEC  
+**v0.2.x**: Complete EXEC layer  
+**v1.0.0**: Stable API, full docs
+
+---
+
+## License
+
+MIT License
+
+---
+
+**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP**
+
+*usekit - Code is memory, not function*

usekit-0.1.2/README.md

@@ -0,0 +1,238 @@
+# usekit
+
+A lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
+
+**Code is not function, but memory.**
+
+```python
+from usekit import u
+
+u.wjb({"hello": "world"}, "config")     # write json to base
+data = u.rjb("config")                  # read json from base
+u.ujb({"version": "0.1.2"}, "config")   # update json
+```
+
+**3-letter interface**: Verb + Format + Location  
+Minimal typing. Maximum clarity.
+
+---
+
+## Installation
+
+```bash
+pip install usekit
+```
+
+---
+
+## Quick Start
+
+```python
+from usekit import u, s
+
+# Basic operations
+u.wjb({"key": "value"}, "config")       # write
+data = u.rjb("config")                  # read
+u.ujb({"new": "data"}, "config")        # update
+u.djb("old")                            # delete
+
+# Safe mode (returns None on error)
+data = s.rjb("missing") or {}           # no exceptions
+```
+
+---
+
+## Status
+
+- **Version**: 0.1.2 (Alpha)
+- **API**: May change
+- **PyPI**: https://pypi.org/project/usekit
+
+---
+
+## Core Pattern
+
+### 3-Letter Interface
+
+`u.[action][format][location]`
+
+```
+u.rjb()  →  read json base
+u.wys()  →  write yaml sub
+u.dtb()  →  delete text base
+```
+
+### Actions
+- **DATA**: `r`ead, `w`rite, `u`pdate, `d`elete, `e`xists
+- **NAVI**: `f`ind, `l`ist, `p`ath
+- **EXEC**: e`x`ec, `i`mp (import)
+
+### Formats
+- **Basic**: `j`son, `y`aml, `t`xt, `c`sv, `m`d
+- **Advanced**: `s`ql, `d`dl, `p`yp, `a`ny
+
+### Locations
+- `b`ase, `s`ub, `t`mp, `n`ow, `d`ir, `c`ache
+
+---
+
+## Examples
+
+### File Operations
+
+```python
+# JSON
+data = u.rjb("config")
+u.wjb({"key": "val"}, "output")
+
+# Different locations
+u.rjs("config")                         # read json sub
+u.wyt({"temp": "data"}, "cache")        # write yaml tmp
+```
+
+### Pattern Matching
+
+```python
+# Find with wildcards
+users = u.fjb("user_*")
+for item in users:
+    print(item["file"], item["data"])
+
+# List files
+files = u.ljb()                         # list all json in base
+```
+
+### SQL & DDL
+
+```python
+# Execute SQL
+results = u.xsb("SELECT * FROM users WHERE age > :age", 
+                params={"age": 20})
+
+# DDL with auto table name
+u.wdb("CREATE TABLE users (id INT, name TEXT)")
+# → creates users.sql
+
+# Dict to DDL
+u.wdb({
+    "table": "products",
+    "records": [{"id": 1, "name": "Apple"}]
+})
+# → creates products.sql with CREATE + INSERT
+```
+
+### Python Import
+
+```python
+# Write module
+u.wpb("""
+def add(a, b):
+    return a + b
+""", "mymod")
+
+# Import and use
+u.ipd("mymod : add")
+result = add(10, 20)                    # auto-injected
+```
+
+### Safe Mode
+
+```python
+from usekit import s
+
+data = s.rjb("missing") or {}           # no exception
+results = s.xsb("SELECT * FROM users") or []
+```
+
+---
+
+## Google Colab
+
+```python
+from google.colab import drive
+drive.mount("/content/drive")
+
+!pip install usekit
+from usekit import u, s
+
+data = "work_path = /content/drive/MyDrive/PROJECT"
+u.wtd(data, "output")
+print(u.rtd("output"))
+print(u.ftd("output"))
+
+# SQLite3
+s.xdb("CREATE TABLE items (id INT, name TEXT)")
+s.xsb("INSERT INTO items VALUES (?, ?)", pa=[(1, "apple")])
+results = u.xsb("SELECT * FROM items")
+print(results[0].id)
+```
+
+---
+
+## Configuration
+
+usekit auto-configures via `sys_const.yaml`:
+
+```yaml
+BASE_PATH: /content/drive/MyDrive/PROJECT
+
+DATA_PATH:
+  root: data
+  json: json/json_main
+  sql: table/sql/sql_main
+  ddl: table/ddl/ddl_main
+
+SYS_PATH:
+  tmp: data/tmp
+  cache: data/.cache
+```
+
+---
+
+## Philosophy: MOSA
+
+**Memory-Oriented Software Architecture**
+
+- Code is memory, not function
+- Semantic names over physical paths
+- Mobile-first design
+- Token economy (~65% savings)
+
+Built entirely on mobile devices from bed.
+
+---
+
+## Help
+
+```python
+u.help()                # overview
+u.help("quick")         # quick start
+u.help("examples")      # usage examples
+```
+
+---
+
+## Requirements
+
+**Core**: Python 3.7+, PyYAML, python-dotenv  
+**Optional**: pandas, sqlalchemy, beautifulsoup4
+
+---
+
+## Roadmap
+
+**v0.1.x (Alpha)**: Core DATA/NAVI, basic EXEC  
+**v0.2.x**: Complete EXEC layer  
+**v1.0.0**: Stable API, full docs
+
+---
+
+## License
+
+MIT License
+
+---
+
+**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP**
+
+*usekit - Code is memory, not function*

{usekit-0.1.1 → usekit-0.1.2}/setup.py

@@ -5,7 +5,7 @@ HERE = Path(__file__).parent
 
 setup(
     name="usekit",
-    version="0.1.1",  # pyproject랑 맞추거나 여기 기준으로 통일
+    version="0.1.2",  # ⚠️ pyproject랑 맞추거나 여기 기준으로 통일
     author="ropnfop",
     author_email="withropnfop@gmail.com",
     description="Minimal input, auto path toolkit (mobile-first, Colab+Drive)",
@@ -13,7 +13,7 @@ setup(
     long_description_content_type="text/markdown",
 
     packages=find_packages(),   # 루트 usekit 구조와 딱 맞음
-    include_package_data=True,  # 핵심
+    include_package_data=True,  # ⭐ 핵심
 
     package_data={
         "usekit": [

{usekit-0.1.1 → usekit-0.1.2}/usekit/classes/common/fileops/helper_restore.py

@@ -10,6 +10,71 @@ from typing import Optional, List, Dict, Any
 from datetime import datetime
 import shutil
 
+# ===============================================================================
+# Restore point
+# ===============================================================================
+
+def select_restore_point(
+    target: Path,
+    restore: Any,
+    backup_dir: Optional[Path] = None,
+    debug: bool = False
+) -> Optional[Dict[str, Any]]:
+    """
+    Select a restore point using restore selector.
+
+    restore:
+        - True        : latest backup
+        - int (>=1)   : N-th backup (1-based), using list_restore_points order
+        - str         : full backup name or suffix such as '20251201.001'
+
+    Returns:
+        Backup info dict from list_restore_points() or None.
+    """
+    restore_points = list_restore_points(
+        target=target,
+        backup_dir=backup_dir,
+        show_details=False,
+    )
+    if not restore_points:
+        if debug:
+            print(f"[RESTORE] No backups for target: {target}")
+        return None
+
+    # 1) restore=True → latest (가장 최근)
+    if restore is True:
+        # list_restore_points 를 최신순/오래된순 중 어느 쪽으로 정렬했는지에 따라
+        # 필요하면 [-1] ↔ [0] 조정
+        return restore_points[-1]
+
+    # 2) restore=int → N-th (1-based index)
+    if isinstance(restore, int):
+        idx = restore - 1
+        if 0 <= idx < len(restore_points):
+            return restore_points[idx]
+        if debug:
+            print(f"[RESTORE] Invalid restore index: {restore}")
+        return None
+
+    # 3) restore=str → full name or suffix
+    if isinstance(restore, str):
+        # full name match
+        for point in restore_points:
+            if point["name"] == restore:
+                return point
+
+        # suffix match (e.g., '20251201.001')
+        for point in restore_points:
+            if point["name"].endswith(restore):
+                return point
+
+        if debug:
+            print(f"[RESTORE] No backup matched restore={restore}")
+        return None
+
+    if debug:
+        print(f"[RESTORE] Unsupported restore type: {type(restore)}")
+    return None
 
 # ===============================================================================
 # Restore

{usekit-0.1.1 → usekit-0.1.2}/usekit/classes/common/utils/helper_path.py

@@ -193,7 +193,7 @@ def get_smart_path(
     
     if fmt == "any":
         if mod in ext_map:
-            fmt = mod           
+            fmt = mod
         fmt_set = "pkl" if loc== "cache" else mod
         fmt_actual = get_format_set(fmt_set)
     else:

{usekit-0.1.1 → usekit-0.1.2}/usekit/classes/data/base/load/dbl_ops_loader.py

@@ -1,4 +1,4 @@
-# Path: usekit.classes.data.base.base_loader.loader_data.py
+# Path: usekit.classes.data.base.load.dbl_ops_loader.py
 # -----------------------------------------------------------------------------------------------
 #  DataLd - Thin wrapper over operation modules
 #  Created by: THE Little Prince × ROP × FOP
@@ -68,6 +68,9 @@ class DataLd:
             >>> loader.read(name="%test%", keydata="email")
         """
         mod = mod or "all"
+        
+        # Allow user-provided debug to override instance debug
+        debug = kwargs.pop('debug', self.debug_mode)
 
         return read_operation(
             fmt=self.fmt,
@@ -80,7 +83,7 @@ class DataLd:
             default=default,
             recursive=recursive,
             find_all=find_all,
-            debug=self.debug_mode,
+            debug=debug,
             **kwargs
         )
 
@@ -100,6 +103,9 @@ class DataLd:
     ) -> Optional[Path]:
         """Write operation"""
         mod = mod or "all"
+        
+        # Allow user-provided debug to override instance debug
+        debug = kwargs.pop('debug', self.debug_mode)
 
         return write_operation(
             fmt=self.fmt,
@@ -112,7 +118,7 @@ class DataLd:
             keydata=keydata,
             create_missing=create_missing,
             recursive=recursive,
-            debug=self.debug_mode,
+            debug=debug,
             **kwargs
         )
 
@@ -132,6 +138,9 @@ class DataLd:
     ) -> Optional[Path]:
         """Update operation"""
         mod = mod or "all"
+        
+        # Allow user-provided debug to override instance debug
+        debug = kwargs.pop('debug', self.debug_mode)
 
         return update_operation(
             fmt=self.fmt,
@@ -144,7 +153,7 @@ class DataLd:
             keydata=keydata,
             create_missing=create_missing,
             recursive=recursive,
-            debug=self.debug_mode,
+            debug=debug,
             **kwargs
         )
 
@@ -162,6 +171,9 @@ class DataLd:
     ) -> Optional[Path]:
         """Delete operation"""
         mod = mod or "all"
+        
+        # Allow user-provided debug to override instance debug
+        debug = kwargs.pop('debug', self.debug_mode)
 
         return delete_operation(
             fmt=self.fmt,
@@ -172,7 +184,7 @@ class DataLd:
             cus=cus,
             keydata=keydata,
             recursive=recursive,
-            debug=self.debug_mode,
+            debug=debug,
             **kwargs
         )
 
@@ -185,9 +197,13 @@ class DataLd:
         cus: Optional[str] = None,
         keydata: Optional[str | list[str]] = None,
         recursive: bool = False,
+        **kwargs
     ) -> bool:
         """Exists check with pattern support"""
         mod = mod or "all"
+        
+        # Allow user-provided debug to override instance debug
+        debug = kwargs.pop('debug', self.debug_mode)
 
         return exists_operation(
             fmt=self.fmt,
@@ -198,7 +214,7 @@ class DataLd:
             cus=cus,
             keydata=keydata,
             recursive=recursive,
-            debug=self.debug_mode,
+            debug=debug,
         )
 
     # ----------------------------------------------------------------
@@ -252,4 +268,4 @@ class DataLd:
 
     def __repr__(self) -> str:
         """String representation of DataLd instance."""
-        return f"DataLd(fmt={self.fmt!r}, debug={self.debug_mode})"
+        return f"DataLd(fmt={self.fmt!r}, debug={self.debug_mode})"