localhost-server 0.1.0__tar.gz

localhost_server-0.1.0/LICENSE

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

localhost_server-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: localhost-server
+Version: 0.1.0
+Summary: Static file hosting library for local development
+Author-email: Your Name <you@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/username/localhost
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# localhost
+
+Static file hosting library for local development.
+
+## Installation
+
+```bash
+pip install localhost
+```
+
+## Quick Start
+
+```python
+from localhost import serve
+
+serve("./website/", port=4488)
+```
+
+## Options
+
+```python
+from localhost import serve, Options
+
+server = serve(
+    "./website/",
+    port=4488,
+    options=Options(
+        index_file="demo.html",
+        enable_js=False,
+        auto_reload=True,
+        log_level="info",
+    )
+)
+```
+
+## API
+
+- `serve(folder, port, options)` - Start hosting
+- `stop()` - Stop the server
+- `Options` - Configuration dataclass
+
+## Error Handling
+
+```python
+from localhost import serve, ErrFolderNotFound, ErrIndexNotFound, ErrPortInUse
+
+try:
+    server = serve("./website/", port=4488)
+except ErrFolderNotFound:
+    print("Folder does not exist")
+except ErrIndexNotFound:
+    print("No index file found")
+except ErrPortInUse:
+    print("Port is already in use")
+```

localhost_server-0.1.0/README.md

@@ -0,0 +1,55 @@
+# localhost
+
+Static file hosting library for local development.
+
+## Installation
+
+```bash
+pip install localhost
+```
+
+## Quick Start
+
+```python
+from localhost import serve
+
+serve("./website/", port=4488)
+```
+
+## Options
+
+```python
+from localhost import serve, Options
+
+server = serve(
+    "./website/",
+    port=4488,
+    options=Options(
+        index_file="demo.html",
+        enable_js=False,
+        auto_reload=True,
+        log_level="info",
+    )
+)
+```
+
+## API
+
+- `serve(folder, port, options)` - Start hosting
+- `stop()` - Stop the server
+- `Options` - Configuration dataclass
+
+## Error Handling
+
+```python
+from localhost import serve, ErrFolderNotFound, ErrIndexNotFound, ErrPortInUse
+
+try:
+    server = serve("./website/", port=4488)
+except ErrFolderNotFound:
+    print("Folder does not exist")
+except ErrIndexNotFound:
+    print("No index file found")
+except ErrPortInUse:
+    print("Port is already in use")
+```

