usekit 0.2.0__tar.gz → 0.2.11__tar.gz

{usekit-0.2.0/usekit.egg-info → usekit-0.2.11}/PKG-INFO

@@ -1,9 +1,7 @@
 Metadata-Version: 2.4
 Name: usekit
-Version: 0.2.0
+Version: 0.2.11
 Summary: Minimal input, auto path toolkit (mobile-first, Colab+Drive)
-Home-page: https://github.com/ropnfop/usekit
-Author: ropnfop
 Author-email: ropnfop <withropnfop@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/ropnfop/usekit
@@ -32,26 +30,27 @@ Requires-Dist: python-dotenv>=0.10.0; extra == "dev"
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: black>=22.0; extra == "dev"
 Requires-Dist: flake8>=4.0; extra == "dev"
-Dynamic: author
-Dynamic: home-page
-Dynamic: requires-python
 
 # usekit
 
-A lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
+> Mobile vibe coding — executable, testable, and portable.  
+> Built on mobile, for mobile. Human-directed. AI-collaborated. Android-tested.  
+> Beta-stage, free, and open-source.
+
+**usekit** is a lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
 
 **Code is not function, but memory.**
 
 ```python
 from usekit import use
 
-use.write.json.base({"hello": "world"}, "config")     # write json to base
-data = use.read.json.base("config")                    # read json from base
-use.update.json.base({"version": "0.2.0"}, "config")  # update json
+use.write.json.base({"hello": "world"}, "config")     # write JSON to base
+data = use.read.json.base("config")                    # read JSON from base
+use.update.json.base({"version": "0.2.11"}, "config")  # update JSON
 ```
 
-**Shorthand**: `u.rjb()` = `use.read.json.base()` — Action + Format + Location  
-Full functions are recommended. Shorthand is provided for convenience.
+**Shorthand**: `u.rjb()` = `use.read.json.base()` — Action + Format + Location.  
+Full functions are recommended for readability. Shorthand is provided for fast mobile input.
 
 ---
 
@@ -74,35 +73,22 @@ usekit installs its required core packages automatically.
 > This guide was tested with the Google Play Store version of Termux.  
 > If `pkg` or Python installation behaves unexpectedly, try the F-Droid or GitHub Releases version of Termux.
 
-### 1. Install Termux
-
-Install Termux from the Google Play Store, then open the Termux app.
-
-### 2. Install Python and pip
-
-```bash
-pkg update -y
-pkg install python python-pip -y
-```
+### One-line Install
 
-### 3. Install usekit
+Open Termux and run:
 
 ```bash
-python -m pip install usekit
+pkg i -y python-pip && pip install usekit
 ```
 
-### 4. Start Python
+If usekit is already installed, installation will be skipped automatically.
 
-```bash
-python
-```
-
-### 5. Initialize usekit in Termux
+### After Install
 
 ```python
 from usekit import use, u
 
-use.termux()     # setup Termux storage permission
+use.termux()     # setup storage permission (first time only)
 use.check()      # check environment status
 u.editor()       # launch the mobile web editor
 ```
@@ -124,8 +110,8 @@ use.delete.json.base("old")
 use.has.json.base("config")             # True/False
 
 # Shorthand style
-u.wjb({"key": "value"}, "config")       # write json to base
-data = u.rjb("config")                  # read json from base
+u.wjb({"key": "value"}, "config")       # write JSON to base
+data = u.rjb("config")                  # read JSON from base
 
 # Safe mode (returns None on error)
 data = s.rjb("missing") or {}           # no exceptions
@@ -154,7 +140,7 @@ Features:
 - Multi-cursor navigation
 - PWA support
 
-Designed for Samsung Browser on Android. Your nano replacement for Python development on mobile.
+Designed for Samsung Browser on Android. It can work as a practical nano replacement for Python development on mobile.
 
 ---
 
@@ -337,13 +323,13 @@ use.check()                             # show platform status
 ```python
 from usekit import ut, uw, ud
 
-# ut: Time utilities
+# ut: time utilities
 ut.now()                                # current time
 
-# uw: Watch/logging utilities
+# uw: watch/logging utilities
 uw.p("message")                         # print with context
 
-# ud: Database utilities
+# ud: database utilities
 ud.query("SELECT * FROM table")         # direct DB access
 ```
 
