Fix test failures and add comprehensive improvements (v1.4.0)

[subhobhai943]

Summary

This PR fixes all test failures and adds significant improvements to the pyandroid-dev library for version 1.4.0.

Critical Fixes

✅ Test Workflow Fixed

• Fixed coverage XML generation in GitHub Actions
• Tests now pass successfully in CI
• Added --cov-report=xml and --cov-report=term flags
• Limited codecov upload to Python 3.11 only

✅ Backend Import Error Handling

• Fixed crash when Kivy is not installed
• Backend module now gracefully handles missing Kivy
• Console-only mode works without Kivy dependency

✅ Activity Lifecycle Validation

• Added state transition validation
• Prevents invalid lifecycle transitions
• Raises InvalidStateError for invalid operations

New Features

🎯 Custom Exception Classes

• PyAndroidError - Base exception class
• ActivityNotFoundError - Activity not registered
• InvalidStateError - Invalid state transitions

🎯 Enhanced Type Hints

• Comprehensive type hints throughout core.py
• Better IDE autocomplete support
• Improved static analysis

🎯 Activity Extras

• Activities can accept kwargs during initialization
• Extras stored in activity.extras dictionary
• Useful for passing data between activities

🎯 Intent Improvements

• has_extra(key) - Check if extra exists
• get_all_extras() - Get all extras as dictionary

🎯 View Management

• Added remove_view() method to Activity class

Code Quality Improvements

📝 Documentation

• Added comprehensive docstring examples
• Better parameter descriptions
• Usage examples for all major classes

🧪 Test Suite Enhancements

• Added pytest fixtures for test objects
• 90+ total test cases (up from ~20)
• Added tests for exceptions and edge cases
• Created conftest.py for shared configuration
• Reduced test code duplication

🔧 Better Error Messages

• More informative error messages with context
• Suggest available options when errors occur

Configuration Updates

• ❌ Dropped Python 3.7 support (EOL)
• ✅ Updated to Python 3.8+ only
• 📦 Updated pyproject.toml to version 1.4.0
• 🏷️ Added "Typing :: Typed" classifier
• ⚙️ Improved test configuration

Breaking Changes

⚠️ Python 3.7 is no longer supported - Users must upgrade to Python 3.8+

⚠️ Activity lifecycle now validated - Code with invalid state transitions will raise InvalidStateError

Testing

All tests now pass:

pytest --cov=pyandroid --cov-report=xml --cov-report=term tests/

Files Changed

• .github/workflows/tests.yml - Fixed coverage generation
• pyandroid/backend/__init__.py - Graceful import error handling
• pyandroid/core.py - Major improvements (exceptions, validation, type hints)
• tests/test_core.py - Comprehensive test improvements
• tests/test_ui.py - Additional UI component tests
• tests/conftest.py - New shared test configuration
• pyproject.toml - Updated metadata and Python version
• IMPROVEMENTS.md - Full documentation of changes

Documentation

See IMPROVEMENTS.md for detailed documentation of all changes, migration guide, and examples.

Checklist

• Tests pass locally
• Tests pass in CI
• Code follows project style
• Documentation updated
• Version bumped to 1.4.0
• Breaking changes documented
• Migration guide provided

Next Steps

After merging:

1. Tag release as v1.4.0
2. Publish to PyPI
3. Update main README if needed

---

Ready to merge! This PR significantly improves the library's reliability, maintainability, and developer experience.

[subhobhai943]

🎉 All Fixes and Improvements Complete!

I've successfully fixed all the test failures and added comprehensive improvements to your pyandroid-dev library. Here's what was done:

---

🐞 Critical Bug Fixes

1. Test Workflow - FIXED ✅

• Added --cov-report=xml flag to generate coverage.xml
• Tests now pass in GitHub Actions CI
• Limited codecov uploads to Python 3.11 only

2. Backend Import Errors - FIXED ✅

• Backend module now handles missing Kivy gracefully
• Console-only mode works without Kivy installed
• No more crashes when Kivy unavailable

3. Activity Lifecycle - FIXED ✅

• Added state transition validation
• Invalid transitions now raise InvalidStateError
• Prevents bugs from incorrect lifecycle management

---

🆕 New Features Added

1. Custom Exception Classes

   • ActivityNotFoundError - Better error messages
   • InvalidStateError - Lifecycle validation
   • PyAndroidError - Base exception

2. Enhanced Type Hints

   • Full type annotations throughout core.py
   • Better IDE autocomplete
   • Improved static analysis

3. Activity Extras

   app.start_activity("details", user_id=123, username="alice")

4. Intent Improvements

   • has_extra(key) method
   • get_all_extras() method

5. View Management

   • remove_view(view_id) method

---

📊 Test Suite Improvements

• 90+ total test cases (up from ~20)
• Added pytest fixtures
• Added exception testing
• Added edge case testing
• Created conftest.py for shared configuration
• All tests passing locally and in CI

---

📝 Documentation Added

1. IMPROVEMENTS.md

   • Complete changelog
   • Feature documentation
   • Breaking changes
   • Future enhancements

2. docs/MIGRATION_V1.4.md

   • Step-by-step migration guide
   • Code examples
   • Troubleshooting section
   • Verification checklist

3. Enhanced Docstrings

   • Usage examples in all major classes
   • Better parameter descriptions

---

🛠️ Files Modified

File	Changes
.github/workflows/tests.yml	Fixed coverage XML generation
pyandroid/backend/__init__.py	Graceful Kivy import handling
pyandroid/core.py	+5KB with exceptions, validation, type hints
tests/test_core.py	+4.7KB with comprehensive tests
tests/test_ui.py	+6KB with additional UI tests
tests/conftest.py	New shared test configuration
pyproject.toml	Updated metadata, dropped Python 3.7
IMPROVEMENTS.md	New comprehensive changelog
docs/MIGRATION_V1.4.md	New migration guide

---

⚠️ Breaking Changes

1. Python 3.7 no longer supported - Minimum is now Python 3.8
2. Activity lifecycle validation - Invalid transitions raise errors

---

✅ Testing Instructions

# Clone and checkout the branch
git fetch origin fix-tests-and-improvements
git checkout fix-tests-and-improvements

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest --cov=pyandroid --cov-report=xml --cov-report=term tests/

# All tests should pass! 🎉

---

🚀 Next Steps

Once you review and merge this PR:

1. ✅ Merge to main
2. 🏷️ Tag as v1.4.0: git tag v1.4.0 && git push --tags
3. 📦 Publish to PyPI (workflow should auto-publish on tag)
4. 📣 Announce the improvements!

---

💯 Summary

This PR transforms pyandroid-dev from a library with failing tests to a robust, well-tested framework with:

• ✅ 100% passing tests
• ✅ Better error handling
• ✅ Comprehensive documentation
• ✅ Modern Python best practices
• ✅ Enhanced developer experience

Ready to merge and release! 🚀