logfore 2.1.3.1__tar.gz

logfore-2.1.3.1/LICENSE

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

logfore-2.1.3.1/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: logfore
+Version: 2.1.3.1
+Summary: A colorful and feature-rich logging library for Python
+Home-page: https://github.com/yourusername/logfore
+Author: 
+Author-email: 
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/logfore
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama
+Requires-Dist: pystyle
+Requires-Dist: requests
+Requires-Dist: packaging
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# logfore
+
+A colorful, feature-rich logging library for Python with support for styled output, loading animations, ASCII banners, and auto-updates.
+
+## Installation
+
+```bash
+pip install logfore
+```
+
+## Quick Start
+
+```python
+from logfore import Logger, Loader, Home, LogLevel
+
+# Basic logger (colorful style)
+log = Logger(prefix="MyApp")
+
+log.info("Application started")
+log.success("Task completed")
+log.warning("Low memory")
+log.failure("Connection lost")
+log.error("Something went wrong")
+log.debug("Debug message")
+log.critical("Fatal error occurred")  # exits program
+
+# Simple/minimal style
+log2 = Logger(style=2, prefix="MyApp")
+log2.info("Simple style log")
+```
+
+## Features
+
+### Logger Styles
+
+| Style | Description |
+|-------|-------------|
+| `style=1` | Colorful logger with pink/cyan/magenta theme (default) |
+| `style=2` | Minimal simple logger with arrow prefix |
+
+### Logger Options
+
+```python
+log = Logger(
+    style=1,                          # 1 = ColorLogger, 2 = SimpleLogger
+    prefix="MyApp",                   # Prefix shown in brackets
+    github_repository="user/repo",    # Displays repo info on start
+    level=LogLevel.DEBUG,             # Minimum log level to display
+    log_file="logs/app.log"           # Optional file logging
+)
+```
+
+### Log Levels
+
+```python
+from logfore import LogLevel
+
+# Available levels (in order):
+LogLevel.DEBUG
+LogLevel.INFO
+LogLevel.WARNING
+LogLevel.SUCCESS
+LogLevel.FAILURE
+LogLevel.CRITICAL
+```
+
+### Timing Support
+
+All log methods support optional timing:
+
+```python
+import time
+
+start = time.time()
+# ... do work ...
+end = time.time()
+
+log.success("Done!", start=start, end=end)
+# Output: ... [Success] -> Done! In 1.234 Seconds
+```
+
+### Loading Spinner
+
+```python
+from logfore import Loader
+
+# As context manager
+with Loader(prefix="MyApp", desc="Processing...", end="Done!"):
+    time.sleep(2)
+
+# Manual control
+loader = Loader(desc="Loading...")
+loader.start()
+# ... do work ...
+loader.stop()
+```
+
+### ASCII Banner (Home Screen)
+
+```python
+from logfore import Home
+
+home = Home(
+    text="LOGFORE",
+    align="center",       # "left", "center", "right"
+    adinfo1="v1.0.0",
+    adinfo2="by Author",
+    credits="GitHub: user",
+    clear=True            # Clear terminal before display
+)
+home.display()
+```
+
+### Auto Updater
+
+```python
+from logfore import AutoUpdater, Logger
+
+log = Logger()
+updater = AutoUpdater("your-pypi-package-name", log)
+updater.check_for_updates()
+```
+
+### File Logging
+
+```python
+log = Logger(log_file="logs/myapp.log")
+log.info("This is saved to file too")
+```
+
+## Questions / Input
+
+```python
+answer = log.question("What is your name? ")
+print(f"Hello, {answer}!")
+```
+
+## Requirements
+
+- Python 3.10+
+- colorama
+- pystyle
+- requests
+- packaging

logfore-2.1.3.1/README.md

@@ -0,0 +1,144 @@
+# logfore
+
+A colorful, feature-rich logging library for Python with support for styled output, loading animations, ASCII banners, and auto-updates.
+
+## Installation
+
+```bash
+pip install logfore
+```
+
+## Quick Start
+
+```python
+from logfore import Logger, Loader, Home, LogLevel
+
+# Basic logger (colorful style)
+log = Logger(prefix="MyApp")
+
+log.info("Application started")
+log.success("Task completed")
+log.warning("Low memory")
+log.failure("Connection lost")
+log.error("Something went wrong")
+log.debug("Debug message")
+log.critical("Fatal error occurred")  # exits program
+
+# Simple/minimal style
+log2 = Logger(style=2, prefix="MyApp")
+log2.info("Simple style log")
+```
+
+## Features
+
+### Logger Styles
+
+| Style | Description |
+|-------|-------------|
+| `style=1` | Colorful logger with pink/cyan/magenta theme (default) |
+| `style=2` | Minimal simple logger with arrow prefix |
+
+### Logger Options
+
+```python
+log = Logger(
+    style=1,                          # 1 = ColorLogger, 2 = SimpleLogger
+    prefix="MyApp",                   # Prefix shown in brackets
+    github_repository="user/repo",    # Displays repo info on start
+    level=LogLevel.DEBUG,             # Minimum log level to display
+    log_file="logs/app.log"           # Optional file logging
+)
+```
+
+### Log Levels
+
+```python
+from logfore import LogLevel
+
+# Available levels (in order):
+LogLevel.DEBUG
+LogLevel.INFO
+LogLevel.WARNING
+LogLevel.SUCCESS
+LogLevel.FAILURE
+LogLevel.CRITICAL
+```
+
+### Timing Support
+
+All log methods support optional timing:
+
+```python
+import time
+
+start = time.time()
+# ... do work ...
+end = time.time()
+
+log.success("Done!", start=start, end=end)
+# Output: ... [Success] -> Done! In 1.234 Seconds
+```
+
+### Loading Spinner
+
+```python
+from logfore import Loader
+
+# As context manager
+with Loader(prefix="MyApp", desc="Processing...", end="Done!"):
+    time.sleep(2)
+
+# Manual control
+loader = Loader(desc="Loading...")
+loader.start()
+# ... do work ...
+loader.stop()
+```
+
+### ASCII Banner (Home Screen)
+
+```python
+from logfore import Home
+
+home = Home(
+    text="LOGFORE",
+    align="center",       # "left", "center", "right"
+    adinfo1="v1.0.0",
+    adinfo2="by Author",
+    credits="GitHub: user",
+    clear=True            # Clear terminal before display
+)
+home.display()
+```
+
+### Auto Updater
+
+```python
+from logfore import AutoUpdater, Logger
+
+log = Logger()
+updater = AutoUpdater("your-pypi-package-name", log)
+updater.check_for_updates()
+```
+
+### File Logging
+
+```python
+log = Logger(log_file="logs/myapp.log")
+log.info("This is saved to file too")
+```
+
+## Questions / Input
+
+```python
+answer = log.question("What is your name? ")
+print(f"Hello, {answer}!")
+```
+
+## Requirements
+
+- Python 3.10+
+- colorama
+- pystyle
+- requests
+- packaging

logfore-2.1.3.1/logfore/__init__.py

@@ -0,0 +1,7 @@
+# logfore/__init__.py
+
+from .logger import Logger, Loader, Home, LogLevel
+from .updater import AutoUpdater
+from .version import __version__
+
+__all__ = ["Logger", "Loader", "Home", "LogLevel", "AutoUpdater", "__version__"]