ghps 0.7__tar.gz → 0.8__tar.gz

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

@@ -5,6 +5,17 @@ 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.8] - 2026-11-08
+### Added
+- `quiet` parameter
+- `--quiet` CLI argument
+- `--config` CLI argument
+- `from_config` method
+### Changed
+- Test system modified
+- Build system modified
+- `Python 3.15` added to `test.yml`
+- `README.md` updated
 ## [0.7] - 2026-09-22
 ### Added
 - `host` parameter
@@ -59,7 +70,8 @@ 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.7...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.8...dev
+[0.8]: https://github.com/sepandhaghighi/ghps/compare/v0.7...v0.8
 [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

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ghps
-Version: 0.7
+Version: 0.8
 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.7
+Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.8
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -11,7 +11,6 @@ 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 :: 4 - Beta
 Classifier: Natural Language :: English
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
 Classifier: Programming Language :: Python :: 3.7
@@ -22,6 +21,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Topic :: Utilities
@@ -33,6 +33,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: AUTHORS.md
 Requires-Dist: art>=5.3
+Requires-Dist: tomli>=2.0.2
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -62,7 +63,7 @@ Dynamic: summary
 ## Overview	
 
 <p align="justify">		
-<b>Ghps</b> is a minimal, zero-dependency GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
+<b>Ghps</b> is a minimal GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
 </p>
 
 <table>
@@ -101,13 +102,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.8](https://github.com/sepandhaghighi/ghps/archive/v0.8.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.7`						
+- `pip install ghps==0.8`						
 
 
 ## Usage
@@ -124,6 +125,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `-c, --config` | Path to configuration file | Auto discovers `.ghps` |
 | `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
@@ -133,6 +135,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 | `--no-threaded` | Disable threaded server | Threaded enabled |
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
+| `--quiet` | Suppress informational server output | Disable |
 
 > [!NOTE]
 > You can set `--port=0` to let the OS automatically select an available port.
@@ -140,24 +143,32 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 > [!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`.
 
+> [!NOTE]
+> Ghps automatically looks for a `.ghps` configuration file in the served directory if available, or you can specify a custom configuration file path using `-c` / `--config`.
+
 
 ### Library
 
 ```python
 from ghps import GHPageServer
 
-server = GHPageServer(
+server1 = GHPageServer(
     directory="dist",
-	host="localhost",
+    host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
     no_cache=False,
     threaded=True,
-	auto_open=True,
+    auto_open=True,
+    quiet=False,
 )
 
-server.start()
+server1.start()
+
+server2 = GHPageServer.from_config(config="config.toml")
+
+server2.start()
 ```
 
 #### Parameters
@@ -173,6 +184,7 @@ server.start()
 | `threaded` | `bool` | Enable threaded request handling | `True` |
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
+| `quiet` | `bool` | Suppress informational server output | `False` |
 
 > [!NOTE]
 > You can set `port=0` to let the OS automatically select an available port.
@@ -180,6 +192,23 @@ server.start()
 > [!NOTE]
 > The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
+### Configuration File
+
+You can define your server settings in a **TOML** configuration file (typically named `.ghps`):
+
+```toml
+directory = "dist"
+host = "localhost"
+port = 8080
+base_path = "/repo-name"
+strict = true
+no_cache = false
+threaded = true
+auto_open = false
+directory_listing = false
+quiet = false
+```
+
 ## Issues & Bug Reports			
 
 Just fill an issue and describe it. We'll check it ASAP!
@@ -229,6 +258,17 @@ 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.8] - 2026-11-08
+### Added
+- `quiet` parameter
+- `--quiet` CLI argument
+- `--config` CLI argument
+- `from_config` method
+### Changed
+- Test system modified
+- Build system modified
+- `Python 3.15` added to `test.yml`
+- `README.md` updated
 ## [0.7] - 2026-09-22
 ### Added
 - `host` parameter
