lfss 0.7.15__py3-none-any.whl → 0.8.1__py3-none-any.whl

lfss/src/server.py

@@ -1,7 +1,7 @@
 from typing import Optional, Literal
 from functools import wraps
 
-from fastapi import FastAPI, APIRouter, Depends, Request, Response
+from fastapi import FastAPI, APIRouter, Depends, Request, Response, UploadFile
 from fastapi.responses import StreamingResponse
 from fastapi.exceptions import HTTPException 
 from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
@@ -9,16 +9,19 @@ from fastapi.middleware.cors import CORSMiddleware
 import mimesniff
 
 import asyncio, json, time
-import mimetypes
 from contextlib import asynccontextmanager
 
 from .error import *
 from .log import get_logger
 from .stat import RequestDB
-from .config import MAX_BUNDLE_BYTES, MAX_FILE_BYTES, LARGE_FILE_BYTES, CHUNK_SIZE
-from .utils import ensure_uri_compnents, format_last_modified, now_stamp
+from .config import MAX_BUNDLE_BYTES, MAX_MEM_FILE_BYTES, LARGE_FILE_BYTES, CHUNK_SIZE
+from .utils import ensure_uri_compnents, format_last_modified, now_stamp, wait_for_debounce_tasks
 from .connection_pool import global_connection_init, global_connection_close, unique_cursor
-from .database import Database, UserRecord, DECOY_USER, FileRecord, check_user_permission, FileReadPermission, UserConn, FileConn, PathContents
+from .database import Database, DECOY_USER, check_user_permission, UserConn, FileConn, delayed_log_activity, get_user
+from .datatype import (
+    FileReadPermission, FileRecord, UserRecord, PathContents, 
+    FileSortKey, DirSortKey
+)
 from .thumb import get_thumb
 
 logger = get_logger("server", term_level="DEBUG")
@@ -35,6 +38,7 @@ async def lifespan(app: FastAPI):
         yield
         await req_conn.commit()
     finally:
+        await wait_for_debounce_tasks()
         await asyncio.gather(req_conn.close(), global_connection_close())
 
 def handle_exception(fn):
@@ -49,6 +53,7 @@ def handle_exception(fn):
             if isinstance(e, InvalidPathError): raise HTTPException(status_code=400, detail=str(e))
             if isinstance(e, FileNotFoundError): raise HTTPException(status_code=404, detail=str(e))
             if isinstance(e, FileExistsError): raise HTTPException(status_code=409, detail=str(e))
+            if isinstance(e, TooManyItemsError): raise HTTPException(status_code=400, detail=str(e))
             logger.error(f"Uncaptured error in {fn.__name__}: {e}")
             raise 
     return wrapper
