planvortex 0.0.1__tar.gz

planvortex-0.0.1/.gitignore

@@ -0,0 +1,23 @@
+# Entornos y build
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+site/
+
+# Cachés de herramientas
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Credenciales
+.env
+.env.live
+
+.DS_Store

planvortex-0.0.1/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this package are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2026-08-26
+
+Placeholder release. It reserves the `planvortex` name on PyPI and proves the trusted-publishing
+pipeline end to end before there is anything to lose. It contains no client.
+
+[Unreleased]: https://github.com/taliasoftworks/PlanVortexPython/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/taliasoftworks/PlanVortexPython/releases/tag/v0.0.1

planvortex-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Talia Softworks
+
+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.

planvortex-0.0.1/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.5
+Name: planvortex
+Version: 0.0.1
+Summary: Official Python client for the PlanVortex API
+Project-URL: Homepage, https://planvortex.com
+Project-URL: Documentation, https://planvortex.com/documentation
+Project-URL: Repository, https://github.com/taliasoftworks/PlanVortexPython
+Project-URL: Changelog, https://github.com/taliasoftworks/PlanVortexPython/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/taliasoftworks/PlanVortexPython/issues
+Author-email: Talia Softworks <contact@planvortex.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bluesky,facebook,instagram,linkedin,planvortex,publishing,scheduling,social media,tiktok
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# planvortex
+
+The official Python client for the [PlanVortex](https://planvortex.com) API — connect social
+accounts, schedule and publish posts, read comments and messages, and pull stats, from Python.
+
+> ## ⚠️ Not released yet
+>
+> **`0.0.1` is a placeholder.** It reserves the name on PyPI and proves the release pipeline; it
+> contains no client and there is nothing useful to install yet. The first usable release will be
+> `0.1.0`.
+>
+> If you need a PlanVortex client today, the Node one is published and complete:
+> [`npm i planvortex`](https://www.npmjs.com/package/planvortex).
+>
+> Watch this repository to hear about `0.1.0`.
+
+## What it will be
+
+- **Synchronous and asynchronous**, same surface: `PlanVortex` and `AsyncPlanVortex`.
+- **Typed**, from the same OpenAPI specification the API publishes at
+  <https://planvortex.com/openapi.json>. Returned shapes are `TypedDict`, so `_id` stays `_id`.
+- **One runtime dependency**, `httpx2` — a different package from `httpx` classic, so it will not
+  collide with whatever your project already uses.
+- **Server-side.** The `client_credentials` flow needs your `client_secret`. Connecting an account
+  from a browser is what the temporal connect token is for.
+- Python 3.10 and newer.
+
+```python
+from planvortex import PlanVortex
+
+pv = PlanVortex()  # reads PLANVORTEX_CLIENT_ID and PLANVORTEX_CLIENT_SECRET
+
+upload = pv.uploads.create(org_id, file="./sourdough.jpg")
+pv.publications.create(
+    org_id,
+    account_id,
+    social_network="instagram",
+    text="New oven, new loaves",
+    files=[upload["_id"]],
+)
+```
+
+## Links
+
+- [API documentation](https://planvortex.com/documentation)
+- [Developers](https://planvortex.com/developers)
+- [Node client](https://github.com/taliasoftworks/PlanVortexNode)
+- [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
+
+MIT © Talia Softworks

planvortex-0.0.1/README.md

@@ -0,0 +1,50 @@
+# planvortex
+
+The official Python client for the [PlanVortex](https://planvortex.com) API — connect social
+accounts, schedule and publish posts, read comments and messages, and pull stats, from Python.
+
+> ## ⚠️ Not released yet
+>
+> **`0.0.1` is a placeholder.** It reserves the name on PyPI and proves the release pipeline; it
+> contains no client and there is nothing useful to install yet. The first usable release will be
+> `0.1.0`.
+>
+> If you need a PlanVortex client today, the Node one is published and complete:
+> [`npm i planvortex`](https://www.npmjs.com/package/planvortex).
+>
+> Watch this repository to hear about `0.1.0`.
+
+## What it will be
+
+- **Synchronous and asynchronous**, same surface: `PlanVortex` and `AsyncPlanVortex`.
+- **Typed**, from the same OpenAPI specification the API publishes at
+  <https://planvortex.com/openapi.json>. Returned shapes are `TypedDict`, so `_id` stays `_id`.
+- **One runtime dependency**, `httpx2` — a different package from `httpx` classic, so it will not
+  collide with whatever your project already uses.
+- **Server-side.** The `client_credentials` flow needs your `client_secret`. Connecting an account
+  from a browser is what the temporal connect token is for.
+- Python 3.10 and newer.
+
+```python
+from planvortex import PlanVortex
+
+pv = PlanVortex()  # reads PLANVORTEX_CLIENT_ID and PLANVORTEX_CLIENT_SECRET
+
+upload = pv.uploads.create(org_id, file="./sourdough.jpg")
+pv.publications.create(
+    org_id,
+    account_id,
+    social_network="instagram",
+    text="New oven, new loaves",
+    files=[upload["_id"]],
+)
+```
+
+## Links
+
+- [API documentation](https://planvortex.com/documentation)
+- [Developers](https://planvortex.com/developers)
+- [Node client](https://github.com/taliasoftworks/PlanVortexNode)
+- [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md)
+
+MIT © Talia Softworks

planvortex-0.0.1/pyproject.toml

@@ -0,0 +1,58 @@
+# NOTA: este pyproject es el del 0.0.1 de RELLENO. Solo tiene lo justo para construir una wheel
+# valida, reservar el nombre en PyPI y ejercitar el trusted publishing. La fase 2 del roadmap lo
+# reescribe entero: httpx2, ruff, mypy --strict, pytest, cobertura y la matriz de CI.
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "planvortex"
+version = "0.0.1"
+description = "Official Python client for the PlanVortex API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Talia Softworks", email = "contact@planvortex.com" }]
+keywords = [
+    "planvortex",
+    "social media",
+    "scheduling",
+    "publishing",
+    "instagram",
+    "facebook",
+    "linkedin",
+    "tiktok",
+    "bluesky",
+]
+classifiers = [
+    # 1 - Planning, porque es exactamente lo que es: un hueco reservado. La 0.1.0 lo sube a 4 - Beta.
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+# Sin dependencias a proposito: el relleno no importa nada. httpx2 entra en la fase 2, cuando haya
+# un cliente que lo use, y no antes: nadie deberia arrastrar una transitiva por instalar un hueco.
+dependencies = []
+
+[project.urls]
+Homepage = "https://planvortex.com"
+Documentation = "https://planvortex.com/documentation"
+Repository = "https://github.com/taliasoftworks/PlanVortexPython"
+Changelog = "https://github.com/taliasoftworks/PlanVortexPython/blob/main/CHANGELOG.md"
+Issues = "https://github.com/taliasoftworks/PlanVortexPython/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/planvortex"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "README.md", "CHANGELOG.md", "LICENSE", "pyproject.toml"]

planvortex-0.0.1/src/planvortex/__init__.py

@@ -0,0 +1,11 @@
+"""Official Python client for the PlanVortex API.
+
+This ``0.0.1`` is a **placeholder**. It reserves the name on PyPI and proves the release
+pipeline; it contains no client. The first usable release is ``0.1.0``.
+
+See https://github.com/taliasoftworks/PlanVortexPython
+"""
+
+__version__ = "0.0.1"
+
+__all__ = ["__version__"]