Skip to content

Commit 62b5a13

Browse files
committed
[MAJOR] First official release
1 parent a0e6d58 commit 62b5a13

7 files changed

Lines changed: 70 additions & 134 deletions

File tree

.github/workflows/pypi_deploy.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ jobs:
1818
- uses: actions/checkout@master
1919

2020
- name: Publish distribution 📦 to PyPI
21-
uses: JRubics/poetry-publish@v1.13
21+
uses: JRubics/poetry-publish@v1.15
2222
with:
2323
ignore_dev_requirements: 'yes'
2424
pypi_token: ${{ secrets.PYPI_PASSWORD }}

.github/workflows/unit_tests.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,17 @@ jobs:
1616
matrix:
1717
os: [macos-latest, ubuntu-latest, windows-latest]
1818
tox-env: [
19-
py310
19+
py310,
20+
py311,
21+
# py312,
2022
]
2123
include:
2224
- tox-env: py310
2325
python-version: "3.10"
26+
- tox-env: py311
27+
python-version: "3.11"
28+
# - tox-env: py312
29+
# python-version: "3.12"
2430
env:
2531
TOXENV: ${{ matrix.tox-env }}
2632

CHANGELOG.md

Lines changed: 27 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -50,32 +50,48 @@ Lorem Ipsum dolor sit amet.
5050
<!--
5151
_______________________________________________________________________________
5252
53-
## [0.9.0] - 2022-12-20
53+
## [1.0.0] - 2022-12-20
5454
55-
This update adds all planned fuctionality for the project.
56-
Strings are parsed into integers, and vice versa.
55+
This update fixes a handful of things, readying the package for official
56+
release.
5757
5858
### Added
5959
60-
- String to int conversion for microseconds
61-
- Int to string conversion for microseconds
62-
- Added more GitHub Actions workflows for PyPI uploads
63-
- Full unit test coverage
60+
- Badges to `README.md`
6461
6562
### Changed
6663
67-
- Moved constants to their own file
68-
- Updated linters and cleaned up the codebase
69-
- Updated localisation files
64+
- Updated GitHub Actions workflows to use newer versions
7065
7166
### Fixed
7267
73-
- Fixed a bug with the regex query
68+
- Swapped `Ellipsis` for `pass` in the hopes of getting coverage reports ignore
69+
them
7470
7571
-->
7672

7773
_______________________________________________________________________________
7874

75+
## [1.0.0] - 2022-12-20
76+
77+
This update fixes a handful of things, readying the package for official
78+
release.
79+
80+
### Added
81+
82+
- Badges to `README.md`
83+
84+
### Changed
85+
86+
- Updated GitHub Actions workflows to use newer versions
87+
88+
### Fixed
89+
90+
- Swapped `Ellipsis` for `pass` in the hopes of getting coverage reports ignore
91+
them
92+
93+
_______________________________________________________________________________
94+
7995
## [0.9.0] - 2022-12-20
8096

8197
This update adds all planned fuctionality for the project.

CONTRIBUTING.md

Lines changed: 23 additions & 118 deletions
Original file line numberDiff line numberDiff line change
@@ -1,128 +1,33 @@
1-
# Contributor Covenant Code of Conduct
1+
# Contributing to the `python-ms` project
22

3-
## Our Pledge
3+
## Filing a bug report
44

5-
We as members, contributors, and leaders pledge to make participation in our
6-
community a harassment-free experience for everyone, regardless of age, body
7-
size, visible or invisible disability, ethnicity, sex characteristics, gender
8-
identity and expression, level of experience, education, socio-economic status,
9-
nationality, personal appearance, race, religion, or sexual identity
10-
and orientation.
5+
To file a bug report, [open the Issues tab][Issues] and add a new issue,
6+
labeling it as a bug report. If you wish to try and fix it yourself, add
7+
yourself as a contributor to that issue. You are allowed to group similar
8+
bugs into one issue report, as long as you don't exceed the limit of three
9+
different bugs. Otherwise, make another issue.
1110

12-
We pledge to act and interact in ways that contribute to an open, welcoming,
13-
diverse, inclusive, and healthy community.
11+
## Suggesting a new feature
1412

15-
## Our Standards
13+
To suggest a new feature:
1614