localhost_server-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "localhost-server"
+version = "0.1.0"
+description = "Static file hosting library for local development"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Your Name", email = "you@example.com"}
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/username/localhost"
+
+[project.optional-dependencies]
+dev = ["build", "twine"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["localhost*"]

localhost_server-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

localhost_server-0.1.0/src/localhost/__init__.py

@@ -0,0 +1,3 @@
+from .server import serve, stop, Options, LocalhostError, LogLevel
+
+__all__ = ["serve", "stop", "Options", "LocalhostError", "LogLevel"]

localhost_server-0.1.0/src/localhost/server.py

@@ -0,0 +1,188 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import Optional
+import http.server
+import socketserver
+import os
+import signal
+import sys
+import threading
+
+
+class LogLevel(Enum):
+    NONE = 0
+    INFO = 1
+    DEBUG = 2
+
+
+class LocalhostError(Exception):
+    pass
+
+
+class ErrFolderNotFound(LocalhostError):
+    pass
+
+
+class ErrIndexNotFound(LocalhostError):
+    pass
+
+
+class ErrPortInUse(LocalhostError):
+    pass
+
+
+@dataclass
+class Options:
+    index_file: str = "index.html"
+    enable_js: bool = True
+    auto_reload: bool = False
+    log_prefix: str = "[localhost]"
+    log_level: str = "info"
+    cert_file: Optional[str] = None
+    key_file: Optional[str] = None
+
+    def __post_init__(self):
+        if isinstance(self.log_level, str):
+            self.log_level = {
+                "none": LogLevel.NONE,
+                "info": LogLevel.INFO,
+                "debug": LogLevel.DEBUG,
+            }.get(self.log_level.lower(), LogLevel.INFO)
+
+
+_server_instance = None
+_server_shutdown = threading.Event()
+
+
+def _log(prefix: str, message: str, level, min_level):
+    if level.value >= min_level.value:
+        print(f"{prefix} {message}")
+
+
+class FileWatcher:
+    def __init__(self, folder: str, callback, log_prefix: str, log_level):
+        self.folder = folder
+        self.callback = callback
+        self.log_prefix = log_prefix
+        self.log_level = log_level
+        self._running = False
+        self._thread = None
+        self._mtimes = {}
+
+    def _get_mtime(self, filepath):
+        try:
+            return os.path.getmtime(filepath)
+        except OSError:
+            return None
+
+    def _scan_files(self):
+        for root, dirs, files in os.walk(self.folder):
+            for f in files:
+                if f.endswith(('.html', '.css', '.js')):
+                    path = os.path.join(root, f)
+                    self._mtimes[path] = self._get_mtime(path)
+
+    def _check_changes(self):
+        self._scan_files()
+        while self._running:
+            for path, old_mtime in list(self._mtimes.items()):
+                new_mtime = self._get_mtime(path)
+                if new_mtime is not None and new_mtime != old_mtime:
+                    self._mtimes[path] = new_mtime
+                    rel_path = os.path.relpath(path, self.folder)
+                    _log(self.log_prefix, f"File changed: {rel_path}", self.log_level, LogLevel.INFO)
+                    self.callback()
+                    break
+            threading.Event().wait(0.5)
+
+    def start(self):
+        self._running = True
+        self._thread = threading.Thread(target=self._check_changes, daemon=True)
+        self._thread.start()
+
+    def stop(self):
+        self._running = False
+        if self._thread:
+            self._thread.join(timeout=1)
+
+
+def serve(
+    folder: str = "./",
+    port: int = 8080,
+    options: Optional[Options] = None,
+):
+    global _server_instance
+
+    if options is None:
+        options = Options()
+
+    if not os.path.isdir(folder):
+        raise ErrFolderNotFound(f"Folder not found: {folder}")
+
+    index_path = os.path.join(folder, options.index_file)
+    if not os.path.isfile(index_path):
+        raise ErrIndexNotFound(f"No index file found in {folder}")
+
+    class Handler(http.server.SimpleHTTPRequestHandler):
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, directory=folder, **kwargs)
+
+        def log_message(self, format, *args):
+            pass
+
+    watcher = None
+    httpd = None
+
+    def signal_handler(sig, frame):
+        _server_shutdown.set()
+        if httpd:
+            httpd.shutdown()
+
+    try:
+        if options.auto_reload:
+            watcher = FileWatcher(folder, lambda: None, options.log_prefix, options.log_level)
+            watcher.start()
+
+        old_sigint = signal.signal(signal.SIGINT, signal_handler)
+        old_sigterm = signal.signal(signal.SIGTERM, signal_handler)
+
+        socketserver.TCPServer.allow_reuse_address = True
+        socketserver.TCPServer.daemon_threads = True
+        httpd = socketserver.TCPServer(("", port), Handler)
+        _server_instance = httpd
+
+        scheme = "https" if options.cert_file else "http"
+        _log(options.log_prefix, f"Started hosting on port {port}.", options.log_level, LogLevel.INFO)
+        _log(options.log_prefix, f"Serving files from \"{folder}\".", options.log_level, LogLevel.INFO)
+        _log(options.log_prefix, f"Go to {scheme}://localhost:{port} in your browser.", options.log_level, LogLevel.INFO)
+        _log(options.log_prefix, "Press Ctrl+C to stop.", options.log_level, LogLevel.INFO)
+
+        if options.auto_reload:
+            _log(options.log_prefix, "Auto-reload enabled. Watching for file changes ...", options.log_level, LogLevel.INFO)
+
+        serve_thread = threading.Thread(target=httpd.serve_forever, kwargs={"poll_interval": 0.1}, daemon=True)
+        serve_thread.start()
+
+        while not _server_shutdown.is_set():
+            threading.Event().wait(0.1)
+
+        serve_thread.join(timeout=1)
+    except OSError as e:
+        if e.errno == 98 or e.errno == 48:
+            raise ErrPortInUse(f"Port {port} is already in use") from e
+        raise
+    finally:
+        signal.signal(signal.SIGINT, old_sigint)
+        signal.signal(signal.SIGTERM, old_sigterm)
+        if watcher:
+            watcher.stop()
+        _server_instance = None
+        _server_shutdown.clear()
+
+
+def stop():
+    global _server_instance
+    _server_shutdown.set()
+    if _server_instance:
+        _server_instance.shutdown()
+        _server_instance = None

localhost_server-0.1.0/src/localhost_server.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: localhost-server
+Version: 0.1.0
+Summary: Static file hosting library for local development
+Author-email: Your Name <you@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/username/localhost
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# localhost
+
+Static file hosting library for local development.
+
+## Installation
+
+```bash
+pip install localhost
+```
+
+## Quick Start
+
+```python
+from localhost import serve
+
+serve("./website/", port=4488)
+```
+
+## Options
+
+```python
+from localhost import serve, Options
+
+server = serve(
+    "./website/",
+    port=4488,
+    options=Options(
+        index_file="demo.html",
+        enable_js=False,
+        auto_reload=True,
+        log_level="info",
+    )
+)
+```
+
+## API
+
+- `serve(folder, port, options)` - Start hosting
+- `stop()` - Stop the server
+- `Options` - Configuration dataclass
+
+## Error Handling
+
+```python
+from localhost import serve, ErrFolderNotFound, ErrIndexNotFound, ErrPortInUse
+
+try:
+    server = serve("./website/", port=4488)
+except ErrFolderNotFound:
+    print("Folder does not exist")
+except ErrIndexNotFound:
+    print("No index file found")
+except ErrPortInUse:
+    print("Port is already in use")
+```

localhost_server-0.1.0/src/localhost_server.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/localhost/__init__.py
+src/localhost/server.py
+src/localhost_server.egg-info/PKG-INFO
+src/localhost_server.egg-info/SOURCES.txt
+src/localhost_server.egg-info/dependency_links.txt
+src/localhost_server.egg-info/requires.txt
+src/localhost_server.egg-info/top_level.txt

localhost_server-0.1.0/src/localhost_server.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

localhost_server-0.1.0/src/localhost_server.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+build
+twine

localhost_server-0.1.0/src/localhost_server.egg-info/top_level.txt

@@ -0,0 +1 @@
+localhost