spring-ready-python 0.1.0__tar.gz → 1.1.0__tar.gz

spring_ready_python-1.1.0/.env.example

@@ -0,0 +1,90 @@
+# Spring-Ready Python - Environment Configuration Example
+# Copy this file to .env and update with your actual values
+
+# =============================================================================
+# Application Configuration
+# =============================================================================
+
+# Application name (must match Spring Boot naming conventions)
+SPRING_APPLICATION_NAME=python-service
+
+# Application port
+APP_PORT=8080
+
+# Active profile (dev, staging, production, etc.)
+SPRING_PROFILES_ACTIVE=development
+
+# Application version (shown in /actuator/info)
+APP_VERSION=1.0.0
+
+# =============================================================================
+# Eureka Configuration
+# =============================================================================
+
+# IMPORTANT: Eureka server URL(s)
+# - For single server: http://eureka-host:8761/eureka/
+# - For multiple servers (failover): http://eureka1:8761/eureka/,http://eureka2:8761/eureka/
+# - Default if not set: http://localhost:8761/eureka/
+#
+# COMMON MISTAKE: Forgetting to set this for non-localhost deployments!
+# If you see "Using default Eureka server URL" warning, set this variable.
+EUREKA_SERVER_URL=http://10.10.0.1:8761/eureka/
+
+# Custom IP address for Eureka registration (optional)
+# - If not set, will auto-detect from hostname
+# - Useful when running in Docker/Kubernetes with specific networking requirements
+# - Example: When container has internal IP but needs to advertise external IP
+# EUREKA_INSTANCE_IP=192.168.1.100
+
+# Custom hostname for Eureka registration (optional)
+# - If not set, will auto-detect using socket.gethostname()
+# - Ignored when prefer_ip_address=True (default behavior)
+# EUREKA_INSTANCE_HOSTNAME=my-service.example.com
+
+# =============================================================================
+# Config Server Configuration (Optional)
+# =============================================================================
+
+# Config Server URI (if not using Eureka discovery)
+# Leave commented to auto-discover via Eureka
+# CONFIG_SERVER_URI=http://config-server:8888
+
+# Config Server service ID in Eureka (default: CONFIG-SERVER)
+# CONFIG_SERVER_SERVICE_ID=CONFIG-SERVER
+
+# Config Server authentication (if required)
+# CONFIG_SERVER_USERNAME=admin
+# CONFIG_SERVER_PASSWORD=secret
+
+# =============================================================================
+# Logging Configuration
+# =============================================================================
+
+# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+# Use DEBUG to see detailed Eureka registration attempts
+LOG_LEVEL=INFO
+
+# =============================================================================
+# Testing Configuration
+# =============================================================================
+
+# Testing mode - disables Eureka and Config Server connections
+# Set to 1 to enable testing mode (useful for unit tests or local development)
+# When enabled, the application will start with actuator endpoints only
+# TESTING=1
+
+# =============================================================================
+# Quick Start Examples
+# =============================================================================
+
+# Example 1: Local development with local Eureka
+# EUREKA_SERVER_URL=http://localhost:8761/eureka/
+
+# Example 2: Docker Compose setup
+# EUREKA_SERVER_URL=http://eureka:8761/eureka/
+
+# Example 3: Production with specific IP
+# EUREKA_SERVER_URL=http://10.10.0.1:8761/eureka/
+
+# Example 4: Multiple Eureka servers for high availability
+# EUREKA_SERVER_URL=http://eureka1.prod.example.com:8761/eureka/,http://eureka2.prod.example.com:8761/eureka/

spring_ready_python-1.1.0/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: tcivie
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

spring_ready_python-1.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

spring_ready_python-1.1.0/.github/ISSUE_TEMPLATE/custom.md

@@ -0,0 +1,10 @@
+---
+name: Custom issue template
+about: Describe this issue template's purpose here.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

spring_ready_python-1.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

spring_ready_python-1.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+gleb@tcivie.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

