businnect 0.0.2__py3-none-any.whl

businnect/__init__.py

@@ -0,0 +1,3 @@
+from .client import Businnect
+
+__all__ = ["Businnect"]

businnect/client.py

@@ -0,0 +1,37 @@
+from businnect.settings import DEFAULT_API_SERVER
+from businnect.resources.micropost import MicropostResource
+from businnect.resources.blog import BlogResource
+import requests
+
+
+class Businnect:
+    """
+    Cliente para a API Businnect.
+
+    Args:
+        api_token: Seu token de API. Gere em https://businnect.com/settings/developer
+        base_url: URL base da API. Padrão: servidor Businnect.
+
+    Example:
+        client = Businnect(api_token="seu_token_aqui")
+    """
+
+    def __init__(
+        self,
+        api_token: str,
+        base_url: str = DEFAULT_API_SERVER,
+    ) -> None:
+        self.api_token = api_token
+        self.base_url = base_url
+        self._headers = {"USER-API-TOKEN": api_token}
+
+        self.micropost = MicropostResource(self)
+        self.blog = BlogResource(self)
+
+    def _request(self, method: str, path: str, **kwargs) -> requests.Response:
+        url = f"{self.base_url}{path}"
+        extra_headers = kwargs.pop("headers", {})
+        headers = {**self._headers, **extra_headers}
+        response = requests.request(method, url, headers=headers, **kwargs)
+        response.raise_for_status()
+        return response

businnect/resources/blog.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Optional
+from businnect.schemas.blog import BlogResponse, BlogListResponse
+
+if TYPE_CHECKING:
+    from ..client import Businnect
+
+
+class BlogResource:
+    def __init__(self, client: "Businnect"):
+        self._client = client
+
+    def client_get_admin_blog(self) -> Optional[BlogResponse]:
+        """
+        Retorna um artigo público do admin.
+
+        Returns:
+            BlogResponse ou None se não houver artigo.
+        """
+        response = self._client._request("GET", "/api/v1/client/admin/blog")
+        data = response.json()
+        if data is None:
+            return None
+        return BlogResponse(**data)
+
+    def client_list_admin_blogs(self) -> BlogListResponse:
+        """
+        Retorna a lista de artigos públicos do admin.
+
+        Returns:
+            BlogListResponse com list, total_list e total_pages.
+        """
+        response = self._client._request("GET", "/api/v1/client/admin/blog/list")
+        return BlogListResponse(**response.json())

businnect/resources/micropost.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Optional
+from requests_toolbelt.multipart.encoder import MultipartEncoder
+
+from businnect.schemas.micropost import PostType
+from businnect.schemas.common import CreatedWithPublicIdAndLinkResponse, VoteResponse
+
+if TYPE_CHECKING:
+    from ..client import Businnect
+
+
+class MicropostResource:
+    def __init__(self, client: "Businnect"):
+        self._client = client
+
+    def client_create_micropost(
+        self,
+        body: str,
+        title: Optional[str] = None,
+        post_type: PostType = PostType.TEXT,
+        community_name: Optional[str] = None,
+        parent_micropost_public_id: Optional[str] = None,
+        parent_micropost_comment_public_id: Optional[str] = None,
+        allow_comments: bool = True,
+        is_draft: bool = False,
+        file: Optional[tuple] = None,
+    ) -> CreatedWithPublicIdAndLinkResponse:
+        """
+        Cria um micropost (texto, mídia ou reply).
+
+        Args:
+            body: Conteúdo do post.
+            title: Obrigatório para posts originais.
+            post_type: "TEXT" ou "MEDIA". Padrão: TEXT.
+            community_name: Comunidade onde postar (opcional).
+            parent_micropost_public_id: Para replies a um post.
+            parent_micropost_comment_public_id: Para replies aninhados.
+            allow_comments: Se permite comentários. Padrão: True.
+            is_draft: Salvar como rascunho. Padrão: False.
+            file: Tuple (filename, file_object, mime_type) para posts MEDIA.
+
+        Returns:
+            CreatedWithPublicIdAndLinkResponse com public_id e link.
+        """
+        fields = {
+            "body": body,
+            "post_type": post_type,
+            "allow_comments": str(allow_comments).lower(),
+            "is_draft": str(is_draft).lower(),
+        }
+
+        if title:
+            fields["title"] = title
+        if community_name:
+            fields["community_name"] = community_name
+        if parent_micropost_public_id:
+            fields["parent_micropost_public_id"] = parent_micropost_public_id
+        if parent_micropost_comment_public_id:
+            fields["parent_micropost_comment_public_id"] = parent_micropost_comment_public_id
+        if file:
+            fields["file"] = file
+
+        m = MultipartEncoder(fields=fields)
+
+        response = self._client._request(
+            "POST",
+            "/api/v1/client/micropost",
+            data=m,
+            headers={"Content-Type": m.content_type},
+        )
+
+        return CreatedWithPublicIdAndLinkResponse(**response.json())
+
+    def client_delete_micropost(self, public_id: str) -> None:
+        """
+        Deleta um micropost pelo public_id.
+
+        Args:
+            public_id: ID público do post a ser deletado.
+
+        Returns:
+            None (204 No Content em caso de sucesso).
+        """
+        self._client._request(
+            "DELETE",
+            "/api/v1/client/micropost",
+            json={"public_id": public_id},
+        )
+
+    def client_vote_micropost(self, public_id: str) -> VoteResponse:
+        """
+        Vota ou remove o voto de um micropost (toggle).
+
+        Args:
+            public_id: ID público do post.
+
+        Returns:
+            VoteResponse com user_voted (bool).
+        """
+        response = self._client._request(
+            "PATCH",
+            "/api/v1/client/micropost/vote",
+            json={"public_id": public_id},
+        )
+        return VoteResponse(**response.json())

