Initial release

Author: DSorlov

.DS_Store

@@ -1,8 +1,13 @@
 .DS_Store
+.env
+venv/
 __pycache__/
 *.pyc
-env/
-venv/
-.idea/
-.vscode/
-*.log
+*.pyo
+*.pyd
+docker-compose.yml
+Dockerfile
+test_api.py
+test.json
+test.sh
+docker/

.gitattributes

@@ -1,37 +1,24 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.0] (2025-10-03)
+## [Unreleased]
 
-### Initial Release
-A Home Assistant integration for HTTP operations with template support and automatic sensor polling.
+## [1.0.0] - 2025-10-08
 
 ### Added
-- **HTTP Services**: Complete HTTP request service with support for all major methods (GET, POST, PUT, DELETE, PATCH, HEAD)
-- **Template Engine**: Full Home Assistant template support for URLs, payloads, query parameters, and headers
-- **HTTP Sensors**: Automatic polling sensors with configurable intervals and response extraction
-- **GUI Configuration**: Complete web-based configuration flow for easy setup and management
-- **Sensor Management**: Add, edit, and delete HTTP sensors through the GUI
-- **SSL Options**: Configurable SSL verification settings for secure connections
-- **Multi-language Support**: Translations for 8 languages (English, Swedish, Danish, Finnish, Norwegian, German, Spanish, French)
-- **Error Handling**: Comprehensive error handling with proper logging and user feedback
-- **Status Indicators**: Dynamic icons based on HTTP response status codes
-- **Session Management**: Efficient HTTP session handling with proper cleanup
-- **Response Validation**: Built-in response validation and error reporting
-- **Development Tools**: Complete development environment with linting, formatting, and testing
-
-### Technical Details
-- **Integration Type**: Hub with local polling
-- **Minimum HA Version**: 2024.10+
-- **Python Dependencies**: aiohttp>=3.8.0
-- **Code Quality**: Black formatting, isort import sorting, flake8 linting, mypy type checking
-- **Testing**: Comprehensive GitHub Actions workflows for CI/CD
-- **Validation**: HACS and Hassfest validation for Home Assistant compliance
-
-This marks the first stable release of HTTP Agent, providing a robust foundation for HTTP operations in Home Assistant with enterprise-grade features and Home Assistant best practices.
+- Initial release of HTTP Agent integration
+- Multi-step configuration wizard (URL → Headers → Payload → Sensors)
+- Support for multiple extraction methods (JSON, XML, CSS)
 
-[keep-a-changelog]: http://keepachangelog.com/en/1.0.0/
-[1.0.0]: https://github.com/dsorlov/http_agent
+### Features
+- HTTP methods: GET, POST, PUT, DELETE, PATCH
+- Content types: JSON, XML, form-data, plain text
+- Template rendering for URLs, headers, and payloads
+- Dynamic sensor configuration
+- Error handling and logging
+- Configurable timeout and update intervals
+- Authentication support via headers

.gitignore

@@ -1,79 +1,167 @@
 # Contributing to HTTP Agent
 
-Thank you for your interest in contributing to HTTP Agent! We welcome contributions of all kinds.
+Thank you for your interest in contributing to HTTP Agent! We welcome contributions from the community.
 
 ## How to Contribute
 
 ### Reporting Bugs
-- Use the GitHub issue tracker
-- Follow the bug report template
-- Include logs with debug logging enabled
-- Provide clear reproduction steps
-
-### Requesting Features
-- Use the GitHub issue tracker
-- Follow the feature request template
-- Explain the use case clearly
-- Consider backward compatibility
-
-### Code Contributions
-
-#### Development Setup
-1. Fork the repository
-2. Clone your fork
-3. Install development dependencies:
+
+If you find a bug, please create an issue on GitHub with the following information:
+
+- **Description**: A clear description of the bug
+- **Steps to Reproduce**: Detailed steps to reproduce the issue
+- **Expected Behavior**: What you expected to happen
+- **Actual Behavior**: What actually happened
+- **Environment**:
+  - Home Assistant version
+  - HTTP Agent version
+  - Browser (if UI-related)
+- **Logs**: Relevant error messages or logs from Home Assistant
+
+### Suggesting Enhancements
+
+We welcome feature requests! Please create an issue with:
+
+- **Description**: A clear description of the enhancement
+- **Use Case**: Why this feature would be useful
+- **Proposed Solution**: If you have ideas on how to implement it
+
+### Pull Requests
+
+We actively welcome pull requests!
+
+#### Before You Start
+
+1. Check existing issues and PRs to avoid duplicates
+2. For major changes, please open an issue first to discuss
+3. Fork the repository and create a branch from `main`
+
+#### Code Guidelines
+
+- **Code Style**: Follow PEP 8 guidelines
+- **Formatting**: Use `black` for code formatting:
+  ```bash
+  black custom_components/
+  ```
+- **Import Sorting**: Use `isort` for import organization:
+  ```bash
+  isort custom_components/
+  ```
+- **Linting**: Run `flake8` to check for issues:
+  ```bash
+  flake8 custom_components/ --count --select=E9,F63,F7,F82 --show-source --statistics
+  ```
+
+#### Testing
+
+Before submitting a PR, ensure:
+
+1. **Code Quality Checks Pass**:
+   ```bash
+   black --check custom_components/
+   isort --check-only custom_components/
+   flake8 custom_components/ --count --select=E9,F63,F7,F82 --show-source --statistics
+   ```
+
+2. **Python Syntax Validation**:
    ```bash
-   pip install -r requirements-dev.txt
+   python -m py_compile custom_components/http_agent/*.py
    ```
 