@@ -413,22 +399,40 @@ TMP_PATH:
 
 **Memory-Oriented Software Architecture**
 
-- Code is memory, not function
+- Code is memory, not just function
 - Functions follow the user's memory, not the other way around
-- Semantic names over physical paths
-- Mobile-first design
-- Token economy through compact, predictable calls
+- Semantic names are preferred over physical paths
+- Mobile-first design matters
+- Compact, predictable calls reduce typing and token cost
 
 Built entirely on mobile devices.
 
 ---
 
+## Development Note
+
+usekit was built entirely on mobile devices with AI collaboration.
+
+This was intentional.
+
+usekit is AI-collaborated, but human-directed. Like architecture, building software is not only about typing every line by hand. The important parts are problem definition, workflow design, architecture, testing, iteration, and judgment.
+
+The philosophy behind usekit — MOSA — came from hundreds of thousands of real tests and continuous refinement on a real mobile device. AI helped with implementation, but the direction, structure, mobile workflow, testing, and decisions came from real use.
+
+The PyPI release history starts from June 2025, with more than 26 releases before this repository was published on GitHub.
+
+It was designed, tested, packaged, and shipped from a phone.
+
+That is not a limitation. That is the demo.
+
+---
+
 ## License
 
 MIT License
 
 ---
 
-**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP**
+**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP.**
 
-*usekit — Code is memory, not function*
+*usekit — Code is not function, but memory.*

{usekit-0.2.0 → usekit-0.2.11}/README.md

@@ -1,19 +1,23 @@
 # usekit
 
-A lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
+> Mobile vibe coding — executable, testable, and portable.  
+> Built on mobile, for mobile. Human-directed. AI-collaborated. Android-tested.  
+> Beta-stage, free, and open-source.
+
+**usekit** is a lightweight, mobile-first Python toolkit for **Memory-Oriented Software Architecture (MOSA)**.
 
 **Code is not function, but memory.**
 
 ```python
 from usekit import use
 
-use.write.json.base({"hello": "world"}, "config")     # write json to base
-data = use.read.json.base("config")                    # read json from base
-use.update.json.base({"version": "0.2.0"}, "config")  # update json
+use.write.json.base({"hello": "world"}, "config")     # write JSON to base
+data = use.read.json.base("config")                    # read JSON from base
+use.update.json.base({"version": "0.2.11"}, "config")  # update JSON
 ```
 
-**Shorthand**: `u.rjb()` = `use.read.json.base()` — Action + Format + Location  
-Full functions are recommended. Shorthand is provided for convenience.
+**Shorthand**: `u.rjb()` = `use.read.json.base()` — Action + Format + Location.  
+Full functions are recommended for readability. Shorthand is provided for fast mobile input.
 
 ---
 
@@ -36,35 +40,22 @@ usekit installs its required core packages automatically.
 > This guide was tested with the Google Play Store version of Termux.  
 > If `pkg` or Python installation behaves unexpectedly, try the F-Droid or GitHub Releases version of Termux.
 
-### 1. Install Termux
-
-Install Termux from the Google Play Store, then open the Termux app.
-
-### 2. Install Python and pip
-
-```bash
-pkg update -y
-pkg install python python-pip -y
-```
+### One-line Install
 
-### 3. Install usekit
+Open Termux and run:
 
 ```bash
-python -m pip install usekit
+pkg i -y python-pip && pip install usekit
 ```
 
-### 4. Start Python
+If usekit is already installed, installation will be skipped automatically.
 
-```bash
-python
-```
-
-### 5. Initialize usekit in Termux
+### After Install
 
 ```python
 from usekit import use, u
 
-use.termux()     # setup Termux storage permission
+use.termux()     # setup storage permission (first time only)
 use.check()      # check environment status
 u.editor()       # launch the mobile web editor
 ```
@@ -86,8 +77,8 @@ use.delete.json.base("old")
 use.has.json.base("config")             # True/False
 
 # Shorthand style