businnect/schemas/__init__.py

@@ -0,0 +1 @@
+

businnect/schemas/blog.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+from enum import Enum, unique
+from typing import List, Optional
+from pydantic import BaseModel
+
+
+@unique
+class BlogCategory(str, Enum):
+    ANNOUNCEMENT = "ANNOUNCEMENT"
+
+
+class BlogItem(BaseModel):
+    body: str
+    category: BlogCategory
+    cover: Optional[str] = None
+    is_featured: bool
+    published_at: str
+    slug: str
+    summary: Optional[str] = None
+    title: str
+
+
+class BlogResponse(BaseModel):
+    body: str
+    category: BlogCategory
+    cover: Optional[str] = None
+    is_featured: bool
+    published_at: str
+    slug: str
+    summary: Optional[str] = None
+    title: str
+
+
+class BlogListResponse(BaseModel):
+    list: List[BlogItem]
+    total_list: int
+    total_pages: int

businnect/schemas/common.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel
+
+
+class CreatedWithPublicIdAndLinkResponse(BaseModel):
+    public_id: str
+    link: str
+
+
+class VoteResponse(BaseModel):
+    user_voted: bool

businnect/schemas/micropost.py

@@ -0,0 +1,6 @@
+from enum import Enum, unique
+
+@unique
+class PostType(str, Enum):
+    TEXT = "TEXT"
+    MEDIA = "MEDIA"

businnect/settings.py

@@ -0,0 +1 @@
+DEFAULT_API_SERVER = "https://api.businnect.com"

businnect/tests/test_businnect_integration.py

@@ -0,0 +1,24 @@
+# Unit tests
+
+import httpx
+import pytest
+from unittest.mock import MagicMock, patch
+
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from client import Businnect
+
+# $pip install -e .
+# $BUSINNECT_API_TOKEN=yours python -m pytest businnect/tests/test_businnect_integration.py -v -s
+# @pytest.mark.skip(reason="already tested")
+def test_client_create_micropost():
+    client = Businnect(api_token=os.environ["BUSINNECT_API_TOKEN"])
+    try:
+        response = client.micropost.client_create_micropost(title="Test", body="Hello")
+        assert response.public_id is not None
+    except Exception as e:
+        if hasattr(e, 'response'):
+            print(repr(e.response.text))
+        raise

businnect/tests/test_businnect_unit.py

