hippius 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

{hippius-0.1.10.dist-info → hippius-0.1.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hippius
-Version: 0.1.10
+Version: 0.1.12
 Summary: Python SDK and CLI for Hippius blockchain storage
 Home-page: https://github.com/thenervelab/hippius-sdk
 Author: Dubs
@@ -46,6 +46,10 @@ A Python SDK and CLI for interacting with Hippius blockchain storage, designed s
 ## Installation
 
 ```bash
+
+# Using pipx
+pipx install hippius
+
 # Using pip
 pip install hippius
 
@@ -348,12 +352,63 @@ When choosing the second option, the system will process each file in the direct
 - Successfully coded files with their metadata CIDs
 - Any files that failed, with error details
 
+You can also directly use the dedicated command for directory erasure coding:
+
+```bash
+# Direct command for applying erasure coding to an entire directory
+hippius erasure-code-dir my_directory/
+
+# With custom parameters
+hippius erasure-code-dir my_important_files/ --k 4 --m 8 --encrypt
+```
+
+This dedicated command processes each file in the directory individually, optimizing erasure coding parameters for each file based on its size.
+
+**Important Note on Directory Structure:**
+- The command processes all files in the entire directory hierarchy, including all subdirectories
+- Each file is processed independently and gets its own separate metadata CID
+- The original directory structure is not automatically preserved for reconstruction
+- You will need to reconstruct each file individually using its specific metadata CID
+
+If preserving the exact directory structure is important, consider these options:
+1. Archive the directory first (option 1 above), then erasure code the single archive file
+2. Keep track of the original file paths relative to the root directory in your own system
+3. For small directories with few files, reconstruct each file individually and manually recreate the structure
+
 To reconstruct a file from erasure-coded chunks:
 
 ```bash
 hippius reconstruct QmMetadataCID reconstructed_filename
 ```
 
+**Integration with Other Features:**
+The directory erasure coding functionality works seamlessly with other Hippius SDK features:
+
+- **Account Management**: Use with multiple coldkeys and hotkeys by specifying the account with `--account` 
+- **Default Address**: Combined with default address management for streamlined operations
+- **Proxy Support**: Hotkeys with proper permissions can perform erasure coding operations on behalf of a coldkey
+- **Configuration Management**: All erasure coding parameters can be preset in your config file with `hippius config set`
+
+For a comprehensive workflow, you can manage accounts, set default addresses, configure erasure coding parameters, and then process directories in a single sequence of commands:
+
+```bash
+# Set active account
+hippius account switch my_account_name
+
+# Set default address for operations
+hippius address set-default 5H1QBRF7T7dgKwzVGCgS4wioudvMRf9K4NEDzfuKLnuyBNzH
+
+# Configure default erasure coding parameters
+hippius config set erasure_coding default_k 4
+hippius config set erasure_coding default_m 8
+
+# Apply erasure coding to a directory
+hippius erasure-code-dir my_important_directory/
+
+# Check the status of erasure-coded files
+hippius ec-files
+```
+
 #### Default Address Management
 
 Hippius SDK now allows setting a default address for read-only operations, making it easier to use commands like `files` and `ec-files` without specifying an account address each time:

{hippius-0.1.10.dist-info → hippius-0.1.12.dist-info}/RECORD

@@ -1,12 +1,12 @@
 hippius_sdk/__init__.py,sha256=OluIKx43ZOGvMI0W06B4bTTcmOJz4e6lq46GLBbPg8M,1402
 hippius_sdk/account.py,sha256=R0lsyUAqe4nmPyiMt4hGDRucoSrpeLouWBVe7DP20Bc,24308
-hippius_sdk/cli.py,sha256=ZHYw4-sUTT8wf_hlOIE1C9TLFOe6aGcLIB8bvC6UMOE,84047
+hippius_sdk/cli.py,sha256=yG1K0N2syohVUIoz9FSoBPTEVpc6ZsDIiPM1H0VsHwU,85646
 hippius_sdk/client.py,sha256=54tsg4k29sqt3F77LQJ_vhzzTR73QuZ_edqI_BvZM1E,14905
 hippius_sdk/config.py,sha256=wrVU0599aH39NIVRL59pZPyHXRevATQR9zwIUkCaWFE,25389
 hippius_sdk/ipfs.py,sha256=9fds5MJwVb7t8IqROM70x9fWgyk9_Ot5psat_hMnRN8,63969
 hippius_sdk/substrate.py,sha256=V49s1VYbl94Wk8-IH8DQsXLmRsAShGhIX9aYSY0BkBk,33034
 hippius_sdk/utils.py,sha256=FSdVhYuCsKRNZiN9-XdzN2HESHXAVcWEpOpb3CLmVPI,2192
-hippius-0.1.10.dist-info/METADATA,sha256=9s1i1aXU-lhxzGeuvjk4cDHoFkbVcbFNOSJPg4r8Evg,31298
-hippius-0.1.10.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-hippius-0.1.10.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
-hippius-0.1.10.dist-info/RECORD,,
+hippius-0.1.12.dist-info/METADATA,sha256=dxf7hKQSATr-lBJQ5CW7YYB8IEh-DYWZ7IPA7U5zZwY,33761
+hippius-0.1.12.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+hippius-0.1.12.dist-info/entry_points.txt,sha256=b1lo60zRXmv1ud-c5BC-cJcAfGE5FD4qM_nia6XeQtM,98
+hippius-0.1.12.dist-info/RECORD,,

hippius_sdk/cli.py

@@ -1915,6 +1915,41 @@ examples:
         "--verbose", action="store_true", help="Enable verbose output", default=True
     )
 
+    # Erasure code directory command
+    erasure_code_dir_parser = subparsers.add_parser(
+        "erasure-code-dir", help="Apply erasure coding to each file in a directory"
+    )
+    erasure_code_dir_parser.add_argument(
+        "dir_path", help="Path to directory to process"
+    )
+    erasure_code_dir_parser.add_argument(
+        "--k",
+        type=int,
+        default=3,
+        help="Number of data chunks needed to reconstruct (default: 3)",
+    )
+    erasure_code_dir_parser.add_argument(
+        "--m", type=int, default=5, help="Total number of chunks to create (default: 5)"
+    )
+    erasure_code_dir_parser.add_argument(
+        "--chunk-size",
+        type=int,
+        default=1048576,
+        help="Chunk size in bytes (default: 1MB)",
+    )
+    erasure_code_dir_parser.add_argument(
+        "--miner-ids", help="Comma-separated list of miner IDs"
+    )
+    erasure_code_dir_parser.add_argument(
+        "--encrypt", action="store_true", help="Encrypt the files"
+    )
+    erasure_code_dir_parser.add_argument(
+        "--no-encrypt", action="store_true", help="Do not encrypt the files"
+    )
+    erasure_code_dir_parser.add_argument(
+        "--verbose", action="store_true", help="Enable verbose output", default=True
+    )
+
     # Reconstruct command
     reconstruct_parser = subparsers.add_parser(
         "reconstruct", help="Reconstruct an erasure-coded file"
@@ -2260,6 +2295,18 @@ examples:
                 verbose=args.verbose,
             )
 
+        elif args.command == "erasure-code-dir":
+            return handle_erasure_code_directory(
+                client,
+                args.dir_path,
+                args.k,
+                args.m,
+                args.chunk_size,
+                miner_ids,
+                encrypt=args.encrypt,
+                verbose=args.verbose,
+            )
+
         elif args.command == "reconstruct":
             return handle_reconstruct(
                 client, args.metadata_cid, args.output_file, verbose=args.verbose