staypresent 1.0.0__tar.gz

staypresent-1.0.0/LICENSE

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

staypresent-1.0.0/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: staypresent
+Version: 1.0.0
+Summary: Run your Python bot alongside a lightweight Flask web server.
+Author: Ashish Sharma
+License: MIT
+Project-URL: Homepage, https://github.com/NTDevLops/staypresent
+Project-URL: Repository, https://github.com/NTDevLops/staypresent
+Project-URL: Issues, https://github.com/NTDevLops/staypresent/issues
+Keywords: flask,telegram,discord,bot,webserver,keepalive
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Flask>=3.0.0
+Dynamic: license-file
+
+# StayPresent
+
+A lightweight Python package that keeps your bot or script alive by running a small Flask web server alongside your application.
+
+Perfect for platforms like **Render**, **Railway**, **Koyeb**, **Heroku**, or anywhere an HTTP server is required to keep your service active.
+
+---
+
+## Features
+
+- 🚀 One-line setup
+- 🌐 Built-in Flask web server
+- 🤖 Runs your Python bot/script automatically
+- 📄 Custom text response
+- 📦 JSON response support
+- ⚡ Lightweight and easy to use
+
+---
+
+## Installation
+
+```bash
+pip install staypresent
+```
+
+Or install locally:
+
+```bash
+pip install .
+```
+
+---
+
+## Basic Usage
+
+```python
+import staypresent
+
+staypresent.web.text("Made With ❤️")
+
+staypresent.run("bot.py")
+```
+
+Open your browser:
+
+```
+http://localhost:8080
+```
+
+Response:
+
+```
+Made With ❤️
+```
+
+---
+
+## JSON Response
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "online",
+    "developer": "John",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run("bot.py")
+```
+
+Response
+
+```json
+{
+  "status": "online",
+  "developer": "John",
+  "message": "Made With Love ❤️"
+}
+```
+
+---
+
+## Custom Port
+
+```python
+import staypresent
+
+staypresent.run(
+    "bot.py",
+    port=5000
+)
+```
+
+---
+
+## Custom Host
+
+```python
+staypresent.run(
+    "bot.py",
+    host="0.0.0.0"
+)
+```
+
+---
+
+## Complete Example
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "Running",
+    "version": "1.0.0",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run(
+    "body.py",
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+---
+
+## API
+
+### Run your bot
+
+```python
+staypresent.run(
+    bot_file,
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `bot_file` | str | Path to your Python script |
+| `host` | str | Flask host |
+| `port` | int | Flask port |
+
+---
+
+### Plain Text Response
+
+```python
+staypresent.web.text("Hello World")
+```
+
+---
+
+### JSON Response
+
+```python
+staypresent.web.json({
+    "hello": "world"
+})
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Flask
+
+---
+
+## Use Cases
+
+- Telegram Bots
+- Discord Bots
+- Automation Scripts
+- Background Workers
+- Render Deployments
+- Railway Deployments
+- Koyeb Deployments
+- Heroku Apps
+
+---
+
+## License
+
+MIT License
+
+---
+
+Made with ❤️ using Python.

staypresent-1.0.0/README.md

@@ -0,0 +1,192 @@
+# StayPresent
+
+A lightweight Python package that keeps your bot or script alive by running a small Flask web server alongside your application.
+
+Perfect for platforms like **Render**, **Railway**, **Koyeb**, **Heroku**, or anywhere an HTTP server is required to keep your service active.
+
+---
+
+## Features
+
+- 🚀 One-line setup
+- 🌐 Built-in Flask web server
+- 🤖 Runs your Python bot/script automatically
+- 📄 Custom text response
+- 📦 JSON response support
+- ⚡ Lightweight and easy to use
+
+---
+
+## Installation
+
+```bash
+pip install staypresent
+```
+
+Or install locally:
+
+```bash
+pip install .
+```
+
+---
+
+## Basic Usage
+
+```python
+import staypresent
+
+staypresent.web.text("Made With ❤️")
+
+staypresent.run("bot.py")
+```
+
+Open your browser:
+
+```
+http://localhost:8080
+```
+
+Response:
+
+```
+Made With ❤️
+```
+
+---
+
+## JSON Response
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "online",
+    "developer": "John",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run("bot.py")
+```
+
+Response
+
+```json
+{
+  "status": "online",
+  "developer": "John",
+  "message": "Made With Love ❤️"
+}
+```
+
+---
+
+## Custom Port
+
+```python
+import staypresent
+
+staypresent.run(
+    "bot.py",
+    port=5000
+)
+```
+
+---
+
+## Custom Host
+
+```python
+staypresent.run(
+    "bot.py",
+    host="0.0.0.0"
+)
+```
+
+---
+
+## Complete Example
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "Running",
+    "version": "1.0.0",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run(
+    "body.py",
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+---
+
+## API
+
+### Run your bot
+
+```python
+staypresent.run(
+    bot_file,
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `bot_file` | str | Path to your Python script |
+| `host` | str | Flask host |
+| `port` | int | Flask port |
+
+---
+
+### Plain Text Response
+
+```python
+staypresent.web.text("Hello World")
+```
+
+---
+
+### JSON Response
+
+```python
+staypresent.web.json({
+    "hello": "world"
+})
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Flask
+
+---
+
+## Use Cases
+
+- Telegram Bots
+- Discord Bots
+- Automation Scripts
+- Background Workers
+- Render Deployments
+- Railway Deployments
+- Koyeb Deployments
+- Heroku Apps
+
+---
+
+## License
+
+MIT License
+
+---
+
+Made with ❤️ using Python.

staypresent-1.0.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "staypresent"
+version = "1.0.0"
+description = "Run your Python bot alongside a lightweight Flask web server."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+  { name = "Ashish Sharma" }
+]
+requires-python = ">=3.8"
+
+dependencies = [
+    "Flask>=3.0.0"
+]
+
+keywords = [
+    "flask",
+    "telegram",
+    "discord",
+    "bot",
+    "webserver",
+    "keepalive"
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://github.com/NTDevLops/staypresent"
+Repository = "https://github.com/NTDevLops/staypresent"
+Issues = "https://github.com/NTDevLops/staypresent/issues"

staypresent-1.0.0/setup.cfg

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

staypresent-1.0.0/staypresent/__init__.py

@@ -0,0 +1,4 @@
+from .runner import run
+from . import web
+
+__all__ = ["run", "web"]

staypresent-1.0.0/staypresent/runner.py

@@ -0,0 +1,43 @@
+import subprocess
+import threading
+import logging
+import signal
+import sys
+import os
+
+from .server import app
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s | %(levelname)-8s | %(message)s",
+)
+
+logger = logging.getLogger("staypresent")
+
+
+def _run_server():
+    app.run(host="0.0.0.0", port=8080)
+
+
+def run(bot_file: str):
+    """
+    Starts Flask + Bot
+
+    Example:
+        staypresent.run("bot.py")
+    """
+
+    flask_thread = threading.Thread(target=_run_server, daemon=True)
+    flask_thread.start()
+
+    process = subprocess.Popen([sys.executable, bot_file])
+
+    def shutdown(*args):
+        logger.info("Stopping...")
+        process.terminate()
+        sys.exit(0)
+
+    signal.signal(signal.SIGINT, shutdown)
+    signal.signal(signal.SIGTERM, shutdown)
+
+    process.wait()

staypresent-1.0.0/staypresent/server.py

@@ -0,0 +1,14 @@
+from flask import Flask, jsonify
+from . import web
+
+app = Flask(__name__)
+
+
+@app.route("/")
+def home():
+    data = web.get()
+
+    if isinstance(data, (dict, list)):
+        return jsonify(data)
+
+    return str(data)

staypresent-1.0.0/staypresent/web.py

@@ -0,0 +1,12 @@
+_response = "StayPresent"
+
+def text(message: str):
+    global _response
+    _response = str(message)
+
+def json(data):
+    global _response
+    _response = data
+
+def get():
+    return _response

staypresent-1.0.0/staypresent.egg-info/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: staypresent
+Version: 1.0.0
+Summary: Run your Python bot alongside a lightweight Flask web server.
+Author: Ashish Sharma
+License: MIT
+Project-URL: Homepage, https://github.com/NTDevLops/staypresent
+Project-URL: Repository, https://github.com/NTDevLops/staypresent
+Project-URL: Issues, https://github.com/NTDevLops/staypresent/issues
+Keywords: flask,telegram,discord,bot,webserver,keepalive
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Flask>=3.0.0
+Dynamic: license-file
+
+# StayPresent
+
+A lightweight Python package that keeps your bot or script alive by running a small Flask web server alongside your application.
+
+Perfect for platforms like **Render**, **Railway**, **Koyeb**, **Heroku**, or anywhere an HTTP server is required to keep your service active.
+
+---
+
+## Features
+
+- 🚀 One-line setup
+- 🌐 Built-in Flask web server
+- 🤖 Runs your Python bot/script automatically
+- 📄 Custom text response
+- 📦 JSON response support
+- ⚡ Lightweight and easy to use
+
+---
+
+## Installation
+
+```bash
+pip install staypresent
+```
+
+Or install locally:
+
+```bash
+pip install .
+```
+
+---
+
+## Basic Usage
+
+```python
+import staypresent
+
+staypresent.web.text("Made With ❤️")
+
+staypresent.run("bot.py")
+```
+
+Open your browser:
+
+```
+http://localhost:8080
+```
+
+Response:
+
+```
+Made With ❤️
+```
+
+---
+
+## JSON Response
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "online",
+    "developer": "John",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run("bot.py")
+```
+
+Response
+
+```json
+{
+  "status": "online",
+  "developer": "John",
+  "message": "Made With Love ❤️"
+}
+```
+
+---
+
+## Custom Port
+
+```python
+import staypresent
+
+staypresent.run(
+    "bot.py",
+    port=5000
+)
+```
+
+---
+
+## Custom Host
+
+```python
+staypresent.run(
+    "bot.py",
+    host="0.0.0.0"
+)
+```
+
+---
+
+## Complete Example
+
+```python
+import staypresent
+
+staypresent.web.json({
+    "status": "Running",
+    "version": "1.0.0",
+    "message": "Made With Love ❤️"
+})
+
+staypresent.run(
+    "body.py",
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+---
+
+## API
+
+### Run your bot
+
+```python
+staypresent.run(
+    bot_file,
+    host="0.0.0.0",
+    port=8080
+)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `bot_file` | str | Path to your Python script |
+| `host` | str | Flask host |
+| `port` | int | Flask port |
+
+---
+
+### Plain Text Response
+
+```python
+staypresent.web.text("Hello World")
+```
+
+---
+
+### JSON Response
+
+```python
+staypresent.web.json({
+    "hello": "world"
+})
+```
+
+---
+
+## Requirements
+
+- Python 3.8+
+- Flask
+
+---
+
+## Use Cases
+
+- Telegram Bots
+- Discord Bots
+- Automation Scripts
+- Background Workers
+- Render Deployments
+- Railway Deployments
+- Koyeb Deployments
+- Heroku Apps
+
+---
+
+## License
+
+MIT License
+
+---
+
+Made with ❤️ using Python.

staypresent-1.0.0/staypresent.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+staypresent/__init__.py
+staypresent/runner.py
+staypresent/server.py
+staypresent/web.py
+staypresent.egg-info/PKG-INFO
+staypresent.egg-info/SOURCES.txt
+staypresent.egg-info/dependency_links.txt
+staypresent.egg-info/requires.txt
+staypresent.egg-info/top_level.txt

staypresent-1.0.0/staypresent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

staypresent-1.0.0/staypresent.egg-info/requires.txt

@@ -0,0 +1 @@
+Flask>=3.0.0

staypresent-1.0.0/staypresent.egg-info/top_level.txt

@@ -0,0 +1 @@
+staypresent