artinforge 0.1.0__py3-none-any.whl

artinforge/__init__.py

@@ -0,0 +1,4 @@
+"""ArtinForge lightweight developer toolkit."""
+__version__ = "0.1.0"
+from . import files, jsonstore, net, system, text
+__all__ = ["files", "jsonstore", "net", "system", "text", "__version__"]

artinforge/cli.py

@@ -0,0 +1,24 @@
+"""ArtinForge command line interface."""
+import argparse
+import json
+from .server import LocalServer
+from .system import info
+
+def main():
+    parser = argparse.ArgumentParser(prog="artinforge", description="ArtinForge developer toolkit")
+    sub = parser.add_subparsers(dest="command")
+    sub.add_parser("info", help="show Python/platform information")
+    serve = sub.add_parser("serve", help="serve a directory for local development")
+    serve.add_argument("--host", default="127.0.0.1")
+    serve.add_argument("--port", type=int, default=8765)
+    serve.add_argument("--directory", default=".")
+    args = parser.parse_args()
+    if args.command == "info":
+        print(json.dumps(info(), indent=2, ensure_ascii=False))
+    elif args.command == "serve":
+        LocalServer(args.host, args.port, args.directory).serve()
+    else:
+        parser.print_help()
+
+if __name__ == "__main__":
+    main()

artinforge/files.py

@@ -0,0 +1,22 @@
+"""Filesystem helpers."""
+from pathlib import Path
+
+def ensure_dir(path) -> Path:
+    target = Path(path)
+    target.mkdir(parents=True, exist_ok=True)
+    return target
+
+def read_text(path, encoding="utf-8") -> str:
+    return Path(path).read_text(encoding=encoding)
+
+def write_text(path, content, encoding="utf-8") -> Path:
+    target = Path(path)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    target.write_text(str(content), encoding=encoding)
+    return target
+
+def file_size(path) -> int:
+    return Path(path).stat().st_size
+
+def list_files(path=".", pattern="*") -> list:
+    return sorted(p for p in Path(path).glob(pattern) if p.is_file())

artinforge/jsonstore.py

@@ -0,0 +1,23 @@
+"""JSON read/write helpers."""
+import json
+from pathlib import Path
+
+def load(path, default=None, encoding="utf-8"):
+    target = Path(path)
+    if not target.exists():
+        return default
+    try:
+        with target.open("r", encoding=encoding) as stream:
+            return json.load(stream)
+    except (json.JSONDecodeError, OSError) as exc:
+        raise ValueError(f"Could not load JSON from {target}: {exc}") from exc
+
+def save(path, data, *, indent=2, ensure_ascii=False, encoding="utf-8"):
+    target = Path(path)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    temp = target.with_suffix(target.suffix + ".tmp")
+    with temp.open("w", encoding=encoding) as stream:
+        json.dump(data, stream, indent=indent, ensure_ascii=ensure_ascii)
+        stream.write("\n")
+    temp.replace(target)
+    return target

artinforge/net.py

@@ -0,0 +1,37 @@
+"""Small HTTP helpers using Python's standard library."""
+import json
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlparse
+from urllib.request import Request, urlopen
+
+def validate_url(url):
+    parsed = urlparse(url)
+    if parsed.scheme not in ("http", "https") or not parsed.netloc:
+        raise ValueError("Expected an absolute http:// or https:// URL")
+    return url
+
+def get(url, *, timeout=10, headers=None):
+    request = Request(validate_url(url), headers=headers or {}, method="GET")
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            return response.read()
+    except (HTTPError, URLError, TimeoutError) as exc:
+        raise RuntimeError(f"GET request failed: {exc}") from exc
+
+def get_text(url, *, timeout=10, encoding="utf-8", headers=None):
+    return get(url, timeout=timeout, headers=headers).decode(encoding, errors="replace")
+
+def get_json(url, *, timeout=10, headers=None):
+    return json.loads(get_text(url, timeout=timeout, headers=headers))
+
+def post_json(url, data, *, timeout=10, headers=None):
+    request_headers = {"Content-Type": "application/json"}
+    request_headers.update(headers or {})
+    request = Request(validate_url(url), data=json.dumps(data).encode("utf-8"),
+                      headers=request_headers, method="POST")
+    try:
+        with urlopen(request, timeout=timeout) as response:
+            body = response.read().decode("utf-8", errors="replace")
+            return json.loads(body) if body else None
+    except (HTTPError, URLError, TimeoutError) as exc:
+        raise RuntimeError(f"POST request failed: {exc}") from exc

