Skip to content

Commit

Permalink
Merge pull request #1 from billsioros/development
Browse files Browse the repository at this point in the history
chore: πŸŽ‚πŸŽ‰ Initial Release πŸŽ‚πŸŽ‰
  • Loading branch information
billsioros authored Aug 20, 2021
2 parents 6a1c595 + 3bbdf10 commit ec372a1
Show file tree
Hide file tree
Showing 45 changed files with 3,257 additions and 308 deletions.
4 changes: 2 additions & 2 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# This CODEOWNERS file is only to make sure that @{{cookiecutter.github_user}} is requested
# This CODEOWNERS file is only to make sure that @billsioros is requested
# for a code review in case of a pull request.

* @{{cookiecutter.github_user}}
* @billsioros
2 changes: 1 addition & 1 deletion .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1 +1 @@
custom: ['https://www.buymeacoffee.com/{{cookiecutter.github_user}}']
custom: ['https://www.buymeacoffee.com/billsioros']
10 changes: 2 additions & 8 deletions .github/ISSUE_TEMPLATE/bug_report.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ description: Did you find a bug?
title: "🐞 "
labels: [":bug: bug"]
assignees:
- {{cookiecutter.github_user}}
- billsioros
body:
- type: textarea
id: what-happened
Expand All @@ -19,12 +19,6 @@ body:
label: How can we reproduce the bug?
description: Please provide the reproduction steps corresponding to the bug.
placeholder: Provide us with some python code!
value: |
from {{cookiecutter.project_name}} import {{cookiecutter.project_name}}
with {{cookiecutter.project_name}}(SPOTIFY_ID, SPOTIFY_SECRET):
pass
render: python
validations:
required: true
- type: textarea
Expand Down Expand Up @@ -77,7 +71,7 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct](https://{{cookiecutter.github_user}}.github.io/{{cookiecutter.project_name}}/latest/CODE_OF_CONDUCT/)
description: By submitting this issue, you agree to follow our [Code of Conduct](https://billsioros.github.io/cookiecutter-pypackage/latest/CODE_OF_CONDUCT/)
options:
- label: I agree to follow this project's Code of Conduct
required: true
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
blank_issues_enabled: false
contact_links:
- name: Q&A
url: https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/discussions/categories/q-a
url: https://github.com/billsioros/cookiecutter-pypackage/discussions/categories/q-a
about: Please ask and answer questions here.
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/docs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ description: Suggest a change regarding this project's documentation
title: "πŸ“„ "
labels: [":memo: documentation"]
assignees:
- {{cookiecutter.github_user}}
- billsioros
body:
- type: textarea
id: change-description
Expand All @@ -25,7 +25,7 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct](https://{{cookiecutter.github_user}}.github.io/{{cookiecutter.project_name}}/latest/CODE_OF_CONDUCT/)
description: By submitting this issue, you agree to follow our [Code of Conduct](https://billsioros.github.io/cookiecutter-pypackage/latest/CODE_OF_CONDUCT/)
options:
- label: I agree to follow this project's Code of Conduct
required: true
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/feature_request.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ description: Suggest a feature or improvement
title: "🎁 "
labels: [":bulb: feature request"]
assignees:
- {{cookiecutter.github_user}}
- billsioros
body:
- type: textarea
id: change-description
Expand All @@ -25,7 +25,7 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct](https://{{cookiecutter.github_user}}.github.io/{{cookiecutter.project_name}}/latest/CODE_OF_CONDUCT/)
description: By submitting this issue, you agree to follow our [Code of Conduct](https://billsioros.github.io/cookiecutter-pypackage/latest/CODE_OF_CONDUCT/)
options:
- label: I agree to follow this project's Code of Conduct
required: true
4 changes: 2 additions & 2 deletions .github/SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Security Policy

If you believe you have identified a security issue, **do not open a public issue**. To report a security issue, please contact {{cookiecutter.github_user}}97@gmail.com.
If you believe you have identified a security issue, **do not open a public issue**. To report a security issue, please contact billsioros97@gmail.com.

Be sure to include as much detail as necessary in your report. As with
reporting normal issues, a minimal reproducible example will help the
Expand All @@ -9,4 +9,4 @@ include a fix for the issue generated with `git format-patch`. You may
include a name and link, if you would like to be credited for the report.

After fixing the issue, we will make a security release along with an
announcement on [GitHub Discussions](https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/discussions).
announcement on [GitHub Discussions](https://github.com/billsioros/cookiecutter-pypackage/discussions).
7 changes: 2 additions & 5 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ on:
push:
branches: [master]
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'tests/**/*.py'
- 'examples/**/*.py'
- 'pyproject.toml'
- 'poetry.lock'
pull_request:
branches: [master]
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'tests/**/*.py'
- 'examples/**/*.py'
- 'pyproject.toml'
Expand Down Expand Up @@ -55,7 +55,4 @@ jobs:
poetry install
- name: Test with tox
env:
SPOTIFY_ID: ${{ secrets.SPOTIFY_ID }}
SPOTIFY_SECRET: ${{ secrets.SPOTIFY_SECRET }}
run: poetry run python -m tox
7 changes: 2 additions & 5 deletions .github/workflows/codecov.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: Code Coverage
on:
push:
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'tests/**/*.py'
- 'pyproject.toml'
- 'poetry.lock'
Expand Down Expand Up @@ -39,11 +39,8 @@ jobs:
poetry install
- name: Generate the coverage report
env:
SPOTIFY_ID: ${{ secrets.SPOTIFY_ID }}
SPOTIFY_SECRET: ${{ secrets.SPOTIFY_SECRET }}
run: |
poetry run python -m pytest -p no:sugar --cov=./{{cookiecutter.project_name}} --cov-report=xml
poetry run python -m pytest -p no:sugar --cov=./cookiecutter-pypackage --cov-report=xml
- name: Upload coverage report
uses: codecov/codecov-action@v2
4 changes: 2 additions & 2 deletions .github/workflows/codeql-analysis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@ on:
push:
branches: [master]
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'pyproject.toml'
- 'poetry.lock'
pull_request:
# The branches below must be a subset of the branches above
branches: [master]
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'pyproject.toml'
- 'poetry.lock'
schedule:
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/greetings.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,5 +9,5 @@ jobs:
- uses: actions/first-interaction@v1
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
issue-message: "Thank you for contributing to **{{cookiecutter.project_name}}**! Please remember to reference our [Contributing Guidelines](https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/blob/master/docs/CONTRIBUTING.md)."
pr-message: "Thank you for contributing to **{{cookiecutter.project_name}}**! Please remember to reference our [Contributing Guidelines](https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/blob/master/docs/CONTRIBUTING.md)."
issue-message: "Thank you for contributing to **cookiecutter-pypackage**! Please remember to reference our [Contributing Guidelines](https://github.com/billsioros/cookiecutter-pypackage/blob/master/docs/CONTRIBUTING.md)."
pr-message: "Thank you for contributing to **cookiecutter-pypackage**! Please remember to reference our [Contributing Guidelines](https://github.com/billsioros/cookiecutter-pypackage/blob/master/docs/CONTRIBUTING.md)."
2 changes: 1 addition & 1 deletion .github/workflows/preview-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ on:
- master
types: [opened, synchronize, reopened, closed]
paths:
- '{{cookiecutter.project_name}}/**/*.py'
- 'cookiecutter-pypackage/**/*.py'
- 'docs/**'
- '*.md'

Expand Down
12 changes: 1 addition & 11 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,6 @@ repos:
- id: check-json
- id: check-toml
- id: debug-statements
- repo: https://github.com/pre-commit/mirrors-mypy
rev: v0.910
hooks:
- id: mypy
files: ^{{cookiecutter.project_name}}
additional_dependencies: [types-all]
- repo: https://github.com/commitizen-tools/commitizen
rev: v2.18.0
hooks:
Expand All @@ -55,10 +49,6 @@ repos:
rev: 2.3.53
hooks:
- id: editorconfig-checker
- repo: https://github.com/jendrikseipp/vulture
rev: v2.3
hooks:
- id: vulture
- repo: https://github.com/tox-dev/tox-ini-fmt
rev: 0.5.1
hooks:
Expand All @@ -69,7 +59,7 @@ repos:
name: export-requirements
language: system
pass_filenames: false
entry: poetry export --without-hashes -o requirements.txt
entry: poetry export --without-hashes --dev -o requirements.txt
files: ^(pyproject.toml|poetry.lock)$
- repo: meta
hooks:
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2021-2021 Vasileios Sioros ({{cookiecutter.github_user}})
Copyright (c) 2021-2021 Vasileios Sioros (billsioros)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
86 changes: 27 additions & 59 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,96 +1,64 @@
![{{cookiecutter.project_name}}](https://raw.githubusercontent.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/master/docs/img/logo.png)
# πŸͺ Python Cookiecutter πŸͺ

<p align="center">
<a href="https://www.python.org/">
<a href="https://github.com/billsioros/cookiecutter-pypackage/actions/workflows/ci.yml">
<img
src="https://img.shields.io/pypi/pyversions/{{cookiecutter.project_name}}"
alt="PyPI - Python Version"
/>
</a>
<a href="https://pypi.org/project/{{cookiecutter.project_name}}/">
<img
src="https://img.shields.io/pypi/v/{{cookiecutter.project_name}}"
alt="PyPI"
/>
</a>
<a href="https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/actions/workflows/ci.yml">
<img
src="https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/actions/workflows/ci.yml/badge.svg"
src="https://github.com/billsioros/cookiecutter-pypackage/actions/workflows/ci.yml/badge.svg"
alt="CI"
/>
</a>
<a href="https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/actions/workflows/cd.yml">
<a href="https://github.com/billsioros/cookiecutter-pypackage/actions/workflows/cd.yml">
<img
src="https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/actions/workflows/cd.yml/badge.svg"
src="https://github.com/billsioros/cookiecutter-pypackage/actions/workflows/cd.yml/badge.svg"
alt="CI"
/>
</a>
<a href="https://results.pre-commit.ci/latest/github/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/master">
<a href="https://results.pre-commit.ci/latest/github/billsioros/cookiecutter-pypackage/master">
<img
src="https://results.pre-commit.ci/badge/github/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/master.svg"
src="https://results.pre-commit.ci/badge/github/billsioros/cookiecutter-pypackage/master.svg"
alt="pre-commit.ci status"
/>
</a>
<a href="https://codecov.io/gh/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}">
<img
src="https://codecov.io/gh/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/branch/master/graph/badge.svg?token=coLOL0j6Ap"
alt="Test Coverage"/>
</a>
<a href="https://opensource.org/licenses/MIT">
<a href="https://codecov.io/gh/billsioros/cookiecutter-pypackage">
<img
src="https://img.shields.io/pypi/l/{{cookiecutter.project_name}}"
alt="PyPI - License"
src="https://codecov.io/gh/billsioros/cookiecutter-pypackage/branch/master/graph/badge.svg?token=coLOL0j6Ap"
alt="Test Coverage"
/>
</a>
<a href="https://gitpod.io/from-referrer/">
<a href="https://opensource.org/licenses/MIT">
<img
src="https://img.shields.io/badge/Gitpod-Open-blue?logo=gitpod"
alt="Open on Gitpod"
src="https://img.shields.io/github/license/billsioros/cookiecutter-pypackage"
alt="GitHub"
/>
</a>
</p>

## Example Usage
## Quickstart

Install the latest Cookiecutter

```python
>>> from {{cookiecutter.project_name}} import {{cookiecutter.project_name}}, Track
>>> with {{cookiecutter.project_name}}(SPOTIFY_ID, SPOTIFY_SECRET):
>>> result = next(Track.search("SAINt JHN 5 Thousand Singles", limit=1))
>>> result
<Track "SAINt JHN - 5 Thousand Singles">
>>> result.url
'https://open.spotify.com/track/0fFWxRZGKR7HDW2xBMOZgW'
>>> result.download("SAINt JHN - 5 Thousand Singles.mp3")
PosixPath('SAINt JHN - 5 Thousand Singles.mp3')
```
pip install -U cookiecutter
```

Feel free to check the [examples](https://github.com/{{cookiecutter.github_user}}/{{cookiecutter.project_name}}/tree/master/examples) folder for more use cases!
and generate a `Python` package project:

```
cookiecutter gh:billsioros/cookiecutter-pypackage
```

## Features

- Searching for
- Tracks
- Playlists
- Albums
- Downloading
- Tracks
- Playlists
- Albums
- TODO

## Documentation

The project's documentation can be found [here](https://{{cookiecutter.github_user}}.github.io/{{cookiecutter.project_name}}/).

## Installation

```bash
pip install {{cookiecutter.project_name}}
```
The project's documentation can be found [here](https://billsioros.github.io/cookiecutter-pypackage/).

## Supporting the project

Feel free to [**Buy me a coffee! β˜•**](https://www.buymeacoffee.com/{{cookiecutter.github_user}}).
Feel free to [**Buy me a coffee! β˜•**](https://www.buymeacoffee.com/billsioros).

## Contributing

If you would like to contribute to the project, please go through the [Contributing Guidelines](https://{{cookiecutter.github_user}}.github.io/{{cookiecutter.project_name}}/latest/CONTRIBUTING/) first.
If you would like to contribute to the project, please go through the [Contributing Guidelines](https://billsioros.github.io/cookiecutter-pypackage/latest/CONTRIBUTING/) first.
8 changes: 4 additions & 4 deletions cookiecutter.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"project_name": "cookiecutter-pypackage",
"package_name": "{{ cookiecutter.project_name.replace('-', '_') }}",
"friendly_name": "{{ cookiecutter.project_name.replace('-', ' ').title() }}",
"author": "{{cookiecutter.author}}",
"email": "{{cookiecutter.github_user}}97@gmail.com",
"github_user": "{{cookiecutter.github_user}}",
"project_description": "🐍 An awesome python package by the name `{{ cookiecutter.friendly_name }}`",
"author": "Vasilis Sioros",
"email": "billsioros97@gmail.com",
"github_user": "billsioros",
"version": "0.0.0",
"license": ["MIT", "Apache-2.0", "GPL-3.0"]
}
1 change: 1 addition & 0 deletions docs/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
--8<-- "CHANGELOG.md"
Loading

0 comments on commit ec372a1

Please sign in to comment.