-#### Code Standards
-- Follow PEP 8 style guidelines
-- Use Black for code formatting: `black custom_components/http_agent`
-- Sort imports with isort: `isort custom_components/http_agent`
-- Run flake8 for linting: `flake8 custom_components/http_agent`
+3. **API Tests Pass**:
+   ```bash
+   python3 test_api.py
+   ```
 
-#### Testing
-- Ensure all GitHub Actions pass
-- Test with different Home Assistant versions if possible
-- Add tests for new features when applicable
+4. **Integration Works**: Test in Home Assistant using the Docker environment
 
-#### Pull Requests
-1. Create a feature branch from `main`
-2. Make your changes
-3. Ensure all tests pass
-4. Update documentation if needed
-5. Submit a pull request with a clear description
+#### Translation Guidelines
+
+If adding or modifying translations:
+
+1. Always update `custom_components/http_agent/strings.json` first
+2. Update all language files in `custom_components/http_agent/translations/`:
+   - `en.json` (English)
+   - `sv.json` (Swedish)
+   - `da.json` (Danish)
+   - `de.json` (German)
+   - `fi.json` (Finnish)
+   - `no.json` (Norwegian)
+3. Ensure all files maintain the same key structure (203 keys)
+4. Validate JSON syntax:
+   ```bash
+   python3 -m json.tool custom_components/http_agent/translations/LANGUAGE.json
+   ```
 
 #### Commit Messages
+
 - Use clear, descriptive commit messages
-- Start with a verb (Add, Fix, Update, etc.)
-- Keep the first line under 50 characters
-- Add details in the body if needed
+- Start with a verb in present tense (e.g., "Add", "Fix", "Update")
+- Reference issue numbers when applicable
 
-## Development Guidelines
+Example:
+```
+Add support for custom authentication headers (#123)
 
-### Code Structure
-- Follow Home Assistant integration patterns
-- Use async/await for I/O operations
-- Handle errors gracefully
-- Add proper logging
+- Add new config flow step for auth configuration
+- Update coordinator to handle auth headers
+- Add tests for authentication
+```
+
+#### Pull Request Process
+
+1. Update documentation if needed
+2. Update CHANGELOG.md with your changes
+3. Ensure all CI checks pass
+4. Request review from maintainers
+5. Address any feedback
 
 ### Documentation
-- Update README.md for user-facing changes
-- Update docstrings for code changes
-- Add examples for new features
 
-### Internationalization
-- Add translation keys to all language files
-- Use descriptive translation keys
-- Test with different languages
+- Update README.md if you change functionality
+- Add code comments for complex logic
+- Update configuration examples if needed
+
+## Code of Conduct
+
+### Our Pledge
+
+We are committed to providing a welcoming and inclusive environment for everyone.
 
-## Getting Help
+### Our Standards
 
-- Check existing issues and pull requests
-- Ask questions in GitHub Discussions
-- Join the Home Assistant community forums
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards others
+
+Examples of unacceptable behavior:
+
+- Harassment or discriminatory language
+- Trolling or insulting comments
+- Personal or political attacks
+- Publishing others' private information
+- Other conduct which could reasonably be considered inappropriate
+
+### Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project maintainers. All complaints will be reviewed and investigated promptly and fairly.
+
+## Questions?
+
+If you have questions, feel free to:
+
+- Open an issue for discussion
+- Check existing documentation
+- Review closed issues and PRs
 
 ## License
 
-By contributing, you agree that your contributions will be licensed under the MIT License.
+By contributing, you agree that your contributions will be licensed under the same license as the project (see LICENSE file).
+
+---
+
+Thank you for contributing to HTTP Agent! 🎉