Metadata-Version: 2.4
Name: elkjs
Version: 0.1.0
Summary: Draw beautiful ASCII and SVG pine trees (elkis)
Project-URL: Homepage, https://github.com/brnv/elkjs
Author-email: Artem <brnv@canva.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ascii-art,elk,forest,pine,svg,tree
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Artistic Software
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# elkjs

Draw beautiful ASCII and SVG pine trees (elkis).

## Installation

```bash
pip install elkjs
```

## Usage

```python
from elkjs import PineTree, TreeStyle, Forest, render_svg

# Single tree
tree = PineTree(height=12, style=TreeStyle.SNOW, seed=42)
print(tree)

# Festive tree
print(PineTree(height=8, style=TreeStyle.FESTIVE))

# SVG output
svg = render_svg(tree, width=200, height=300)

# Random forest
forest = Forest.generate(count=7, min_height=5, max_height=15, seed=99)
print(forest)
```

## CLI

```bash
elkjs tree --height 12 --style snow
elkjs tree --height 8 --style festive --svg tree.svg
elkjs forest --count 7 --seed 42
```

## Styles

- `classic` — traditional symmetric pine
- `sparse` — airy, fewer branches
- `dense` — thick full foliage
- `snow` — snow-capped branches
- `minimal` — simple outline
- `festive` — decorated with ornaments

## License

MIT