spring_ready_python-1.1.0/CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing to Spring-Ready Python
+
+Thanks for considering contributing! This library is intentionally simple and focused.
+
+## Philosophy
+
+- **Keep it simple** - No over-engineering
+- **Match Spring Boot behavior** - Fail-fast, retry logic, etc.
+- **Own implementation** - No hidden dependencies
+- **Well-tested** - Every feature needs tests
+- **Clear documentation** - Examples for everything
+
+## Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/tcivie/spring_ready_python.git
+cd spring_ready_python
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -e ".[dev,all]"
+
+# Run tests
+pytest tests/
+
+# Run example
+python example.py
+```
+
+## Making Changes
+
+1. **Fork the repository**
+2. **Create a branch** - `git checkout -b feature/my-feature`
+3. **Write tests** - Tests go in `tests/`
+4. **Make changes** - Keep it focused
+5. **Run tests** - `pytest tests/`
+6. **Update docs** - If adding features
+7. **Submit PR** - Describe what and why
+
+## Code Style
+
+- Use type hints where it makes sense
+- Follow PEP 8 (but don't be annoying about it)
+- Keep functions small and focused
+- Comment the "why", not the "what"
+- Match Spring Boot naming conventions where possible
+
+## Testing
+
+```bash
+# Run all tests
+pytest tests/
+
+# Run with coverage
+pytest tests/ --cov=spring_ready --cov-report=html
+
+# Run specific test
+pytest tests/test_basic.py::TestRetry
+```
+
+## What We're Looking For
+
+✅ **Bug fixes** - Always welcome  
+✅ **Better error messages** - Help users debug  
+✅ **Performance improvements** - If measurable  
+✅ **Documentation fixes** - Typos, clarity, examples  
+✅ **More tests** - Increase coverage  
+
+## What We're NOT Looking For
+
+❌ **New frameworks** - FastAPI only for now  
+❌ **Complex features** - Keep it simple  
+❌ **Breaking changes** - Unless absolutely necessary  
+❌ **Dependencies** - Avoid adding new ones  
+❌ **Runtime config refresh** - Out of scope  
+
+## Questions?
+
+Open an issue first if you're unsure whether a feature fits.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

spring_ready_python-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gleb Tcivie
+
+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.

{spring_ready_python-0.1.0 → spring_ready_python-1.1.0}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: spring-ready-python
-Version: 0.1.0
+Version: 1.1.0
 Summary: Make Python FastAPI apps work with Spring Boot ecosystem (Eureka, Config Server, Actuator)
 Project-URL: Homepage, https://github.com/tcivie/spring-ready-python
 Project-URL: Issues, https://github.com/tcivie/spring-ready-python/issues
 Author-email: Gleb Tcivie <gleb@tcivie.com>
 License-Expression: MIT
+License-File: LICENSE
 Keywords: actuator,config-server,eureka,fastapi,microservices,prometheus,spring-boot
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: FastAPI
@@ -130,6 +131,7 @@ CONFIG_SERVER_PASSWORD=secret
 | `EUREKA_SERVER_URL` | Eureka server URL(s) | `http://localhost:8761/eureka/` | `http://eureka:8761/eureka/` |
 | `EUREKA_INSTANCE_IP` | Custom IP for registration | Auto-detected | `192.168.1.100` |
 | `EUREKA_INSTANCE_HOSTNAME` | Custom hostname | Auto-detected | `my-service.local` |
+| `EUREKA_INSTANCE_SECURE` | Register with HTTPS URLs | `false` | `true` |
 | `CONFIG_SERVER_URI` | Config Server URL | Discovered from Eureka | `http://config:8888` |
 | `CONFIG_SERVER_SERVICE_ID` | Config Server service ID | `CONFIG-SERVER` | `CONFIG-SERVER` |
 | `CONFIG_SERVER_USERNAME` | Config Server username | None | `admin` |
