ghps 0.5__tar.gz → 0.7__tar.gz

{ghps-0.5 → ghps-0.7}/CHANGELOG.md

@@ -5,6 +5,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.7] - 2026-09-22
+### Added
+- `host` parameter
+- `--host` CLI argument
+### Changed
+- Test system modified
+- `README.md` updated
+## [0.6] - 2026-08-31
+### Added
+- Custom default error page
+### Changed
+- Server header modified
 ## [0.5] - 2026-08-02
 ### Added
 - `directory_listing` parameter
@@ -47,7 +59,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Command line interface
 - Test system
 
-[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.5...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.7...dev
+[0.7]: https://github.com/sepandhaghighi/ghps/compare/v0.6...v0.7
+[0.6]: https://github.com/sepandhaghighi/ghps/compare/v0.5...v0.6
 [0.5]: https://github.com/sepandhaghighi/ghps/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/ghps/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/ghps/compare/v0.2...v0.3

{ghps-0.5 → ghps-0.7}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: ghps
-Version: 0.5
+Version: 0.7
 Summary: Ghps: A Minimal GitHub Pages Simulator for Local Development
 Home-page: https://github.com/sepandhaghighi/ghps
-Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.5
+Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.7
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
 Project-URL: Source, https://github.com/sepandhaghighi/ghps
 Keywords: github gh-pages static-server static-hosting development server local http simulator testing cli python
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -101,13 +101,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/sepandhaghighi/ghps/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install ghps==0.5`						
+- `pip install ghps==0.7`						
 
 
 ## Usage
@@ -117,13 +117,14 @@ Ghps can be used both as a CLI tool and as a Python library.
 ### CLI
 
 ```bash
-ghps --port=8080 --no-cache --no-threaded
+ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 ```
 
 #### Options
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
 | `-b, --base-path` | Base path for project pages (e.g. `/repo-name`) | `""` |
@@ -133,7 +134,11 @@ ghps --port=8080 --no-cache --no-threaded
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
 
-ℹ️ You can set `--port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `--port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> You can use `--host=0.0.0.0` to bind Ghps to all available network interfaces, or specify a particular address such as `127.0.0.1`.
 
 
 ### Library
@@ -143,6 +148,7 @@ from ghps import GHPageServer
 
 server = GHPageServer(
     directory="dist",
+	host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
@@ -159,6 +165,7 @@ server.start()
 | Parameter | Type | Description | Default |
 |------------|------|-------------|----------|
 | `directory` | `str` | Directory to serve | `"."` |
+| `host` | `str` | Host address to bind the server to | `"localhost"` |
 | `port` | `int` | Port number | `8000` |
 | `base_path` | `str` | Base path for project page simulation | `""` |
 | `strict` | `bool` | Enforce GitHub-like routing behavior | `True` |
@@ -167,7 +174,11 @@ server.start()
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
 
-ℹ️ You can set `port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
 ## Issues & Bug Reports			
 
@@ -218,6 +229,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.7] - 2026-09-22
+### Added
+- `host` parameter
+- `--host` CLI argument
+### Changed
+- Test system modified
+- `README.md` updated
+## [0.6] - 2026-08-31
+### Added
+- Custom default error page
+### Changed
+- Server header modified
 ## [0.5] - 2026-08-02
 ### Added
 - `directory_listing` parameter
@@ -260,7 +283,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Command line interface
 - Test system
 
