met-share 1.0__tar.gz

met_share-1.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.3
+Name: met-share
+Version: 1.0
+Summary: Add your description here
+Author: Bail
+Author-email: Bail <2915289604@qq.com>
+Requires-Dist: httpx2[ws]>=2.16.0
+Requires-Dist: platformdirs>=4.0
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+

met_share-1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "met-share"
+version = "1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "httpx2[ws]>=2.16.0",
+    "platformdirs>=4.0",
+]
+
+[[project.authors]]
+name = "Bail"
+email = "2915289604@qq.com"
+
+[project.scripts]
+met-share = "met_share.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = ["pytest>=9.2.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["live: 需要真实网络与真实站点，默认跳过（MET_SHARE_LIVE=1 才跑）"]
+addopts = "-m 'not live'"
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+extend-exclude = [
+    "docs/examples",
+    "*.md",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "RUF",
+]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/met_share/cli.py" = [
+    "RUF001",
+    "RUF002",
+    "RUF003",
+]
+"tests/test_cli.py" = [
+    "RUF001",
+    "RUF002",
+    "RUF003",
+]

met_share-1.0/pyproject.toml.orig

@@ -0,0 +1,58 @@
+[project]
+name = "met-share"
+version = "1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Bail", email = "2915289604@qq.com" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "httpx2[ws]>=2.16.0",
+    "platformdirs>=4.0",
+]
+
+[project.scripts]
+met-share = "met_share.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.7,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "live: 需要真实网络与真实站点，默认跳过（MET_SHARE_LIVE=1 才跑）",
+]
+addopts = "-m 'not live'"
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+# Kept out of lint/format for two independent reasons:
+#   - docs/examples/ holds the throwaway Chinese-language protocol-probing
+#     scripts written during research. RUF001/2/3 would flag every full-width
+#     punctuation mark, and none of it ships.
+#   - the Markdown pages embed illustrative snippets whose alignment carries
+#     meaning (aligned trailing comments, deliberate blank-line placement).
+#     ruff formats fenced Python blocks inside .md, which would rewrite
+#     documentation prose as if it were source.
+extend-exclude = ["docs/examples", "*.md"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "RUF"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+# The CLI's user-facing strings are Chinese, so full-width punctuation is
+# deliberate prose rather than a lookalike character. Same reasoning as the
+# docs/examples exclusion above; RUF003 would also fire on the comment text.
+"src/met_share/cli.py" = ["RUF001", "RUF002", "RUF003"]
+# The CLI tests assert on the Chinese output those strings produce.
+"tests/test_cli.py" = ["RUF001", "RUF002", "RUF003"]
+

met_share-1.0/src/met_share/__init__.py

@@ -0,0 +1,119 @@
+"""met-share: a Python SDK for ClipBox pickup-code sharing.
+
+Two ways in, deliberately different:
+
+- :class:`MetShare` — async, explicit, any deployment. The full surface.
+- module-level functions — synchronous, bound to the public instance. Convenience
+  for scripts; anything else is a sign to instantiate :class:`MetShare`.
+
+A pickup code may point at a file, text, or a link. Use :func:`info` to find out
+which before deciding how to pick it up — it never consumes an access::
+
+    from met_share import info, receive, save
+
+    meta = info("72349")
+    if meta.kind == "file":
+        save("72349", "out.pdf")      # consumes 1 access
+    else:
+        print(receive("72349").content)  # consumes 1 access
+"""
+
+from __future__ import annotations
+
+from ._client import DEFAULT_BASE, MetShare
+from ._errors import (
+    Forbidden,
+    HashMismatch,
+    InvalidRequest,
+    MetShareError,
+    NetworkError,
+    NotAFile,
+    NotFound,
+    RateLimited,
+    ServerError,
+    SourceChanged,
+    Timeout,
+    TooLarge,
+    Unauthorized,
+    UnexpectedResponse,
+    Unsupported,
+    UploadIncomplete,
+    UploadSessionExpired,
+)
+from ._models import (
+    ClipKind,
+    ClipMeta,
+    DownloadResult,
+    FileClip,
+    Progress,
+    ReceivedClip,
+    ReceivedFile,
+    ReceivedLink,
+    ReceivedText,
+    SiteConfig,
+    TextClip,
+    UploadedClip,
+)
+from ._sync import (
+    configure,
+    info,
+    read,
+    receive,
+    save,
+    send_file,
+    send_text,
+    shared,
+    shutdown,
+    stream,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "DEFAULT_BASE",
+    # models
+    "ClipKind",
+    "ClipMeta",
+    "DownloadResult",
+    "FileClip",
+    "Forbidden",
+    "HashMismatch",
+    "InvalidRequest",
+    # clients
+    "MetShare",
+    # errors
+    "MetShareError",
+    "NetworkError",
+    "NotAFile",
+    "NotFound",
+    "Progress",
+    "RateLimited",
+    "ReceivedClip",
+    "ReceivedFile",
+    "ReceivedLink",
+    "ReceivedText",
+    "ServerError",
+    "SiteConfig",
+    "SourceChanged",
+    "TextClip",
+    "Timeout",
+    "TooLarge",
+    "Unauthorized",
+    "UnexpectedResponse",
+    "Unsupported",
+    "UploadIncomplete",
+    "UploadSessionExpired",
+    "UploadedClip",
+    "__version__",
+    "configure",
+    "info",
+    "read",
+    "receive",
+    "save",
+    # sync helpers
+    "send_file",
+    "send_text",
+    "shared",
+    "shutdown",
+    "stream",
+]