17-
Examples of behavior that contributes to a positive environment for our
18-
community include:
15+
* For small suggestions, [you can go directly to the Projects tab][Projects]
16+
and write a suggestion to the Suggestions/Ideas column
17+
* For medium-to-large suggestions, write an issue, mark it as part of the
18+
current project and label it as a suggestion
1919

20-
- Demonstrating empathy and kindness toward other people
21-
- Being respectful of differing opinions, viewpoints, and experiences
22-
- Giving and gracefully accepting constructive feedback
23-
- Accepting responsibility and apologizing to those affected by our mistakes,
24-
and learning from the experience
25-
- Focusing on what is best not just for us as individuals, but for the
26-
overall community
20+
You may NOT suggest features through email to the core developers.
2721

28-
Examples of unacceptable behavior include:
22+
## Setting up your development environment
2923

30-
- The use of sexualized language or imagery, and sexual attention or
31-
advances of any kind
32-
- Trolling, insulting or derogatory comments, and personal or political attacks
33-
- Public or private harassment
34-
- Publishing others' private information, such as a physical or email
35-
address, without their explicit permission
36-
- Other conduct which could reasonably be considered inappropriate in a
37-
professional setting
24+
Since `python-ms` has very little to do beyond programming and testing, the following should be enough for 95% of all contributors:
3825

39-
## Enforcement Responsibilities
26+
1. A working Git or GitHub Desktop installation
27+
2. A text editor / Python IDE
28+
3. An installation of Python that supports Python version 3.10 or higher
29+
4. The following, non-standard PyPI modules (available through pip):
30+
* `poetry`
4031