-[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.5...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.7...dev
+[0.7]: https://github.com/sepandhaghighi/ghps/compare/v0.6...v0.7
+[0.6]: https://github.com/sepandhaghighi/ghps/compare/v0.5...v0.6
 [0.5]: https://github.com/sepandhaghighi/ghps/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/ghps/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/ghps/compare/v0.2...v0.3

{ghps-0.5 → ghps-0.7}/README.md

@@ -50,13 +50,13 @@
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/sepandhaghighi/ghps/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install ghps==0.5`						
+- `pip install ghps==0.7`						
 
 
 ## Usage
@@ -66,13 +66,14 @@ Ghps can be used both as a CLI tool and as a Python library.
 ### CLI
 
 ```bash
-ghps --port=8080 --no-cache --no-threaded
+ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 ```
 
 #### Options
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
 | `-b, --base-path` | Base path for project pages (e.g. `/repo-name`) | `""` |
@@ -82,7 +83,11 @@ ghps --port=8080 --no-cache --no-threaded
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
 
-ℹ️ You can set `--port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `--port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> You can use `--host=0.0.0.0` to bind Ghps to all available network interfaces, or specify a particular address such as `127.0.0.1`.
 
 
 ### Library
@@ -92,6 +97,7 @@ from ghps import GHPageServer
 
 server = GHPageServer(
     directory="dist",
+	host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
@@ -108,6 +114,7 @@ server.start()
 | Parameter | Type | Description | Default |
 |------------|------|-------------|----------|
 | `directory` | `str` | Directory to serve | `"."` |
+| `host` | `str` | Host address to bind the server to | `"localhost"` |
 | `port` | `int` | Port number | `8000` |
 | `base_path` | `str` | Base path for project page simulation | `""` |
 | `strict` | `bool` | Enforce GitHub-like routing behavior | `True` |
@@ -116,7 +123,11 @@ server.start()
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
 
-ℹ️ You can set `port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
 ## Issues & Bug Reports			
 

{ghps-0.5 → ghps-0.7}/SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version       | Supported          |
 | ------------- | ------------------ |
-| 0.5           | :white_check_mark: |
-| < 0.5         | :x:                |
+| 0.7           | :white_check_mark: |
+| < 0.7         | :x:                |
 
 ## Reporting a Vulnerability
 

{ghps-0.5 → ghps-0.7}/ghps/cli.py

@@ -32,6 +32,13 @@ def _parse_args() -> argparse.Namespace:
         help="Version"
     )
 
