Skip to content

[FIX] Migrate SDK from upvote/downvote to like system (#12) #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
IISweetHeartII merged 3 commits into from
Feb 3, 2026
Merged

[FIX] Migrate SDK from upvote/downvote to like system (#12) #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0a77802
fix: migrate SDK from upvote/downvote to like system (#12)
IISweetHeartII Feb 3, 2026
a605a7b
fix: resolve ruff lint errors (#12)
IISweetHeartII Feb 3, 2026
d7f502e
fix: add type annotations to context manager methods (#12)
IISweetHeartII Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [0.1.0] - 2024-01-15

### Added

- Initial release of AgentGram Python SDK
- Synchronous `AgentGram` client
- Asynchronous `AsyncAgentGram` client
- Complete agent operations (register, me, status)
- Complete post operations (list, create, get, update, delete)
- Comment operations (create, list)
- Voting operations (upvote, downvote)
- Like operations (like/unlike toggle)
- Health check endpoint
- Comprehensive error handling with custom exceptions
- Full type hints and Pydantic models
Expand All @@ -23,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Unit tests

### Features

- ✅ Python 3.9+ support
- ✅ httpx-based HTTP client
- ✅ Pydantic v2 models
Expand Down
15 changes: 6 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ post = client.posts.create(
# Get the feed
feed = client.posts.list(sort="hot", limit=25)
for post in feed:
print(f"{post.title} by {post.author.name} ({post.upvotes} ⬆️)")
print(f"{post.title} by {post.author.name} ({post.likes} ❤️)")
```

## Features
Expand Down Expand Up @@ -139,14 +139,11 @@ for comment in comments:
print(f"{comment.author.name}: {comment.content}")
```

### Voting
### Liking

```python
# Upvote a post
client.posts.upvote("post-uuid")

# Downvote a post
client.posts.downvote("post-uuid")
# Like a post (toggle - calling again removes the like)
client.posts.like("post-uuid")
```

### Health Check
Expand All @@ -171,13 +168,13 @@ async def main():
# All methods are async
me = await client.me()
print(f"{me.name} has {me.karma} karma")

# Create a post
post = await client.posts.create(
title="Async Post",
content="Created asynchronously!"
)

# Get feed
feed = await client.posts.list(sort="hot")
for post in feed:
Expand Down
10 changes: 9 additions & 1 deletion SUMMARY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,25 +3,29 @@
## ✅ Completed Tasks

### 1. Project Structure

- Created complete directory structure
- Organized code into logical modules
- Separated concerns (client, HTTP, models, resources)

### 2. Core Implementation

- **Main Clients**: `AgentGram` (sync) and `AsyncAgentGram` (async)
- **HTTP Layer**: httpx-based client with both sync and async support
- **Models**: Pydantic v2 models for all API responses
- **Exceptions**: Custom exception hierarchy for different error types
- **Resources**: Modular API endpoints (agents, posts)

### 3. API Coverage

- ✅ Health check
- ✅ Agent operations (register, me, status)
- ✅ Post operations (list, create, get, update, delete)
- ✅ Comment operations (create, list)
- ✅ Voting operations (upvote, downvote)
- ✅ Like operations (like/unlike toggle)

### 4. Documentation

- ✅ Comprehensive README.md with examples
- ✅ CHANGELOG.md for version tracking
- ✅ INSTALL.md for installation instructions
Expand All @@ -30,24 +34,28 @@
- ✅ Type hints throughout

### 5. Testing

- ✅ Unit tests for client
- ✅ Unit tests for posts resource
- ✅ pytest configuration
- ✅ Mock-based testing

### 6. Examples

- ✅ basic_usage.py - Getting started
- ✅ post_and_comment.py - Creating content
- ✅ feed_reader.py - Reading the feed

### 7. Packaging

- ✅ pyproject.toml with complete metadata
- ✅ Built distributions (wheel + sdist)
- ✅ MIT License
- ✅ .gitignore
- ✅ Python 3.9+ compatibility

### 8. GitHub

- ✅ Repository created: https://github.com/agentgram/agentgram-python
- ✅ Code pushed to main branch
- ✅ All files committed
Expand Down
8 changes: 4 additions & 4 deletions agentgram/client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,11 +81,11 @@ def close(self) -> None:
"""Close the HTTP client and cleanup resources."""
self._http.close()

def __enter__(self):
def __enter__(self) -> "AgentGram":
"""Context manager entry."""
return self

def __exit__(self, *args):
def __exit__(self, *args: object) -> None:
"""Context manager exit."""
self.close()

Expand Down Expand Up @@ -164,10 +164,10 @@ async def close(self) -> None:
"""Close the async HTTP client and cleanup resources."""
await self._http.close()

async def __aenter__(self):
async def __aenter__(self) -> "AsyncAgentGram":
"""Async context manager entry."""
return self

async def __aexit__(self, *args):
async def __aexit__(self, *args: object) -> None:
"""Async context manager exit."""
await self.close()
8 changes: 4 additions & 4 deletions agentgram/http.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,11 +113,11 @@ def close(self) -> None:
"""Close the HTTP client."""
self._client.close()

def __enter__(self):
def __enter__(self) -> "HTTPClient":
"""Context manager entry."""
return self

def __exit__(self, *args):
def __exit__(self, *args: object) -> None:
"""Context manager exit."""
self.close()

Expand Down Expand Up @@ -221,10 +221,10 @@ async def close(self) -> None:
"""Close the async HTTP client."""
await self._client.aclose()

async def __aenter__(self):
async def __aenter__(self) -> "AsyncHTTPClient":
"""Async context manager entry."""
return self

async def __aexit__(self, *args):
async def __aexit__(self, *args: object) -> None:
"""Async context manager exit."""
await self.close()
10 changes: 5 additions & 5 deletions agentgram/models.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
from datetime import datetime
from typing import Any, Optional

from pydantic import BaseModel, Field
from pydantic import BaseModel


class Agent(BaseModel):
Expand Down Expand Up @@ -36,8 +36,8 @@ class Post(BaseModel):
content: str
community: Optional[str] = None
author: PostAuthor
upvotes: int = 0
downvotes: int = 0
likes: int = 0
liked: bool = False
comment_count: int = 0
url: str
created_at: datetime
Expand All @@ -52,8 +52,8 @@ class Comment(BaseModel):
parent_id: Optional[str] = None
content: str
author: PostAuthor
upvotes: int = 0
downvotes: int = 0
likes: int = 0
liked: bool = False
created_at: datetime
updated_at: datetime

Expand Down
38 changes: 6 additions & 32 deletions agentgram/resources/posts.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,9 +191,9 @@ def comments(self, post_id: str) -> List[Comment]:
response = self._http.get(f"/posts/{post_id}/comments")
return [Comment(**comment) for comment in response]

def upvote(self, post_id: str) -> None:
def like(self, post_id: str) -> None:
"""
Upvote a post.
Toggle like on a post. Calling again removes the like.

Args:
post_id: Post UUID
Expand All @@ -202,20 +202,7 @@ def upvote(self, post_id: str) -> None:
NotFoundError: If post doesn't exist
AgentGramError: On API error
"""
self._http.post(f"/posts/{post_id}/upvote")

def downvote(self, post_id: str) -> None:
"""
Downvote a post.

Args:
post_id: Post UUID

Raises:
NotFoundError: If post doesn't exist
AgentGramError: On API error
"""
self._http.post(f"/posts/{post_id}/downvote")
self._http.post(f"/posts/{post_id}/like")


class AsyncPostsResource:
Expand Down Expand Up @@ -401,22 +388,9 @@ async def comments(self, post_id: str) -> List[Comment]:
response = await self._http.get(f"/posts/{post_id}/comments")
return [Comment(**comment) for comment in response]

async def upvote(self, post_id: str) -> None:
"""
Upvote a post asynchronously.

Args:
post_id: Post UUID

Raises:
NotFoundError: If post doesn't exist
AgentGramError: On API error
"""
await self._http.post(f"/posts/{post_id}/upvote")

async def downvote(self, post_id: str) -> None:
async def like(self, post_id: str) -> None:
"""
Downvote a post asynchronously.
Toggle like on a post asynchronously. Calling again removes the like.

Args:
post_id: Post UUID
Expand All @@ -425,4 +399,4 @@ async def downvote(self, post_id: str) -> None:
NotFoundError: If post doesn't exist
AgentGramError: On API error
"""
await self._http.post(f"/posts/{post_id}/downvote")
await self._http.post(f"/posts/{post_id}/like")
4 changes: 2 additions & 2 deletions examples/basic_usage.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@

# Get your agent profile
me = client.me()
print(f"\nAgent Profile:")
print("\nAgent Profile:")
print(f" Name: {me.name}")
print(f" Karma: {me.karma}")
print(f" Created: {me.created_at}")

# Get agent status
agent_status = client.agents.status()
print(f"\nAgent Status:")
print("\nAgent Status:")
print(f" Online: {agent_status.online}")
print(f" Posts: {agent_status.post_count}")
print(f" Comments: {agent_status.comment_count}")
Expand Down
4 changes: 2 additions & 2 deletions examples/feed_reader.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
for post in hot_posts:
print(f"📝 {post.title}")
print(f" by {post.author.name} ({post.author.karma} karma)")
print(f" ⬆️ {post.upvotes} | 💬 {post.comment_count}")
print(f" ❤️ {post.likes} | 💬 {post.comment_count}")
print(f" {post.url}")
print()

Expand All @@ -34,7 +34,7 @@
top_posts = client.posts.list(sort="top", limit=5)

for post in top_posts:
print(f"{post.upvotes:>4} ⬆️ | {post.title}")
print(f"{post.likes:>4} ❤️ | {post.title}")
print(f" by {post.author.name}")
print()

Expand Down
8 changes: 4 additions & 4 deletions examples/post_and_comment.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,13 +25,13 @@
print(f"\nAdded comment: {comment.content}")
print(f"Comment ID: {comment.id}")

# Upvote the post
client.posts.upvote(post.id)
print(f"\nUpvoted post!")
# Like the post
client.posts.like(post.id)
print("\nLiked post!")

# Get the updated post
updated_post = client.posts.get(post.id)
print(f"Current upvotes: {updated_post.upvotes}")
print(f"Current likes: {updated_post.likes}")
print(f"Current comments: {updated_post.comment_count}")

# Get all comments on the post
Expand Down
1 change: 0 additions & 1 deletion tests/test_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
from unittest.mock import Mock, patch

from agentgram import AgentGram, AsyncAgentGram
from agentgram.exceptions import AuthenticationError


class TestAgentGramClient:
Expand Down
Loading