@@ -182,7 +187,7 @@ async def emit_file(
 @handle_exception
 async def get_file(
     path: str, 
-    download: bool = False, flat: bool = False, thumb: bool = False,
+    download: bool = False, thumb: bool = False,
     user: UserRecord = Depends(get_current_user)
     ):
     path = ensure_uri_compnents(path)
@@ -199,8 +204,6 @@ async def get_file(
                 return await emit_thumbnail(path, download, create_time=None)
             
             if path == "/":
-                if flat:
-                    raise HTTPException(status_code=400, detail="Flat query not supported for root path")
                 return PathContents(
                     dirs = await fconn.list_root_dirs(user.username, skim=True) \
                         if not user.is_admin else await fconn.list_root_dirs(skim=True),
@@ -210,7 +213,7 @@ async def get_file(
             if not path.startswith(f"{user.username}/") and not user.is_admin:
                 raise HTTPException(status_code=403, detail="Permission denied, path must start with username")
 
-            return await fconn.list_path(path, flat = flat)
+            return await fconn.list_path(path)
     
     # handle file query
     async with unique_cursor() as conn:
@@ -242,18 +245,21 @@ async def put_file(
     path: str, 
     conflict: Literal["overwrite", "skip", "abort"] = "abort",
     permission: int = 0,
-    user: UserRecord = Depends(registered_user)):
+    user: UserRecord = Depends(registered_user)
+    ):
     path = ensure_uri_compnents(path)
-    if not path.startswith(f"{user.username}/") and not user.is_admin:
-        logger.debug(f"Reject put request from {user.username} to {path}")
-        raise HTTPException(status_code=403, detail="Permission denied")
-    
-    content_length = request.headers.get("Content-Length")
-    if content_length is not None:
-        content_length = int(content_length)
-        if content_length > MAX_FILE_BYTES:
-            logger.debug(f"Reject put request from {user.username} to {path}, file too large")
-            raise HTTPException(status_code=413, detail="File too large")
+    assert not path.endswith("/"), "Path must not end with /"
+    if not path.startswith(f"{user.username}/"):
+        if not user.is_admin:
+            logger.debug(f"Reject put request from {user.username} to {path}")
+            raise HTTPException(status_code=403, detail="Permission denied")
+        else:
+            first_comp = path.split("/")[0]
+            async with unique_cursor() as c:
+                uconn = UserConn(c)
+                owner = await uconn.get_user(first_comp)
+                if not owner:
+                    raise HTTPException(status_code=404, detail="Owner not found")
     
     logger.info(f"PUT {path}, user: {user.username}")
     exists_flag = False
@@ -276,47 +282,73 @@ async def put_file(
     # check content-type
     content_type = request.headers.get("Content-Type")
     logger.debug(f"Content-Type: {content_type}")
-    if content_type == "application/json":
-        body = await request.json()
-        blobs = json.dumps(body).encode('utf-8')
-    elif content_type == "application/x-www-form-urlencoded":
-        # may not work...
-        body = await request.form()
-        file = body.get("file")
-        if isinstance(file, str) or file is None:
-            raise HTTPException(status_code=400, detail="Invalid form data, file required")
-        blobs = await file.read()
-    elif content_type == "application/octet-stream":
-        blobs = await request.body()
-    else:
-        blobs = await request.body()
+    if not (content_type == "application/octet-stream" or content_type == "application/json"):
+        raise HTTPException(status_code=415, detail="Unsupported content type, put request must be application/json or application/octet-stream")
     
-    # check file type
-    assert not path.endswith("/"), "Path must be a file"
-    fname = path.split("/")[-1]
-    mime_t, _ = mimetypes.guess_type(fname)
-    if mime_t is None:
-        mime_t = mimesniff.what(blobs)
-    if mime_t is None:
-        mime_t = "application/octet-stream"
-
-    if len(blobs) > LARGE_FILE_BYTES:
-        async def blob_reader():
-            for b in range(0, len(blobs), CHUNK_SIZE):
-                yield blobs[b:b+CHUNK_SIZE]
-        await db.save_file(user.id, path, blob_reader(), permission = FileReadPermission(permission), mime_type = mime_t)
-    else:
-        await db.save_file(user.id, path, blobs, permission = FileReadPermission(permission), mime_type=mime_t)
+    async def blob_reader():
+        nonlocal request
+        async for chunk in request.stream():
+            yield chunk
+
+    await db.save_file(user.id, path, blob_reader(), permission = FileReadPermission(permission))
 
     # https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Methods/PUT
-    if exists_flag:
-        return Response(status_code=201, headers={
-            "Content-Type": "application/json",
-        }, content=json.dumps({"url": path}))
-    else:
-        return Response(status_code=200, headers={
-            "Content-Type": "application/json",
-        }, content=json.dumps({"url": path}))
+    return Response(status_code=200 if exists_flag else 201, headers={
+        "Content-Type": "application/json",
+    }, content=json.dumps({"url": path}))
+
+# using form-data instead of raw body
+@router_fs.post("/{path:path}")
+@handle_exception
+async def post_file(
+    path: str, 
+    file: UploadFile,
+    conflict: Literal["overwrite", "skip", "abort"] = "abort",
+    permission: int = 0,
+    user: UserRecord = Depends(registered_user)
+    ):
+    path = ensure_uri_compnents(path)
+    assert not path.endswith("/"), "Path must not end with /"
+    if not path.startswith(f"{user.username}/"):
+        if not user.is_admin:
+            logger.debug(f"Reject put request from {user.username} to {path}")
+            raise HTTPException(status_code=403, detail="Permission denied")
+        else:
+            first_comp = path.split("/")[0]
+            async with unique_cursor() as conn:
+                uconn = UserConn(conn)
+                owner = await uconn.get_user(first_comp)
+                if not owner:
+                    raise HTTPException(status_code=404, detail="Owner not found")
+
+    logger.info(f"POST {path}, user: {user.username}")
+    exists_flag = False
+    async with unique_cursor() as conn:
+        fconn = FileConn(conn)
+        file_record = await fconn.get_file_record(path)
+
+    if file_record:
+        if conflict == "abort":
+            raise HTTPException(status_code=409, detail="File exists")
+        if conflict == "skip":
+            return Response(status_code=200, headers={
+                "Content-Type": "application/json",
+            }, content=json.dumps({"url": path}))
+        exists_flag = True
+        if not user.is_admin and not file_record.owner_id == user.id:
+            raise HTTPException(status_code=403, detail="Permission denied, cannot overwrite other's file")
+        await db.delete_file(path)
+    
+    async def blob_reader():
+        nonlocal file
+        while (chunk := await file.read(CHUNK_SIZE)):
+            yield chunk
+
+    await db.save_file(user.id, path, blob_reader(), permission = FileReadPermission(permission))
+    return Response(status_code=200 if exists_flag else 201, headers={
+        "Content-Type": "application/json",
+    }, content=json.dumps({"url": path}))
+    
 
 @router_fs.delete("/{path:path}")
 @handle_exception
@@ -332,7 +364,7 @@ async def delete_file(path: str, user: UserRecord = Depends(registered_user)):
     else:
         res = await db.delete_file(path, user if not user.is_admin else None)
 
-    await db.record_user_activity(user.username)
+    await delayed_log_activity(user.username)
     if res:
         return Response(status_code=200, content="Deleted")
     else:
@@ -366,7 +398,10 @@ async def bundle_files(path: str, user: UserRecord = Depends(registered_user)):
     
     async with unique_cursor() as conn:
         fconn = FileConn(conn)
-        files = (await fconn.list_path(path, flat = True)).files
+        files = await fconn.list_path_files(
+            url = path, flat = True, 
+            limit=(await fconn.count_path_files(url = path, flat = True))
+            )
     files = [f for f in files if await is_access_granted(f)]
     if len(files) == 0:
         raise HTTPException(status_code=404, detail="No files found")
@@ -421,7 +456,7 @@ async def update_file_meta(
     path = ensure_uri_compnents(path)
     if path.startswith("/"):
         path = path[1:]
-    await db.record_user_activity(user.username)
+    await delayed_log_activity(user.username)
 
     # file
     if not path.endswith("/"):
@@ -448,6 +483,57 @@ async def update_file_meta(
             await db.move_path(user, path, new_path)
 
     return Response(status_code=200, content="OK")
+
+async def validate_path_permission(path: str, user: UserRecord):
+    if not path.endswith("/"):
+        raise HTTPException(status_code=400, detail="Path must end with /")
+    if not path.startswith(f"{user.username}/") and not user.is_admin:
+        raise HTTPException(status_code=403, detail="Permission denied")
+
+@router_api.get("/count-files")
+async def count_files(path: str, flat: bool = False, user: UserRecord = Depends(registered_user)):
+    await validate_path_permission(path, user)
+    path = ensure_uri_compnents(path)
+    async with unique_cursor() as conn:
+        fconn = FileConn(conn)
+        return { "count": await fconn.count_path_files(url = path, flat = flat) }
+@router_api.get("/list-files")
+async def list_files(
+    path: str, offset: int = 0, limit: int = 1000,
+    order_by: FileSortKey = "", order_desc: bool = False,
+    flat: bool = False, user: UserRecord = Depends(registered_user)
+    ):
+    await validate_path_permission(path, user)
+    path = ensure_uri_compnents(path)
+    async with unique_cursor() as conn:
+        fconn = FileConn(conn)
+        return await fconn.list_path_files(
+            url = path, offset = offset, limit = limit,
+            order_by=order_by, order_desc=order_desc, 
+            flat=flat
+        )
+
+@router_api.get("/count-dirs")
+async def count_dirs(path: str, user: UserRecord = Depends(registered_user)):
+    await validate_path_permission(path, user)
+    path = ensure_uri_compnents(path)
+    async with unique_cursor() as conn:
+        fconn = FileConn(conn)
+        return { "count": await fconn.count_path_dirs(url = path) }
+@router_api.get("/list-dirs")
+async def list_dirs(
+    path: str, offset: int = 0, limit: int = 1000,
+    order_by: DirSortKey = "", order_desc: bool = False,
+    skim: bool = True, user: UserRecord = Depends(registered_user)
+    ):
+    await validate_path_permission(path, user)
+    path = ensure_uri_compnents(path)
+    async with unique_cursor() as conn:
+        fconn = FileConn(conn)
+        return await fconn.list_path_dirs(
+            url = path, offset = offset, limit = limit,
+            order_by=order_by, order_desc=order_desc, skim=skim
+        )
     
 @router_api.get("/whoami")
 @handle_exception

lfss/src/stat.py

@@ -42,7 +42,7 @@ class RequestDB:
     async def commit(self):
         await self.conn.commit()
     
-    @debounce_async(0.05)
+    @debounce_async()
     async def ensure_commit_once(self):
         await self.commit()
     

lfss/src/utils.py

@@ -1,11 +1,14 @@
-import datetime
+import datetime, time
 import urllib.parse
 import asyncio
 import functools
 import hashlib
+from asyncio import Lock
+from collections import OrderedDict
 from concurrent.futures import ThreadPoolExecutor
 from typing import TypeVar, Callable, Awaitable
 from functools import wraps, partial
+from uuid import uuid4
 import os
 
 def hash_credential(username: str, password: str):
@@ -25,25 +28,56 @@ def ensure_uri_compnents(path: str):
     """ Ensure the path components are safe to use """
     return encode_uri_compnents(decode_uri_compnents(path))
 
-def debounce_async(delay: float = 0):
-    """ Debounce the async procedure """
+g_debounce_tasks: OrderedDict[str, asyncio.Task] = OrderedDict()
+lock_debounce_task_queue = Lock()
+async def wait_for_debounce_tasks():
+    async def stop_task(task: asyncio.Task):
+        task.cancel()
+        try:
+            await task
+        except asyncio.CancelledError:
+            pass
+    await asyncio.gather(*map(stop_task, g_debounce_tasks.values()))
+    g_debounce_tasks.clear()
+
+def debounce_async(delay: float = 0.1, max_wait: float = 1.):
+    """ 
+    Debounce the async procedure, 
+    ensuring execution at least once every `max_wait` seconds. 
+    """
     def debounce_wrap(func):
-        # https://docs.python.org/3/library/asyncio-task.html#asyncio.Task.cancel
+        task_record: tuple[str, asyncio.Task] | None = None
+        last_execution_time = 0
+
         async def delayed_func(*args, **kwargs):
+            nonlocal last_execution_time
             await asyncio.sleep(delay)
             await func(*args, **kwargs)
+            last_execution_time = time.monotonic()
 
-        task_record: asyncio.Task | None = None
         @functools.wraps(func)
         async def wrapper(*args, **kwargs):
-            nonlocal task_record
-            if task_record is not None:
-                task_record.cancel()
-            task_record = asyncio.create_task(delayed_func(*args, **kwargs))
-            try:
-                await task_record
-            except asyncio.CancelledError:
-                pass
+            nonlocal task_record, last_execution_time
+
+            async with lock_debounce_task_queue:
+                if task_record is not None:
+                    task_record[1].cancel()
+                    g_debounce_tasks.pop(task_record[0], None)
+            
+            if time.monotonic() - last_execution_time > max_wait:
+                await func(*args, **kwargs)
+                last_execution_time = time.monotonic()
+                return
+
+            task = asyncio.create_task(delayed_func(*args, **kwargs))
+            task_uid = uuid4().hex
+            task_record = (task_uid, task)
+            async with lock_debounce_task_queue:
+                g_debounce_tasks[task_uid] = task
+                if len(g_debounce_tasks) > 2048:
+                    # finished tasks are not removed from the dict
+                    # so we need to clear it periodically
+                    await wait_for_debounce_tasks()
         return wrapper
     return debounce_wrap
 

{lfss-0.7.15.dist-info → lfss-0.8.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lfss
-Version: 0.7.15
+Version: 0.8.1
 Summary: Lightweight file storage service
 Home-page: https://github.com/MenxLi/lfss
 Author: li, mengxun
@@ -16,6 +16,8 @@ Requires-Dist: aiosqlite (==0.*)
 Requires-Dist: fastapi (==0.*)
 Requires-Dist: mimesniff (==1.*)
 Requires-Dist: pillow
+Requires-Dist: python-multipart
+Requires-Dist: requests (==2.*)
 Requires-Dist: uvicorn (==0.*)
 Project-URL: Repository, https://github.com/MenxLi/lfss
 Description-Content-Type: text/markdown
@@ -23,7 +25,7 @@ Description-Content-Type: text/markdown
 # Lightweight File Storage Service (LFSS)
 [![PyPI](https://img.shields.io/pypi/v/lfss)](https://pypi.org/project/lfss/)
 
-My experiment on a lightweight file/object storage service.  
+My experiment on a lightweight and high-performance file/object storage service.  
 It stores small files and metadata in sqlite, large files in the filesystem.  
 Tested on 2 million files, and it works fine... 
 
@@ -45,7 +47,7 @@ Or, you can start a web server at `/frontend` and open `index.html` in your brow
 
 The API usage is simple, just `GET`, `PUT`, `DELETE` to the `/<username>/file/url` path.  
 Authentication is done via `Authorization` header with the value `Bearer <token>`, or through the `token` query parameter.  
-You can refer to `frontend` as an application example, and `frontend/api.js` or `lfss/client/api.py` for the API usage.
+You can refer to `frontend` as an application example, and `frontend/api.js` or `lfss/api/connector.py` for the API usage.
 
 By default, the service exposes all files to the public for `GET` requests, 
 but file-listing is restricted to the user's own files.  

lfss-0.8.1.dist-info/RECORD

@@ -0,0 +1,43 @@
+Readme.md,sha256=LpbTvUWjCOv4keMNDrZvEnNAmCQnvaxvlq2srWixXn0,1299
+docs/Known_issues.md,sha256=rfdG3j1OJF-59S9E06VPyn0nZKbW-ybPxkoZ7MEZWp8,81
+docs/Permission.md,sha256=9r9nEmhqfz18RTS8FI0fZ9F0a31r86OoAyx3EQxxpk0,2317
+frontend/api.js,sha256=wUJNAkL8QigAiwR_jaMPUhCQEsL-lp0wZ6XeueYgunE,18049
+frontend/index.html,sha256=-k0bJ5FRqdl_H-O441D_H9E-iejgRCaL_z5UeYaS2qc,3384
+frontend/info.css,sha256=Ny0N3GywQ3a9q1_Qph_QFEKB4fEnTe_2DJ1Y5OsLLmQ,595
+frontend/info.js,sha256=WhOGaeqMoezEAfg4nIpK26hvejC7AZ-ZDLiJmRj0kDk,5758
+frontend/login.css,sha256=VMM0QfbDFYerxKWKSGhMI1yg5IRBXg0TTdLJEEhQZNk,355
+frontend/login.js,sha256=QoO8yKmBHDVP-ZomCMOaV7xVUVIhpl7esJrb6T5aHQE,2466
+frontend/popup.css,sha256=TJZYFW1ZcdD1IVTlNPYNtMWKPbN6XDbQ4hKBOFK8uLg,1284
+frontend/popup.js,sha256=3PgaGZmxSdV1E-D_MWgcR7aHWkcsHA1BNKSOkmP66tA,5191
+frontend/scripts.js,sha256=2YoMhrcAkI1bHihD_2EK6uCHZ1s0DiIR3FzZsh79x9A,21729
+frontend/state.js,sha256=vbNL5DProRKmSEY7xu9mZH6IY0PBenF8WGxPtGgDnLI,1680
+frontend/styles.css,sha256=xcNLqI3KBsY5TLnku8UIP0Jfr7QLajr1_KNlZj9eheM,4935
+frontend/thumb.css,sha256=rNsx766amYS2DajSQNabhpQ92gdTpNoQKmV69OKvtpI,295
+frontend/thumb.js,sha256=RQ_whXNwmkdG4SEbNQGeh488YYzqwoNYDc210hPeuhQ,5703
+frontend/utils.js,sha256=IYUZl77ugiXKcLxSNOWC4NSS0CdD5yRgUsDb665j0xM,2556
+lfss/api/__init__.py,sha256=MRzwISePOdq3of9IWGryVWX6coGkxeJ3OEh42Se4IYc,6029
+lfss/api/connector.py,sha256=tmcgKswE0sktBhanEDEc6mpuJA0de7C-DS2YqlpxHX4,10743
+lfss/cli/balance.py,sha256=R2rbO2tg9TVnnQIVeU0GJVeMS-5LDhEdk4mbOE9qGq0,4121
+lfss/cli/cli.py,sha256=8VKe41m_LhVSFxGlvgBxdz55sjscLNbbkNX1fOnmES4,4618
+lfss/cli/panel.py,sha256=iGdVmdWYjA_7a78ZzWEB_3ggIOBeUKTzg6F5zLaB25c,1401
+lfss/cli/serve.py,sha256=T-jz_PJcaY9FJRRfyWV9MbjDI73YdOOCn4Nr2PO-s0c,993
+lfss/cli/user.py,sha256=wlR-xcJKCtr_y5QgYO9GM0JyDCKooIRlsAxw2eilPfs,3418
+lfss/cli/vacuum.py,sha256=4TMMYC_5yEt7jeaFTVC3iX0X6aUzYXBiCsrcIYgw_uA,3695
+lfss/sql/init.sql,sha256=C-JtQAlaOjESI8uoF1Y_9dKukEVSw5Ll-7yA3gG-XHU,1210
+lfss/sql/pragma.sql,sha256=uENx7xXjARmro-A3XAK8OM8v5AxDMdCCRj47f86UuXg,206
+lfss/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lfss/src/bounded_pool.py,sha256=BI1dU-MBf82TMwJBYbjhEty7w1jIUKc5Bn9SnZ_-hoY,1288
+lfss/src/config.py,sha256=7k_6L_aG7vD-lVcmgpwMIg-ggpMMDNU8IbaB4y1effE,861
+lfss/src/connection_pool.py,sha256=4YULPcmndy33FyBSo9w1fZjAlBX2q-xPP27xJOTA06I,5228
+lfss/src/database.py,sha256=Cexv6r9sZl29hWzFyL_J_kWz9roUbut6A246Zc4ORs0,35885
+lfss/src/datatype.py,sha256=q2lc8BJaB2sS7gtqPMqxM625mckgI2SmvuqbadiObLY,2158
+lfss/src/error.py,sha256=Bh_GUtuNsMSMIKbFreU4CfZzL96TZdNAIcgmDxvGbQ0,333
+lfss/src/log.py,sha256=u6WRZZsE7iOx6_CV2NHh1ugea26p408FI4WstZh896A,5139
+lfss/src/server.py,sha256=mUu0WbiGdM08Jos7a4r_e9ND5sK_tNDEv1VGRPIHvLk,21206
+lfss/src/stat.py,sha256=WlRiiAl0rHX9oPi3thi6K4GKn70WHpClSDCt7iZUow4,3197
+lfss/src/thumb.py,sha256=qjCNMpnCozMuzkhm-2uAYy1eAuYTeWG6xqs-13HX-7k,3266
+lfss/src/utils.py,sha256=nal2rpr00jq1PeFhGQXkvU0FIbtRhXTj8VmbeIyRyLI,5184
+lfss-0.8.1.dist-info/METADATA,sha256=PMNu6iNXnpYU6Lyxvlr9-e-ypSj71dygYyqH3mTHzE0,2108
+lfss-0.8.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+lfss-0.8.1.dist-info/entry_points.txt,sha256=VJ8svMz7RLtMCgNk99CElx7zo7M-N-z7BWDVw2HA92E,205
+lfss-0.8.1.dist-info/RECORD,,

lfss/client/api.py

@@ -1,143 +0,0 @@
-from typing import Optional, Literal
-import os
-import requests
-import urllib.parse
-from lfss.src.datatype import (
-    FileReadPermission, FileRecord, DirectoryRecord, UserRecord, PathContents
-    )
-from lfss.src.utils import ensure_uri_compnents
-
-_default_endpoint = os.environ.get('LFSS_ENDPOINT', 'http://localhost:8000')
-_default_token = os.environ.get('LFSS_TOKEN', '')
-
-class Connector:
-    def __init__(self, endpoint=_default_endpoint, token=_default_token):
-        assert token, "No token provided. Please set LFSS_TOKEN environment variable."
-        self.config = {
-            "endpoint": endpoint,
-            "token": token
-        }
-    
-    def _fetch_factory(
-        self, method: Literal['GET', 'POST', 'PUT', 'DELETE'], 
-        path: str, search_params: dict = {}
-    ):
-        if path.startswith('/'):
-            path = path[1:]
-        path = ensure_uri_compnents(path)
-        def f(**kwargs):
-            url = f"{self.config['endpoint']}/{path}" + "?" + urllib.parse.urlencode(search_params)
-            headers: dict = kwargs.pop('headers', {})
-            headers.update({
-                'Authorization': f"Bearer {self.config['token']}",
-            })
-            with requests.Session() as s:
-                response = s.request(method, url, headers=headers, **kwargs)
-                response.raise_for_status()
-            return response
-        return f
-
-    def put(self, path: str, file_data: bytes, permission: int | FileReadPermission = 0, conflict: Literal['overwrite', 'abort', 'skip', 'skip-ahead'] = 'abort'):
-        """Uploads a file to the specified path."""
-        assert isinstance(file_data, bytes), "file_data must be bytes"
-
-        # Skip ahead by checking if the file already exists
-        if conflict == 'skip-ahead':
-            exists = self.get_metadata(path)
-            if exists is None:
-                conflict = 'skip'
-            else:
-                return {'status': 'skipped', 'path': path}
-
-        response = self._fetch_factory('PUT', path, search_params={
-            'permission': int(permission),
-            'conflict': conflict
-            })(
-            data=file_data, 
-            headers={'Content-Type': 'application/octet-stream'}
-        )
-        return response.json()
-    
-    def put_json(self, path: str, data: dict, permission: int | FileReadPermission = 0, conflict: Literal['overwrite', 'abort', 'skip', 'skip-ahead'] = 'abort'):
-        """Uploads a JSON file to the specified path."""
-        assert path.endswith('.json'), "Path must end with .json"
-        assert isinstance(data, dict), "data must be a dict"
-
-        # Skip ahead by checking if the file already exists
-        if conflict == 'skip-ahead':
-            exists = self.get_metadata(path)
-            if exists is None:
-                conflict = 'skip'
-            else:
-                return {'status': 'skipped', 'path': path}
-
-        response = self._fetch_factory('PUT', path, search_params={
-            'permission': int(permission),
-            'conflict': conflict
-            })(
-            json=data, 
-            headers={'Content-Type': 'application/json'}
-        )
-        return response.json()
-    
-    def _get(self, path: str) -> Optional[requests.Response]:
-        try:
-            response = self._fetch_factory('GET', path)()
-        except requests.exceptions.HTTPError as e:
-            if e.response.status_code == 404:
-                return None
-            raise e
-        return response
-
-    def get(self, path: str) -> Optional[bytes]:
-        """Downloads a file from the specified path."""
-        response = self._get(path)
-        if response is None: return None
-        return response.content
-
-    def get_json(self, path: str) -> Optional[dict]:
-        response = self._get(path)
-        if response is None: return None
-        assert response.headers['Content-Type'] == 'application/json'
-        return response.json()
-    
-    def delete(self, path: str):
-        """Deletes the file at the specified path."""
-        self._fetch_factory('DELETE', path)()
-    
-    def get_metadata(self, path: str) -> Optional[FileRecord | DirectoryRecord]:
-        """Gets the metadata for the file at the specified path."""
-        try:
-            response = self._fetch_factory('GET', '_api/meta', {'path': path})()
-            if path.endswith('/'):
-                return DirectoryRecord(**response.json())
-            else:
-                return FileRecord(**response.json())
-        except requests.exceptions.HTTPError as e:
-            if e.response.status_code == 404:
-                return None
-            raise e
-    
-    def list_path(self, path: str, flat: bool = False) -> PathContents:
-        assert path.endswith('/')
-        response = self._fetch_factory('GET', path, {'flat': flat})()
-        dirs = [DirectoryRecord(**d) for d in response.json()['dirs']]
-        files = [FileRecord(**f) for f in response.json()['files']]
-        return PathContents(dirs=dirs, files=files)
-
-    def set_file_permission(self, path: str, permission: int | FileReadPermission):
-        """Sets the file permission for the specified path."""
-        self._fetch_factory('POST', '_api/meta', {'path': path, 'perm': int(permission)})(
-            headers={'Content-Type': 'application/www-form-urlencoded'}
-        )
-        
-    def move(self, path: str, new_path: str):
-        """Move file or directory to a new path."""
-        self._fetch_factory('POST', '_api/meta', {'path': path, 'new_path': new_path})(
-            headers = {'Content-Type': 'application/www-form-urlencoded'}
-        )
-        
-    def whoami(self) -> UserRecord:
-        """Gets information about the current user."""
-        response = self._fetch_factory('GET', '_api/whoami')()
-        return UserRecord(**response.json())

lfss-0.7.15.dist-info/RECORD

@@ -1,41 +0,0 @@
-Readme.md,sha256=vsPotlwPAaHI5plh4aaszpi3rr7ZGDn7-wLdEYTWQ0k,1275
-docs/Known_issues.md,sha256=rfdG3j1OJF-59S9E06VPyn0nZKbW-ybPxkoZ7MEZWp8,81
-docs/Permission.md,sha256=X0VNfBKU52f93QYqcVyiBFJ3yURiSkhIo9S_5fdSgzM,2265
-frontend/api.js,sha256=o1sP4rKxxnM-rebxnlMlPkhPHzKaVW4kZC7B4ufbOK4,8026
-frontend/index.html,sha256=i45ilkRCorqXP0bTfMiwT3QmmEF23V34lZJC1nODHLo,2862
-frontend/info.css,sha256=Ny0N3GywQ3a9q1_Qph_QFEKB4fEnTe_2DJ1Y5OsLLmQ,595
-frontend/info.js,sha256=WhOGaeqMoezEAfg4nIpK26hvejC7AZ-ZDLiJmRj0kDk,5758
-frontend/popup.css,sha256=TJZYFW1ZcdD1IVTlNPYNtMWKPbN6XDbQ4hKBOFK8uLg,1284
-frontend/popup.js,sha256=3PgaGZmxSdV1E-D_MWgcR7aHWkcsHA1BNKSOkmP66tA,5191
-frontend/scripts.js,sha256=tmA_tG3bLEEqn0jTgZ-DkcEl6egxdrFYJmstb9eZMr0,21862
-frontend/state.js,sha256=Dda-2G4QzyqdxffjJa3Lb7rgJOrg2LvJ3TCRcB8YCrU,1327
-frontend/styles.css,sha256=krMo6Ulroi8pqEq1exQsFEU-FJqT9GzI8vyARiNF11k,4484
-frontend/thumb.css,sha256=1i8wudiMWGwdrnTqs6yrS8YaiPeHPR-A2YqUNJN20Ok,165
-frontend/thumb.js,sha256=6m8bscQpi2sYaLRir2ZeY1H_1ZRKFVss5P28AnLvIVQ,5486
-frontend/utils.js,sha256=IYUZl77ugiXKcLxSNOWC4NSS0CdD5yRgUsDb665j0xM,2556
-lfss/cli/balance.py,sha256=R2rbO2tg9TVnnQIVeU0GJVeMS-5LDhEdk4mbOE9qGq0,4121
-lfss/cli/cli.py,sha256=LH1nx5wI1K2DZ3hvHz7oq5HcXVDoW2V6sr7q9gJ8gqo,4621
-lfss/cli/panel.py,sha256=iGdVmdWYjA_7a78ZzWEB_3ggIOBeUKTzg6F5zLaB25c,1401
-lfss/cli/serve.py,sha256=T-jz_PJcaY9FJRRfyWV9MbjDI73YdOOCn4Nr2PO-s0c,993
-lfss/cli/user.py,sha256=ETLtj0N-kmxv0mhmeAsO6cY7kPq7nOOP4DetxIRoQpQ,3405
-lfss/cli/vacuum.py,sha256=4TMMYC_5yEt7jeaFTVC3iX0X6aUzYXBiCsrcIYgw_uA,3695
-lfss/client/__init__.py,sha256=kcClDdHaQowAhHFYdrFyFqHIOe5MEjfENYq1icuj3Mg,4577
-lfss/client/api.py,sha256=aHorSuxl79xvRRfwuitXANYoTogWKVO11XX7mdrhHTE,5807
-lfss/sql/init.sql,sha256=C-JtQAlaOjESI8uoF1Y_9dKukEVSw5Ll-7yA3gG-XHU,1210
-lfss/sql/pragma.sql,sha256=uENx7xXjARmro-A3XAK8OM8v5AxDMdCCRj47f86UuXg,206
-lfss/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lfss/src/bounded_pool.py,sha256=BI1dU-MBf82TMwJBYbjhEty7w1jIUKc5Bn9SnZ_-hoY,1288
-lfss/src/config.py,sha256=K1b5clNRO4EzxDG-p6U5aRLDaq-Up0tDHfn_D79D0ns,857
-lfss/src/connection_pool.py,sha256=r4Ho5d_Gd4S_KbT7515UJoiyfIgS6xyttqMsKqOfaIg,5190
-lfss/src/database.py,sha256=w2QPE3h1Lx0D0fUmdtu9s1XHpNp9p27zqm8AVeP2UVg,32476
-lfss/src/datatype.py,sha256=WfrLALU_7wei5-i_b0TxY8xWI5mwxLUHFepHSps49zA,1767
-lfss/src/error.py,sha256=imbhwnbhnI3HLhkbfICROe3F0gleKrOk4XnqHJDOtuI,285
-lfss/src/log.py,sha256=u6WRZZsE7iOx6_CV2NHh1ugea26p408FI4WstZh896A,5139
-lfss/src/server.py,sha256=igkPC3gdJoIqcVTKBAKkVPRrclXR2ZNBdRIAEci4xMo,17717
-lfss/src/stat.py,sha256=Wr-ug_JqtbSIf3XwQnv1xheGhsDTEOlLWuYoKO_26Jo,3201
-lfss/src/thumb.py,sha256=qjCNMpnCozMuzkhm-2uAYy1eAuYTeWG6xqs-13HX-7k,3266
-lfss/src/utils.py,sha256=TBGYvgt6xMP8UC5wTGHAr9fmdhu0_gjOtxcSeyvGyVM,3918
-lfss-0.7.15.dist-info/METADATA,sha256=s6jCttzD9bRauwKiKGNgrBouK5UDNEUMTgDHZBY_VfY,2021
-lfss-0.7.15.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-lfss-0.7.15.dist-info/entry_points.txt,sha256=VJ8svMz7RLtMCgNk99CElx7zo7M-N-z7BWDVw2HA92E,205
-lfss-0.7.15.dist-info/RECORD,,