A common set of classes for the ColorSplash project python components
Project description
colorsplash-common
Description
colorsplash-common (CSC) is a component of the overarching ColorSplash web application that can be found at https://thurau.io/colorsplash/. ColorSplash allows users to browse royalty free images that have colors within a certain Euclidean distance of a provided HEX code. CSC is a python library hosted on PyPi to allow common features to be included as dependencies within the other python componenets.
You can see other components of this project in the following Github repos
Motivation
A friend was facing issues when trying to create social media posts for an ecommerce company we recently launched. She had developed a branding guide and had chosen what colors she wanted to include in the website, logos, and eventual marketing material. But when it was time to make marketing posts, trying to apply that style guide was difficult. For all the tools on the internet she used, none were able to query royalty free images that were close to the HEX color codes she had selected. This project was born to remedy this issue.
I wanted to provide a clean minimal interface on a website that would have a form for a HEX code, and query a REST API that would return royalty free images that had a subset of colors within close to the original HEX code.
Tech Used
CSC is a very simple python library that tightly couples integration with the various DynamoDB tables in the project. It uses boto3 as the client library.
Installation
Cloning The Project
You can either fork the repo or clone it directly with
$ git clone https://github.com/DanielThurau/colorsplash-common.git
$ cd colorsplash-common
Developing
This project uses poetry to build, test, and publish.
To install dependencies run
$ poetry install
To run the unit tests run
$ poetry run pytest
Usage
CSC is hosted on PyPi so you can use any tool that integrates with PyPi to bring it in as a dependency. The easiest way is with pip. For example
$ pip install colorsplash-common
// TODO link a Github gist showing the use of the library
Contribute
If you'd like to contribute, fork the project and submit a Pull Request.
License
See LICENSE.md
MIT License
Copyright (c) 2021 Daniel Thurau
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for colorsplash_common-0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54d4eb18abea7fa25cf46262a22f5060c13011913881f66cab797e97af860e0c |
|
MD5 | c15b914a32f771573c467e51112781ec |
|
BLAKE2b-256 | 6b8adbebd329ee493c5b7125d9c219d044d7ba0b1e6e64394654b84750aef9b7 |