+    parser.add_argument(
+        "--host",
+        type=str,
+        default="localhost",
+        help="Host address to bind to (default: localhost)"
+    )
+
     parser.add_argument(
         "-p", "--port",
         type=int,
@@ -94,6 +101,7 @@ def main() -> None:
         else:
             server = GHPageServer(
                 directory=args.directory,
+                host=args.host,
                 port=args.port,
                 base_path=args.base_path,
                 strict=not args.no_strict,

ghps-0.7/ghps/params.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+"""ghps params."""
+
+GHPS_VERSION = "0.7"
+GHPS_REPO = "https://github.com/sepandhaghighi/ghps"
+
+INVALID_DIRECTORY_TYPE_ERROR = "`directory` must be str or pathlib.Path."
+DIRECTORY_NOT_FOUND_ERROR = "`directory` does not exist."
+DIRECTORY_NOT_DIR_ERROR = "`directory` must be a valid directory."
+
+INVALID_HOST_TYPE_ERROR = "`host` must be str."
+INVALID_PORT_TYPE_ERROR = "`port` must be int."
+INVALID_PORT_RANGE_ERROR = "`port` must be between 0 and 65535."
+
+INVALID_BASE_PATH_TYPE_ERROR = "`base_path` must be str."
+INVALID_BASE_PATH_FORMAT_ERROR = "`base_path` must start with '/' or be empty."
+
+INVALID_STRICT_TYPE_ERROR = "`strict` must be bool."
+INVALID_NO_CACHE_TYPE_ERROR = "`no_cache` must be bool."
+INVALID_THREADED_TYPE_ERROR = "`threaded` must be bool."
+INVALID_AUTO_OPEN_TYPE_ERROR = "`auto_open` must be bool."
+INVALID_DIRECTORY_LISTING_TYPE_ERROR = "`directory_listing` must be bool."
+
+PORT_IN_USE_ERROR = "`port` is already in use. Try another port or use `0` for automatic allocation."
+PORT_ACCESS_DENIED_ERROR = "`port` access denied. Try a different port or check permissions."
+PORT_ADDRESS_NOT_AVAILABLE_ERROR = "`port` address is not available. Check network configuration."
+PORT_BIND_GENERIC_ERROR = "Failed to start server on port `{port}`: {error}"
+
+DEFAULT_ERROR_PAGE = """<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{code} - {message}</title>
+    <style>
+        body {{
+            margin: 0;
+            padding: 40px 20px;
+            font-family: system-ui, -apple-system, BlinkMacSystemFont,
+                         "Segoe UI", sans-serif;
+            background: #f6f8fa;
+            color: #24292f;
+        }}
+
+        main {{
+            max-width: 720px;
+            margin: 80px auto;
+            padding: 40px;
+            background: #ffffff;
+            border: 1px solid #d0d7de;
+            border-radius: 8px;
+        }}
+
+        h1 {{
+            margin: 0 0 12px;
+            font-size: 32px;
+        }}
+
+        p {{
+            margin: 8px 0;
+            color: #57606a;
+        }}
+
+        .status {{
+            font-size: 18px;
+            font-weight: 600;
+            color: #24292f;
+        }}
+
+        footer {{
+            margin-top: 32px;
+            padding-top: 16px;
+            border-top: 1px solid #d0d7de;
+            font-size: 13px;
+            color: #57606a;
+        }}
+    </style>
+</head>
+<body>
+    <main>
+        <h1>{code}</h1>
+        <p class="status">{message}</p>
+        <p>{explain}</p>
+        <p>The requested resource could not be served by Ghps.</p>
+
+        <footer>
+            <a href="{repo}">Ghps/{version} &mdash; A Minimal GitHub Pages Simulator for Local Development</a>
+        </footer>
+    </main>
+</body>
+</html>
+"""

{ghps-0.5 → ghps-0.7}/ghps/server.py

@@ -2,6 +2,7 @@
 """ghps server."""
 
 import http.server
+from http import HTTPStatus
 import socketserver
 import webbrowser
 import errno
@@ -10,9 +11,13 @@ from typing import Optional, Any
 from pathlib import Path
 from urllib.parse import unquote
 from .params import (
+    GHPS_VERSION,
+    GHPS_REPO,
+    DEFAULT_ERROR_PAGE,
     INVALID_DIRECTORY_TYPE_ERROR,
     DIRECTORY_NOT_FOUND_ERROR,
     DIRECTORY_NOT_DIR_ERROR,
+    INVALID_HOST_TYPE_ERROR,
     INVALID_PORT_TYPE_ERROR,
     INVALID_PORT_RANGE_ERROR,
     INVALID_BASE_PATH_TYPE_ERROR,
@@ -34,6 +39,7 @@ from .errors import GHPSValidationError, GHPSRuntimeError
 
 def _validate_inputs(
     directory: Any,
+    host: Any,
     port: Any,
     base_path: Any,
     strict: Any,
@@ -46,6 +52,7 @@ def _validate_inputs(
     Validate GHPageServer inputs.
 
     :param directory: Root directory to serve files from.
+    :param host: Host address to bind the server to.
     :param port: Port number to bind the server to.
     :param base_path: URL base path prefix for serving content.
     :param strict: If False, enables automatic ".html" resolution.
@@ -64,6 +71,9 @@ def _validate_inputs(
     if not directory.is_dir():
         raise GHPSValidationError(DIRECTORY_NOT_DIR_ERROR)
 
+    if not isinstance(host, str):
+        raise GHPSValidationError(INVALID_HOST_TYPE_ERROR)
+
     if not isinstance(port, int) or isinstance(port, bool):
         raise GHPSValidationError(INVALID_PORT_TYPE_ERROR)
 
@@ -119,6 +129,9 @@ def _handle_bind_error(port: int, e: OSError) -> None:
 class _GHRequestHandler(http.server.SimpleHTTPRequestHandler):
     """Custom HTTP request handler for serving static files with optional base path stripping, strict routing, custom 404 page support, and cache control headers."""
 
+    server_version = f"Ghps/{GHPS_VERSION}"
+    sys_version = ""
+
     def __init__(
         self,
         *args: list,
@@ -196,7 +209,26 @@ class _GHRequestHandler(http.server.SimpleHTTPRequestHandler):
                 with open(not_found, "rb") as f:
                     self.wfile.write(f.read())
                 return
-        super().send_error(code, message, explain)
+        if message is None:
+            message = HTTPStatus(code).phrase
+        if explain is None:
+            explain = HTTPStatus(code).description
+
+        html = DEFAULT_ERROR_PAGE.format(
+            code=code,
+            message=message,
+            explain=explain,
+            version=GHPS_VERSION,
+            repo=GHPS_REPO,
+        )
+
+        encoded = html.encode("utf-8")
+
+        self.send_response(code)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Content-Length", str(len(encoded)))
+        self.end_headers()
+        self.wfile.write(encoded)
 
     def end_headers(self) -> None:
         """
@@ -223,6 +255,7 @@ class GHPageServer:
     def __init__(
         self,
         directory: str = ".",
+        host: str = "localhost",
         port: int = 8000,
         base_path: str = "",
         strict: bool = True,
@@ -235,6 +268,7 @@ class GHPageServer:
         Initialize the server.
 
         :param directory: Root directory to serve files from.
+        :param host: Host address to bind the server to.
         :param port: Port number to bind the server to.
         :param base_path: URL base path prefix for serving content.
         :param strict: If False, enables automatic ".html" resolution.
@@ -245,6 +279,7 @@ class GHPageServer:
         """
         _validate_inputs(
             directory=directory,
+            host=host,
             port=port,
             base_path=base_path,
             strict=strict,
@@ -254,6 +289,7 @@ class GHPageServer:
             directory_listing=directory_listing
         )
         self._directory = str(Path(directory).resolve())
+        self._host = host
         self._port = port
         self._url = None
         self._base_path = base_path
@@ -289,11 +325,11 @@ class GHPageServer:
         server_cls = _ThreadedTCPServer if self._threaded else socketserver.TCPServer
 
         try:
-            self._httpd = server_cls(("", self._port), handler)
+            self._httpd = server_cls((self._host, self._port), handler)
         except OSError as e:
             _handle_bind_error(self._port, e)
         self._port = self._httpd.server_address[1]
-        self._url = f"http://localhost:{self._port}{self._base_path}"
+        self._url = f"http://{self._host}:{self._port}{self._base_path}"
         self._print_server_info()
 
         if self._auto_open:

{ghps-0.5 → ghps-0.7}/ghps.egg-info/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: ghps
-Version: 0.5
+Version: 0.7
 Summary: Ghps: A Minimal GitHub Pages Simulator for Local Development
 Home-page: https://github.com/sepandhaghighi/ghps
-Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.5
+Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.7
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
 Project-URL: Source, https://github.com/sepandhaghighi/ghps
 Keywords: github gh-pages static-server static-hosting development server local http simulator testing cli python
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -101,13 +101,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.5](https://github.com/sepandhaghighi/ghps/archive/v0.5.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install ghps==0.5`						
+- `pip install ghps==0.7`						
 
 
 ## Usage
@@ -117,13 +117,14 @@ Ghps can be used both as a CLI tool and as a Python library.
 ### CLI
 
 ```bash
-ghps --port=8080 --no-cache --no-threaded
+ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 ```
 
 #### Options
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
 | `-b, --base-path` | Base path for project pages (e.g. `/repo-name`) | `""` |
@@ -133,7 +134,11 @@ ghps --port=8080 --no-cache --no-threaded
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
 
-ℹ️ You can set `--port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `--port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> You can use `--host=0.0.0.0` to bind Ghps to all available network interfaces, or specify a particular address such as `127.0.0.1`.
 
 
 ### Library
@@ -143,6 +148,7 @@ from ghps import GHPageServer
 
 server = GHPageServer(
     directory="dist",
+	host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
@@ -159,6 +165,7 @@ server.start()
 | Parameter | Type | Description | Default |
 |------------|------|-------------|----------|
 | `directory` | `str` | Directory to serve | `"."` |
+| `host` | `str` | Host address to bind the server to | `"localhost"` |
 | `port` | `int` | Port number | `8000` |
 | `base_path` | `str` | Base path for project page simulation | `""` |
 | `strict` | `bool` | Enforce GitHub-like routing behavior | `True` |
@@ -167,7 +174,11 @@ server.start()
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
 
-ℹ️ You can set `port=0` to let the OS automatically select an available port
+> [!NOTE]
+> You can set `port=0` to let the OS automatically select an available port.
+
+> [!NOTE]
+> The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
 ## Issues & Bug Reports			
 
@@ -218,6 +229,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.7] - 2026-09-22
+### Added
+- `host` parameter
+- `--host` CLI argument
+### Changed
+- Test system modified
+- `README.md` updated
+## [0.6] - 2026-08-31
+### Added
+- Custom default error page
+### Changed
+- Server header modified
 ## [0.5] - 2026-08-02
 ### Added
 - `directory_listing` parameter
@@ -260,7 +283,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Command line interface
 - Test system
 
-[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.5...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.7...dev
+[0.7]: https://github.com/sepandhaghighi/ghps/compare/v0.6...v0.7
+[0.6]: https://github.com/sepandhaghighi/ghps/compare/v0.5...v0.6
 [0.5]: https://github.com/sepandhaghighi/ghps/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/ghps/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/ghps/compare/v0.2...v0.3

{ghps-0.5 → ghps-0.7}/setup.py

@@ -22,7 +22,7 @@ def read_description() -> str:
 setup(
     name='ghps',
     packages=['ghps'],
-    version='0.5',
+    version='0.7',
     description='Ghps: A Minimal GitHub Pages Simulator for Local Development',
     long_description=read_description(),
     long_description_content_type='text/markdown',
@@ -30,7 +30,7 @@ setup(
     author='Sepand Haghighi',
     author_email='me@sepand.tech',
     url='https://github.com/sepandhaghighi/ghps',
-    download_url='https://github.com/sepandhaghighi/ghps/tarball/v0.5',
+    download_url='https://github.com/sepandhaghighi/ghps/tarball/v0.7',
     keywords='github gh-pages static-server static-hosting development server local http simulator testing cli python',
     project_urls={
         'Source': 'https://github.com/sepandhaghighi/ghps'
@@ -38,7 +38,7 @@ setup(
     install_requires=['art>=5.3'],
     python_requires='>=3.7',
     classifiers=[
-        'Development Status :: 3 - Alpha',
+        'Development Status :: 4 - Beta',
         'Natural Language :: English',
         'License :: OSI Approved :: MIT License',
         'Operating System :: OS Independent',

{ghps-0.5 → ghps-0.7}/tests/test_cli.py

@@ -36,6 +36,7 @@ def test_cli_default_arguments(monkeypatch):
 
     run_cli(monkeypatch, [])
 
+    assert captured["host"] == "localhost"
     assert captured["port"] == 8000
     assert captured["strict"] is True
     assert captured["no_cache"] is False
@@ -64,6 +65,26 @@ def test_cli_custom_port_and_directory(monkeypatch, tmp_path):
     assert captured["directory"] == str(tmp_path.resolve())
 
 
+def test_cli_host(monkeypatch):
+    captured = {}
+
+    def fake_init(self, **kwargs):
+        captured.update(kwargs)
+
+    monkeypatch.setattr(ghps.cli, "GHPageServer", type(
+        "MockServer",
+        (),
+        {
+            "__init__": fake_init,
+            "start": lambda self: None,
+        },
+    ))
+
+    run_cli(monkeypatch, ["--host", "127.0.0.1"])
+
+    assert captured["host"] == "127.0.0.1"
+
+
 def test_cli_base_path(monkeypatch):
     captured = {}
 

{ghps-0.5 → ghps-0.7}/tests/test_error.py

@@ -47,6 +47,20 @@ def test_directory_not_directory(tmp_path):
         )
 
 
+def test_invalid_host_type(tmp_path):
+    with pytest.raises(GHPSValidationError, match="`host` must be str."):
+        GHPageServer(
+            directory=tmp_path,
+            port=8000,
+            host=123,
+            base_path="",
+            strict=True,
+            no_cache=False,
+            threaded=True,
+            directory_listing=False,
+        )
+
+
 def test_invalid_port_type1(tmp_path):
     with pytest.raises(GHPSValidationError, match="`port` must be int."):
         GHPageServer(

{ghps-0.5 → ghps-0.7}/tests/test_server.py

@@ -6,6 +6,8 @@ from pathlib import Path
 import requests
 from unittest.mock import patch, MagicMock
 from ghps import GHPageServer
+from ghps.server import _GHRequestHandler
+from http import HTTPStatus
 
 
 def run_server(server):
@@ -36,6 +38,25 @@ def test_404_without_custom_page():
 
         response = requests.get("http://localhost:9002/missing", timeout=5)
         assert response.status_code == 404
+        assert "404" in response.text
+        assert "The requested resource could not be served by Ghps." in response.text
+        assert "Ghps/" in response.text
+
+        server.stop()
+
+
+def test_default_error_page_content():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        server = GHPageServer(directory=tmpdir, port=9010)
+        run_server(server)
+
+        response = requests.get("http://localhost:9010/missing", timeout=5)
+
+        assert response.status_code == 404
+        assert response.headers["Content-Type"].startswith("text/html")
+        assert "404" in response.text
+        assert "The requested resource could not be served by Ghps." in response.text
+        assert "A Minimal GitHub Pages Simulator for Local Development" in response.text
 
         server.stop()
 
@@ -54,6 +75,78 @@ def test_custom_404_page():
         server.stop()
 
 
+def test_send_error_uses_default_message(tmp_path):
+    handler = _GHRequestHandler.__new__(_GHRequestHandler)
+
+    handler.directory = str(tmp_path)
+    handler.wfile = MagicMock()
+    handler._no_cache = False
+
+    handler.send_response = MagicMock()
+    handler.send_header = MagicMock()
+    handler.end_headers = MagicMock()
+
+    _GHRequestHandler.send_error(
+        handler,
+        404,
+        message=None,
+        explain="custom explanation",
+    )
+
+    html = handler.wfile.write.call_args[0][0].decode("utf-8")
+
+    assert HTTPStatus(404).phrase in html
+    assert "custom explanation" in html
+
+
+def test_send_error_uses_default_explain(tmp_path):
+    handler = _GHRequestHandler.__new__(_GHRequestHandler)
+
+    handler.directory = str(tmp_path)
+    handler.wfile = MagicMock()
+    handler._no_cache = False
+
+    handler.send_response = MagicMock()
+    handler.send_header = MagicMock()
+    handler.end_headers = MagicMock()
+
+    _GHRequestHandler.send_error(
+        handler,
+        404,
+        message="Custom message",
+        explain=None,
+    )
+
+    html = handler.wfile.write.call_args[0][0].decode("utf-8")
+
+    assert "Custom message" in html
+    assert HTTPStatus(404).description in html
+
+
+def test_send_error_uses_default_message_and_explain(tmp_path):
+    handler = _GHRequestHandler.__new__(_GHRequestHandler)
+
+    handler.directory = str(tmp_path)
+    handler.wfile = MagicMock()
+    handler._no_cache = False
+
+    handler.send_response = MagicMock()
+    handler.send_header = MagicMock()
+    handler.end_headers = MagicMock()
+
+    _GHRequestHandler.send_error(
+        handler,
+        404,
+        message=None,
+        explain=None,
+    )
+
+    html = handler.wfile.write.call_args[0][0].decode("utf-8")
+
+    assert HTTPStatus(404).phrase in html
+    assert HTTPStatus(404).description in html
+
+
 def test_non_strict_html_fallback():
     with tempfile.TemporaryDirectory() as tmpdir:
         Path(tmpdir, "about.html").write_text("About Page")
@@ -166,6 +259,25 @@ def test_auto_open_disabled(mock_server_cls, mock_web_open, tmp_path):
     mock_web_open.assert_not_called()
 
 
+@patch("ghps.server.webbrowser.open")
+@patch("ghps.server._ThreadedTCPServer")
+def test_auto_open_custom_host(mock_server_cls, mock_web_open, tmp_path):
+    mock_server = mock_server_cls.return_value
+    mock_server.server_address = ("127.0.0.1", 8000)
+    mock_server.serve_forever.side_effect = KeyboardInterrupt
+
+    server = GHPageServer(
+        directory=tmp_path,
+        port=8000,
+        host="127.0.0.1",
+        auto_open=True,
+    )
+
+    server.start()
+
+    mock_web_open.assert_called_once_with("http://127.0.0.1:8000")
+
+
 @patch("ghps.server._ThreadedTCPServer")
 def test_random_port_resolution(mock_server_cls, tmp_path):
     mock_server = mock_server_cls.return_value
@@ -179,6 +291,26 @@ def test_random_port_resolution(mock_server_cls, tmp_path):
     assert server._port == 54321
 
 
+@patch("ghps.server._ThreadedTCPServer")
+def test_custom_host_binding(mock_server_cls, tmp_path):
+    mock_server = mock_server_cls.return_value
+    mock_server.server_address = ("127.0.0.1", 8000)
+    mock_server.serve_forever.side_effect = KeyboardInterrupt
+
+    server = GHPageServer(
+        directory=tmp_path,
+        port=8000,
+        host="127.0.0.1",
+    )
+
+    server.start()
+
+    mock_server_cls.assert_called_once()
+    address = mock_server_cls.call_args[0][0]
+
+    assert address == ("127.0.0.1", 8000)
+
+
 def test_directory_listing_enabled():
     with tempfile.TemporaryDirectory() as tmpdir:
         Path(tmpdir, "file.txt").write_text("Hello")

ghps-0.5/ghps/params.py

@@ -1,25 +0,0 @@
-# -*- coding: utf-8 -*-
-"""ghps params."""
-
-GHPS_VERSION = "0.5"
-
-INVALID_DIRECTORY_TYPE_ERROR = "`directory` must be str or pathlib.Path."
-DIRECTORY_NOT_FOUND_ERROR = "`directory` does not exist."
-DIRECTORY_NOT_DIR_ERROR = "`directory` must be a valid directory."
-
-INVALID_PORT_TYPE_ERROR = "`port` must be int."
-INVALID_PORT_RANGE_ERROR = "`port` must be between 0 and 65535."
-
-INVALID_BASE_PATH_TYPE_ERROR = "`base_path` must be str."
-INVALID_BASE_PATH_FORMAT_ERROR = "`base_path` must start with '/' or be empty."
-
-INVALID_STRICT_TYPE_ERROR = "`strict` must be bool."
-INVALID_NO_CACHE_TYPE_ERROR = "`no_cache` must be bool."
-INVALID_THREADED_TYPE_ERROR = "`threaded` must be bool."
-INVALID_AUTO_OPEN_TYPE_ERROR = "`auto_open` must be bool."
-INVALID_DIRECTORY_LISTING_TYPE_ERROR = "`directory_listing` must be bool."
-
-PORT_IN_USE_ERROR = "`port` is already in use. Try another port or use `0` for automatic allocation."
-PORT_ACCESS_DENIED_ERROR = "`port` access denied. Try a different port or check permissions."
-PORT_ADDRESS_NOT_AVAILABLE_ERROR = "`port` address is not available. Check network configuration."
-PORT_BIND_GENERIC_ERROR = "Failed to start server on port `{port}`: {error}"