oguild


Nameoguild JSON
Version 0.1.5 PyPI version JSON
download
home_pagehttps://github.com/OpsGuild/guildpack
SummaryOGuild utilities — reusable logging and helpers for Python projects
upload_time2025-08-27 13:36:38
maintainerNone
docs_urlNone
authorHordunlarmy
requires_python>=3.9
licenseMIT
keywords utilities oguild helpers python opsguild logging
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ██████╗ ██╗ ██╗██╗██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗██████╗
██╔════╝ ██║ ██║██║██║ ██╔═══██╗██╔══██╗██╔═══██╗██║ ██╔╝██╔══██╗
██║ ███╗██║ ██║██║██║ ██║ ██║██║ ██║██║ ██║█████╔╝ ██████╔╝
██║ ██║██║ ██║██║██║ ██║ ██║██║ ██║██║ ██║██╔═██╗ ██╔═══╝
╚██████╔╝╚██████╔╝██║███████╗ ╚██████╔╝██████╔╝╚██████╔╝██║ ██╗██║  
 ╚═════╝ ╚═════╝ ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝

                    🚀 Multi-Language Utilities Pack 🚀
                    🐍 Python • 🔷 Node.js • 🦀 Rust • 🐹 Go
                    ☕ Java • 🔵 C# • 🐘 PHP • 🦎 Python
                    📦 Configuration • 🔍 Monitoring • 🛠️ Operations

