about to upgrade pickleSocket

Author: Daniel-Chin

book.py

@@ -1,5 +1,5 @@
 '''
-sys.argv[1] in ('sun', 'pad') 
+A file system. 
 '''
 print('Importing...')
 import platform

cache_no_hash.py

@@ -1,3 +1,6 @@
+'''
+Inefficiently cache and lookup function returns. 
+'''
 class cache:
     def __init__(self, func):
         self.func = func

console.py console/__init__.py

@@ -166,6 +166,3 @@ def console(namespace = {}, prompt = '>>> ', use_input = False, fixer = None):
         next(kernal)
         if result is not None:
             print(result)
-
-if __name__ == '__main__':
-    console({})

console/__main__.py

@@ -0,0 +1,2 @@
+from console import console
+console({})

kernal.py console/kernal.py

@@ -1,5 +1,5 @@
 '''
-Like dummy.Pool.map, but no limit of thread number. 
+Like dummy.Pool.map, but no limit of number of threads. 
 '''
 from threading import Thread, Lock, Condition
 from queue import Queue

forcemap.py

@@ -1,5 +1,5 @@
 '''
-Evaluate beautiful formulas like    √(2×3÷4)
+Evaluate beautiful formulas like √(2×3÷4)
 '''
 from console import console
 from math import sqrt

formula.py

@@ -1,3 +1,6 @@
+'''
+Formatting time data in a friendly manner. 
+'''
 import time
 
 def friendlyTime(raw_time=None):

friendly_time.py

@@ -1,3 +1,8 @@
+'''
+This is for me only. 
+You won't get why this code is here. 
+Give up. 
+'''
 from pickle_socket import PickleSocket
 from io import BytesIO as IO
 import socket

lab.py

@@ -1,5 +1,5 @@
 '''
-by Daniel
+More tkinter gadgets
 '''
 import tkinter as tk
 import threading
@@ -207,6 +207,9 @@ def insert(self, index, chars, *args):
             super(__class__,self).insert(index, chunk, *args)
 
 def bilingualStringLen(string, fontsize = 18):
+    '''
+    counts a chinese character as length of 2. 
+    '''
     length = 0
     for char in string:
         if len(char.encode()) > 1:

moretk.py

@@ -1,3 +1,6 @@
+'''
+My misc little tools. 
+'''
 class LockableInt(int):
     def __init__(self, value = None):
         super(__class__,self).__init__()

my.py

@@ -1,3 +1,6 @@
+'''
+Unreliable file utils
+'''
 import os
 from os import path
 from listen import listen

myfile.py

@@ -1,4 +1,7 @@
 '''
+Serves through a (super) simplified version of http protocol. 
+Warning: Running this may expose your computer to attacks. 
+Don't run this. 
 '''
 from threading import Thread
 from queue import Queue, Empty

myhttp.py

@@ -1,3 +1,6 @@
+'''
+My threading utils
+'''
 from threading import Condition
 
 class Safe(Condition):

mythread.py

@@ -1,5 +1,7 @@
 '''
 一嗖传
+Transmit files over the internet / LAN
+No encryption! Consider everything you transmit broadcast to the entire network. 
 '''
 print('importing...')
 from recvfile import recvFile

oneship.py

@@ -1,3 +1,6 @@
+'''
+Preview a pickle file
+'''
 import sys, pickle
 from pprint import pprint
 

pickle_preview.py

@@ -1,25 +1,12 @@
 '''
-WARNING: under Linux, socket.sendfile is overridden!!!  
+A socket that supports object transmission. 
 '''
 import socket
 import pickle
 from io import BytesIO
 import sys
 __all__ = ['PickleSocket', 'RemoteClosedUnexpectedly']
 
-if 'sendfile' not in dir(socket.socket):
-    # Android
-    def fakeSendfile(self, file, offset=0, count=None):
-        start = file.tell()
-        if offset != 0:
-            file.seek(start + offset)
-        read = file.read(4096)
-        while read != b'':
-            self.sendall(read)
-            read = file.read(4096)
-        return file.tell() - start - offset
-    socket.socket.sendfile = fakeSendfile
-
 class PickleSocket():
     def __init__(self,upon_this_socket=None):
         if upon_this_socket is None:
@@ -40,13 +27,11 @@ def shakeHands(self,banner='This is a pickleSocket by Daniel Chin. ',echo=True):
             input('Enter to exit...')
             sys.exit(1)
 
-    def bind(self,address,AB=False,dorm=False,local=False):
-        '''if AB or dorm is True, address is no longer a tuple, but a port int.'''
-        if AB:
-            self.socket.bind(('10.209.1.45',address))
-        elif dorm:
-            self.socket.bind(('10.209.23.186',address))
-        elif local:
+    def bind(self,address,local=False):
+        '''
+        if `local` is True, address is no longer a tuple, but a port int.
+        '''
+        if local:
             self.socket.bind(('127.0.0.1',address))
         else:
             self.socket.bind(address)

pickle_socket.py

@@ -1,7 +1,6 @@
 '''
 Provides fake p2p, port forwarding. 
 
-
 Ignored the thread-danger of sockets. 
 Expect unexpected behaviors. 
 '''

port_forward.py

@@ -0,0 +1,7 @@
+All the wheels I re-invented. 
+
+This repo has various useful python tools and utils. 
+
+I kinda documented them. 
+
+If you have questions or suggestions, please send email to [email protected]

readme.md

@@ -1,5 +1,7 @@
 '''
-If no problem, del assert. 
+Receive `size` bytes from `socket`. Blocks until gets all. 
+Somehow doesn't handle socket closing. 
+I will fix that when I have time. 
 '''
 
 def recvall(socket, size, use_list = True):
@@ -14,6 +16,4 @@ def recvall(socket, size, use_list = True):
         recved = b''
         while len(recved) < size:
             recved += socket.recv(left)
-        return recved
-    assert len(recved) == size
-    return result
+    return recved

recvall.py

@@ -1,3 +1,6 @@
+'''
+receive a file from a socket with known length. 
+'''
 import jdt
 from socket import socket as Socket