@@ -235,6 +237,41 @@ export EUREKA_INSTANCE_IP=192.168.1.100
 export EUREKA_INSTANCE_HOSTNAME=my-service.example.com
 ```
 
+### HTTPS Registration (Secure Mode)
+
+When your application uses HTTPS, you need to register with HTTPS URLs in Eureka so that Spring Boot Admin and other services can connect to it correctly.
+
+```python
+from spring_ready import SpringReadyApp
+
+# Register with HTTPS URLs in Eureka
+spring_app = SpringReadyApp(
+    app=app,
+    app_name="my-service",
+    app_port=8443,
+    secure=True  # Register with https:// URLs
+)
+spring_app.start()
+```
+
+Or via environment variable:
+```bash
+export EUREKA_INSTANCE_SECURE=true
+```
+
+When `secure=True`:
+- The `homePageUrl`, `statusPageUrl`, and `healthCheckUrl` will use `https://`
+- The `securePort` will be enabled and set to your `app_port`
+- The regular `port` will be disabled
+
+This is equivalent to Spring Boot's:
+```yaml
+eureka:
+  instance:
+    secure-port-enabled: true
+    non-secure-port-enabled: false
+```
+
 ## How It Works
 
 ### Startup Sequence

{spring_ready_python-0.1.0 → spring_ready_python-1.1.0}/README.md

@@ -92,6 +92,7 @@ CONFIG_SERVER_PASSWORD=secret
 | `EUREKA_SERVER_URL` | Eureka server URL(s) | `http://localhost:8761/eureka/` | `http://eureka:8761/eureka/` |
 | `EUREKA_INSTANCE_IP` | Custom IP for registration | Auto-detected | `192.168.1.100` |
 | `EUREKA_INSTANCE_HOSTNAME` | Custom hostname | Auto-detected | `my-service.local` |
+| `EUREKA_INSTANCE_SECURE` | Register with HTTPS URLs | `false` | `true` |
 | `CONFIG_SERVER_URI` | Config Server URL | Discovered from Eureka | `http://config:8888` |
 | `CONFIG_SERVER_SERVICE_ID` | Config Server service ID | `CONFIG-SERVER` | `CONFIG-SERVER` |
 | `CONFIG_SERVER_USERNAME` | Config Server username | None | `admin` |
@@ -197,6 +198,41 @@ export EUREKA_INSTANCE_IP=192.168.1.100
 export EUREKA_INSTANCE_HOSTNAME=my-service.example.com
 ```
 
+### HTTPS Registration (Secure Mode)
+
+When your application uses HTTPS, you need to register with HTTPS URLs in Eureka so that Spring Boot Admin and other services can connect to it correctly.
+
+```python
+from spring_ready import SpringReadyApp
+
+# Register with HTTPS URLs in Eureka
+spring_app = SpringReadyApp(
+    app=app,
+    app_name="my-service",
+    app_port=8443,
+    secure=True  # Register with https:// URLs
+)
+spring_app.start()
+```
+
+Or via environment variable:
+```bash
+export EUREKA_INSTANCE_SECURE=true
+```
+
+When `secure=True`:
+- The `homePageUrl`, `statusPageUrl`, and `healthCheckUrl` will use `https://`
+- The `securePort` will be enabled and set to your `app_port`
+- The regular `port` will be disabled
+
+This is equivalent to Spring Boot's:
+```yaml
+eureka:
+  instance:
+    secure-port-enabled: true
+    non-secure-port-enabled: false
+```
+
 ## How It Works
 
 ### Startup Sequence

spring_ready_python-1.1.0/SECURITY.md