# OpsGuild Utilities Pack

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![Poetry](https://img.shields.io/badge/Poetry-1.0+-blue.svg)](https://python-poetry.org/)

A comprehensive multi-language utilities pack providing essential tools and helper functions for modern software development. Currently featuring Python utilities with plans to expand to multiple programming languages.

## 🚀 What is OpsGuild Pack?

OpsGuild Pack is a collection of utility libraries designed to solve common development challenges across different programming languages and platforms. Think of it as your Swiss Army knife for software development operations.

### Current Components

- **🐍 [Python Logger Package](python/oguild/logs/README.md)** - Enhanced logging, helpers, and utilities
- **🔮 More Coming Soon** - Go, Rust, and other language support planned

## 📦 Installation

### Prerequisites

- Python 3.9 or higher
- Poetry (recommended) or pip

### Using Poetry (Recommended)

```bash
poetry add oguild
```

### Using pip

```bash
pip install oguild
```

## 🎯 Quick Start

### Python Logger (Current Package)

```python
from oguild.logs import logger

# Simple logging
logger.info("Hello, World!")
logger.debug("Debug information")

# The logger automatically detects the module name
# Output: INFO: (your_module_name) == Hello, World! [timestamp]
```

**📖 [Full Python Logger Documentation](python/oguild/logs/README.md)**

## 🤝 Contributing

We welcome contributions across all planned languages! Please follow these steps:

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

### Development Setup

```bash
# Clone and setup
git clone https://github.com/OpsGuild/guildpack.git
cd guildpack

# Install development dependencies
poetry install --with dev

# Run tests
poetry run pytest
```

### Contributing to New Languages

When contributing utilities for new languages:

1. Create a new directory for the language (e.g., `javascript/`, `go/`, `rust/`)
2. Follow the established project structure
3. Include comprehensive tests
4. Create a dedicated README.md for the package
5. Update this main README with links to the new package
6. Ensure consistent API design across languages

## 📄 License

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

## 🆘 Support

- **Issues**: [GitHub Issues](https://github.com/OpsGuild/guildpack/issues)
- **Documentation**: [GitHub README](https://github.com/OpsGuild/guildpack#readme)
- **Team**: OpsGuild <Hordunlarmy@gmail.com>

## 🔄 Changelog

### Version 0.1.4

- Initial release with Python logging utilities
- Smart logger with automatic formatting
- Logstash integration support
- Multi-output logging (console, file, logstash)
- Automatic module detection
- Foundation for multi-language utilities pack

## 🌟 Why OpsGuild Pack?

OpsGuild Pack is designed to solve common development challenges across multiple programming languages:

- **Multi-Language Support** - Consistent utilities across different tech stacks
- **Production Ready** - Built with enterprise needs in mind
- **Developer Friendly** - Automatic configuration and intelligent defaults
- **Extensible** - Easy to customize and extend for specific use cases
- **Performance** - Efficient utilities with minimal overhead
- **Standards Compliant** - Follows best practices for each language
- **Unified Experience** - Consistent API design across all supported languages

## 🎯 Use Cases

- **Microservices Architecture** - Consistent logging and monitoring across services
- **Polyglot Teams** - Unified utilities regardless of language choice
- **DevOps & SRE** - Standardized operational tools across infrastructure
- **Enterprise Development** - Consistent patterns for large-scale applications
- **Open Source Projects** - Reusable utilities for community projects

---

**Made with ❤️ by the OpsGuild team**

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/OpsGuild/guildpack",
    "name": "oguild",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "utilities, oguild, helpers, python, opsguild, logging",
    "author": "Hordunlarmy",
    "author_email": "Hordunlarmy@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/f8/c3/738c915a21c1420ae3684f4142577b97f6612588d6c57b9a2b1ce84bc350/oguild-0.1.5.tar.gz",
    "platform": null,
    "description": "\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2554\u255d\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\n\u2588\u2588\u2551 \u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2554\u255d \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\n\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u2550\u255d\n\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551 \u2588\u2588\u2557\u2588\u2588\u2551  \n \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u255d\n\n                    \ud83d\ude80 Multi-Language Utilities Pack \ud83d\ude80\n                    \ud83d\udc0d Python \u2022 \ud83d\udd37 Node.js \u2022 \ud83e\udd80 Rust \u2022 \ud83d\udc39 Go\n                    \u2615 Java \u2022 \ud83d\udd35 C# \u2022 \ud83d\udc18 PHP \u2022 \ud83e\udd8e Python\n                    \ud83d\udce6 Configuration \u2022 \ud83d\udd0d Monitoring \u2022 \ud83d\udee0\ufe0f Operations\n\n# OpsGuild Utilities Pack\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![Poetry](https://img.shields.io/badge/Poetry-1.0+-blue.svg)](https://python-poetry.org/)\n\nA comprehensive multi-language utilities pack providing essential tools and helper functions for modern software development. Currently featuring Python utilities with plans to expand to multiple programming languages.\n\n## \ud83d\ude80 What is OpsGuild Pack?\n\nOpsGuild Pack is a collection of utility libraries designed to solve common development challenges across different programming languages and platforms. Think of it as your Swiss Army knife for software development operations.\n\n### Current Components\n\n- **\ud83d\udc0d [Python Logger Package](python/oguild/logs/README.md)** - Enhanced logging, helpers, and utilities\n- **\ud83d\udd2e More Coming Soon** - Go, Rust, and other language support planned\n\n## \ud83d\udce6 Installation\n\n### Prerequisites\n\n- Python 3.9 or higher\n- Poetry (recommended) or pip\n\n### Using Poetry (Recommended)\n\n```bash\npoetry add oguild\n```\n\n### Using pip\n\n```bash\npip install oguild\n```\n\n## \ud83c\udfaf Quick Start\n\n### Python Logger (Current Package)\n\n```python\nfrom oguild.logs import logger\n\n# Simple logging\nlogger.info(\"Hello, World!\")\nlogger.debug(\"Debug information\")\n\n# The logger automatically detects the module name\n# Output: INFO: (your_module_name) == Hello, World! [timestamp]\n```\n\n**\ud83d\udcd6 [Full Python Logger Documentation](python/oguild/logs/README.md)**\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions across all planned languages! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Setup\n\n```bash\n# Clone and setup\ngit clone https://github.com/OpsGuild/guildpack.git\ncd guildpack\n\n# Install development dependencies\npoetry install --with dev\n\n# Run tests\npoetry run pytest\n```\n\n### Contributing to New Languages\n\nWhen contributing utilities for new languages:\n\n1. Create a new directory for the language (e.g., `javascript/`, `go/`, `rust/`)\n2. Follow the established project structure\n3. Include comprehensive tests\n4. Create a dedicated README.md for the package\n5. Update this main README with links to the new package\n6. Ensure consistent API design across languages\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## \ud83c\udd98 Support\n\n- **Issues**: [GitHub Issues](https://github.com/OpsGuild/guildpack/issues)\n- **Documentation**: [GitHub README](https://github.com/OpsGuild/guildpack#readme)\n- **Team**: OpsGuild <Hordunlarmy@gmail.com>\n\n## \ud83d\udd04 Changelog\n\n### Version 0.1.4\n\n- Initial release with Python logging utilities\n- Smart logger with automatic formatting\n- Logstash integration support\n- Multi-output logging (console, file, logstash)\n- Automatic module detection\n- Foundation for multi-language utilities pack\n\n## \ud83c\udf1f Why OpsGuild Pack?\n\nOpsGuild Pack is designed to solve common development challenges across multiple programming languages:\n\n- **Multi-Language Support** - Consistent utilities across different tech stacks\n- **Production Ready** - Built with enterprise needs in mind\n- **Developer Friendly** - Automatic configuration and intelligent defaults\n- **Extensible** - Easy to customize and extend for specific use cases\n- **Performance** - Efficient utilities with minimal overhead\n- **Standards Compliant** - Follows best practices for each language\n- **Unified Experience** - Consistent API design across all supported languages\n\n## \ud83c\udfaf Use Cases\n\n- **Microservices Architecture** - Consistent logging and monitoring across services\n- **Polyglot Teams** - Unified utilities regardless of language choice\n- **DevOps & SRE** - Standardized operational tools across infrastructure\n- **Enterprise Development** - Consistent patterns for large-scale applications\n- **Open Source Projects** - Reusable utilities for community projects\n\n---\n\n**Made with \u2764\ufe0f by the OpsGuild team**\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "OGuild utilities \u2014 reusable logging and helpers for Python projects",
    "version": "0.1.5",
    "project_urls": {
        "Documentation": "https://github.com/OpsGuild/guildpack#readme",
        "Homepage": "https://github.com/OpsGuild/guildpack",
        "Repository": "https://github.com/OpsGuild/guildpack"
    },
    "split_keywords": [
        "utilities",
        " oguild",
        " helpers",
        " python",
        " opsguild",
        " logging"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3c94884a60c54294ba92826baf89b7e5af42b021b97675a324cf970bec79c672",
                "md5": "68276d3b7136a4534d9b9e072368f239",
                "sha256": "718ef3d7131bf3653a27b1e1606c54a1a78af23e219fadbd7199a213d241a78d"
            },
            "downloads": -1,
            "filename": "oguild-0.1.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "68276d3b7136a4534d9b9e072368f239",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 20569,
            "upload_time": "2025-08-27T13:36:37",
            "upload_time_iso_8601": "2025-08-27T13:36:37.254386Z",
            "url": "https://files.pythonhosted.org/packages/3c/94/884a60c54294ba92826baf89b7e5af42b021b97675a324cf970bec79c672/oguild-0.1.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f8c3738c915a21c1420ae3684f4142577b97f6612588d6c57b9a2b1ce84bc350",
                "md5": "8784f47c1eabc47d0fc56b324158698d",
                "sha256": "5c1c4762877e52a76a30ff9f5d55337738769b25dde0629b4b2e61996631a7a9"
            },
            "downloads": -1,
            "filename": "oguild-0.1.5.tar.gz",
            "has_sig": false,
            "md5_digest": "8784f47c1eabc47d0fc56b324158698d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 18820,
            "upload_time": "2025-08-27T13:36:38",
            "upload_time_iso_8601": "2025-08-27T13:36:38.213988Z",
            "url": "https://files.pythonhosted.org/packages/f8/c3/738c915a21c1420ae3684f4142577b97f6612588d6c57b9a2b1ce84bc350/oguild-0.1.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-27 13:36:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "OpsGuild",
    "github_project": "guildpack",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "oguild"
}
        
Elapsed time: 1.09809s