@@ -283,7 +323,8 @@ 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.7...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.8...dev
+[0.8]: https://github.com/sepandhaghighi/ghps/compare/v0.7...v0.8
 [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

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

@@ -11,7 +11,7 @@
 ## Overview	
 
 <p align="justify">		
-<b>Ghps</b> is a minimal, zero-dependency GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
+<b>Ghps</b> is a minimal GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
 </p>
 
 <table>
@@ -50,13 +50,13 @@
 ## Installation		
 
 ### Source Code
-- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.8](https://github.com/sepandhaghighi/ghps/archive/v0.8.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.7`						
+- `pip install ghps==0.8`						
 
 
 ## Usage
@@ -73,6 +73,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `-c, --config` | Path to configuration file | Auto discovers `.ghps` |
 | `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
@@ -82,6 +83,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 | `--no-threaded` | Disable threaded server | Threaded enabled |
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
+| `--quiet` | Suppress informational server output | Disable |
 
 > [!NOTE]
 > You can set `--port=0` to let the OS automatically select an available port.
@@ -89,24 +91,32 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 > [!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`.
 
+> [!NOTE]
+> Ghps automatically looks for a `.ghps` configuration file in the served directory if available, or you can specify a custom configuration file path using `-c` / `--config`.
+
 
 ### Library
 
 ```python
 from ghps import GHPageServer
 
-server = GHPageServer(
+server1 = GHPageServer(
     directory="dist",
-	host="localhost",
+    host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
     no_cache=False,
     threaded=True,
-	auto_open=True,
+    auto_open=True,
+    quiet=False,
 )
 
-server.start()
+server1.start()
+
+server2 = GHPageServer.from_config(config="config.toml")
+
+server2.start()
 ```
 
 #### Parameters
@@ -122,6 +132,7 @@ server.start()
 | `threaded` | `bool` | Enable threaded request handling | `True` |
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
+| `quiet` | `bool` | Suppress informational server output | `False` |
 
 > [!NOTE]
 > You can set `port=0` to let the OS automatically select an available port.
@@ -129,6 +140,23 @@ server.start()
 > [!NOTE]
 > The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
+### Configuration File
+
+You can define your server settings in a **TOML** configuration file (typically named `.ghps`):
+
+```toml
+directory = "dist"
+host = "localhost"
+port = 8080
+base_path = "/repo-name"
+strict = true
+no_cache = false
+threaded = true
+auto_open = false
+directory_listing = false
+quiet = false
+```
+
 ## Issues & Bug Reports			
 
 Just fill an issue and describe it. We'll check it ASAP!

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

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

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

@@ -32,62 +32,81 @@ def _parse_args() -> argparse.Namespace:
         help="Version"
     )
 
+    parser.add_argument(
+        "-c", "--config",
+        type=str,
+        default=None,
+        help="Path to configuration file"
+    )
+
     parser.add_argument(
         "--host",
         type=str,
-        default="localhost",
+        default=None,
         help="Host address to bind to (default: localhost)"
     )
 
     parser.add_argument(
         "-p", "--port",
         type=int,
-        default=8000,
+        default=None,
         help="Port to serve on (default: 8000, use 0 for automatic allocation)"
     )
 
     parser.add_argument(
         "-d", "--directory",
-        default=".",
+        default=None,
         help="Directory to serve (default: current directory)"
     )
 
     parser.add_argument(
         "-b", "--base-path",
-        default="",
+        default=None,
         help="Base path for project pages (e.g. /repo-name)"
     )
 
     parser.add_argument(
         "--no-strict",
         action="store_true",
+        default=None,
         help="Enable .html fallback"
     )
 
     parser.add_argument(
         "--no-cache",
         action="store_true",
+        default=None,
         help="Disable HTTP caching headers"
     )
 
     parser.add_argument(
         "--no-threaded",
         action="store_true",
+        default=None,
         help="Disable threaded server"
     )
 
     parser.add_argument(
         "--auto-open",
         action="store_true",
+        default=None,
         help="Automatically open the server URL"
     )
 
     parser.add_argument(
         "--directory-listing",
         action="store_true",
+        default=None,
         help="Enable directory listing"
     )
 
+    parser.add_argument(
+        "--quiet",
+        action="store_true",
+        default=None,
+        help="Suppress informational server output"
+    )
+
     args = parser.parse_args()
     return args
 
@@ -99,16 +118,19 @@ def main() -> None:
         if args.version:
             print(GHPS_VERSION)
         else:
-            server = GHPageServer(
+            server = GHPageServer.from_config(
                 directory=args.directory,
                 host=args.host,
                 port=args.port,
                 base_path=args.base_path,
-                strict=not args.no_strict,
+                strict=False if args.no_strict else None,
                 no_cache=args.no_cache,
-                threaded=not args.no_threaded,
+                threaded=False if args.no_threaded else None,
                 auto_open=args.auto_open,
                 directory_listing=args.directory_listing,
+                quiet=args.quiet,
+                config=args.config,
+                auto_discover=True,
             )
             server.start()
     except GHPSError as e:

{ghps-0.7 → ghps-0.8}/ghps/params.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 """ghps params."""
 
-GHPS_VERSION = "0.7"
+GHPS_VERSION = "0.8"
 GHPS_REPO = "https://github.com/sepandhaghighi/ghps"
 
 INVALID_DIRECTORY_TYPE_ERROR = "`directory` must be str or pathlib.Path."
@@ -20,6 +20,11 @@ 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."
+INVALID_QUIET_TYPE_ERROR = "`quiet` must be bool."
+
+INVALID_CONFIG_TYPE_ERROR = "`config` must be str, pathlib.Path, or dict."
+INVALID_CONFIG_FILE_ERROR = "Failed to load config file: {error}"
+INVALID_CONFIG_FORMAT_ERROR = "Config file content must be a valid TOML format."
 
 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."

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

@@ -7,9 +7,10 @@ import socketserver
 import webbrowser
 import errno
 from functools import partial
-from typing import Optional, Any
+from typing import Optional, Any, Union
 from pathlib import Path
 from urllib.parse import unquote
+import tomli
 from .params import (
     GHPS_VERSION,
     GHPS_REPO,
@@ -26,7 +27,11 @@ from .params import (
     INVALID_NO_CACHE_TYPE_ERROR,
     INVALID_THREADED_TYPE_ERROR,
     INVALID_AUTO_OPEN_TYPE_ERROR,
-    INVALID_DIRECTORY_LISTING_TYPE_ERROR
+    INVALID_DIRECTORY_LISTING_TYPE_ERROR,
+    INVALID_QUIET_TYPE_ERROR,
+    INVALID_CONFIG_TYPE_ERROR,
+    INVALID_CONFIG_FILE_ERROR,
+    INVALID_CONFIG_FORMAT_ERROR
 )
 from .params import (
     PORT_IN_USE_ERROR,
@@ -46,7 +51,8 @@ def _validate_inputs(
     no_cache: Any,
     threaded: Any,
     auto_open: Any,
-    directory_listing: Any
+    directory_listing: Any,
+    quiet: Any
 ):
     """
     Validate GHPageServer inputs.
@@ -60,6 +66,7 @@ def _validate_inputs(
     :param threaded: If True, handles requests using threads.
     :param auto_open: If True, automatically opens the server URL in the default web browser.
     :param directory_listing: If True, enables directory listing.
+    :param quiet: If True, suppresses informational server output.
     """
     if not isinstance(directory, (str, Path)):
         raise GHPSValidationError(INVALID_DIRECTORY_TYPE_ERROR)
@@ -101,6 +108,52 @@ def _validate_inputs(
     if not isinstance(directory_listing, bool):
         raise GHPSValidationError(INVALID_DIRECTORY_LISTING_TYPE_ERROR)
 
+    if not isinstance(quiet, bool):
+        raise GHPSValidationError(INVALID_QUIET_TYPE_ERROR)
+
+
+def _load_config(directory: Union[str, Path], config_source: Optional[Union[str,
+                 Path, dict]] = None, auto_discover: bool = False) -> dict:
+    """
+    Load config.
+
+    :param directory: Root directory.
+    :param config_source: Config source.
+    :param auto_discover: Auto discover flag.
+    """
+    if config_source is None:
+        if not auto_discover:
+            return {}
+        dir_path = Path(directory)
+        if dir_path.exists() and dir_path.is_dir():
+            candidate = dir_path / ".ghps"
+            if candidate.exists() and candidate.is_file():
+                config_path = candidate
+            else:
+                return {}
+        else:
+            return {}
+    elif isinstance(config_source, dict):
+        return config_source
+    elif isinstance(config_source, (str, Path)):
+        config_path = Path(config_source)
+    else:
+        raise GHPSValidationError(INVALID_CONFIG_TYPE_ERROR)
+
+    if not config_path.exists():
+        return {}
+
+    try:
+        with open(config_path, "rb") as f:
+            data = tomli.load(f)
+            if not isinstance(data, dict):
+                raise GHPSValidationError(INVALID_CONFIG_FORMAT_ERROR)
+            return data
+    except Exception as e:
+        if isinstance(e, GHPSValidationError):
+            raise e
+        raise GHPSValidationError(INVALID_CONFIG_FILE_ERROR.format(error=e))
+
 
 def _handle_bind_error(port: int, e: OSError) -> None:
     """
@@ -262,7 +315,8 @@ class GHPageServer:
         no_cache: bool = False,
         threaded: bool = True,
         auto_open: bool = False,
-        directory_listing: bool = False
+        directory_listing: bool = False,
+        quiet: bool = False
     ):
         """
         Initialize the server.
@@ -276,6 +330,7 @@ class GHPageServer:
         :param threaded: If True, handles requests using threads.
         :param auto_open: If True, automatically opens the server URL in the default web browser.
         :param directory_listing: If True, enables directory listing.
+        :param quiet: If True, suppresses informational server output.
         """
         _validate_inputs(
             directory=directory,
@@ -286,7 +341,8 @@ class GHPageServer:
             no_cache=no_cache,
             threaded=threaded,
             auto_open=auto_open,
-            directory_listing=directory_listing
+            directory_listing=directory_listing,
+            quiet=quiet
         )
         self._directory = str(Path(directory).resolve())
         self._host = host
@@ -298,10 +354,14 @@ class GHPageServer:
         self._threaded = threaded
         self._auto_open = auto_open
         self._directory_listing = directory_listing
+        self._quiet = quiet
         self._httpd = None
 
     def _print_server_info(self) -> None:
         """Print the current server configuration and access URL."""
+        if self._quiet:
+            return
+
         print(f"Serving at {self._url}")
         print(f"Directory: {self._directory}")
         print(f"Strict mode: {'ON' if self._strict else 'OFF'}")
@@ -348,3 +408,63 @@ class GHPageServer:
             self._httpd.shutdown()
             self._httpd.server_close()
             print("Server stopped.")
+
+    @classmethod
+    def from_config(
+        cls,
+        config: Optional[Union[str, Path, dict]] = None,
+        directory: Optional[str] = None,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        base_path: Optional[str] = None,
+        strict: Optional[bool] = None,
+        no_cache: Optional[bool] = None,
+        threaded: Optional[bool] = None,
+        auto_open: Optional[bool] = None,
+        directory_listing: Optional[bool] = None,
+        quiet: Optional[bool] = None,
+        auto_discover: bool = False,
+    ):
+        """
+        Create a GHPageServer instance from a configuration file or dictionary, with explicit parameter overrides.
+
+        :param config: Config input.
+        :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.
+        :param no_cache: If True, disables client-side caching.
+        :param threaded: If True, handles requests using threads.
+        :param auto_open: If True, automatically opens the server URL in the default web browser.
+        :param directory_listing: If True, enables directory listing.
+        :param quiet: If True, suppresses informational server output.
+        :param auto_discover: Auto discover flag.
+        """
+        init_directory = directory if directory is not None else "."
+        loaded_config = _load_config(init_directory, config, auto_discover=auto_discover)
+
+        resolved_directory = directory if directory is not None else loaded_config.get("directory", ".")
+        resolved_host = host if host is not None else loaded_config.get("host", "localhost")
+        resolved_port = port if port is not None else loaded_config.get("port", 8000)
+        resolved_base_path = base_path if base_path is not None else loaded_config.get("base_path", "")
+        resolved_strict = strict if strict is not None else loaded_config.get("strict", True)
+        resolved_no_cache = no_cache if no_cache is not None else loaded_config.get("no_cache", False)
+        resolved_threaded = threaded if threaded is not None else loaded_config.get("threaded", True)
+        resolved_auto_open = auto_open if auto_open is not None else loaded_config.get("auto_open", False)
+        resolved_directory_listing = directory_listing if directory_listing is not None else loaded_config.get(
+            "directory_listing", False)
+        resolved_quiet = quiet if quiet is not None else loaded_config.get("quiet", False)
+
+        return cls(
+            directory=resolved_directory,
+            host=resolved_host,
+            port=resolved_port,
+            base_path=resolved_base_path,
+            strict=resolved_strict,
+            no_cache=resolved_no_cache,
+            threaded=resolved_threaded,
+            auto_open=resolved_auto_open,
+            directory_listing=resolved_directory_listing,
+            quiet=resolved_quiet,
+        )

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: ghps
-Version: 0.7
+Version: 0.8
 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.7
+Download-URL: https://github.com/sepandhaghighi/ghps/tarball/v0.8
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -11,7 +11,6 @@ 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 :: 4 - Beta
 Classifier: Natural Language :: English
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
 Classifier: Programming Language :: Python :: 3.7
@@ -22,6 +21,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
 Classifier: Topic :: Utilities
@@ -33,6 +33,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: AUTHORS.md
 Requires-Dist: art>=5.3
+Requires-Dist: tomli>=2.0.2
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -62,7 +63,7 @@ Dynamic: summary
 ## Overview	
 
 <p align="justify">		
-<b>Ghps</b> is a minimal, zero-dependency GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
+<b>Ghps</b> is a minimal GitHub Pages simulator written in pure Python for local development and testing. It accurately replicates GitHub Pages' static hosting behavior, including proper <code>404.html</code> handling, project base path simulation, strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.
 </p>
 
 <table>
@@ -101,13 +102,13 @@ Dynamic: summary
 ## Installation		
 
 ### Source Code
-- Download [Version 0.7](https://github.com/sepandhaghighi/ghps/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/ghps/archive/dev.zip)
+- Download [Version 0.8](https://github.com/sepandhaghighi/ghps/archive/v0.8.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.7`						
+- `pip install ghps==0.8`						
 
 
 ## Usage
@@ -124,6 +125,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 
 | Option | Description | Default |
 |--------|-------------|----------|
+| `-c, --config` | Path to configuration file | Auto discovers `.ghps` |
 | `--host` | Host address to bind to | `localhost` |
 | `-p, --port` | Port to serve on | `8000` |
 | `-d, --directory` | Directory to serve | Current directory (`.`) |
@@ -133,6 +135,7 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 | `--no-threaded` | Disable threaded server | Threaded enabled |
 | `--auto-open` | Automatically open the server URL | Disable |
 | `--directory-listing` | Enable directory listing | Disable |
+| `--quiet` | Suppress informational server output | Disable |
 
 > [!NOTE]
 > You can set `--port=0` to let the OS automatically select an available port.
@@ -140,24 +143,32 @@ ghps --host=127.0.0.1 --port=8080 --no-cache --no-threaded
 > [!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`.
 
+> [!NOTE]
+> Ghps automatically looks for a `.ghps` configuration file in the served directory if available, or you can specify a custom configuration file path using `-c` / `--config`.
+
 
 ### Library
 
 ```python
 from ghps import GHPageServer
 
-server = GHPageServer(
+server1 = GHPageServer(
     directory="dist",
-	host="localhost",
+    host="localhost",
     port=5000,
     base_path="/repo-name",
     strict=True,
     no_cache=False,
     threaded=True,
-	auto_open=True,
+    auto_open=True,
+    quiet=False,
 )
 
-server.start()
+server1.start()
+
+server2 = GHPageServer.from_config(config="config.toml")
+
+server2.start()
 ```
 
 #### Parameters
@@ -173,6 +184,7 @@ server.start()
 | `threaded` | `bool` | Enable threaded request handling | `True` |
 | `auto_open` | `bool` | Automatically open the server URL | `False` |
 | `directory_listing` | `bool` | Enable directory listing | `False` |
+| `quiet` | `bool` | Suppress informational server output | `False` |
 
 > [!NOTE]
 > You can set `port=0` to let the OS automatically select an available port.
@@ -180,6 +192,23 @@ server.start()
 > [!NOTE]
 > The `host` parameter controls the network interface used for server binding. The default is `"localhost"`.
 
+### Configuration File
+
+You can define your server settings in a **TOML** configuration file (typically named `.ghps`):
+
+```toml
+directory = "dist"
+host = "localhost"
+port = 8080
+base_path = "/repo-name"
+strict = true
+no_cache = false
+threaded = true
+auto_open = false
+directory_listing = false
+quiet = false
+```
+
 ## Issues & Bug Reports			
 
 Just fill an issue and describe it. We'll check it ASAP!
@@ -229,6 +258,17 @@ 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.8] - 2026-11-08
+### Added
+- `quiet` parameter
+- `--quiet` CLI argument
+- `--config` CLI argument
+- `from_config` method
+### Changed
+- Test system modified
+- Build system modified
+- `Python 3.15` added to `test.yml`
+- `README.md` updated
 ## [0.7] - 2026-09-22
 ### Added
 - `host` parameter
@@ -283,7 +323,8 @@ 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.7...dev
+[Unreleased]: https://github.com/sepandhaghighi/ghps/compare/v0.8...dev
+[0.8]: https://github.com/sepandhaghighi/ghps/compare/v0.7...v0.8
 [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

{ghps-0.7 → ghps-0.8}/ghps.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ LICENSE
 MANIFEST.in
 README.md
 SECURITY.md
+pyproject.toml
 requirements-dev.txt
 requirements-latest.txt
 setup.py

ghps-0.8/ghps.egg-info/requires.txt

@@ -0,0 +1,2 @@
+art>=5.3
+tomli>=2.0.2

ghps-0.8/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel>=0.37.0"]
+build-backend = "setuptools.build_meta"

{ghps-0.7 → ghps-0.8}/requirements-dev.txt

@@ -1,7 +1,7 @@
 requests>=2.20.0
 pytest>=4.3.1
 pytest-cov>=2.6.1
-setuptools>=40.8.0
+setuptools>=61.0.0
 vulture>=1.0
 bandit>=1.5.1
 pydocstyle>=6.3.0

ghps-0.8/requirements-latest.txt

@@ -0,0 +1,2 @@
+art==6.5
+tomli==2.5.0

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

@@ -14,7 +14,7 @@ def read_description() -> str:
             description += c.read()
         return description
     except Exception:
-        return '''Ghps is a minimal, zero-dependency GitHub Pages simulator written in pure Python for local development and testing.
+        return '''Ghps is a minimal GitHub Pages simulator written in pure Python for local development and testing.
         It accurately replicates GitHub Pages' static hosting behavior, including proper 404.html handling, project base path simulation,
         strict routing mode, and optional cache control - all while remaining lightweight, fast, and usable both as a CLI tool and as an importable Python library.'''
 
@@ -22,7 +22,7 @@ def read_description() -> str:
 setup(
     name='ghps',
     packages=['ghps'],
-    version='0.7',
+    version='0.8',
     description='Ghps: A Minimal GitHub Pages Simulator for Local Development',
     long_description=read_description(),
     long_description_content_type='text/markdown',
@@ -30,17 +30,16 @@ setup(
     author='Sepand Haghighi',
     author_email='me@sepand.tech',
     url='https://github.com/sepandhaghighi/ghps',
-    download_url='https://github.com/sepandhaghighi/ghps/tarball/v0.7',
+    download_url='https://github.com/sepandhaghighi/ghps/tarball/v0.8',
     keywords='github gh-pages static-server static-hosting development server local http simulator testing cli python',
     project_urls={
         'Source': 'https://github.com/sepandhaghighi/ghps'
     },
-    install_requires=['art>=5.3'],
+    install_requires=['art>=5.3', 'tomli>=2.0.2'],
     python_requires='>=3.7',
     classifiers=[
         'Development Status :: 4 - Beta',
         'Natural Language :: English',
-        'License :: OSI Approved :: MIT License',
         'Operating System :: OS Independent',
         'Environment :: Console',
         'Programming Language :: Python :: 3.7',
@@ -51,6 +50,7 @@ setup(
         'Programming Language :: Python :: 3.12',
         'Programming Language :: Python :: 3.13',
         'Programming Language :: Python :: 3.14',
+        'Programming Language :: Python :: 3.15',
         'Intended Audience :: Developers',
         'Intended Audience :: Education',
         'Topic :: Utilities',

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

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 import sys
-from unittest.mock import patch
+from unittest.mock import patch, MagicMock
 import pytest
 from ghps.params import GHPS_VERSION
 import ghps.cli
@@ -8,7 +8,6 @@ import ghps.cli
 
 def run_cli(monkeypatch, args):
     monkeypatch.setattr(sys, "argv", ["ghps"] + args)
-    monkeypatch.setattr(ghps.cli.GHPageServer, "start", lambda self: None)
     ghps.cli.main()
 
 
@@ -22,39 +21,46 @@ def test_version_flag(capsys):
 def test_cli_default_arguments(monkeypatch):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
 
     run_cli(monkeypatch, [])
 
-    assert captured["host"] == "localhost"
-    assert captured["port"] == 8000
-    assert captured["strict"] is True
-    assert captured["no_cache"] is False
-    assert captured["threaded"] is True
-    assert captured["directory_listing"] is False
+    assert captured["host"] is None
+    assert captured["port"] is None
+    assert captured["strict"] is None
+    assert captured["no_cache"] is None
+    assert captured["threaded"] is None
+    assert captured["directory_listing"] is None
+    assert captured["quiet"] is None
 
 
 def test_cli_custom_port_and_directory(monkeypatch, tmp_path):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
@@ -68,14 +74,17 @@ def test_cli_custom_port_and_directory(monkeypatch, tmp_path):
 def test_cli_host(monkeypatch):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
@@ -88,14 +97,17 @@ def test_cli_host(monkeypatch):
 def test_cli_base_path(monkeypatch):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
@@ -108,24 +120,28 @@ def test_cli_base_path(monkeypatch):
 def test_cli_flags(monkeypatch):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
 
-    run_cli(monkeypatch, ["--no-strict", "--no-cache", "--no-threaded"])
+    run_cli(monkeypatch, ["--no-strict", "--no-cache", "--no-threaded", "--quiet"])
 
     assert captured["strict"] is False
     assert captured["no_cache"] is True
     assert captured["threaded"] is False
-    assert captured["directory_listing"] is False
+    assert captured["directory_listing"] is None
+    assert captured["quiet"] is True
 
 
 def test_cli_invalid_directory(monkeypatch):
@@ -138,7 +154,7 @@ def test_cli_invalid_directory(monkeypatch):
 @patch("ghps.cli.GHPageServer")
 @patch("sys.stderr")
 def test_cli_unexpected_error(mock_stderr, mock_server_cls):
-    mock_server = mock_server_cls.return_value
+    mock_server = mock_server_cls.from_config.return_value
     mock_server.start.side_effect = Exception("boom")
     test_args = ["ghps"]
     with patch("sys.argv", test_args):
@@ -152,14 +168,17 @@ def test_cli_unexpected_error(mock_stderr, mock_server_cls):
 def test_cli_directory_listing(monkeypatch):
     captured = {}
 
-    def fake_init(self, **kwargs):
+    def fake_from_config(cls, **kwargs):
         captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
 
     monkeypatch.setattr(ghps.cli, "GHPageServer", type(
         "MockServer",
         (),
         {
-            "__init__": fake_init,
+            "from_config": classmethod(fake_from_config),
             "start": lambda self: None,
         },
     ))
@@ -167,3 +186,50 @@ def test_cli_directory_listing(monkeypatch):
     run_cli(monkeypatch, ["--directory-listing"])
 
     assert captured["directory_listing"] is True
+
+
+def test_cli_quiet(monkeypatch):
+    captured = {}
+
+    def fake_from_config(cls, **kwargs):
+        captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
+
+    monkeypatch.setattr(ghps.cli, "GHPageServer", type(
+        "MockServer",
+        (),
+        {
+            "from_config": classmethod(fake_from_config),
+            "start": lambda self: None,
+        },
+    ))
+
+    run_cli(monkeypatch, ["--quiet"])
+
+    assert captured["quiet"] is True
+
+
+def test_cli_config_flag(monkeypatch, tmp_path):
+    captured = {}
+
+    def fake_from_config(cls, **kwargs):
+        captured.update(kwargs)
+        mock_server = MagicMock()
+        mock_server.start = lambda: None
+        return mock_server
+
+    monkeypatch.setattr(ghps.cli, "GHPageServer", type(
+        "MockServer",
+        (),
+        {
+            "from_config": classmethod(fake_from_config),
+        },
+    ))
+
+    config_path = str(tmp_path / "myconfig.toml")
+    run_cli(monkeypatch, ["-c", config_path])
+
+    assert captured["config"] == config_path
+    assert captured["auto_discover"] is True

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

@@ -196,6 +196,24 @@ def test_invalid_directory_listing_type(tmp_path):
         )
 
 
+def test_invalid_quiet_type(tmp_path):
+    with pytest.raises(
+        GHPSValidationError,
+        match="`quiet` must be bool."
+    ):
+        GHPageServer(
+            directory=tmp_path,
+            port=8000,
+            base_path="",
+            strict=True,
+            no_cache=False,
+            threaded=True,
+            auto_open=False,
+            directory_listing=False,
+            quiet="true",
+        )
+
+
 @patch("ghps.server.webbrowser.open", side_effect=Exception("boom"))
 @patch("ghps.server._ThreadedTCPServer")
 @patch("builtins.print")
@@ -262,3 +280,25 @@ def test_port_address_not_available_error(mock_server_cls, tmp_path):
         server.start()
 
     assert "`port` address is not available. Check network configuration." in str(exc.value)
+
+
+def test_invalid_config_type(tmp_path):
+    with pytest.raises(GHPSValidationError, match="`config` must be str, pathlib.Path, or dict."):
+        GHPageServer.from_config(config=123, directory=tmp_path)
+
+
+def test_invalid_config_syntax(tmp_path):
+    config_file = tmp_path / ".ghps"
+    config_file.write_text('port = [invalid_syntax\n')
+
+    with pytest.raises(GHPSValidationError, match="Failed to load config file:"):
+        GHPageServer.from_config(config=config_file, directory=tmp_path)
+
+
+def test_invalid_config_value(tmp_path):
+    config_file = tmp_path / "invalid.toml"
+    config_file.write_text("invalid = true\n")
+
+    with patch("ghps.server.tomli.load", return_value=[]):
+        with pytest.raises(GHPSValidationError, match="Config file content must be a valid TOML format."):
+            GHPageServer.from_config(config=config_file, directory=tmp_path)

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

@@ -346,3 +346,92 @@ def test_directory_listing_disabled():
         assert response.status_code == 404
 
         server.stop()
+
+
+def test_quiet_mode(capsys, tmp_path):
+    server = GHPageServer(
+        directory=tmp_path,
+        port=9011,
+        quiet=True,
+    )
+
+    server._url = "http://localhost:9011"
+    server._print_server_info()
+
+    captured = capsys.readouterr()
+
+    assert captured.out == ""
+
+
+def test_quiet_mode_disabled(capsys, tmp_path):
+    server = GHPageServer(
+        directory=tmp_path,
+        port=9012,
+        quiet=False,
+    )
+
+    server._url = "http://localhost:9012"
+    server._print_server_info()
+
+    captured = capsys.readouterr()
+
+    assert "Serving at http://localhost:9012" in captured.out
+    assert f"Directory: {tmp_path.resolve()}" in captured.out
+    assert "Strict mode: ON" in captured.out
+    assert "Cache disabled: NO" in captured.out
+
+
+def test_server_from_config1():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        config = {"port": 9015, "strict": False, "no_cache": True}
+        server = GHPageServer.from_config(config=config, directory=tmpdir)
+        assert server._port == 9015
+        assert server._strict is False
+        assert server._no_cache is True
+
+
+def test_server_from_config2(tmp_path):
+    config_file = tmp_path / "custom.toml"
+    config_file.write_text('port = 9016\nhost = "127.0.0.1"\n')
+
+    server = GHPageServer.from_config(config=config_file, directory=tmp_path)
+    assert server._port == 9016
+    assert server._host == "127.0.0.1"
+
+
+def test_server_from_config3():
+    server1 = GHPageServer.from_config(auto_discover=False)
+    server2 = GHPageServer()
+    assert server1._port == server2._port
+    assert server1._host == server2._host
+
+
+def test_server_from_config4():
+    server1 = GHPageServer.from_config(auto_discover=True)
+    server2 = GHPageServer()
+    assert server1._port == server2._port
+    assert server1._host == server2._host
+
+
+def test_server_from_config5():
+    server1 = GHPageServer.from_config(config="custom2.toml")
+    server2 = GHPageServer()
+    assert server1._port == server2._port
+    assert server1._host == server2._host
+
+
+def test_server_from_config6(tmp_path):
+    config_file = tmp_path / ".ghps"
+    config_file.write_text('port = 9017\n')
+
+    server = GHPageServer.from_config(directory=tmp_path, auto_discover=True)
+    assert server._port == 9017
+
+
+def test_server_from_config7(tmp_path):
+    config_file = tmp_path / ".ghps"
+    config_file.write_text('port = 9017\nstrict = false\n')
+
+    server = GHPageServer.from_config(directory=tmp_path, port=9018, auto_discover=True)
+    assert server._port == 9018
+    assert server._strict is False

ghps-0.7/ghps.egg-info/requires.txt

@@ -1 +0,0 @@
-art>=5.3

ghps-0.7/requirements-latest.txt

@@ -1 +0,0 @@
-art==6.5