pyxpo-sharing 0.1.0a1__tar.gz

pyxpo_sharing-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vishal Chaubey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyxpo_sharing-0.1.0a1/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: pyxpo-sharing
+Version: 0.1.0a1
+Summary: System share sheet for pyxpo apps (react-native Share and expo-sharing shapes).
+Author: Vishal Chaubey
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pyxpo/pyxpo/tree/main/packages/sharing
+Project-URL: Issues, https://github.com/pyxpo/pyxpo/issues
+Keywords: pyxpo,pyxpo-module,mobile,android,ios
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyxpo<0.2,>=0.1.0a1
+Dynamic: license-file
+
+# pyxpo-sharing
+
+System share sheet for pyxpo apps (react-native Share shape).
+
+This is an optional [pyxpo](https://github.com/pyxpo/pyxpo) native module. Apps that do not
+list it carry none of its code, permissions or dependencies.
+
+## Install
+
+```bash
+pip install pyxpo-sharing
+```
+
+Then link it into your app in `pyproject.toml`:
+
+```toml
+[tool.pyxpo]
+modules = ["sharing"]
+```
+
+and rebuild (`pyxpo run ios`, `pyxpo build android`, ...). The build copies the module's Swift and Kotlin
+sources into the native project and its Python package into the app.
+
+## Use
+
+```python
+from pyxpo_sharing import Share
+
+await Share.share({"url": path, "message": "Made with pyxpo"})
+```
+
+Permissions and Info.plist keys: none (Android shares through a FileProvider declared in the module manifest).
+
+## What is in the package
+
+- `pyxpo_sharing/__init__.py`: the Python API.
+- `pyxpo_sharing/pyxpo-module.json`: autolink metadata (bridge name, Swift and Kotlin classes, Android namespace and dependencies, Info.plist keys).
+- `pyxpo_sharing/ios/`: Swift sources compiled into the iOS app.
+- `pyxpo_sharing/android/src/main/`: Kotlin sources and the manifest merged into the Android app.

pyxpo_sharing-0.1.0a1/README.md

@@ -0,0 +1,39 @@
+# pyxpo-sharing
+
+System share sheet for pyxpo apps (react-native Share shape).
+
+This is an optional [pyxpo](https://github.com/pyxpo/pyxpo) native module. Apps that do not
+list it carry none of its code, permissions or dependencies.
+
+## Install
+
+```bash
+pip install pyxpo-sharing
+```
+
+Then link it into your app in `pyproject.toml`:
+
+```toml
+[tool.pyxpo]
+modules = ["sharing"]
+```
+
+and rebuild (`pyxpo run ios`, `pyxpo build android`, ...). The build copies the module's Swift and Kotlin
+sources into the native project and its Python package into the app.
+
+## Use
+
+```python
+from pyxpo_sharing import Share
+
+await Share.share({"url": path, "message": "Made with pyxpo"})
+```
+
+Permissions and Info.plist keys: none (Android shares through a FileProvider declared in the module manifest).
+
+## What is in the package
+
+- `pyxpo_sharing/__init__.py`: the Python API.
+- `pyxpo_sharing/pyxpo-module.json`: autolink metadata (bridge name, Swift and Kotlin classes, Android namespace and dependencies, Info.plist keys).
+- `pyxpo_sharing/ios/`: Swift sources compiled into the iOS app.
+- `pyxpo_sharing/android/src/main/`: Kotlin sources and the manifest merged into the Android app.

pyxpo_sharing-0.1.0a1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyxpo-sharing"
+dynamic = ["version"]
+description = "System share sheet for pyxpo apps (react-native Share and expo-sharing shapes)."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Vishal Chaubey" }]
+keywords = ["pyxpo", "pyxpo-module", "mobile", "android", "ios"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: User Interfaces",
+]
+requires-python = ">=3.9"
+dependencies = ["pyxpo>=0.1.0a1,<0.2"]
+
+[project.urls]
+Homepage = "https://github.com/pyxpo/pyxpo/tree/main/packages/sharing"
+Issues = "https://github.com/pyxpo/pyxpo/issues"
+
+# How `pyxpo build` finds this module: the entry point name is the module name apps list in
+# `[tool.pyxpo] modules`, its value the import package holding pyxpo-module.json.
+[project.entry-points."pyxpo.modules"]
+sharing = "pyxpo_sharing"
+
+[tool.setuptools]
+packages = ["pyxpo_sharing"]
+
+[tool.setuptools.dynamic]
+version = { attr = "pyxpo_sharing.__version__" }
+
+[tool.setuptools.package-data]
+pyxpo_sharing = ["pyxpo-module.json", "py.typed", "ios/**/*", "android/**/*"]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["__pycache__", "*.pyc", ".DS_Store"]

pyxpo_sharing-0.1.0a1/pyxpo_sharing/__init__.py

@@ -0,0 +1,68 @@
+"""System share sheet: react-native `Share` and expo-sharing shapes. Shares local files, links and an optional message."""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from pyxpo.module_api import call, require_linked, snake_aliases
+
+__version__ = "0.1.0a1"
+
+_in_flight = False
+
+
+def _is_link(s: str) -> bool:
+    return s.lower().startswith(("http://", "https://"))
+
+
+async def _share(files: List[str], message: str, mime: str, title: str) -> Dict[str, str]:
+    """One share sheet at a time; a second call while one is open raises instead of stacking sheets."""
+    global _in_flight
+    if _in_flight:
+        raise RuntimeError("a share sheet is already open")
+    _in_flight = True
+    try:
+        res = await call("Share", "share", files, message, mime, title, reply=True)
+    finally:
+        _in_flight = False
+    return {"action": (res or {}).get("action", "dismissedAction")}
+
+
+@snake_aliases
+class Share:
+    @staticmethod
+    async def share(content: Dict[str, Any], options: Optional[Dict[str, Any]] = None) -> Dict[str, str]:
+        """Opens the system share sheet. `content`: `{"url": path_or_link}` or `{"urls": [...]}`, plus optional `message`.
+        Local paths are shared as files; http(s) links are appended to the message, the same on both OSes.
+        `options`: `{"dialogTitle": str}` (Android chooser title; iOS has none).
+        Returns `{"action": "sharedAction" | "dismissedAction"}` (Android always reports sharedAction, as react-native does).
+        Android shares files from the app's own cache and files folders."""
+        require_linked("Share", "sharing", package="pyxpo-sharing")
+        items = [str(u) for u in (content.get("urls") or ([content["url"]] if content.get("url") else []))]
+        files = [u for u in items if not _is_link(u)]
+        message = "\n".join([m for m in [content.get("message") or ""] + [u for u in items if _is_link(u)] if m])
+        if not files and not message:
+            raise ValueError("Share.share needs a url, urls or message")
+        return await _share(files, message, "", str((options or {}).get("dialogTitle") or ""))
+
+
+@snake_aliases
+class Sharing:
+    """expo-sharing shape."""
+
+    @staticmethod
+    async def isAvailableAsync() -> bool:
+        """True when the share sheet module is linked (both iOS and Android always have a share sheet)."""
+        try:
+            require_linked("Share", "sharing", package="pyxpo-sharing")
+        except Exception:  # noqa: BLE001 - not linked means unavailable, not an error
+            return False
+        return True
+
+    @staticmethod
+    async def shareAsync(url: str, options: Optional[Dict[str, Any]] = None) -> None:
+        """Shares one local file. `options`: `mimeType` and `dialogTitle` (Android only; iOS derives both from the file)."""
+        require_linked("Share", "sharing", package="pyxpo-sharing")
+        if not url or _is_link(str(url)):
+            raise ValueError("Sharing.shareAsync needs a local file path; use Share.share for links")
+        o = options or {}
+        await _share([str(url)], "", str(o.get("mimeType") or ""), str(o.get("dialogTitle") or ""))

pyxpo_sharing-0.1.0a1/pyxpo_sharing/android/src/main/AndroidManifest.xml

@@ -0,0 +1,10 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application>
+        <!-- Hands files from the app's cache and files folders to the share sheet without exposing file:// paths (no AndroidX needed). -->
+        <provider
+            android:name="dev.pyxpo.modules.sharing.PxShareFileProvider"
+            android:authorities="${applicationId}.pyxpo.share"
+            android:exported="false"
+            android:grantUriPermissions="true" />
+    </application>
+</manifest>

pyxpo_sharing-0.1.0a1/pyxpo_sharing/android/src/main/java/dev/pyxpo/modules/sharing/PxShareFileProvider.kt

@@ -0,0 +1,61 @@
+package dev.pyxpo.modules.sharing
+
+import android.content.ContentProvider
+import android.content.ContentValues
+import android.content.Context
+import android.database.Cursor
+import android.database.MatrixCursor
+import android.net.Uri
+import android.os.ParcelFileDescriptor
+import android.provider.OpenableColumns
+import android.webkit.MimeTypeMap
+import java.io.File
+import java.io.FileNotFoundException
+
+/**
+ * Read-only provider for the share sheet. Serves only files inside the app's cache and files folders,
+ * addressed as content://<applicationId>.pyxpo.share/<absolute path>. Plain ContentProvider, so no AndroidX is needed.
+ */
+class PxShareFileProvider : ContentProvider() {
+    override fun onCreate() = true
+
+    private fun resolve(uri: Uri): File {
+        val ctx = context ?: throw FileNotFoundException("no context")
+        val f = File("/" + uri.pathSegments.joinToString("/")).canonicalFile
+        if (!allowedRoots(ctx).any { f.path.startsWith(it.path + File.separator) } || !f.isFile) throw FileNotFoundException(uri.toString())
+        return f
+    }
+
+    override fun openFile(uri: Uri, mode: String): ParcelFileDescriptor {
+        if (mode != "r") throw FileNotFoundException("read-only")
+        return ParcelFileDescriptor.open(resolve(uri), ParcelFileDescriptor.MODE_READ_ONLY)
+    }
+
+    override fun getType(uri: Uri): String? = try {
+        MimeTypeMap.getSingleton().getMimeTypeFromExtension(resolve(uri).extension.lowercase()) ?: "application/octet-stream"
+    } catch (e: FileNotFoundException) { null }
+
+    override fun query(uri: Uri, projection: Array<String>?, selection: String?, selectionArgs: Array<String>?, sortOrder: String?): Cursor {
+        val f = resolve(uri)
+        val cols = projection ?: arrayOf(OpenableColumns.DISPLAY_NAME, OpenableColumns.SIZE)
+        val cur = MatrixCursor(cols)
+        cur.addRow(Array<Any?>(cols.size) { i -> when (cols[i]) { OpenableColumns.DISPLAY_NAME -> f.name; OpenableColumns.SIZE -> f.length(); else -> null } })
+        return cur
+    }
+
+    override fun insert(uri: Uri, values: ContentValues?): Uri? = throw UnsupportedOperationException("read-only")
+    override fun update(uri: Uri, values: ContentValues?, selection: String?, selectionArgs: Array<String>?): Int = throw UnsupportedOperationException("read-only")
+    override fun delete(uri: Uri, selection: String?, selectionArgs: Array<String>?): Int = throw UnsupportedOperationException("read-only")
+
+    companion object {
+        private fun allowedRoots(ctx: Context) = listOf(ctx.cacheDir.canonicalFile, ctx.filesDir.canonicalFile)
+
+        fun uriFor(ctx: Context, file: File): Uri {
+            val f = file.canonicalFile
+            if (!allowedRoots(ctx).any { f.path.startsWith(it.path + File.separator) }) {
+                throw IllegalArgumentException("only files in the app's cache or files folder can be shared")
+            }
+            return Uri.Builder().scheme("content").authority(ctx.packageName + ".pyxpo.share").path(f.path).build()
+        }
+    }
+}

pyxpo_sharing-0.1.0a1/pyxpo_sharing/android/src/main/java/dev/pyxpo/modules/sharing/ShareModule.kt

@@ -0,0 +1,59 @@
+package dev.pyxpo.modules.sharing
+
+import android.content.ClipData
+import android.content.Intent
+import android.net.Uri
+import android.webkit.MimeTypeMap
+import dev.pyxpo.moduleapi.PxModule
+import dev.pyxpo.moduleapi.PxModuleContext
+import dev.pyxpo.moduleapi.PxReply
+import org.json.JSONArray
+import java.io.File
+
+/** System share sheet. Files must live in the app's cache or files folder. Like react-native, Android always reports sharedAction. */
+class ShareModule : PxModule() {
+    override val name = "Share"
+
+    override fun call(ctx: PxModuleContext, method: String, args: JSONArray, reply: PxReply) {
+        if (method != "share") { reply(null, "unknown native call Share.$method"); return }
+        val paths = args.optJSONArray(0) ?: JSONArray()
+        val message = args.optString(1, "")
+        val mimeOverride = args.optString(2, "")
+        val title = args.optString(3, "")
+        val app = ctx.activity
+        val uris = ArrayList<Uri>()
+        val mimes = HashSet<String>()
+        try {
+            for (i in 0 until paths.length()) {
+                val raw = paths.optString(i)
+                val f = File(if (raw.startsWith("file://")) Uri.parse(raw).path ?: raw else raw)
+                if (!f.isFile) { reply(null, "file not found: ${f.name}"); return }
+                uris.add(PxShareFileProvider.uriFor(app, f))
+                mimes.add(MimeTypeMap.getSingleton().getMimeTypeFromExtension(f.extension.lowercase()) ?: "application/octet-stream")
+            }
+        } catch (e: IllegalArgumentException) {
+            reply(null, e.message ?: "file can not be shared"); return
+        }
+        val intent = Intent(if (uris.size > 1) Intent.ACTION_SEND_MULTIPLE else Intent.ACTION_SEND)
+        intent.type = when {
+            mimeOverride.isNotEmpty() -> mimeOverride
+            uris.isEmpty() -> "text/plain"
+            mimes.size == 1 -> mimes.first()
+            mimes.all { it.startsWith("image/") } -> "image/*"
+            else -> "*/*"
+        }
+        if (message.isNotEmpty()) intent.putExtra(Intent.EXTRA_TEXT, message)
+        if (uris.size == 1) intent.putExtra(Intent.EXTRA_STREAM, uris[0])
+        else if (uris.size > 1) intent.putParcelableArrayListExtra(Intent.EXTRA_STREAM, uris)
+        if (uris.isNotEmpty()) {
+            intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
+            intent.clipData = ClipData.newRawUri("", uris[0]).also { c -> for (u in uris.drop(1)) c.addItem(ClipData.Item(u)) }
+        }
+        try {
+            app.startActivity(Intent.createChooser(intent, title.ifEmpty { null }))
+            reply(mapOf("action" to "sharedAction"), null)
+        } catch (e: Throwable) {
+            reply(null, e.message ?: e.toString())
+        }
+    }
+}

pyxpo_sharing-0.1.0a1/pyxpo_sharing/ios/ShareModule.swift

@@ -0,0 +1,33 @@
+import UIKit
+
+/// System share sheet (UIActivityViewController). Replies once the sheet closes.
+final class ShareModule: PxModule {
+    static let moduleName = "Share"
+
+    required init() {}
+
+    func call(_ ctx: PxModuleContext, _ method: String, _ args: [Any], _ reply: @escaping PxReply) {
+        guard method == "share" else { reply(nil, "unknown native call Share.\(method)"); return }
+        let paths = (args.first as? [Any])?.compactMap { $0 as? String } ?? []
+        let message = (args.count > 1 ? args[1] as? String : nil) ?? ""
+        var items: [Any] = []
+        if !message.isEmpty { items.append(message) }
+        for p in paths {
+            let path = p.hasPrefix("file://") ? (URL(string: p)?.path ?? p) : p
+            guard FileManager.default.fileExists(atPath: path) else { reply(nil, "file not found: \((path as NSString).lastPathComponent)"); return }
+            items.append(URL(fileURLWithPath: path))
+        }
+        guard let top = ctx.presenter() else { reply(nil, "no view controller to present the share sheet"); return }
+        let vc = UIActivityViewController(activityItems: items, applicationActivities: nil)
+        vc.completionWithItemsHandler = { _, completed, _, err in
+            if let err = err { reply(nil, err.localizedDescription); return }
+            reply(["action": completed ? "sharedAction" : "dismissedAction"], nil)
+        }
+        if let pop = vc.popoverPresentationController {
+            pop.sourceView = top.view
+            pop.sourceRect = CGRect(x: top.view.bounds.midX, y: top.view.bounds.midY, width: 0, height: 0)
+            pop.permittedArrowDirections = []
+        }
+        top.present(vc, animated: true)
+    }
+}

pyxpo_sharing-0.1.0a1/pyxpo_sharing/pyxpo-module.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "nativeContract": 1,
+  "name": "sharing",
+  "native": "Share",
+  "ios": { "classes": ["ShareModule"] },
+  "android": {
+    "namespace": "dev.pyxpo.modules.sharing",
+    "classes": ["dev.pyxpo.modules.sharing.ShareModule"],
+    "dependencies": [],
+    "minSdk": 24
+  }
+}

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: pyxpo-sharing
+Version: 0.1.0a1
+Summary: System share sheet for pyxpo apps (react-native Share and expo-sharing shapes).
+Author: Vishal Chaubey
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pyxpo/pyxpo/tree/main/packages/sharing
+Project-URL: Issues, https://github.com/pyxpo/pyxpo/issues
+Keywords: pyxpo,pyxpo-module,mobile,android,ios
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyxpo<0.2,>=0.1.0a1
+Dynamic: license-file
+
+# pyxpo-sharing
+
+System share sheet for pyxpo apps (react-native Share shape).
+
+This is an optional [pyxpo](https://github.com/pyxpo/pyxpo) native module. Apps that do not
+list it carry none of its code, permissions or dependencies.
+
+## Install
+
+```bash
+pip install pyxpo-sharing
+```
+
+Then link it into your app in `pyproject.toml`:
+
+```toml
+[tool.pyxpo]
+modules = ["sharing"]
+```
+
+and rebuild (`pyxpo run ios`, `pyxpo build android`, ...). The build copies the module's Swift and Kotlin
+sources into the native project and its Python package into the app.
+
+## Use
+
+```python
+from pyxpo_sharing import Share
+
+await Share.share({"url": path, "message": "Made with pyxpo"})
+```
+
+Permissions and Info.plist keys: none (Android shares through a FileProvider declared in the module manifest).
+
+## What is in the package
+
+- `pyxpo_sharing/__init__.py`: the Python API.
+- `pyxpo_sharing/pyxpo-module.json`: autolink metadata (bridge name, Swift and Kotlin classes, Android namespace and dependencies, Info.plist keys).
+- `pyxpo_sharing/ios/`: Swift sources compiled into the iOS app.
+- `pyxpo_sharing/android/src/main/`: Kotlin sources and the manifest merged into the Android app.

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+pyxpo_sharing/__init__.py
+pyxpo_sharing/py.typed
+pyxpo_sharing/pyxpo-module.json
+pyxpo_sharing.egg-info/PKG-INFO
+pyxpo_sharing.egg-info/SOURCES.txt
+pyxpo_sharing.egg-info/dependency_links.txt
+pyxpo_sharing.egg-info/entry_points.txt
+pyxpo_sharing.egg-info/requires.txt
+pyxpo_sharing.egg-info/top_level.txt
+pyxpo_sharing/android/src/main/AndroidManifest.xml
+pyxpo_sharing/android/src/main/java/dev/pyxpo/modules/sharing/PxShareFileProvider.kt
+pyxpo_sharing/android/src/main/java/dev/pyxpo/modules/sharing/ShareModule.kt
+pyxpo_sharing/ios/ShareModule.swift

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pyxpo.modules]
+sharing = pyxpo_sharing

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/requires.txt

@@ -0,0 +1 @@
+pyxpo<0.2,>=0.1.0a1

pyxpo_sharing-0.1.0a1/pyxpo_sharing.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyxpo_sharing

pyxpo_sharing-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+