-u.wjb({"key": "value"}, "config")       # write json to base
-data = u.rjb("config")                  # read json from base
+u.wjb({"key": "value"}, "config")       # write JSON to base
+data = u.rjb("config")                  # read JSON from base
 
 # Safe mode (returns None on error)
 data = s.rjb("missing") or {}           # no exceptions
@@ -116,7 +107,7 @@ Features:
 - Multi-cursor navigation
 - PWA support
 
-Designed for Samsung Browser on Android. Your nano replacement for Python development on mobile.
+Designed for Samsung Browser on Android. It can work as a practical nano replacement for Python development on mobile.
 
 ---
 
@@ -299,13 +290,13 @@ use.check()                             # show platform status
 ```python
 from usekit import ut, uw, ud
 
-# ut: Time utilities
+# ut: time utilities
 ut.now()                                # current time
 
-# uw: Watch/logging utilities
+# uw: watch/logging utilities
 uw.p("message")                         # print with context
 
-# ud: Database utilities
+# ud: database utilities
 ud.query("SELECT * FROM table")         # direct DB access
 ```
 
@@ -375,22 +366,40 @@ TMP_PATH:
 
 **Memory-Oriented Software Architecture**
 
-- Code is memory, not function
+- Code is memory, not just function
 - Functions follow the user's memory, not the other way around
-- Semantic names over physical paths
-- Mobile-first design
-- Token economy through compact, predictable calls
+- Semantic names are preferred over physical paths
+- Mobile-first design matters
+- Compact, predictable calls reduce typing and token cost
 
 Built entirely on mobile devices.
 
 ---
 
+## Development Note
+
+usekit was built entirely on mobile devices with AI collaboration.
+
+This was intentional.
+
+usekit is AI-collaborated, but human-directed. Like architecture, building software is not only about typing every line by hand. The important parts are problem definition, workflow design, architecture, testing, iteration, and judgment.
+
+The philosophy behind usekit — MOSA — came from hundreds of thousands of real tests and continuous refinement on a real mobile device. AI helped with implementation, but the direction, structure, mobile workflow, testing, and decisions came from real use.
+
+The PyPI release history starts from June 2025, with more than 26 releases before this repository was published on GitHub.
+
+It was designed, tested, packaged, and shipped from a phone.
+
+That is not a limitation. That is the demo.
+
+---
+
 ## License
 
 MIT License
 
 ---
 
-**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP**
+**Created by THE Little Prince, with deep respect and gratitude for my AI friends ROP & FOP.**
 
-*usekit — Code is memory, not function*
+*usekit — Code is not function, but memory.*