artinforge/server.py

@@ -0,0 +1,27 @@
+"""Local static-file server for development."""
+from functools import partial
+from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+
+class LocalServer:
+    def __init__(self, host="127.0.0.1", port=8765, directory="."):
+        if not 0 <= int(port) <= 65535:
+            raise ValueError("port must be between 0 and 65535")
+        self.host, self.port = host, int(port)
+        self.directory = str(Path(directory).resolve())
+        self._server = ThreadingHTTPServer(
+            (self.host, self.port),
+            partial(SimpleHTTPRequestHandler, directory=self.directory)
+        )
+
+    def serve(self):
+        print("ARTINFORGE LOCAL SERVER")
+        print(f"Serving: {self.directory}")
+        print(f"Open: http://{self.host}:{self._server.server_address[1]}")
+        print("Press Ctrl+C to stop.")
+        try:
+            self._server.serve_forever()
+        except KeyboardInterrupt:
+            print("\nStopping server...")
+        finally:
+            self._server.server_close()

artinforge/system.py

@@ -0,0 +1,12 @@
+"""Basic runtime information."""
+import os
+import platform
+import sys
+
+def info() -> dict:
+    return {"python": sys.version.split()[0],
+            "implementation": platform.python_implementation(),
+            "platform": platform.platform(),
+            "executable": sys.executable,
+            "current_directory": os.getcwd(),
+            "pid": os.getpid()}

artinforge/text.py

@@ -0,0 +1,23 @@
+"""Unicode-friendly text utilities."""
+import re
+import unicodedata
+
+def normalize_whitespace(value: str) -> str:
+    return " ".join(str(value).split())
+
+def word_count(value: str) -> int:
+    return len(str(value).split())
+
+def truncate(value: str, length: int, suffix: str = "...") -> str:
+    if length < 0:
+        raise ValueError("length must be >= 0")
+    value = str(value)
+    if len(value) <= length:
+        return value
+    if length <= len(suffix):
+        return suffix[:length]
+    return value[:length-len(suffix)] + suffix
+
+def slugify(value: str, separator: str = "-") -> str:
+    value = unicodedata.normalize("NFKD", str(value)).encode("ascii", "ignore").decode()
+    return re.sub(r"[^a-zA-Z0-9]+", separator, value.lower()).strip(separator)

