cullinan 0.65a1__tar.gz

cullinan-0.65a1/LICENSE

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

cullinan-0.65a1/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: cullinan
+Version: 0.65a1
+Summary: Cullinan is written based on tornado and Sqlalchemy to help the project quickly build web application
+Home-page: https://github.com/plumeink/Cullinan
+Author: plumeink
+Author-email: official@plumeink.com
+License: http://www.apache.org/licenses/LICENSE-2.0
+Project-URL: Source, https://github.com/plumeink/Cullinan
+Project-URL: Wiki, https://github.com/plumeink/Cullinan/wiki
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tornado
+Requires-Dist: python-dotenv
+Requires-Dist: sqlalchemy
+Requires-Dist: pymysql
+Requires-Dist: contextvars
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+![Python version](https://img.shields.io/badge/python-3.7%20|%203.8%20|%203.9%20|%203.10%20|%203.11%20|%203.12%20|%203.13-blue)
+![PyPI version](https://img.shields.io/pypi/v/cullinan.svg?style=flat&logo=pypi&color=green)
+![PyPI downloads](https://img.shields.io/pypi/dm/cullinan.svg?style=flat&logo=pypi&color=blue)
+![GitHub stars](https://img.shields.io/github/stars/plumeink/cullinan.svg?style=flat&logo=github&color=white)
+![License](https://img.shields.io/github/license/plumeink/cullinan.svg?style=flat&color=white)
+
+```                                              
+   _____      _ _ _                      
+  / ____|    | | (_)                     
+ | |    _   _| | |_ _ __   __ _ _ __     
+ | |   | | | | | | | '_ \ / _` | '_ \    
+ | |___| |_| | | | | | | | (_| | | | |   
+ \_____\__, _|_|_|_|_| |_|\__,_|_| |_|  
+```
+
+# Cullinan
+
+**A lightweight, production-ready Python web framework with full packaging support.**
+
+Cullinan is built on Tornado and SQLAlchemy, designed to help you quickly build web applications with easy packaging for deployment.
+
+---
+
+## ✨ Features
+
+- 🚀 **Easy to Use** - Simple decorator-based routing
+- 📦 **Packaging Ready** - Full Nuitka & PyInstaller support
+- ⚙️ **Flexible Configuration** - Multiple configuration options
+- 🌍 **Cross-Platform** - Windows, Linux, macOS
+- 🏭 **Production Ready** - Built on battle-tested Tornado
+- 🗄️ **SQLAlchemy Integration** - Built-in ORM support
+- 🔧 **Smart Module Loading** - Auto-discovery for development, configurable for packaging
+
+---
+
+## 📚 Documentation
+
+### Language / 语言
+
+- **[English Documentation](docs/README.md)** - Complete English documentation
+- **[中文文档](docs/zh/README_zh.md)** - 完整中文文档
+
+---
+
+## 🚀 Quick Start
+
+## 📦 Installation
+
+### From PyPI (Stable Release)
+
+```bash
+pip install cullinan
+```
+
+### Basic Application
+
+```python
+# app.py
+from cullinan import configure, application
+from cullinan.controller import controller, get_api
+
+# Configure for packaging (optional in development)
+configure(user_packages=['your_app'])
+
+@controller(url='/api')
+class HelloController:
+    @get_api(url='/hello')
+    def hello(self, query_params):
+        return self.response_build(status=200, message="Hello, Cullinan!" + query_params)
+
+if __name__ == '__main__':
+    application.run()
+```
+
+### Run
+
+```bash
+python app.py
+# Visit: http://localhost:4080/api/hello
+```
+
+---
+
+## 💡 Full Example
+
+### Project Structure
+
+```
+my_app/
+├── main.py              # Entry point
+├── controllers/         # Controllers
+│   ├── __init__.py
+│   └── api.py
+├── services/            # Services
+│   ├── __init__.py
+│   └── data.py
+└── models/              # Models
+    ├── __init__.py
+    └── user.py
+```
+
+### Controller (`controllers/api.py`)
+
+```python
+from cullinan.controller import controller, get_api, post_api
+
+
+@controller(url='/api')
+class UserController:
+    
+    @get_api(url='/users', query_params=['id'])
+    def get_user(self, query_params):
+        user_id = query_params.get('id')
+        return self.response_build(status=200, message="User fetched successfully", data={"user_id": user_id})
+    
+    @post_api(url='/users', body_params=['name', 'email'])
+    def create_user(self, body_params):
+        self.service['UserService'].create_user(
+            body_params['name'],
+            body_params['email']
+        )
+        return self.response_build(status=201, message="User created successfully")
+```
+
+### Application (`main.py`)
+
+```python
+from cullinan import configure, application
+
+# Configure for packaging
+configure(
+    user_packages=['my_app'],
+    verbose=True  # Enable logging
+)
+
+def main():
+    application.run()
+
+if __name__ == '__main__':
+    main()
+```
+
+---
+
+## 📖 Documentation Structure
+
+```
+docs/
+├── README.md                    # Documentation index
+├── index.md                     # Framework overview
+├── 01-configuration.md          # Configuration guide
+├── 02-packaging.md              # Packaging guide
+├── 03-troubleshooting.md        # Troubleshooting
+├── 04-quick-reference.md        # Quick reference
+└── 05-build-scripts.md          # Build scripts guide
+```
+
+---
+
+## 🔗 Links
+
+- **Documentation**: [docs/README.md](docs/README.md)
+- **GitHub**: https://github.com/plumeink/Cullinan
+- **PyPI**: https://pypi.org/project/cullinan/
+- **Issues**: https://github.com/plumeink/Cullinan/issues
+- **Discussions**: https://github.com/plumeink/Cullinan/discussions
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Built on [Tornado](https://www.tornadoweb.org/)
+- ORM powered by [SQLAlchemy](https://www.sqlalchemy.org/)
+- Packaging powered by [Nuitka](https://nuitka.net/) and [PyInstaller](https://pyinstaller.org/)
+
+---
+
+## 💻 Maintainer
+
+[<img src="https://avatars.githubusercontent.com/u/104434649?v=4" width = "40" height = "40"/>](https://github.com/plumeink)

cullinan-0.65a1/cullinan/__init__.py

@@ -0,0 +1,11 @@
+import logging
+
+# Prevent "No handlers could be found" warnings when library is imported
+# Applications should configure logging (console/file) at their entry point.
+logging.getLogger('cullinan').addHandler(logging.NullHandler())
+
+# 导出配置接口
+from cullinan.config import configure, get_config, CullinanConfig
+
+__all__ = ['configure', 'get_config', 'CullinanConfig']
+