makeastar 1.0

Minimalist star pattern generator using optimized one-liners.

makeastar

A minimalist Python package for printing star patterns with zero boilerplate code.

Overview

makeastar eliminates the need for writing repetitive loops when creating ASCII star patterns. Perfect for Python beginners learning loops or developers who need quick ASCII art generation.

Features

• Zero Boilerplate: Single function calls replace complex nested loops
• Type-Safe: Full type hints with Union types for flexible input
• Optimized Performance: Uses sys.stdout.write, generator expressions, and efficient algorithms
• Multilingual Support: English and Korean aliases (including phonetic and Choseong variations)
• Flexible Input: Accepts integers, floats, strings - handles commas, dots, spaces gracefully
• Production Ready: Comprehensive unit tests, CI/CD with GitHub Actions
• Lightweight: Minimal dependencies, pure Python implementation

Requirements

• Python 3.8 or higher

Installation

From PyPI (recommended):

pip install makeastar

From source:

git clone https://github.com/hslcrb/pypack_makeastar.git
cd pypack_makeastar
pip install .

Quick Start

import star

# Basic usage
star.pyramid(5)
star.diamond(7)
star.triangle(10)

# Korean aliases
star.피라미드(5)
star.다이아몬드(7)

# Flexible input handling
star.pyramid("5")           # String input
star.pyramid(5.8)           # Float input (auto-converted)
star.draw("pyramid 5")      # Command string parsing
star.draw("triangle, 10, 5") # Handles various separators

Supported Patterns

All functions support custom width/height and character parameters.

1. Triangle (Left-aligned)

star.triangle(5)
# Output:
# *
# **
# ***
# ****
# *****

Aliases: samgak, tri, 삼각형, 삼, ㅅㄱ, ㅅㄱㅎ

2. Right Triangle (Right-aligned)

star.right_triangle(5)
# Output:
#     *
#    **
#   ***
#  ****
# *****

Aliases: usamgak, rtri, 우측삼각형, 오른쪽삼각형, 우삼, ㅇㅅㄱ, ㅇㅊㅅㄱㅎ, ㅇㄹㅉㅅㄱㅎ

3. Inverted Triangle

star.inverted(5)
# Output:
# *****
# ****
# ***
# **
# *

Aliases: yeoksamgak, inv, 역삼각형, 역삼, ㅇㅅ, ㅇㅅㄱㅎ

4. Inverted Right Triangle

star.inverted_right(5)
# Output:
# *****
#  ****
#   ***
#    **
#     *

Aliases: yeokusamgak, rtinv, rinv, 우측역삼각형, 오른쪽역삼각형, 우역, ㅇㅇ, ㅇㅊㅇㅅㄱㅎ, ㅇㄹㅉㅇㅅㄱㅎ

5. Pyramid

star.pyramid(5)
# Output:
#     *
#    ***
#   *****
#  *******
# *********

Aliases: pyra, 피라미드, 피라, ㅍㄹ, ㅍㄹㅁㄷ

6. Diamond

star.diamond(5)
# Output:
#     *
#    ***
#   *****
#  *******
# *********
#  *******
#   *****
#    ***
#     *

Aliases: dia, 다이아몬드, 다이아, 다, ㄷㅇ, ㄷㅇㅇㅁㄷ

7. Hourglass

star.hourglass(5)
# Output:
# *********
#  *******
#   *****
#    ***
#     *
#    ***
#   *****
#  *******
# *********

Aliases: morae, 모래시계, 모, ㅁㄹ, ㅁㄹㅅㄱ

8. Arrow

star.arrow(5)
# Output:
# *
# **
# ***
# ****
# *****
# ****
# ***
# **
# *

Aliases: hwasal, 화살표, 화, ㅎㅅ, ㅎㅅㅍ

Advanced Usage

Custom Dimensions

# Triangle with custom width and height
star.triangle(10, 5)   # Width=10, Height=5

# When height is omitted, it defaults to width
star.triangle(7)       # Width=7, Height=7

Custom Characters

star.pyramid(5, char='#')
star.diamond(7, char='@')

Flexible Input Types

# All of these work identically
star.pyramid(5)
star.pyramid("5")
star.pyramid(5.0)
star.pyramid(5.9)  # Auto-converts to 5

Command String Parsing

The draw() function accepts flexible command strings:

star.draw("pyramid 5")
star.draw("triangle, 10, 5")
star.draw("diamond.7")
star.draw("arrow 3")

Using Korean Aliases

# Full Korean names
star.피라미드(5)
star.다이아몬드(7)

# Short forms
star.피라(5)
star.다(7)

# Choseong (initial consonants)
star.ㅍㄹ(5)
star.ㄷㅇ(7)

# Using Korean package name
import 별
별.피라미드(5)

API Reference

Triangle Functions

All triangle functions accept:

• width (int | str | float): Width of the triangle
• height (int | str | float | None): Height (defaults to width if None)
• char (str): Character to use (default: '*')

Functions:

• triangle(width, height=None, char='*') - Left-aligned
• right_triangle(width, height=None, char='*') - Right-aligned
• inverted(width, height=None, char='*') - Inverted left-aligned
• inverted_right(width, height=None, char='*') - Inverted right-aligned

Symmetric Shape Functions

All symmetric functions accept:

• n (int | str | float): Size parameter (default: 5)
• char (str): Character to use (default: '*')

Functions:

• pyramid(n=5, char='*') - Centered pyramid
• diamond(n=5, char='*') - Diamond shape
• hourglass(n=5, char='*') - Hourglass shape
• arrow(n=5, char='*') - Right-pointing arrow

Utility Functions

• draw(command: str) - Parse and execute command strings

Testing

Run the test suite:

python -m unittest discover tests

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Author

Rheehose (Rhee Creative)

• Email: [e-mail]
• GitHub: @hslcrb
• Copyright 2008-2026

License

This project is licensed under the MIT License. See LICENSE for details.

Changelog

v1.0 (2026-01-15)

• Initial stable release
• 8 pattern types with full Korean/English aliases
• Flexible input parsing (strings, floats, various separators)
• Type hints and optimized performance
• Comprehensive unit tests
• GitHub Actions CI/CD