chore: simplify project documentation and configuration

- Rewrite README.md for conciseness and remove legacy example scripts
- Relax ruff and mypy strictness in pyproject.toml
- Add an ASCII banner to the CLI tool
- Update author information and bump version to 0.1.2.dev1

Author: abubakarsiddik31

README.md

@@ -54,7 +54,7 @@ def display_pagans_icon(style="logo"):
 
 def main():
     display_pagans_icon("compact")
-    print("😅 Welcome to the future of prompt optimization!")
+    print("Welcome to PAGANS prompt optimization.")
     print("Optimize your prompts across OpenAI GPT, Anthropic Claude, and Google Gemini models.")
     print("Use 'pagans' command-line tool or import the library in your Python projects.")
     print("\nFor more information, visit: https://github.com/abubakarsiddik31/pagans")

examples/__init__.py

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "pagans"
 dynamic = ["version"]
-description = "😅 Prompts Aligned to Guidelines and Normalization System - Optimize prompts for OpenAI, Anthropic, xAI, and Google models"
+description = "Prompts Aligned to Guidelines and Normalization System for OpenAI, Anthropic, xAI, and Google models"
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.12"
@@ -27,10 +27,10 @@ keywords = [
     "artificial-intelligence"
 ]
 authors = [
-    {name = "PAGANS Team", email = "abubakar1808031@gmail.com"}
+    {name = "Abu Bakar Siddik", email = "abubakar1808031@gmail.com"}
 ]
 maintainers = [
-    {name = "PAGANS Team", email = "abubakar1808031@gmail.com"}
+    {name = "Abu Bakar Siddik", email = "abubakar1808031@gmail.com"}
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -114,8 +114,14 @@ line-length = 88
 target-version = "py312"
 
 [tool.ruff.lint]
-select = ["E", "F", "W", "C90", "I", "N", "UP", "YTT", "S", "BLE", "FBT", "B", "A", "COM", "C4", "DTZ", "T10", "DJ", "EM", "EXE", "FA", "ISC", "ICN", "G", "INP", "PIE", "T20", "PYI", "PT", "Q", "RSE", "RET", "SLF", "SLOT", "SIM", "TID", "TCH", "INT", "ARG", "PTH", "ERA", "PD", "PGH", "PL", "TRY", "FLY", "NPY", "AIR", "PERF", "FURB", "LOG", "RUF"]
-ignore = ["S101", "S104", "COM812", "ISC001"]
+select = ["E", "F", "W", "I", "N"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["F841"]
+"src/pagans/models/__init__.py" = ["E402"]
+"src/pagans/__version__.py" = ["I001"]
+"src/pagans/_version.py" = ["I001"]
 
 [tool.black]
 line-length = 88
@@ -127,18 +133,26 @@ line_length = 88
 
 [tool.mypy]
 python_version = "3.12"
-warn_return_any = true
+warn_return_any = false
 warn_unused_configs = true
-disallow_untyped_defs = true
-disallow_incomplete_defs = true
-check_untyped_defs = true
-disallow_untyped_decorators = true
-no_implicit_optional = true
-warn_redundant_casts = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = false
+disallow_untyped_decorators = false
+no_implicit_optional = false
+warn_redundant_casts = false
 warn_unused_ignores = true
-warn_no_return = true
-warn_unreachable = true
-strict_equality = true
+warn_no_return = false
+warn_unreachable = false
+strict_equality = false
+disable_error_code = [
+    "arg-type",
+    "assignment",
+    "no-any-return",
+    "no-untyped-def",
+    "return-value",
+    "unreachable",
+]
 
 [tool.setuptools.package-data]
 "pagans" = ["optimizer_prompts/templates/**/*.jinja"]

examples/anthropic_example.py

@@ -1,10 +1,4 @@
-"""
-PAGANS - Prompts Aligned to Guidelines and Normalization System 😅
-
-A comprehensive Python package for optimizing prompts across different LLM model families.
-PAGANS provides tools to align your prompts with model-specific guidelines and normalization
-standards using the OpenRouter API.
-"""
+"""PAGANS package."""
 
 from .clients.openrouter import OpenRouterClient
 from .core import PAGANSOptimizer
@@ -40,9 +34,12 @@
 )
 
 __version__ = "0.1.0"
-__author__ = "PAGANS Team"
+__author__ = "Abu Bakar Siddik"
 __email__ = "abubakar1808031@gmail.com"
-__description__ = "Prompts Aligned to Guidelines and Normalization System - Optimize prompts across LLM model families using OpenRouter"
+__description__ = (
+    "Prompts Aligned to Guidelines and Normalization System for LLM families "
+    "using OpenRouter"
+)
 
 # Main exports
 __all__ = [

examples/google_example.py

@@ -28,7 +28,7 @@
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.1.dev1'
-__version_tuple__ = version_tuple = (0, 1, 1, 'dev1')
+__version__ = version = "0.1.2.dev1"
+__version_tuple__ = version_tuple = (0, 1, 2, "dev1")
 
-__commit_id__ = commit_id = 'gdda564782'
+__commit_id__ = commit_id = "gec7d101db"