@@ -0,0 +1,131 @@
+# Testes unitários
+# pip install -e .
+# pytest businnect/tests/test_businnect_unit.py -v
+
+import pytest
+from unittest.mock import MagicMock, patch
+
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from client import Businnect
+from settings import DEFAULT_API_SERVER
+
+
+@pytest.fixture
+def client():
+    return Businnect(api_token="test_token")
+
+
+# --- Client ---
+
+def test_init(client):
+    assert client.api_token == "test_token"
+    assert client._headers == {"USER-API-TOKEN": "test_token"}
+    assert client.base_url == DEFAULT_API_SERVER
+
+
+@patch("businnect.client.requests.request")
+def test_request_success(mock_request, client):
+    mock_response = MagicMock()
+    mock_response.status_code = 200
+    mock_request.return_value = mock_response
+
+    response = client._request("GET", "/some/path")
+
+    mock_request.assert_called_once_with(
+        "GET",
+        f"{DEFAULT_API_SERVER}/some/path",
+        headers={"USER-API-TOKEN": "test_token"},
+    )
+    assert response == mock_response
+
+
+@patch("businnect.client.requests.request")
+def test_request_raises_on_error(mock_request, client):
+    import requests as req
+    mock_response = MagicMock()
+    mock_response.raise_for_status.side_effect = req.exceptions.HTTPError("404")
+    mock_request.return_value = mock_response
+
+    with pytest.raises(req.exceptions.HTTPError):
+        client._request("GET", "/bad/path")
+
+
+# --- Micropost ---
+
+@patch("businnect.resources.micropost.MultipartEncoder")
+def test_create_micropost(mock_encoder, client):
+    mock_m = MagicMock()
+    mock_m.content_type = "multipart/form-data; boundary=abc"
+    mock_encoder.return_value = mock_m
+
+    mock_response = MagicMock()
+    mock_response.json.return_value = {"public_id": "abc123", "link": "https://businnect.com/p/abc123"}
+    client._request = MagicMock(return_value=mock_response)
+
+    result = client.micropost.client_create_micropost(title="Teste", body="Olá mundo")
+
+    assert result.public_id == "abc123"
+    assert result.link == "https://businnect.com/p/abc123"
+    client._request.assert_called_once()
+
+
+def test_delete_micropost(client):
+    client._request = MagicMock()
+    client.micropost.client_delete_micropost(public_id="abc123")
+    client._request.assert_called_once_with(
+        "DELETE",
+        "/api/v1/client/micropost",
+        json={"public_id": "abc123"},
+    )
+
+
+def test_vote_micropost(client):
+    mock_response = MagicMock()
+    mock_response.json.return_value = {"user_voted": True}
+    client._request = MagicMock(return_value=mock_response)
+
+    result = client.micropost.client_vote_micropost(public_id="abc123")
+
+    assert result.user_voted is True
+    client._request.assert_called_once_with(
+        "PATCH",
+        "/api/v1/client/micropost/vote",
+        json={"public_id": "abc123"},
+    )
+
+
+# --- Blog ---
+
+def test_get_admin_blog_none(client):
+    mock_response = MagicMock()
+    mock_response.json.return_value = None
+    client._request = MagicMock(return_value=mock_response)
+
+    result = client.blog.client_get_admin_blog()
+    assert result is None
+
+
+def test_list_admin_blogs(client):
+    mock_response = MagicMock()
+    mock_response.json.return_value = {
+        "list": [
+            {
+                "body": "Conteúdo",
+                "category": "ANNOUNCEMENT",
+                "is_featured": True,
+                "published_at": "2026-03-25T16:17:12.799Z",
+                "slug": "meu-artigo",
+                "title": "Meu Artigo",
+            }
+        ],
+        "total_list": 1,
+        "total_pages": 1,
+    }
+    client._request = MagicMock(return_value=mock_response)
+
+    result = client.blog.client_list_admin_blogs()
+    assert result.total_list == 1
+    assert result.list[0].slug == "meu-artigo"