artinforge-0.1.0.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: artinforge
+Version: 0.1.0
+Summary: A lightweight, modular Python toolkit for developer utilities.
+Author: Artin Karimian
+License-Expression: MIT
+Keywords: python,developer-tools,automation,files,json,networking
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ArtinForge
+
+**A lightweight, modular Python toolkit for everyday developer tasks.**
+
+ArtinForge starts with useful, real features and avoids mandatory third-party runtime dependencies.
+
+## Features
+
+- **Text utilities:** normalize whitespace, count words, truncate text, create slugs.
+- **File utilities:** UTF-8 read/write, directory creation, file listing and size.
+- **JSON storage:** read and save JSON, including Persian/Unicode text.
+- **HTTP helpers:** GET text/JSON and POST JSON using Python's standard library.
+- **Local development server:** serve a folder for local testing.
+- **System information:** Python version, platform, executable and current directory.
+- **Command line:** inspect runtime details and launch the local server.
+
+> ArtinForge is a developer toolkit, not a bundled AI model. AI features require a model or service to be connected separately.
+
+## Install
+
+```bash
+python -m pip install artinforge
+```
+
+If a package mirror is stale, check the official PyPI index:
+
+```bash
+python -m pip install --index-url https://pypi.org/simple artinforge
+```
+
+The name must be available on PyPI before the first release. Check the project page before publishing.
+
+## Quick example
+
+```python
+from artinforge import text, files, jsonstore
+
+print(text.slugify("Hello ArtinForge!"))
+files.write_text("demo/hello.txt", "سلام آرتین")
+jsonstore.save("demo/settings.json", {"language": "fa", "theme": "dark"})
+print(jsonstore.load("demo/settings.json", default={}))
+```
+
+## Start a local test server
+
+```bash
+artinforge serve --host 127.0.0.1 --port 8765 --directory .
+```
+
+Then open `http://127.0.0.1:8765` in your browser. This is for local development; do not expose it to the public internet without a security review and appropriate protections.
+
+## Commands
+
+```bash
+artinforge --help
+artinforge info
+artinforge serve --host 127.0.0.1 --port 8765 --directory .
+```
+
+## Package the project
+
+From the folder containing `pyproject.toml`:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+Only after checks pass, upload with your PyPI token:
+
+```bash
+python -m twine upload dist/*
+```
+
+**Release rule:** every upload to PyPI needs a version that has not been published before. If you need to fix a release, increment `version` in `pyproject.toml`, rebuild from a clean `dist/` directory, and upload the new version. A mirror may take time to sync, so verify against the official PyPI index.
+
+
+## License
+
+MIT. See `LICENSE`.

artinforge-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+artinforge/__init__.py,sha256=obt0lVZLWKkTj0clJkh9AIcL_KlCq17MkwHeBhPLQq4,193
+artinforge/cli.py,sha256=Fy18P2HVLk9cytID7D_6tdFwjIqyQnThQ8YAKRG6CPY,904
+artinforge/files.py,sha256=kEn-96x-N9sP3o7DYTUT7McnpnCIbBK-Gg25twciQKA,660
+artinforge/jsonstore.py,sha256=LxNTA5egPTDxMYn5QSrKNr4-jI-XIGvmL_G4xSOph94,831
+artinforge/net.py,sha256=9U1lmljCJaNyfAvYG-_FzUeSn2nVfJ3bruJQSZmNGdE,1636
+artinforge/server.py,sha256=DgZu80j2K5U9u3l3fy4V1A2cQrrjdWxoY1yOc3Hwpag,1040
+artinforge/system.py,sha256=lW2URGbJX-S-9owF9Kzw-hCKiS8_Cfbn889vmNbb1BE,366
+artinforge/text.py,sha256=9BLy4QONMy9d0b_X97XxCeHLtv4l8vnIh8RGCCDQdDo,764
+artinforge/assets/artinforge-banner.png,sha256=9ThHZ9QVh6GixUZmzluU35FfcR8aKK8XMwBIuL-6CMU,1991563
+artinforge-0.1.0.dist-info/licenses/LICENSE,sha256=qTWUb-x1Rt-H5lDFtGSiTzxcKgVaUro8MxTyhMuTph0,812
+artinforge-0.1.0.dist-info/METADATA,sha256=QiJ95OqKCFdTXHbtgH4JbNzBQR9uYH98wwk-P-ZKsC0,3096
+artinforge-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+artinforge-0.1.0.dist-info/entry_points.txt,sha256=-PFKVE-z34ej8hzKsHx5tQSiiovuJaVWdjl8v9NSrxE,51
+artinforge-0.1.0.dist-info/top_level.txt,sha256=iprDOQxUc35LeDbVx3-a0nXXEfOvFDVAgRseBveUTZs,11
+artinforge-0.1.0.dist-info/RECORD,,

artinforge-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

artinforge-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+artinforge = artinforge.cli:main

artinforge-0.1.0.dist-info/licenses/LICENSE

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

artinforge-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+artinforge