wp_python 0.1.1__tar.gz → 0.1.2__tar.gz

{wp_python-0.1.1 → wp_python-0.1.2}/.gitignore

@@ -23,3 +23,4 @@ wheels/
 env/
 venv/
 .cache/
+*.db

wp_python-0.1.2/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+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.

{wp_python-0.1.1 → wp_python-0.1.2}/PKG-INFO

@@ -1,7 +1,12 @@
 Metadata-Version: 2.4
 Name: wp_python
-Version: 0.1.1
+Version: 0.1.2
 Summary: A Python client for interacting with the WordPress REST API.
+Author-email: Andrew <andrew.neher1@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
 Requires-Dist: hatch>=1.16.3
 Requires-Dist: httpx>=0.28.1

{wp_python-0.1.1 → wp_python-0.1.2}/pyproject.toml

@@ -1,8 +1,17 @@
 [project]
 name = "wp_python"
-version = "0.1.1"
+dynamic = ["version"]
 description = "A Python client for interacting with the WordPress REST API."
+authors = [
+    { name = "Andrew", email = "andrew.neher1@gmail.com"}
+]
 requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
 dependencies = [
     "hatch>=1.16.3",
     "httpx>=0.28.1",
@@ -17,7 +26,13 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src"]
+packages = ["src/wp_python"]
+
+[tool.hatch.build.targets.sdist]
+packages = ["src/wp_python"]
+
+[tool.hatch.version]
+path = "src/wp_python/__init__.py"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{wp_python-0.1.1/src/wordpress_api → wp_python-0.1.2/wp_python}/__init__.py

@@ -4,18 +4,18 @@ WordPress REST API Python Client
 A full-featured Python 3.12 interface to the WordPress REST API.
 """
 
-from .client import WordPressClient
 from .auth import ApplicationPasswordAuth, BasicAuth, JWTAuth, OAuth2Auth
+from .client import WordPressClient
 from .exceptions import (
-    WordPressError,
     AuthenticationError,
     NotFoundError,
-    ValidationError,
     RateLimitError,
     ServerError,
+    ValidationError,
+    WordPressError,
 )
 
-__version__ = "1.0.0"
+__version__ = "0.1.2"
 __all__ = [
     "WordPressClient",
     "ApplicationPasswordAuth",

wp_python-0.1.1/README.md

@@ -1,81 +0,0 @@
-# WordPress REST API Python Client
-
-A full-featured Python 3.12 interface to the WordPress REST API.
-
-## Overview
-
-This library provides a comprehensive, type-safe Python client for interacting with WordPress sites via the REST API. It supports all major WordPress endpoints including posts, pages, media, users, comments, categories, tags, settings, plugins, themes, menus, and more.
-
-## Project Structure
-
-```
-src/wordpress_api/
-├── __init__.py          # Main exports
-├── client.py            # WordPressClient main class
-├── auth.py              # Authentication handlers
-├── exceptions.py        # Custom exceptions
-├── models/              # Pydantic data models
-│   ├── post.py
-│   ├── page.py
-│   ├── media.py
-│   ├── user.py
-│   ├── comment.py
-│   ├── category.py
-│   ├── tag.py
-│   └── ...
-└── endpoints/           # API endpoint classes
-    ├── posts.py
-    ├── pages.py
-    ├── media.py
-    ├── users.py
-    ├── comments.py
-    └── ...
-```
-
-## Quick Start
-
-```python
-from wordpress_api import WordPressClient, ApplicationPasswordAuth
-
-# Authenticate with WordPress Application Passwords
-auth = ApplicationPasswordAuth("username", "xxxx xxxx xxxx xxxx")
-client = WordPressClient("https://your-site.com", auth=auth)
-
-# List posts
-posts = client.posts.list()
-
-# Create a post
-from wordpress_api.models import PostCreate, PostStatus
-post = client.posts.create(PostCreate(
-    title="Hello World",
-    content="<p>My first post!</p>",
-    status=PostStatus.PUBLISH
-))
-
-# Get current user
-me = client.users.me()
-```
-
-## Features
-
-- **Full CRUD Support**: Posts, Pages, Media, Users, Comments, Categories, Tags
-- **Authentication**: Application Passwords, Basic Auth, JWT
-- **Type Safety**: Pydantic models for all WordPress objects
-- **Pagination**: Automatic iteration through all results
-- **Media Upload**: Upload files from path or file objects
-- **Custom Post Types**: Access any registered custom post type
-- **Block Editor**: Access block types and patterns
-- **Error Handling**: Typed exceptions for all API errors
-
-## Dependencies
-
-- httpx: Modern HTTP client
-- pydantic: Data validation using Python type annotations
-
-## Authentication Setup
-
-1. Go to your WordPress site
-2. Navigate to Users → Your Profile
-3. Scroll to "Application Passwords"
-4. Create a new application password
-5. Use it with `ApplicationPasswordAuth`

wp_python-0.1.1/pytest.ini

@@ -1,6 +0,0 @@
-[pytest]
-testpaths = tests
-python_files = test_*.py
-python_classes = Test*
-python_functions = test_*
-addopts = -v --tb=short

wp_python-0.1.1/tests/__init__.py

@@ -1 +0,0 @@
-"""WordPress API Test Suite."""

wp_python-0.1.1/tests/conftest.py

@@ -1,243 +0,0 @@
-"""Pytest fixtures for WordPress API tests."""
-
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
-
-import pytest
-import respx
-import httpx
-
-from wordpress_api import WordPressClient, ApplicationPasswordAuth, BasicAuth, JWTAuth
-
-
-@pytest.fixture
-def base_url():
-    """Return the test WordPress site URL."""
-    return "https://example.com"
-
-
-@pytest.fixture
-def api_url(base_url):
-    """Return the full API URL."""
-    return f"{base_url}/wp-json"
-
-
-@pytest.fixture
-def mock_auth():
-    """Return a mock authentication handler."""
-    return ApplicationPasswordAuth("testuser", "xxxx xxxx xxxx xxxx")
-
-
-@pytest.fixture
-def client(base_url, mock_auth):
-    """Return a WordPress client for testing."""
-    return WordPressClient(base_url, auth=mock_auth)
-
-
-@pytest.fixture
-def unauthenticated_client(base_url):
-    """Return a WordPress client without authentication."""
-    return WordPressClient(base_url)
-
-
-@pytest.fixture
-def mock_post():
-    """Return mock post data."""
-    return {
-        "id": 1,
-        "date": "2024-01-15T10:30:00",
-        "date_gmt": "2024-01-15T10:30:00",
-        "guid": {"rendered": "https://example.com/?p=1"},
-        "modified": "2024-01-15T10:30:00",
-        "modified_gmt": "2024-01-15T10:30:00",
-        "slug": "hello-world",
-        "status": "publish",
-        "type": "post",
-        "link": "https://example.com/hello-world/",
-        "title": {"rendered": "Hello World"},
-        "content": {"rendered": "<p>Hello World content</p>"},
-        "excerpt": {"rendered": "<p>Hello World excerpt</p>"},
-        "author": 1,
-        "featured_media": 0,
-        "comment_status": "open",
-        "ping_status": "open",
-        "sticky": False,
-        "template": "",
-        "format": "standard",
-        "meta": {},
-        "categories": [1],
-        "tags": [],
-    }
-
-
-@pytest.fixture
-def mock_page():
-    """Return mock page data."""
-    return {
-        "id": 10,
-        "date": "2024-01-15T10:30:00",
-        "date_gmt": "2024-01-15T10:30:00",
-        "guid": {"rendered": "https://example.com/?page_id=10"},
-        "modified": "2024-01-15T10:30:00",
-        "modified_gmt": "2024-01-15T10:30:00",
-        "slug": "about",
-        "status": "publish",
-        "type": "page",
-        "link": "https://example.com/about/",
-        "title": {"rendered": "About Us"},
-        "content": {"rendered": "<p>About us content</p>"},
-        "excerpt": {"rendered": ""},
-        "author": 1,
-        "featured_media": 0,
-        "parent": 0,
-        "menu_order": 0,
-        "comment_status": "closed",
-        "ping_status": "closed",
-        "template": "",
-        "meta": {},
-    }
-
-
-@pytest.fixture
-def mock_user():
-    """Return mock user data."""
-    return {
-        "id": 1,
-        "username": "admin",
-        "name": "Admin User",
-        "first_name": "Admin",
-        "last_name": "User",
-        "email": "admin@example.com",
-        "url": "https://example.com",
-        "description": "Site administrator",
-        "link": "https://example.com/author/admin/",
-        "locale": "en_US",
-        "nickname": "admin",
-        "slug": "admin",
-        "registered_date": "2024-01-01T00:00:00",
-        "roles": ["administrator"],
-        "capabilities": {"administrator": True},
-        "extra_capabilities": {},
-        "avatar_urls": {"24": "https://example.com/avatar.jpg"},
-        "meta": {},
-    }
-
-
-@pytest.fixture
-def mock_category():
-    """Return mock category data."""
-    return {
-        "id": 1,
-        "count": 5,
-        "description": "Default category",
-        "link": "https://example.com/category/uncategorized/",
-        "name": "Uncategorized",
-        "slug": "uncategorized",
-        "taxonomy": "category",
-        "parent": 0,
-        "meta": {},
-    }
-
-
-@pytest.fixture
-def mock_tag():
-    """Return mock tag data."""
-    return {
-        "id": 1,
-        "count": 3,
-        "description": "",
-        "link": "https://example.com/tag/python/",
-        "name": "Python",
-        "slug": "python",
-        "taxonomy": "post_tag",
-        "meta": {},
-    }
-
-
-@pytest.fixture
-def mock_comment():
-    """Return mock comment data."""
-    return {
-        "id": 1,
-        "post": 1,
-        "parent": 0,
-        "author": 0,
-        "author_name": "John Doe",
-        "author_email": "john@example.com",
-        "author_url": "",
-        "author_ip": "127.0.0.1",
-        "author_user_agent": "Mozilla/5.0",
-        "date": "2024-01-15T10:30:00",
-        "date_gmt": "2024-01-15T10:30:00",
-        "content": {"rendered": "<p>Great post!</p>"},
-        "link": "https://example.com/hello-world/#comment-1",
-        "status": "approved",
-        "type": "comment",
-        "author_avatar_urls": {},
-        "meta": {},
-    }
-
-
-@pytest.fixture
-def mock_media():
-    """Return mock media data."""
-    return {
-        "id": 100,
-        "date": "2024-01-15T10:30:00",
-        "date_gmt": "2024-01-15T10:30:00",
-        "guid": {"rendered": "https://example.com/wp-content/uploads/image.jpg"},
-        "modified": "2024-01-15T10:30:00",
-        "modified_gmt": "2024-01-15T10:30:00",
-        "slug": "image",
-        "status": "inherit",
-        "type": "attachment",
-        "link": "https://example.com/image/",
-        "title": {"rendered": "Test Image"},
-        "author": 1,
-        "comment_status": "open",
-        "ping_status": "closed",
-        "template": "",
-        "meta": {},
-        "description": {"rendered": ""},
-        "caption": {"rendered": ""},
-        "alt_text": "Test image alt",
-        "media_type": "image",
-        "mime_type": "image/jpeg",
-        "media_details": {
-            "width": 1920,
-            "height": 1080,
-            "file": "2024/01/image.jpg",
-            "filesize": 102400,
-            "sizes": {},
-            "image_meta": {},
-        },
-        "post": None,
-        "source_url": "https://example.com/wp-content/uploads/image.jpg",
-    }
-
-
-@pytest.fixture
-def mock_application_password():
-    """Return mock application password data."""
-    return {
-        "uuid": "12345678-1234-1234-1234-123456789012",
-        "app_id": "",
-        "name": "Test App",
-        "created": "2024-01-15T10:30:00",
-        "last_used": None,
-        "last_ip": None,
-    }
-
-
-@pytest.fixture
-def mock_application_password_created():
-    """Return mock created application password data (includes password)."""
-    return {
-        "uuid": "12345678-1234-1234-1234-123456789012",
-        "app_id": "",
-        "name": "Test App",
-        "created": "2024-01-15T10:30:00",
-        "password": "abcd efgh ijkl mnop",
-    }

wp_python-0.1.1/tests/test_application_passwords.py

@@ -1,167 +0,0 @@
-"""Tests for Application Passwords endpoint."""
-
-import pytest
-import respx
-import httpx
-
-from wordpress_api import WordPressClient
-
-
-class TestApplicationPasswordsEndpoint:
-    """Tests for ApplicationPasswordsEndpoint."""
-
-    @respx.mock
-    def test_list_passwords(self, client, api_url, mock_application_password):
-        """Test listing application passwords."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[mock_application_password])
-        )
-        
-        passwords = client.application_passwords.list()
-        assert len(passwords) == 1
-        assert passwords[0].name == "Test App"
-
-    @respx.mock
-    def test_list_passwords_for_user(self, client, api_url, mock_application_password):
-        """Test listing application passwords for specific user."""
-        respx.get(f"{api_url}/wp/v2/users/1/application-passwords").mock(
-            return_value=httpx.Response(200, json=[mock_application_password])
-        )
-        
-        passwords = client.application_passwords.list(user_id=1)
-        assert len(passwords) == 1
-
-    @respx.mock
-    def test_get_password(self, client, api_url, mock_application_password):
-        """Test getting a specific application password."""
-        uuid = mock_application_password["uuid"]
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords/{uuid}").mock(
-            return_value=httpx.Response(200, json=mock_application_password)
-        )
-        
-        password = client.application_passwords.get(uuid)
-        assert password.uuid == uuid
-        assert password.name == "Test App"
-
-    @respx.mock
-    def test_create_password(self, client, api_url, mock_application_password_created):
-        """Test creating an application password."""
-        respx.post(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(201, json=mock_application_password_created)
-        )
-        
-        result = client.application_passwords.create("Test App")
-        assert result.name == "Test App"
-        assert result.password == "abcd efgh ijkl mnop"
-
-    @respx.mock
-    def test_update_password(self, client, api_url, mock_application_password):
-        """Test updating an application password."""
-        uuid = mock_application_password["uuid"]
-        updated = {**mock_application_password, "name": "Renamed App"}
-        respx.post(f"{api_url}/wp/v2/users/me/application-passwords/{uuid}").mock(
-            return_value=httpx.Response(200, json=updated)
-        )
-        
-        result = client.application_passwords.update(uuid, "Renamed App")
-        assert result.name == "Renamed App"
-
-    @respx.mock
-    def test_delete_password(self, client, api_url, mock_application_password):
-        """Test deleting an application password."""
-        uuid = mock_application_password["uuid"]
-        respx.delete(f"{api_url}/wp/v2/users/me/application-passwords/{uuid}").mock(
-            return_value=httpx.Response(200, json={"deleted": True})
-        )
-        
-        result = client.application_passwords.delete(uuid)
-        assert result["deleted"] is True
-
-    @respx.mock
-    def test_delete_all_passwords(self, client, api_url):
-        """Test deleting all application passwords."""
-        respx.delete(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json={"deleted": 3})
-        )
-        
-        result = client.application_passwords.delete_all()
-        assert result["deleted"] == 3
-
-    @respx.mock
-    def test_get_or_create_existing(self, client, api_url, mock_application_password):
-        """Test get_or_create returns existing password."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[mock_application_password])
-        )
-        
-        result = client.application_passwords.get_or_create("Test App")
-        assert result.name == "Test App"
-
-    @respx.mock
-    def test_get_or_create_new(self, client, api_url, mock_application_password_created):
-        """Test get_or_create creates new password when none exists."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[])
-        )
-        respx.post(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(201, json=mock_application_password_created)
-        )
-        
-        result = client.application_passwords.get_or_create("Test App")
-        assert hasattr(result, "password")
-        assert result.password == "abcd efgh ijkl mnop"
-
-    @respx.mock
-    def test_ensure_exists_returns_existing(self, client, api_url, mock_application_password):
-        """Test ensure_exists returns existing with was_created=False."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[mock_application_password])
-        )
-        
-        result, was_created = client.application_passwords.ensure_exists("Test App")
-        assert result.name == "Test App"
-        assert was_created is False
-
-    @respx.mock
-    def test_ensure_exists_creates_new(self, client, api_url, mock_application_password_created):
-        """Test ensure_exists creates new with was_created=True."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[])
-        )
-        respx.post(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(201, json=mock_application_password_created)
-        )
-        
-        result, was_created = client.application_passwords.ensure_exists("Test App")
-        assert was_created is True
-        assert result.password == "abcd efgh ijkl mnop"
-
-    @respx.mock
-    def test_has_any_true(self, client, api_url, mock_application_password):
-        """Test has_any returns True when passwords exist."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[mock_application_password])
-        )
-        
-        assert client.application_passwords.has_any() is True
-
-    @respx.mock
-    def test_has_any_false(self, client, api_url):
-        """Test has_any returns False when no passwords exist."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[])
-        )
-        
-        assert client.application_passwords.has_any() is False
-
-    @respx.mock
-    def test_count(self, client, api_url, mock_application_password):
-        """Test count returns correct number."""
-        respx.get(f"{api_url}/wp/v2/users/me/application-passwords").mock(
-            return_value=httpx.Response(200, json=[
-                mock_application_password,
-                {**mock_application_password, "uuid": "different-uuid", "name": "Another App"},
-            ])
-        )
-        
-        assert client.application_passwords.count() == 2