businnect-0.0.2.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: businnect
+Version: 0.0.2
+Summary: Python SDK for the Businnect API
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32.0
+Requires-Dist: requests-toolbelt>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Dynamic: license-file
+
+# Businnect Python
+
+The official Python SDK for the [Businnect](https://businnect.com) API.
+
+## Installation
+
+```bash
+pip install businnect
+```
+
+## Setup
+
+Find your API token at [https://businnect.com/settings/developer](https://businnect.com/settings/developer) after creating an account at [https://businnect.com/register](https://businnect.com/register).
+
+```python
+from businnect import Businnect
+
+client = Businnect(api_token="your_api_token_here")
+```
+
+---
+
+## Micropost
+
+### Create a post
+
+```python
+from businnect.schemas.micropost import PostType
+
+# Text post
+post = client.micropost.client_create_micropost(
+    title="Hello World",
+    body="This is my first post.",
+)
+print(post.public_id)
+print(post.link)
+
+# Media post
+with open("photo.png", "rb") as f:
+    post = client.micropost.client_create_micropost(
+        title="My photo",
+        body="Check this out",
+        post_type=PostType.MEDIA,
+        file=("photo.png", f, "image/png"),
+    )
+
+# Reply to a post
+reply = client.micropost.client_create_micropost(
+    body="Great post!",
+    parent_micropost_public_id="post_public_id_here",
+)
+
+# Nested reply (reply to a comment)
+nested = client.micropost.client_create_micropost(
+    body="I agree!",
+    parent_micropost_public_id="post_public_id_here",
+    parent_micropost_comment_public_id="comment_public_id_here",
+)
+```
+
+### Delete a post
+
+```python
+client.micropost.client_delete_micropost(public_id="post_public_id_here")
+```
+
+### Vote on a post (toggle)
+
+```python
+result = client.micropost.client_vote_micropost(public_id="post_public_id_here")
+print(result.user_voted)  # True or False
+```
+
+---
+
+## Blog
+
+### Get admin article
+
+```python
+article = client.blog.client_get_admin_blog()
+if article:
+    print(article.title)
+    print(article.body)
+```
+
+### List admin articles
+
+```python
+result = client.blog.client_list_admin_blogs()
+print(result.total_list)
+for article in result.list:
+    print(article.title, article.slug)
+```
+
+---
+
+## API Reference
+
+### `Businnect(api_token, base_url?)`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `api_token` | `str` | Your API token |
+| `base_url` | `str` | API base URL (default: `https://api.businnect.com`) |
+
+---
+
+### `client.micropost.client_create_micropost(...)`
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `body` | `str` | required | Content of the post |
+| `title` | `str` | `None` | Required for original posts |
+| `post_type` | `PostType` | `PostType.TEXT` | `TEXT` or `MEDIA` |
+| `community_name` | `str` | `None` | Community to post in |
+| `parent_micropost_public_id` | `str` | `None` | For replies |
+| `parent_micropost_comment_public_id` | `str` | `None` | For nested replies |
+| `allow_comments` | `bool` | `True` | Whether comments are allowed |
+| `is_draft` | `bool` | `False` | Save as draft |
+| `file` | `tuple` | `None` | `(filename, file_object, mime_type)` for MEDIA posts |
+
+**Returns:** `CreatedWithPublicIdAndLinkResponse` with `public_id` and `link`
+
+---
+
+### `client.micropost.client_delete_micropost(public_id)`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `public_id` | `str` | Public ID of the post to delete |
+
+**Returns:** `None` (204 on success)
+
+---
+
+### `client.micropost.client_vote_micropost(public_id)`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `public_id` | `str` | Public ID of the post to vote on |
+
+**Returns:** `VoteResponse` with `user_voted` (bool)
+
+---
+
+### `client.blog.client_get_admin_blog()`
+
+**Returns:** `BlogResponse` or `None`
+
+---
+
+### `client.blog.client_list_admin_blogs()`
+
+**Returns:** `BlogListResponse` with `list`, `total_list` and `total_pages`
+
+---
+
+## Development
+
+```bash
+# Install in editable mode
+pip install -e .
+
+# Run unit tests
+python -m pytest businnect/tests/test_businnect_unit.py -v
+
+# Run integration tests (requires real API token)
+BUSINNECT_API_TOKEN=your_token python -m pytest businnect/tests/test_businnect_integration.py -v -s
+```
+
+## License
+
+MIT

businnect-0.0.2.dist-info/RECORD

@@ -0,0 +1,17 @@
+businnect/__init__.py,sha256=Ug4w0IpjbQXyryYE3GZu-5_HF7MLoUGtntbT1EQTvf0,54
+businnect/client.py,sha256=c45HQSQQ3kg5Dccc5P1XKZZZYrVwG8tPhG_zFJHBHjU,1160
+businnect/settings.py,sha256=A1PRJGGib2fW3yJLfpHblWyhOOCgc9OhgGHPckTo7vk,48
+businnect/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+businnect/resources/blog.py,sha256=eieZsQBFcddVXZgQzlEhNNIq4swgPdvNl-ZC3izya2o,1050
+businnect/resources/micropost.py,sha256=RB0800Vv18Tqr3axDJJ-ynJWaR7zI_lJi3rf72LQQAM,3487
+businnect/schemas/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+businnect/schemas/blog.py,sha256=-9SVreOyFAXA2NSAjgTv5YGSqZn5ZeRq3yF-l-qKRpc,730
+businnect/schemas/common.py,sha256=m9Sm5-aDHqS1xsLBbCcTun8qeaU1MjphHwU9n7ht8FA,173
+businnect/schemas/micropost.py,sha256=X-NwhGlm5zwk2YLqQ3nv7FlPXiTw1SNDuF1GuPyTriE,103
+businnect/tests/test_businnect_integration.py,sha256=Kf7d_fv8LehPFLRxHhMADrkzYQVB2cha9KFlGqug0Rc,729
+businnect/tests/test_businnect_unit.py,sha256=Dagb8jifCsoIMmWmETx703YmreiVKoRnZJ_O4bb-1bI,3763
+businnect-0.0.2.dist-info/licenses/LICENSE,sha256=RwnK9-0uTiDG9cSNvgDvmgheQ38zQ34oJBwJyno922s,1113
+businnect-0.0.2.dist-info/METADATA,sha256=bHOZTTZObdV00RgQkcyuy0PKuHbxa7J4zn1EUKqtZDQ,4344
+businnect-0.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+businnect-0.0.2.dist-info/top_level.txt,sha256=NM9952km5ZEjn7pKTUrdAg4YOPFFihwx1dmsUTefLXU,10
+businnect-0.0.2.dist-info/RECORD,,

businnect-0.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

businnect-0.0.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Businnect https://www.businnect.com support@businnect.com
+
+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.

businnect-0.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+businnect