41-
Community leaders are responsible for clarifying and enforcing our standards of
42-
acceptable behavior and will take appropriate and fair corrective action in
43-
response to any behavior that they deem inappropriate, threatening, offensive,
44-
or harmful.
45-
46-
Community leaders have the right and responsibility to remove, edit, or reject
47-
comments, commits, code, wiki edits, issues, and other contributions that are
48-
not aligned to this Code of Conduct, and will communicate reasons for moderation
49-
decisions when appropriate.
50-
51-
## Scope
52-
53-
This Code of Conduct applies within all community spaces, and also applies when
54-
an individual is officially representing the community in public spaces.
55-
Examples of representing our community include using an official e-mail address,
56-
posting via an official social media account, or acting as an appointed
57-
representative at an online or offline event.
58-
59-
## Enforcement
60-
61-
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62-
reported to the community leaders responsible for enforcement at
63-
lari.liuhamo+github@gmail.com.
64-
All complaints will be reviewed and investigated promptly and fairly.
65-
66-
All community leaders are obligated to respect the privacy and security of the
67-
reporter of any incident.
68-
69-
## Enforcement Guidelines
70-
71-
Community leaders will follow these Community Impact Guidelines in determining
72-
the consequences for any action they deem in violation of this Code of Conduct:
73-
74-
### 1. Correction
75-
76-
**Community Impact**: Use of inappropriate language or other behavior deemed
77-
unprofessional or unwelcome in the community.
78-
79-
**Consequence**: A private, written warning from community leaders, providing
80-
clarity around the nature of the violation and an explanation of why the
81-
behavior was inappropriate. A public apology may be requested.
82-
83-
### 2. Warning
84-
85-
**Community Impact**: A violation through a single incident or series
86-
of actions.
87-
88-
**Consequence**: A warning with consequences for continued behavior. No
89-
interaction with the people involved, including unsolicited interaction with
90-
those enforcing the Code of Conduct, for a specified period of time. This
91-
includes avoiding interactions in community spaces as well as external channels
92-
like social media. Violating these terms may lead to a temporary or
93-
permanent ban.
94-
95-
### 3. Temporary Ban
96-
97-
**Community Impact**: A serious violation of community standards, including
98-
sustained inappropriate behavior.
99-
100-
**Consequence**: A temporary ban from any sort of interaction or public
101-
communication with the community for a specified period of time. No public or
102-
private interaction with the people involved, including unsolicited interaction
103-
with those enforcing the Code of Conduct, is allowed during this period.
104-
Violating these terms may lead to a permanent ban.
105-
106-
### 4. Permanent Ban
107-
108-
**Community Impact**: Demonstrating a pattern of violation of community
109-
standards, including sustained inappropriate behavior, harassment of an
110-
individual, or aggression toward or disparagement of classes of individuals.
111-
112-
**Consequence**: A permanent ban from any sort of public interaction within
113-
the community.
114-
115-
## Attribution
116-
117-
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118-
version 2.0, available [here][Covenant].
119-
120-
Community Impact Guidelines were inspired by [Mozilla's code of conduct
121-
enforcement ladder](https://github.com/mozilla/diversity).
122-
123-
For answers to common questions about this code of conduct, see the FAQ [here][FAQ]. Translations are available [here][Translations].
124-
125-
[homepage]: https://www.contributor-covenant.org
126-
[Covenant]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
127-
[FAQ]: https://www.contributor-covenant.org/faq
128-
[Translations]: https://www.contributor-covenant.org/translations
32+
[Issues]: https://github.com/Diapolo10/python-ms/issues
33+
[Projects]: https://github.com/Diapolo10/python-ms/projects

README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,13 @@ floating-point numbers when using large values.
1010
Using the project's unit tests as examples is recommended, as they cover
1111
everything.
1212

13+
| | |
14+
|--------------|---|
15+
| Tests (main) | [![codecov](https://codecov.io/gh/Diapolo10/python-ms/branch/main/graph/badge.svg?token=zBlgCd32Aq)](https://codecov.io/gh/Diapolo10/python-ms) ![Unit tests](https://github.com/diapolo10/python-ms/workflows/Unit%20tests/badge.svg) ![Pylint](https://github.com/diapolo10/python-ms/workflows/Pylint/badge.svg) ![Flake8](https://github.com/diapolo10/python-ms/workflows/Flake8/badge.svg) |
16+
| Activity | ![GitHub contributors](https://img.shields.io/github/contributors/diapolo10/python-ms) ![Last commit](https://img.shields.io/github/last-commit/diapolo10/python-ms?logo=github) ![GitHub all releases](https://img.shields.io/github/downloads/diapolo10/python-ms/total?logo=github) ![GitHub issues](https://img.shields.io/github/issues/diapolo10/python-ms) ![GitHub closed issues](https://img.shields.io/github/issues-closed/diapolo10/python-ms) ![GitHub pull requests](https://img.shields.io/github/issues-pr/diapolo10/python-ms) ![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/diapolo10/python-ms) |
17+
| QA | [![CodeFactor](https://www.codefactor.io/repository/github/diapolo10/python-ms/badge?logo=codefactor)](https://www.codefactor.io/repository/github/diapolo10/python-ms) |
18+
| Other | [![License](https://img.shields.io/github/license/diapolo10/python-ms)](https://opensource.org/licenses/MIT) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FDiapolo10%2Fpython-ms.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FDiapolo10%2Fpython-ms?ref=badge_shield) [![Known Vulnerabilities](https://snyk.io/test/github/diapolo10/python-ms/badge.svg)](https://snyk.io/test/github/diapolo10/python-ms) ![Repository size](https://img.shields.io/github/repo-size/diapolo10/python-ms?logo=github) ![Code size](https://img.shields.io/github/languages/code-size/diapolo10/python-ms?logo=github) ![Lines of code](https://img.shields.io/tokei/lines/github/diapolo10/python-ms?logo=github) |
19+
1320
## Installation
1421

1522
The project is available via PyPI:

pyproject.toml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ __init__.py:F401,F403,F405\
2626

2727
[tool.poetry]
2828
name = 'python_ms'
29-
version = '0.9.0'
29+
version = '1.0.0'
3030
description = "A Python equivalent to the JavaScript ms package."
3131

3232
authors = ["Lari Liuhamo <lari.liuhamo+pypi@gmail.com>",]
@@ -113,6 +113,8 @@ isolated_build = True
113113
[gh-actions]
114114
python =
115115
3.10: py310
116+
3.11: py311
117+
3.12: py312
116118
pypy-3.10: pypy3
117119
118120
[gh-actions:env]

python_ms/ms.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -174,11 +174,11 @@ class _ms(types.ModuleType):
174174

175175
@overload
176176
def __call__(self, value: str, long: bool) -> int:
177-
...
177+
pass
178178

179179
@overload
180180
def __call__(self, value: int, long: bool) -> str:
181-
...
181+
pass
182182

183183
def __call__(self, value: str | int, long: bool = False) -> int | str:
184184
if isinstance(value, str):

0 commit comments

Comments
 (0)