socialseed-e2e 0.1.0__tar.gz → 0.1.2__tar.gz

{socialseed_e2e-0.1.0 → socialseed_e2e-0.1.2}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: socialseed-e2e
-Version: 0.1.0
+Version: 0.1.2
 Summary: Framework E2E para testing de APIs REST con Playwright
-Author: Dairon Pérez
+Author: Dairon Pérez Frías
 Author-email: Dairon Pérez Frías <dairon.perezfrias@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/daironpf/socialseed-e2e
@@ -54,12 +54,13 @@ Dynamic: license-file
 
 [![PyPI](https://img.shields.io/pypi/v/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
 [![Python](https://img.shields.io/pypi/pyversions/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
-[![CI](https://github.com/daironpf/socialseed-e2e/workflows/CI/badge.svg)](https://github.com/daironpf/socialseed-e2e/actions)
 [![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://daironpf.github.io/socialseed-e2e/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Downloads](https://img.shields.io/pypi/dm/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
 
 > **The ultimate E2E testing framework for REST APIs - Built for developers and AI agents**
+>
+> ⚡️ **NEW v2.0**: AI-First design with automatic error prevention, camelCase serialization support, and zero-config setup for Java backends
 
 **One-liner:** Test your REST APIs with 10x less code using intelligent scaffolding, automatic test discovery, and stateful test chaining. Perfect for both manual testing and AI-generated test suites.
 
@@ -74,12 +75,68 @@ Dynamic: license-file
 ### Key Differentiators
 
 - **🤖 AI-Native Architecture**: Structured protocols (`IServicePage`, `ITestModule`) designed for automated test generation
+- **🧠 .agent Awareness**: Automatically generates AI documentation (`.agent/`) for self-guided test generation by LLMs
 - **⚡ 10x Less Code**: Stateful test chaining and automatic discovery eliminate boilerplate
 - **🧪 Built-in Mocking**: Flask-based mock API for testing without external dependencies
 - **🔧 Zero Configuration**: Sensible defaults with YAML/JSON override support
 
 ---
 
+## 🚀 Quick Start
+
+```bash
+# Install
+pip install socialseed-e2e
+playwright install chromium
+
+# Initialize project
+e2e init my-api-tests
+cd my-api-tests
+
+# Create service and test
+e2e new-service users-api
+e2e new-test login --service users-api
+
+# Run tests
+e2e run
+```
+
+📚 **[Complete Quick Start Guide →](https://daironpf.github.io/socialseed-e2e/quickstart.html)**
+
+---
+
+## 🤖 Workflow with AI Agents
+
+socialseed-e2e is designed to be the first **AI-Native Testing Framework**. When you initialize a project with `e2e init`, a `.agent/` folder is created with specific instructions for LLMs (Claude, GPT-4, etc.).
+
+### How to use it:
+
+1. **Initialize**: Run `e2e init` in your project root.
+2. **Prompt your Agent**:
+   > "Read the documentation in the `.agent/` folder to understand the testing framework. Then, scan my API controllers in `../src/controllers/` and generate the corresponding E2E tests following the framework patterns."
+3. **Execute**: Run `e2e run` to verify the generated tests.
+
+The `.agent` folder contains:
+- **`AGENT_GUIDE.md`**: ⭐ **START HERE** - Complete guide with error prevention patterns, camelCase serialization, and common pitfalls to avoid
+- `FRAMEWORK_CONTEXT.md`: Architecture and core concepts.
+- `WORKFLOW_GENERATION.md`: Step-by-step guide for generating tests.
+- `EXAMPLE_TEST.md`: Gold standard code examples.
+
+### 🛡️ AI-First Error Prevention (v2.0)
+
+The framework now includes automatic safeguards for AI-generated code:
+
+- ✅ **Absolute imports only** - No more `ImportError` from relative imports
+- ✅ **CamelCase serialization** - Automatic Pydantic aliases for Java backends
+- ✅ **Dependency management** - `requirements.txt` includes email-validator
+- ✅ **Method naming** - `do_*` prefix prevents attribute/method conflicts
+- ✅ **Header handling** - Manual authentication management (no missing methods)
+- ✅ **Verification script** - Run `python verify_installation.py` to check setup
+
+**Result:** AI agents can generate working E2E tests with minimal or no human intervention.
+
+---
+
 ## 🏗️ Architecture
 
 ### Hexagonal Design
@@ -143,29 +200,6 @@ graph TD;
 
 ---
 
-## 🚀 Quick Start
-
-```bash
-# Install
-pip install socialseed-e2e
-playwright install chromium
-
-# Initialize project
-e2e init my-api-tests
-cd my-api-tests
-
-# Create service and test
-e2e new-service users-api
-e2e new-test login --service users-api
-
-# Run tests
-e2e run
-```
-
-📚 **[Complete Quick Start Guide →](https://daironpf.github.io/socialseed-e2e/quickstart.html)**
-
----
-
 ## 📦 Installation
 
 ```bash
@@ -215,6 +249,7 @@ pytest --cov=socialseed_e2e --cov-report=html
 - ✅ **Mock API**: Flask-based server for integration testing
 - ✅ **CI/CD**: GitHub Actions configured (CI, Release, Docs)
 - ✅ **Documentation**: Complete guides hosted on GitHub Pages
+- ✅ **AI-Ready**: Perfect for automated test generation workflows
 
 ### In Progress
 - 🚧 HTML reports with detailed metrics
@@ -261,9 +296,11 @@ This project recognizes AI agents as legitimate co-authors:
 - **Claude (Anthropic)** - Documentation, feature suggestions, bug fixes
 
 See [AI_CONTRIBUTORS.md](AI_CONTRIBUTORS.md) for full details and contribution philosophy.
-
+this list need updates
 ---
 
+
+
 ## 📚 Documentation
 
 All documentation is hosted on **GitHub Pages** and automatically deployed on every push to main:

{socialseed_e2e-0.1.0 → socialseed_e2e-0.1.2}/README.md

@@ -2,12 +2,13 @@
 
 [![PyPI](https://img.shields.io/pypi/v/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
 [![Python](https://img.shields.io/pypi/pyversions/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
-[![CI](https://github.com/daironpf/socialseed-e2e/workflows/CI/badge.svg)](https://github.com/daironpf/socialseed-e2e/actions)
 [![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://daironpf.github.io/socialseed-e2e/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Downloads](https://img.shields.io/pypi/dm/socialseed-e2e)](https://pypi.org/project/socialseed-e2e/)
 
 > **The ultimate E2E testing framework for REST APIs - Built for developers and AI agents**
+>
+> ⚡️ **NEW v2.0**: AI-First design with automatic error prevention, camelCase serialization support, and zero-config setup for Java backends
 
 **One-liner:** Test your REST APIs with 10x less code using intelligent scaffolding, automatic test discovery, and stateful test chaining. Perfect for both manual testing and AI-generated test suites.
 
@@ -22,12 +23,68 @@
 ### Key Differentiators
 
 - **🤖 AI-Native Architecture**: Structured protocols (`IServicePage`, `ITestModule`) designed for automated test generation
+- **🧠 .agent Awareness**: Automatically generates AI documentation (`.agent/`) for self-guided test generation by LLMs
 - **⚡ 10x Less Code**: Stateful test chaining and automatic discovery eliminate boilerplate
 - **🧪 Built-in Mocking**: Flask-based mock API for testing without external dependencies
 - **🔧 Zero Configuration**: Sensible defaults with YAML/JSON override support
 
 ---
 
+## 🚀 Quick Start
+
+```bash
+# Install
+pip install socialseed-e2e
+playwright install chromium
+
+# Initialize project
+e2e init my-api-tests
+cd my-api-tests
+
+# Create service and test
+e2e new-service users-api
+e2e new-test login --service users-api
+
+# Run tests
+e2e run
+```
+
+📚 **[Complete Quick Start Guide →](https://daironpf.github.io/socialseed-e2e/quickstart.html)**
+
+---
+
+## 🤖 Workflow with AI Agents
+
+socialseed-e2e is designed to be the first **AI-Native Testing Framework**. When you initialize a project with `e2e init`, a `.agent/` folder is created with specific instructions for LLMs (Claude, GPT-4, etc.).
+
+### How to use it:
+
+1. **Initialize**: Run `e2e init` in your project root.
+2. **Prompt your Agent**:
+   > "Read the documentation in the `.agent/` folder to understand the testing framework. Then, scan my API controllers in `../src/controllers/` and generate the corresponding E2E tests following the framework patterns."
+3. **Execute**: Run `e2e run` to verify the generated tests.
+
+The `.agent` folder contains:
+- **`AGENT_GUIDE.md`**: ⭐ **START HERE** - Complete guide with error prevention patterns, camelCase serialization, and common pitfalls to avoid
+- `FRAMEWORK_CONTEXT.md`: Architecture and core concepts.
+- `WORKFLOW_GENERATION.md`: Step-by-step guide for generating tests.
+- `EXAMPLE_TEST.md`: Gold standard code examples.
+
+### 🛡️ AI-First Error Prevention (v2.0)
+
+The framework now includes automatic safeguards for AI-generated code:
+
+- ✅ **Absolute imports only** - No more `ImportError` from relative imports
+- ✅ **CamelCase serialization** - Automatic Pydantic aliases for Java backends
+- ✅ **Dependency management** - `requirements.txt` includes email-validator
+- ✅ **Method naming** - `do_*` prefix prevents attribute/method conflicts
+- ✅ **Header handling** - Manual authentication management (no missing methods)
+- ✅ **Verification script** - Run `python verify_installation.py` to check setup
+
+**Result:** AI agents can generate working E2E tests with minimal or no human intervention.
+
+---
+
 ## 🏗️ Architecture
 
 ### Hexagonal Design
@@ -91,29 +148,6 @@ graph TD;
 
 ---
 
-## 🚀 Quick Start
-
-```bash
-# Install
-pip install socialseed-e2e
-playwright install chromium
-
-# Initialize project
-e2e init my-api-tests
-cd my-api-tests
-
-# Create service and test
-e2e new-service users-api
-e2e new-test login --service users-api
-
-# Run tests
-e2e run
-```
-
-📚 **[Complete Quick Start Guide →](https://daironpf.github.io/socialseed-e2e/quickstart.html)**
-
----
-
 ## 📦 Installation
 
 ```bash
@@ -163,6 +197,7 @@ pytest --cov=socialseed_e2e --cov-report=html
 - ✅ **Mock API**: Flask-based server for integration testing
 - ✅ **CI/CD**: GitHub Actions configured (CI, Release, Docs)
 - ✅ **Documentation**: Complete guides hosted on GitHub Pages
+- ✅ **AI-Ready**: Perfect for automated test generation workflows
 
 ### In Progress
 - 🚧 HTML reports with detailed metrics
@@ -209,9 +244,11 @@ This project recognizes AI agents as legitimate co-authors:
 - **Claude (Anthropic)** - Documentation, feature suggestions, bug fixes
 
 See [AI_CONTRIBUTORS.md](AI_CONTRIBUTORS.md) for full details and contribution philosophy.
-
+this list need updates
 ---
 
+
+
 ## 📚 Documentation
 
 All documentation is hosted on **GitHub Pages** and automatically deployed on every push to main: