patlab 0.1.0__tar.gz

patlab-0.1.0/LICENSE

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

patlab-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: patlab
+Version: 0.1.0
+Summary: Simple pattern generation library for Python
+Author-email: Sayam <sayampradhan07@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sayampradhan/patlab
+Project-URL: Repository, https://github.com/sayampradhan/patlab
+Project-URL: GitHub, https://github.com/sayampradhan
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# patlab
+
+Generate common patterns in Python easily.
+
+## Installation
+
+```bash
+pip install patlab

patlab-0.1.0/README.md

@@ -0,0 +1,8 @@
+# patlab
+
+Generate common patterns in Python easily.
+
+## Installation
+
+```bash
+pip install patlab

patlab-0.1.0/patlab/__init__.py

@@ -0,0 +1,6 @@
+from .basic import square
+from .pyramid import make as pyramid
+from .right_triangle import make as right_triangle
+
+__version__ = "0.1.0"
+__all__ = ["square", "right_triangle", "pyramid"]

patlab-0.1.0/patlab/basic.py

@@ -0,0 +1,40 @@
+# basic.py
+
+def square(n, char="*"):
+    """
+    Generate a square pattern of size `n` using the specified character.
+
+    Parameters:
+    -----------
+    n : int
+        The size of the square (number of rows and columns). Must be positive.
+    char : str, optional
+        The character to use for building the square. Default is '*'.
+        Should be a single character.
+
+    Returns:
+    --------
+    str
+        A string representing the square pattern, with each row separated by a newline.
+
+    Raises:
+    -------
+    ValueError
+        If `n` is not a positive integer.
+
+    Examples:
+    ---------
+    >>> print(square(3))
+    ***
+    ***
+    ***
+
+    >>> print(square(4, "#"))
+    ####
+    ####
+    ####
+    ####
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    return "\n".join([char * n for _ in range(n)])

patlab-0.1.0/patlab/pyramid.py

@@ -0,0 +1,223 @@
+"""
+pyramid.py
+
+Module for generating various pyramid shapes in text form.
+
+Available pyramid variants:
+- centered: A classic centered pyramid.
+- right: Right-aligned pyramid (staircase style).
+- numeric: Pyramid with ascending numbers.
+"""
+
+from typing import Literal
+
+
+def centered(n: int, char: str = "*", hollow: bool = False) -> str:
+    """
+    Generate a centered pyramid of height `n`.
+
+    Parameters
+    ----------
+    n : int
+        The height of the pyramid. Must be a positive integer.
+    char : str, optional
+        The character used to build the pyramid (default is '*').
+    hollow : bool, optional
+        If True, generate a hollow pyramid (default is False).
+
+    Returns
+    -------
+    str
+        A string representation of the centered pyramid.
+
+    Raises
+    ------
+    ValueError
+        If `n` is not positive.
+
+    Examples
+    --------
+    >>> print(centered(4))
+       *
+      ***
+     *****
+    *******
+
+    >>> print(centered(4, hollow=True))
+       *
+      * *
+     *   *
+    *******
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    
+    lines = []
+    for i in range(1, n + 1):
+        spaces = " " * (n - i)
+        if not hollow:
+            stars = char * (2 * i - 1)
+            lines.append(spaces + stars)
+        else:
+            if i == 1:
+                line = spaces + char
+            elif i == n:
+                line = char * (2 * i - 1)
+            else:
+                line = spaces + char + " " * (2 * i - 3) + char
+            lines.append(line)
+    return "\n".join(lines)
+
+
+def right_aligned(n: int, char: str = "*", hollow: bool = False) -> str:
+    """
+    Generate a right-aligned pyramid (staircase style) of height `n`.
+
+    Parameters
+    ----------
+    n : int
+        The height of the pyramid. Must be positive.
+    char : str, optional
+        The character used to build the pyramid (default is '*').
+    hollow : bool, optional
+        If True, generate a hollow right-aligned pyramid (default is False).
+
+    Returns
+    -------
+    str
+        A string representation of the right-aligned pyramid.
+
+    Raises
+    ------
+    ValueError
+        If `n` is not positive.
+
+    Examples
+    --------
+    >>> print(right_aligned(4))
+    *
+    **
+    ***
+    ****
+
+    >>> print(right_aligned(4, hollow=True))
+    *
+    **
+    * *
+    ****
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    
+    lines = []
+    for i in range(1, n + 1):
+        if not hollow:
+            lines.append(char * i)
+        else:
+            if i == 1:
+                lines.append(char)
+            elif i == n:
+                lines.append(char * i)
+            else:
+                lines.append(char + " " * (i - 2) + char)
+    return "\n".join(lines)
+
+
+def numeric(n: int) -> str:
+    """
+    Generate a numeric pyramid of height `n`.
+
+    Each row displays numbers from 1 up to the row number.
+
+    Parameters
+    ----------
+    n : int
+        The height of the pyramid. Must be positive.
+
+    Returns
+    -------
+    str
+        A string representation of the numeric pyramid.
+
+    Raises
+    ------
+    ValueError
+        If `n` is not positive.
+
+    Examples
+    --------
+    >>> print(numeric(4))
+       1
+      12
+     123
+    1234
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    
+    lines = []
+    for i in range(1, n + 1):
+        line = " " * (n - i) + "".join(str(x) for x in range(1, i + 1))
+        lines.append(line)
+    return "\n".join(lines)
+
+
+def make(n: int, variant: Literal["centered", "right", "numeric"] = "centered", char: str = "*") -> str:
+    """
+    Factory function to generate a pyramid of a specified variant.
+
+    Parameters
+    ----------
+    n : int
+        The height of the pyramid. Must be positive.
+    variant : {'centered', 'right', 'numeric'}, optional
+        The pyramid style to generate (default is 'centered'):
+        - 'centered': classic centered pyramid.
+        - 'right': right-aligned (staircase) pyramid.
+        - 'numeric': pyramid of ascending numbers (ignores `char`).
+    char : str, optional
+        The character used for drawing the pyramid (default is '*').
+        Ignored if `variant='numeric'`.
+
+    Returns
+    -------
+    str
+        A string representation of the chosen pyramid variant.
+
+    Raises
+    ------
+    ValueError
+        If `variant` is not one of the supported options.
+
+    Examples
+    --------
+    >>> print(make(4, variant='centered'))
+       *
+      ***
+     *****
+    *******
+
+    >>> print(make(4, variant='right', char='#'))
+    #
+    ##
+    ###
+    ####
+
+    >>> print(make(4, variant='numeric'))
+       1
+      12
+     123
+    1234
+    """
+    variants = {
+        "centered": centered,
+        "right": right_aligned,
+        "numeric": numeric,
+    }
+
+    if variant not in variants:
+        raise ValueError(
+            f"Unknown pyramid variant: {variant}. Available: {list(variants.keys())}"
+        )
+
+    return variants[variant](n, char) if variant != "numeric" else variants[variant](n)

patlab-0.1.0/patlab/right_triangle.py

@@ -0,0 +1,169 @@
+from typing import Literal
+import inspect
+
+def classic(n: int, char: str = "*", hollow: bool = False, numeric: bool = False) -> str:
+    """
+    Generate a right-angled triangle of height `n`.
+
+    Parameters
+    ----------
+    n : int
+        The height of the triangle. Must be a positive integer.
+    char : str, optional
+        The character used to draw the triangle (default is '*').
+    hollow : bool, optional
+        If True, generate a hollow triangle (default is False).
+    numeric : bool, optional
+        If True, print numbers instead of characters (default is False).
+
+    Returns
+    -------
+    str
+        A string representation of the right-angled triangle.
+
+    Raises
+    ------
+    ValueError
+        If `n` is not positive or if `char` is passed while numeric=True.
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    
+    # Disallow any explicit char when numeric=True
+    caller_args = inspect.currentframe().f_locals
+    if numeric and caller_args.get("char", "*") != "*":
+        raise ValueError("Cannot specify 'char' when numeric=True")
+    
+    lines = []
+    for i in range(1, n + 1):
+        if numeric:
+            if not hollow:
+                line = "".join(str(x) for x in range(1, i + 1))
+            else:
+                if i == 1:
+                    line = "1"
+                elif i == n:
+                    line = "".join(str(x) for x in range(1, n + 1))
+                else:
+                    line = "1" + " " * (i - 2) + str(i)
+        else:
+            if not hollow:
+                line = char * i
+            else:
+                if i == 1:
+                    line = char
+                elif i == n:
+                    line = char * n
+                else:
+                    line = char + " " * (i - 2) + char
+        lines.append(line)
+    return "\n".join(lines)
+
+
+def inverted(n: int, char: str = "*", hollow: bool = False, numeric: bool = False) -> str:
+    """
+    Generate an inverted right-angled triangle of height `n`.
+
+    Parameters
+    ----------
+    n : int
+        The height of the triangle. Must be a positive integer.
+    char : str, optional
+        The character used to draw the triangle (default is '*').
+    hollow : bool, optional
+        If True, generate a hollow triangle (default is False).
+
+    Returns
+    -------
+    str
+        A string representation of the inverted right-angled triangle.
+
+    Raises
+    ------
+    ValueError
+        If `n` is not positive or if `char` is passed while numeric=True.
+    """
+    if n <= 0:
+        raise ValueError("n must be positive")
+    
+    # Disallow any explicit char when numeric=True
+    caller_args = inspect.currentframe().f_locals
+    if numeric and caller_args.get("char", "*") != "*":
+        raise ValueError("Cannot specify 'char' when numeric=True")
+    
+    lines = []
+    for i in range(n, 0, -1):
+        if numeric:
+            if not hollow:
+                line = "".join(str(x) for x in range(1, i + 1))
+            else:
+                if i == 1:
+                    line = "1"
+                elif i == n:
+                    line = "".join(str(x) for x in range(1, n + 1))
+                else:
+                    line = "1" + " " * (i - 2) + str(i)
+        else:
+            if not hollow:
+                line = char * i
+            else:
+                if i == 1:
+                    line = char
+                elif i == n:
+                    line = char * n
+                else:
+                    line = char + " " * (i - 2) + char
+        lines.append(line)
+    return "\n".join(lines)
+
+
+def make(n: int, variant: Literal["classic","inverted"] = "classic", char: str = "*") -> str:
+    """
+    Factory function to create a right-angled triangle of a specified variant.
+
+    Parameters
+    ----------
+    n : int
+        The height of the triangle. Must be positive.
+    variant : str, optional
+        The triangle variant. Options are:
+        - "classic": normal right-angled triangle (default)
+        - "inverted": inverted right-angled triangle
+    char : str, optional
+        The character used to draw the triangle (default is '*').
+
+    Returns
+    -------
+    str
+        A string representation of the chosen triangle variant.
+
+    Raises
+    ------
+    ValueError
+        If `variant` is not recognized.
+
+    Examples
+    --------
+    >>> print(make(4, variant="classic"))
+    *
+    **
+    ***
+    ****
+
+    >>> print(make(4, variant="inverted"))
+    ****
+    ***
+    **
+    *
+    """
+    variants = {
+        "classic": classic,
+        "inverted": inverted
+    }
+
+    if variant not in variants:
+        raise ValueError(
+            f"Unknown right-triangle variant: {variant}. Available: {list(variants.keys())}"
+        )
+
+    return variants[variant](n, char)

patlab-0.1.0/patlab.egg-info/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: patlab
+Version: 0.1.0
+Summary: Simple pattern generation library for Python
+Author-email: Sayam <sayampradhan07@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sayampradhan/patlab
+Project-URL: Repository, https://github.com/sayampradhan/patlab
+Project-URL: GitHub, https://github.com/sayampradhan
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# patlab
+
+Generate common patterns in Python easily.
+
+## Installation
+
+```bash
+pip install patlab

patlab-0.1.0/patlab.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+patlab/__init__.py
+patlab/basic.py
+patlab/pyramid.py
+patlab/right_triangle.py
+patlab.egg-info/PKG-INFO
+patlab.egg-info/SOURCES.txt
+patlab.egg-info/dependency_links.txt
+patlab.egg-info/top_level.txt

patlab-0.1.0/patlab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

patlab-0.1.0/patlab.egg-info/top_level.txt

@@ -0,0 +1 @@
+patlab

patlab-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "patlab"
+version = "0.1.0"
+description = "Simple pattern generation library for Python"
+authors = [{ name = "Sayam", email = "sayampradhan07@outlook.com" }]
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+dependencies = []
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project.urls]
+"Homepage" = "https://github.com/sayampradhan/patlab"
+"Repository" = "https://github.com/sayampradhan/patlab"
+"GitHub" = "https://github.com/sayampradhan"

patlab-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+