@@ -0,0 +1,73 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | :white_check_mark: |
+| < 1.0   | :x:                |
+
+As this is a new project, only the latest 0.1.x release receives security updates.
+
+## Reporting a Vulnerability
+
+**Please do NOT open a public issue for security vulnerabilities.**
+
+### How to Report
+
+1. **Email**: Send details to the maintainer (check package metadata for contact)
+2. **GitHub Security Advisory**: Use the "Security" tab → "Report a vulnerability"
+
+### What to Include
+
+- Description of the vulnerability
+- Steps to reproduce
+- Potential impact
+- Affected versions
+- Suggested fix (if you have one)
+
+### What to Expect
+
+- **Initial Response**: Within 7 days
+- **Status Update**: Every 14 days until resolved
+- **Fix Timeline**: Best effort, no guaranteed SLA
+- **Credit**: You'll be credited in release notes (if desired)
+
+### Important Notes
+
+This is a small open-source project maintained by volunteers. Security issues will be addressed as quickly as possible, but response times may vary.
+
+If you need an immediate fix, consider:
+- Forking and applying your own patch
+- Contributing a PR with the security fix
+- Using dependency pinning to avoid affected versions
+
+## Security Best Practices
+
+When using spring-ready-python:
+
+1. **Never hardcode credentials** - Use environment variables
+2. **Use HTTPS for Eureka/Config Server** - Avoid plain HTTP in production
+3. **Secure your Config Server** - Enable authentication
+4. **Keep dependencies updated** - Run `pip list --outdated` regularly
+5. **Review actuator endpoints** - Ensure they're not publicly exposed without authentication
+6. **Use secrets management** - Kubernetes Secrets, AWS Secrets Manager, etc.
+
+## Known Security Considerations
+
+- **Actuator endpoints expose application info** - Secure them in production
+- **Config Server credentials stored in environment** - Use proper secrets management
+- **Eureka registration sends metadata** - Don't include sensitive data in metadata
+- **Heartbeat thread runs in background** - Ensure proper shutdown handling
+
+## Dependencies
+
+This library has minimal dependencies:
+- `fastapi` - Web framework (security is your responsibility)
+- `requests` - HTTP client (ensure you're using latest version)
+
+Optional dependencies:
+- `spring-config-client-python` - Config Server client
+- `prometheus-client` - Metrics client
+
+Keep all dependencies updated to receive security patches.

{spring_ready_python-0.1.0 → spring_ready_python-1.1.0}/spring_ready/__init__.py

@@ -21,7 +21,7 @@ from .exceptions import (
     ConfigServerError,
 )
 
-__version__ = "0.1.0"
+__version__ = "1.1.0"
 __all__ = [
     "SpringReadyApp",
     "SpringReadyException",

{spring_ready_python-0.1.0 → spring_ready_python-1.1.0}/spring_ready/core.py

@@ -59,7 +59,8 @@ class SpringReadyApp:
             prefer_ip_address: bool = True,
             instance_ip: Optional[str] = None,
             instance_hostname: Optional[str] = None,
-            instance_metadata: Optional[dict] = None
+            instance_metadata: Optional[dict] = None,
+            secure: bool = False
     ):
         """
         Args:
@@ -73,6 +74,7 @@ class SpringReadyApp:
             instance_ip: Custom IP address to register with Eureka (auto-detected if None)
             instance_hostname: Custom hostname to register with Eureka (auto-detected if None)
             instance_metadata: Additional metadata for Eureka instance
+            secure: If True, register with HTTPS URLs (default from env EUREKA_INSTANCE_SECURE)
         """
         # Configuration from environment variables or parameters
         self.app_name = app_name or os.getenv("SPRING_APPLICATION_NAME") or os.getenv("APP_NAME", "python-service")
@@ -82,6 +84,12 @@ class SpringReadyApp:
         self.prefer_ip_address = prefer_ip_address
         self.instance_ip = instance_ip or os.getenv("EUREKA_INSTANCE_IP")
         self.instance_hostname = instance_hostname or os.getenv("EUREKA_INSTANCE_HOSTNAME")
+        self.secure = secure or os.getenv("EUREKA_INSTANCE_SECURE", "false").lower() == "true"
+
+        # Testing mode - disables Eureka and Config Server connections
+        self.testing_mode = os.getenv("TESTING", "0") == "1"
+        if self.testing_mode:
+            logger.info("TESTING mode enabled - Eureka and Config Server connections will be disabled")
 
         # Parse Eureka servers
         if eureka_servers is None:
@@ -146,14 +154,29 @@ class SpringReadyApp:
         logger.info(f"Starting Spring-Ready application: {self.app_name}")
 
         try:
+            # If testing mode is enabled, skip Eureka and Config Server setup
+            if self.testing_mode:
+                logger.info("Running in TESTING mode - skipping Eureka and Config Server setup")
+
+                # Only set up actuator endpoints
+                logger.info("Setting up actuator endpoints...")
+                self._setup_actuator_endpoints()
+
+                self._started = True
+                logger.info(f"✓ Spring-Ready application started successfully in TESTING mode on port {self.app_port}")
+                logger.info(f"  Actuator: http://localhost:{self.app_port}/actuator/health")
+                return
+
             # Step 1: Create Eureka instance info
             instance_info = InstanceInfo.create(
                 app_name=self.app_name,
                 port=self.app_port,
+                secure_port=self.app_port,  # Use same port for HTTPS
                 prefer_ip_address=self.prefer_ip_address,
                 ip_addr=self.instance_ip,
                 host_name=self.instance_hostname,
-                metadata=self._get_instance_metadata()
+                metadata=self._get_instance_metadata(),
+                secure=self.secure
             )
 
             # Log instance registration details
@@ -163,9 +186,12 @@ class SpringReadyApp:
                 logger.info(f"Auto-detected IP address for Eureka registration: {instance_info.ip_addr}")
 
             logger.info(f"Instance will register as: {instance_info.instance_id}")
+            if self.secure:
+                logger.info(f"Secure mode enabled - registering with HTTPS URLs")
 
             # Configure FastAPI OpenAPI servers to use the correct service URL
-            service_url = f"http://{instance_info.ip_addr}:{self.app_port}"
+            protocol = "https" if self.secure else "http"
+            service_url = f"{protocol}://{instance_info.ip_addr}:{self.app_port}"
             self.fastapi_app.servers = [{"url": service_url, "description": "Service instance"}]
             logger.info(f"Configured OpenAPI server URL: {service_url}")
 
@@ -309,8 +335,13 @@ class SpringReadyApp:
 
         # Build base URL for actuator discovery
         # Try to use instance_ip if available, otherwise use localhost
-        host = self.instance_ip if self.instance_ip else "localhost"
-        base_url = f"http://{host}:{self.app_port}"
+        # In testing mode, always use localhost since we don't connect to Eureka
+        if self.testing_mode:
+            host = "localhost"
+        else:
+            host = self.instance_ip if self.instance_ip else "localhost"
+        protocol = "https" if self.secure else "http"
+        base_url = f"{protocol}://{host}:{self.app_port}"
 
         # Integrate with FastAPI (CORS and middleware already set up in __init__)
         self.actuator_integration = FastAPIActuatorIntegration(

{spring_ready_python-0.1.0 → spring_ready_python-1.1.0}/spring_ready/eureka/instance.py

@@ -97,7 +97,8 @@ class InstanceInfo:
             port: int = 8080,
             secure_port: int = 443,
             metadata: Optional[Dict[str, str]] = None,
-            prefer_ip_address: bool = True
+            prefer_ip_address: bool = True,
+            secure: bool = False
     ) -> "InstanceInfo":
         """
         Factory method to create InstanceInfo with sensible defaults.
@@ -111,6 +112,7 @@ class InstanceInfo:
             secure_port: HTTPS port
             metadata: Additional metadata
             prefer_ip_address: Use IP address instead of hostname
+            secure: If True, register with HTTPS URLs and enable secure port
         """
 
         # Auto-detect hostname and IP
@@ -131,8 +133,10 @@ class InstanceInfo:
         if not instance_id:
             instance_id = f"{app_name.lower()}:{host_name}:{port}"
 
-        # Build URLs
-        base_url = f"http://{ip_addr}:{port}"
+        # Build URLs based on secure flag
+        protocol = "https" if secure else "http"
+        actual_port = secure_port if secure else port
+        base_url = f"{protocol}://{ip_addr}:{actual_port}"
 
         return cls(
             app=app_name.upper(),
@@ -142,7 +146,9 @@ class InstanceInfo:
             vip_address=app_name.lower(),
             secure_vip_address=app_name.lower(),
             port=port,
-            secure_port=secure_port,
+            secure_port=secure_port if secure else 443,
+            port_enabled=not secure,
+            secure_port_enabled=secure,
             home_page_url=base_url,
             status_page_url=f"{base_url}/actuator/info",
             health_check_url=f"{base_url}/actuator/health",