bryanveloso / geopatterns

A Python-port of @jasonlong's lovely SVG generation library.

GeoPatterns

Generate beautiful SVG patterns from a string. This is a Python-port of Jason Long's Ruby library.

Installation

GeoPatterns is installable via pip:

$ pip install geopatterns

Usage

Create a new pattern by initializing GeoPattern() with a string and a generator (the result of this string/generator pair is the above image).

>>> from geopatterns import GeoPattern
>>> pattern = GeoPattern('A string for your consideration.', generator='xes')

Currently available generators are:

• hexagons
• overlapping_circles
• overlapping_rings
• plaid
• plus_signs
• rings
• sinewaves
• squares
• triangles
• xes

Get the SVG string:

>>> print(pattern.svg_string)
u'<svg xmlns="http://www.w3.org/2000/svg" ...

Get the Base64-encoded string:

>>> print(pattern.base64_string)
'PHN2ZyB4bWxucz0iaHR0cDov...

In the case of the Base64-encoded string, you can use it in CSS as follows:

body {
  background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz...zdmc+');
}

You can use cairosvg to save the SVG string as a PNG image. First, install cairosvg:

pip install cairosvg

And then run:

>>> import cairosvg
>>> from geopatterns import GeoPattern
>>> pattern = GeoPattern('A string for your consideration.', generator='xes')
>>> cairosvg.svg2png(bytestring=pattern.svg_string, write_to="output.png")

If you just want to visualize the pattern, you can use cairosvg with PIL:

>>> import matplotlib.pyplot as plt
>>> from PIL import Image
>>> import cairosvg
>>> from geopatterns import GeoPattern
>>> pattern = GeoPattern('A string for your consideration.', generator='xes')
>>> png = cairosvg.svg2png(bytestring=pattern.svg_string)
>>> image = Image.open(BytesIO(png))
>>> plt.imshow(image)
>>> plt.show()

geopatterns's Issues

Can't install via pip

I am using the latest version of pip, 23.0.1.

When I run pip install geopatterns, it can't be found:

ERROR: Could not find a version that satisfies the requirement geopatterns (from versions: none)
ERROR: No matching distribution found for geopatterns

How to save the image as a file?

Hello, is it possible to save the image as ".png" or ".jpg" file on the filesystem?

Demo

I have built an online demo of geopatterns library recently.

Demo: https://anatoly-scherbakov.github.io/geopatterns-demo/site/
Code: https://github.com/anatoly-scherbakov/geopatterns-demo/

Just wanted to share in case it interests anyone :)

What python versions are supported/tested?

Hello,
I wanted to check this out but encountered an error that made me believe I might not be using a version of python that is supported but didn't see where any version was specified.

I tried to (sudo) pip install on three different machines:
cloud9 with 2.7 and 3.2
pythonanywhere default bash console
Mac OS X 10.10.2 python 2.7.6 with sudo and virtualenv

and received the same error:

Could not find a version that satisfies the requirement geopatterns (from versions: )
No matching distribution found for geopatterns

Sorry if it is my error!

Anybody interested in helping maintain this?

Hey friends. Crazy to me how people are still finding use out of this repo, given how old it is. Unfortunately, I don't have that much time to dedicate to it these days. So if anybody would be interested in helping maintain it, get it up to feature parity with @jasonlong's repo, etc., please let me know!