pyhappy


Namepyhappy JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryA boilerplate utility package
upload_time2024-11-08 14:22:57
maintainerNone
docs_urlNone
authoralaamer12
requires_python<4.0,>=3.11
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            readme_content = """

# Happy Project

## Overview

`Happy` is a modular and feature-rich package boilerplate code that is
designed to solve a simple yet impactful problems .The project is designed to be highly maintainable,
extensible, and, flexible,
with a focus on clean code principles
and optimization.

`Happy` will have a lot of different extensions in the future.

## Table of Contents


- [Content](#Content)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)

## Content
The project includes multiple modules with a clear separation of concerns:

- **Log**: Provide a different logging strategies [e.g. ConsoleLogger], built on the top of loguru.
- **Collections**: Collection of helper functions and classes.
- **Toolkit**: Collection of simple yet fast functions and classes.
- **Re**: Collection of regular expressions (regex patterns) for common data validation tasks across a variety of fields.
- **Time**: Collection of time-related functions and classes.
- **Types**: Collection of types used across the project.

## Features
- **Console Logging**: Using the `ConsoleLogger` class, the application can log messages to the console for debugging
  and runtime monitoring.
- **IDE Compatibility**: The `FixIDEComplain` class prevents IDE complaints about unimplemented methods while keeping
  the codebase functional.
- **Modular Design**: The project is broken down into independent modules for easier testing, maintenance, and
  scalability.
- **High Performance**: The project uses efficient data structures and algorithms to optimize performance.
- **Type Checking**: The project uses type hints to enforce strong typing and provide better documentation.


## Installation

To install and run the `happy` project locally, follow these steps:

### Prerequisites

- Python 3.7+

### Steps

1. Clone the repository:
   ```bash
   git clone https://github.com/alaamer12/happy.git
   cd pyhappy
   ```

2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

or install the project as a package:

   ```bash
   pip install pyhappy
   ```
## Usage

### Toolkits

The `toolkits` module provides a collection of utility functions, decorators, and context managers for various tasks.

```python
from pyhappy.toolkits import simple_debugger, profile, check_internet_connectivity, monitor, Constants, retry

myconstants = Constants(a=1, b=2)

# Example usage
simple_debugger('Hello, World!')


def my_function():
    pass


my_function()


# Example usage
@profile
def my_function():
    pass


my_function()

# Example usage
check_internet_connectivity("https://www.google.com")


# Example usage
@monitor
def my_function():
    pass


my_function()


# Example usage
@retry
def my_function():
    pass


my_function()
```

## License

The `happy` project is licensed under the MIT License.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pyhappy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.11",
    "maintainer_email": null,
    "keywords": null,
    "author": "alaamer12",
    "author_email": "ahmedmuhmmed239@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/b3/b3/0aa515031aa1a290d9bf03ca145b0b2fd5ef9631ad5a7c15acfc7fc5a092/pyhappy-0.1.0.tar.gz",
    "platform": null,
    "description": "readme_content = \"\"\"\n\n# Happy Project\n\n## Overview\n\n`Happy` is a modular and feature-rich package boilerplate code that is\ndesigned to solve a simple yet impactful problems .The project is designed to be highly maintainable,\nextensible, and, flexible,\nwith a focus on clean code principles\nand optimization.\n\n`Happy` will have a lot of different extensions in the future.\n\n## Table of Contents\n\n\n- [Content](#Content)\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [License](#license)\n\n## Content\nThe project includes multiple modules with a clear separation of concerns:\n\n- **Log**: Provide a different logging strategies [e.g. ConsoleLogger], built on the top of loguru.\n- **Collections**: Collection of helper functions and classes.\n- **Toolkit**: Collection of simple yet fast functions and classes.\n- **Re**: Collection of regular expressions (regex patterns) for common data validation tasks across a variety of fields.\n- **Time**: Collection of time-related functions and classes.\n- **Types**: Collection of types used across the project.\n\n## Features\n- **Console Logging**: Using the `ConsoleLogger` class, the application can log messages to the console for debugging\n  and runtime monitoring.\n- **IDE Compatibility**: The `FixIDEComplain` class prevents IDE complaints about unimplemented methods while keeping\n  the codebase functional.\n- **Modular Design**: The project is broken down into independent modules for easier testing, maintenance, and\n  scalability.\n- **High Performance**: The project uses efficient data structures and algorithms to optimize performance.\n- **Type Checking**: The project uses type hints to enforce strong typing and provide better documentation.\n\n\n## Installation\n\nTo install and run the `happy` project locally, follow these steps:\n\n### Prerequisites\n\n- Python 3.7+\n\n### Steps\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/alaamer12/happy.git\n   cd pyhappy\n   ```\n\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\nor install the project as a package:\n\n   ```bash\n   pip install pyhappy\n   ```\n## Usage\n\n### Toolkits\n\nThe `toolkits` module provides a collection of utility functions, decorators, and context managers for various tasks.\n\n```python\nfrom pyhappy.toolkits import simple_debugger, profile, check_internet_connectivity, monitor, Constants, retry\n\nmyconstants = Constants(a=1, b=2)\n\n# Example usage\nsimple_debugger('Hello, World!')\n\n\ndef my_function():\n    pass\n\n\nmy_function()\n\n\n# Example usage\n@profile\ndef my_function():\n    pass\n\n\nmy_function()\n\n# Example usage\ncheck_internet_connectivity(\"https://www.google.com\")\n\n\n# Example usage\n@monitor\ndef my_function():\n    pass\n\n\nmy_function()\n\n\n# Example usage\n@retry\ndef my_function():\n    pass\n\n\nmy_function()\n```\n\n## License\n\nThe `happy` project is licensed under the MIT License.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A boilerplate utility package",
    "version": "0.1.0",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "66bd30701fb90c7d91861c08d9c0f7044d6ed57d7a2b3557acac7eef6e44e613",
                "md5": "05cc1ee91cfb4cc19d777433c40b4b0a",
                "sha256": "a0b1b398c44a50901b0801bfc52fe26b45eb333d86107c2eb23284b6261d9ec7"
            },
            "downloads": -1,
            "filename": "pyhappy-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "05cc1ee91cfb4cc19d777433c40b4b0a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.11",
            "size": 52230,
            "upload_time": "2024-11-08T14:22:55",
            "upload_time_iso_8601": "2024-11-08T14:22:55.124974Z",
            "url": "https://files.pythonhosted.org/packages/66/bd/30701fb90c7d91861c08d9c0f7044d6ed57d7a2b3557acac7eef6e44e613/pyhappy-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b3b30aa515031aa1a290d9bf03ca145b0b2fd5ef9631ad5a7c15acfc7fc5a092",
                "md5": "b3cd83fc11d9f9e33b7142a79294f42a",
                "sha256": "8ebf32c1da5d46dee20b4263fda1369983f35a8a8020dbe92d2af1c9ec03e76d"
            },
            "downloads": -1,
            "filename": "pyhappy-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "b3cd83fc11d9f9e33b7142a79294f42a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.11",
            "size": 47119,
            "upload_time": "2024-11-08T14:22:57",
            "upload_time_iso_8601": "2024-11-08T14:22:57.165259Z",
            "url": "https://files.pythonhosted.org/packages/b3/b3/0aa515031aa1a290d9bf03ca145b0b2fd5ef9631ad5a7c15acfc7fc5a092/pyhappy-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-08 14:22:57",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pyhappy"
}
        
Elapsed time: 0.33303s