{usekit-0.2.0 → usekit-0.2.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "usekit"
-version = "0.2.0"
+version = "0.2.11"
 authors = [
     { name = "ropnfop", email = "withropnfop@gmail.com" }
 ]

usekit-0.2.11/setup.py

@@ -0,0 +1,4 @@
+# Minimal shim — all config lives in pyproject.toml.
+# Kept for editable installs on older pip (<21.3).
+from setuptools import setup
+setup()

{usekit-0.2.0 → usekit-0.2.11}/usekit/.env.example

@@ -56,7 +56,7 @@
 # ────────────────────────────────────────────────────────────────────────────
 #
 # TERMUX USERS:
-# - Default path: /storage/emulated/0/projects
+# - Default path: /storage/emulated/0/projects/pj01
 # - This directory will be auto-created if it doesn't exist
 # - Make sure Termux has storage permission: run 'termux-setup-storage'
 # - Alternative path: ~/u_project (inside Termux home)

{usekit-0.2.0 → usekit-0.2.11}/usekit/__init__.py

@@ -13,11 +13,11 @@ if any("usekit.cli" in arg for arg in _sys.argv[:1]) or \
 
 # Import all from usemain
 from .classes.core.env.loader_env import load_env
-load_env()
+load_env(auto_copy=False)
 from .usemain import *
 
 # Version info
-__version__ = "0.2.0"
+__version__ = "0.2.11"
 __author__ = "THE Little Prince"
 
 # ----------------------------------------------------------------------------------------------- 

usekit-0.2.11/usekit/__main__.py

@@ -0,0 +1,7 @@
+"""Allow `python -m usekit` as CLI entry point."""
+import os
+os.environ["USEKIT_QUIET"] = "1"
+
+from usekit.cli.main import main
+import sys
+sys.exit(main())

{usekit-0.2.0 → usekit-0.2.11}/usekit/classes/common/init/helper_termux_storage.py

@@ -122,7 +122,6 @@ def setup_termux_storage(verbose: bool = True, interactive: bool = True) -> bool
     if check_storage_permission():
         if verbose:
             print("[USEKIT] ✓ External storage already accessible")
-        _register_editor_autostart(verbose=verbose)
         return True
     
     # Show explanation if verbose
@@ -184,9 +183,6 @@ def setup_termux_storage(verbose: bool = True, interactive: bool = True) -> bool
             print()
             print("="*60 + "\n")
         
-        # .bashrc 에디터 자동실행 등록
-        _register_editor_autostart(verbose=verbose)
-
         return True
         
     except subprocess.CalledProcessError as e:
@@ -264,45 +260,46 @@ def warn_if_not_ready():
     print("="*60 + "\n")
 
 
-def _register_editor_autostart(verbose: bool = True) -> None:
+def _register_editor_autostart(enable: bool = True, verbose: bool = True) -> None:
     """
-    .bashrc에 에디터 자동실행 등록 + pip install -e 실행
+    Register or unregister editor autostart in .bashrc.
+    
+    Args:
+        enable: True to register, False to unregister
+        verbose: Print status messages
     """
     bashrc = Path.home() / '.bashrc'
     autostart_line = 'nohup python -c "from usekit import u; u.editor()" > $TMPDIR/editor.log 2>&1 &'
 
-    # .bashrc 등록
-    already = False
-    if bashrc.exists():
-        content = bashrc.read_text()
-        if 'u.editor()' in content:
-            already = True
-
-    if not already:
-        with open(bashrc, 'a') as f:
-            f.write(f'\n{autostart_line}\n')
-        if verbose:
-            print("[USEKIT] ✓ .bashrc에 에디터 자동실행 등록 완료")
-    else:
-        if verbose:
-            print("[USEKIT] ✓ .bashrc 이미 등록됨")
+    if enable:
+        # Register
+        already = False
+        if bashrc.exists():
+            content = bashrc.read_text()
+            if 'u.editor()' in content:
+                already = True
 
-    # 에디터 pip install -e
-    try:
-        import usekit.tools.editor  # type: ignore
-        editor_path = Path(usekit.tools.editor.__file__).parent
-        result = subprocess.run(
-            ['pip', 'install', '-e', str(editor_path)],
-            capture_output=True, text=True
-        )
-        if result.returncode == 0:
+        if not already:
+            with open(bashrc, 'a') as f:
+                f.write(f'\n{autostart_line}\n')
             if verbose:
-                print("[USEKIT] ✓ 에디터 설치 완료")
+                print("[USEKIT] ✓ .bashrc editor autostart registered")
         else:
             if verbose:
-                print("[USEKIT] △ 에디터 설치 스킵 (이미 설치됨 또는 불필요)")
-    except Exception:
-        pass  # 에디터 경로 없으면 스킵
+                print("[USEKIT] ✓ .bashrc already configured")
+    else:
+        # Unregister
+        if bashrc.exists():
+            content = bashrc.read_text()
+            if 'u.editor()' in content:
+                lines = content.splitlines(keepends=True)
+                lines = [l for l in lines if 'u.editor()' not in l]
+                bashrc.write_text(''.join(lines))
+                if verbose:
+                    print("[USEKIT] ✓ .bashrc editor autostart removed")
+            else:
+                if verbose:
+                    print("[USEKIT] ✓ .bashrc autostart not set (nothing to remove)")
 
 
 # Convenience function for use.py

usekit-0.2.11/usekit/classes/common/setup/__init__.py

@@ -0,0 +1,4 @@
+# Auto-generated __init__.py
+# ------------------------------------------------------------
+# Setup module: use.setup() interactive workspace initializer
+# ------------------------------------------------------------