Skip to content

Commit

Permalink
Merge pull request #8 from JordanWelsman/readme
Browse files Browse the repository at this point in the history
To-do list complete. Merging now.
  • Loading branch information
JordanWelsman authored Feb 16, 2023
2 parents 5733529 + 56163af commit dd5a96c
Showing 1 changed file with 36 additions and 17 deletions.
53 changes: 36 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
<!-- ASCII Logo -->
```ascii
_ _ _ _
(_)_ _| |_(_) |___
Expand All @@ -7,17 +8,36 @@
|__/
```

![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/JordanWelsman/jutils)
![GitHub Release Date](https://img.shields.io/github/release-date/JordanWelsman/jutils)
![GitHub repo size](https://img.shields.io/github/repo-size/JordanWelsman/jutils)
![GitHub](https://img.shields.io/github/license/JordanWelsman/jutils)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/JordanWelsman/jutils)
------------------------------------------------------

![PyPI](https://img.shields.io/pypi/v/jutl)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/jutl)
![PyPI - Wheel](https://img.shields.io/pypi/wheel/jutl)
![PyPI - Status](https://img.shields.io/pypi/status/jutl)
![PyPI - Downloads](https://img.shields.io/pypi/dm/jutl)
<div align="center">

[![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/tags)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/releases)
[![GitHub Release Date](https://img.shields.io/github/release-date/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/wiki/Version-History)
[![GitHub](https://img.shields.io/github/license/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/blob/main/LICENSE.md)
[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/commits/main)

</div>
<div align="center">

[![PyPI](https://img.shields.io/pypi/v/jutl?style=for-the-badge)](https://pypi.org/project/jutl)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/jutl?style=for-the-badge)](https://docs.python.org/3/whatsnew/3.11.html)
[![PyPI - Wheel](https://img.shields.io/pypi/wheel/jutl?style=for-the-badge)](https://pypi.org/project/jutl/#files)
[![PyPI - Status](https://img.shields.io/pypi/status/jutl?style=for-the-badge)](https://pypi.org/project/jutl/#data)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/jutl?style=for-the-badge)](https://pypi.org/project/jutl/#history)

</div>
<div align="center">

[![GitHub Repo stars](https://img.shields.io/github/stars/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/stargazers)
[![GitHub watchers](https://img.shields.io/github/watchers/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/watchers)
[![GitHub forks](https://img.shields.io/github/forks/JordanWelsman/jutils?style=for-the-badge)](https://github.com/JordanWelsman/jutils/network/members)
![Lines of code](https://img.shields.io/tokei/lines/github/JordanWelsman/jutils?style=for-the-badge)
![GitHub repo file count](https://img.shields.io/github/directory-file-count/JordanWelsman/jutils?style=for-the-badge)
![GitHub repo size](https://img.shields.io/github/repo-size/JordanWelsman/jutils?style=for-the-badge)

</div>

# Overview

Expand All @@ -37,7 +57,7 @@ jutils is a simple `Python 3.10+` package which gives the user various tools. Th
# Install & use

1. From terminal: `pip install jutl`
2. From python environment: `from jutl import <submodule>` where `<submodule>` is:
2. From python environment: `from jutl import <submodule>` where `<submodule>` is one from the following:

- `averages`
- `calculators`
Expand All @@ -55,8 +75,8 @@ jutils is a simple `Python 3.10+` package which gives the user various tools. Th

1. Clone repository: `git clone https://github.com/JordanWelsman/jutils.git`
2. Build module for testing: `python3 setup.py bdist_wheel`
3. Install module locally: `pip install jutl -e . dev`
4. Run tests with PyTest: `pytest`
3. Install module locally: `pip install jutl -e .`
4. Run tests with PyTest: `pytest test/<submodule>` where `<submodule>` is one [from the above list](#install--use).

# Objectives

Expand All @@ -65,11 +85,12 @@ jutils is a simple `Python 3.10+` package which gives the user various tools. Th

# Credits

`jutils` was created, developed, and is currently maintained by **Jordan Welsman**.
jutils was created, developed, and is currently maintained by **Jordan Welsman**.

# Licence

`jutils` is developed and distributed under the `MIT` license.
jutils is developed and distributed under the `MIT` license.
> **Note**
> See `LICENSE` for more details.
# Links
Expand All @@ -83,5 +104,3 @@ jutils is a simple `Python 3.10+` package which gives the user various tools. Th
:briefcase: [Connect with me on Linkedin](https://linkedin.com/in/JordanWelsman/)

:email: [Send me an email](mailto:[email protected])

:clapper: [Followed tutorial](https://www.youtube.com/watch?v=GIF3LaRqgXo/) by [Mark Smith (@judy2k)](https://twitter.com/judy2k/)

0 comments on commit dd5a96c

Please sign in to comment.