mathdatech/best-of-python-dev
1
0
Fork 0
mirror of https://github.com/ml-tooling/best-of-python-dev.git synced 2024-10-05 20:39:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Initial setup for best-of list

Browse Source
This commit is contained in:
LukasMasuch 2021-01-08 14:47:51 +00:00 committed by best-of setup
parent 502e9b7a51
commit 22664611d2
26 changed files with 26 additions and 454 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
.github/workflows/setup-best-of-list.yml vendored
View File

@ -1,72 +0,0 @@
# Based on https://github.com/best-of-lists/best-of/blob/main/.github/workflows/setup-best-of-list.yml
name: setup-best-of-list
on:
workflow_dispatch:
env:
DEFAULT_BRANCH: "main"
SETUP_BRANCH: "setup"
PLACEHOLDER_REPO: "best-of-lists/best-of-template"
jobs:
setup-best-of-list:
runs-on: ubuntu-latest
steps:
- name: create-update-branch
uses: peterjgrainger/action-create-branch@v2.0.1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
branch: ${{ env.SETUP_BRANCH }}
- uses: actions/checkout@v2
with:
fetch-depth: 0
ref: ${{ env.SETUP_BRANCH }}
token: ${{ secrets.GITHUB_TOKEN }}
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: setup-template
shell: bash
run: |
echo $GITHUB_REPOSITORY
rm -rf history config latest-changes.md README.md projects.yaml ./.github/workflows/setup-best-of-list.yml CONTRIBUTING.md create-best-of-list.md
mkdir -p ./config
cp ./template/footer.md ./config/footer.md
cp ./template/header.md ./config/header.md
cp ./template/projects.yaml ./projects.yaml
cp ./template/CONTRIBUTING.md ./CONTRIBUTING.md
rm -rf ./template/
sed -i 's:${{ env.PLACEHOLDER_REPO }}:'$GITHUB_REPOSITORY':g' ./config/footer.md
sed -i 's:${{ env.PLACEHOLDER_REPO }}:'$GITHUB_REPOSITORY':g' ./config/header.md
sed -i 's:${{ env.PLACEHOLDER_REPO }}:'$GITHUB_REPOSITORY':g' ./CONTRIBUTING.md
sed -i 's:'$(echo "${{ env.PLACEHOLDER_REPO }}" | sed "s:.*/::")':'$(echo "$GITHUB_REPOSITORY" | sed "s:.*/::")':g' ./config/header.md
- name: push-update
uses: stefanzweifel/git-auto-commit-action@v4
with:
branch: ${{ env.SETUP_BRANCH }}
commit_user_name: best-of setup
commit_user_email: actions@github.com
commit_message: Initial setup for best-of list
skip_dirty_check: true
commit_options: "--allow-empty"
- name: create-pull-request
shell: bash
run: |
# Stops script execution if a command has an error
set -e
curl -fsSL https://github.com/github/hub/raw/master/script/get | bash -s 2.14.2
bin/hub pull-request -b ${{ env.DEFAULT_BRANCH }} -h ${{ env.SETUP_BRANCH }} --no-edit -m "Initial setup for best-of list" -m "To finish this setup: Select <code>Merge pull request</code> below and <code>Confirm merge</code>." || true
rm bin/hub
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: sync-labels
# Alternative actions:
# https://github.com/crazy-max/ghaction-github-labeler
# https://github.com/EndBug/label-sync
uses: micnncim/action-label-syncer@v1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
manifest: ".github/labels.yml"
prune: true

16
CONTRIBUTING.md
View File

@ -16,8 +16,8 @@ Thanks for your interest in contributing to our project. This page will give you
If you like to suggest or add a project, choose one of the following ways:
- Suggest a project by opening an issue: Please use the suggest project template from the [issue page](https://github.com/best-of-lists/best-of/issues/new/choose) and fill in the requested information.
- Add a project by modifying the [projects.yaml](https://github.com/best-of-lists/best-of/blob/main/projects.yaml) and submitting a pull request with your addition. This can also be done directly via the [GitHub UI](https://github.com/best-of-lists/best-of/edit/main/projects.yaml).
- Suggest a project by opening an issue: Please use the suggest project template from the [issue page](https://github.com/ml-tooling/best-of-python-dev/issues/new/choose) and fill in the requested information.
- Add a project by modifying the [projects.yaml](https://github.com/ml-tooling/best-of-python-dev/blob/main/projects.yaml) and submitting a pull request with your addition. This can also be done directly via the [Github UI](https://github.com/ml-tooling/best-of-python-dev/edit/main/projects.yaml).
Before opening an issue or pull request, please ensure that you adhere to the following guidelines:
@ -33,14 +33,14 @@ Before opening an issue or pull request, please ensure that you adhere to the fo
```
- Please create an individual issue or pull request for each project.
- Please use the following title format for the issue or pull request: `Add project: project-name`.
- If a project doesn't fit any of the pre-existing categories, it should go under the `Others` category by not assigning any category. You can also suggest a new category via the add or update category template on the [issue page](https://github.com/best-of-lists/best-of/issues/new/choose).
- If a project doesn't fit into any of the pre-existing categories, it should go under the `Others` category by not assigning any category. You can also suggest a new category via the add or update category template on the [issue page](https://github.com/ml-tooling/best-of-python-dev/issues/new/choose).
## Update a project
If you like to suggest or contribute a project update, choose one of the following ways:
- Suggest a project update by opening an issue: Please use the update project template from the [issue page](https://github.com/best-of-lists/best-of/issues/new/choose) and fill in the requested information.
- Update a project by modifying the [projects.yaml](https://github.com/best-of-lists/best-of/blob/main/projects.yaml) and submitting a pull request with your changes. This can also be done directly via the [GitHub UI](https://github.com/best-of-lists/best-of/edit/main/projects.yaml).
- Suggest a project update by opening an issue: Please use the update project template from the [issue page](https://github.com/ml-tooling/best-of-python-dev/issues/new/choose) and fill in the requested information.
- Update a project by modifying the [projects.yaml](https://github.com/ml-tooling/best-of-python-dev/blob/main/projects.yaml) and submitting a pull request with your changes. This can also be done directly via the [Github UI](https://github.com/ml-tooling/best-of-python-dev/edit/main/projects.yaml).
Before opening an issue or pull request, please ensure that you adhere to the following guidelines:
@ -61,7 +61,7 @@ Before opening an issue or pull request, please ensure that you adhere to the fo
</tr>
<tr>
<td><code>github_id</code></td>
<td>GitHub ID of the project based on user or organization and the repository name, e.g. <code>best-of-lists/best-of-generator</code>.</td>
<td>Github ID of the project based on user or organization and the repository name, e.g. <code>best-of-lists/best-of-generator</code>.</td>
</tr>
<tr>
<td colspan="2"><b>Optional Properties:</b></td>
@ -91,7 +91,7 @@ Before opening an issue or pull request, please ensure that you adhere to the fo
</tr>
<tr>
<td><code>dockerhub_id</code></td>
<td>Project ID on the <a href="https://hub.docker.com">Dockerhub container registry</a>. </td>
<td>Project ID on the <a href="https://hub.docker.com">Docker Hub container registry</a>. </td>
</tr>
<tr>
<td><code>maven_id</code></td>
@ -111,7 +111,7 @@ If you like to contribute to or share suggestions regarding the markdown generat
## Create your own best-of list
If you want to create your own best-of list, we strongly recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md). With this guide, it will only take about 3 minutes to get you started. It is already set-up to automatically run the best-of generator via our GitHub Action and includes other useful template files.
If you want to create your own best-of list, we strongly recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md). With this guide, it will only take about 3 minutes to get you started. It is already set-up to automatically run the best-of generator via our Github Action and includes other useful template files.
## Code of Conduct

96
README.md
View File

@ -1,96 +0,0 @@
<!-- markdownlint-disable -->
<h1 align="center">
best-of
<br>
</h1>
<p align="center">
<strong>🏆&nbsp; Discover best-of lists with awesome open-source projects on all kinds of topics.</strong>
</p>
<p align="center">
<a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
<a href="#Contents" title="Project Count"><img src="https://img.shields.io/badge/projects-2-blue.svg?color=5ac4bf"></a>
<a href="#Contribution" title="Contributions are welcome"><img src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
<a href="https://github.com/best-of-lists/best-of/releases" title="Best-of Updates"><img src="https://img.shields.io/github/release-date/best-of-lists/best-of?color=green&label=updated"></a>
<a href="https://bestoflists.substack.com/subscribe" title="Subscribe for updates"><img src="http://bit.ly/2Md9rxM"></a>
<a href="https://twitter.com/best_of_lists" title="Best-of on Twitter"><img src="https://img.shields.io/twitter/follow/best_of_lists.svg?style=social&label=Follow"></a>
</p>
This curated list contains 2 best-of lists with a total of 52 stars grouped into 2 categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from GitHub and different package managers. If you like to add or update projects, feel free to open an [issue](https://github.com/best-of-lists/best-of/issues/new/choose), submit a [pull request](https://github.com/best-of-lists/best-of/pulls), or directly edit the [projects.yaml](https://github.com/best-of-lists/best-of/edit/main/projects.yaml). Contributions are very welcome!
> 🧙‍♂️ Create your own best-of list in just 3 minutes with [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
## Contents
- [Machine Learning & Data Engineering](#machine-learning--data-engineering) _2 projects_
- [Web Development](#web-development) _0 projects_
## Explanation
- 🥇🥈🥉&nbsp; Combined project-quality score
- ⭐️&nbsp; Star count from GitHub
- 🐣&nbsp; New project _(less than 6 months old)_
- 💤&nbsp; Inactive project _(6 months no activity)_
- 💀&nbsp; Dead project _(12 months no activity)_
- 📈📉&nbsp; Project is trending up or down
- ➕&nbsp; Project was recently added
- 👨‍💻&nbsp; Contributors count from GitHub
- 🔀&nbsp; Fork count from GitHub
- 📋&nbsp; Issue count from GitHub
- ⏱️&nbsp; Last update timestamp on package manager
- 📥&nbsp; Download count from package manager
- 📦&nbsp; Number of dependent projects
- <img src="https://www.python.org/static/favicon.ico" style="display:inline;" width="13" height="13">&nbsp; Best-of list with Python projects
<br>
## Machine Learning & Data Engineering
<a href="#contents"><img align="right" width="15" height="15" src="https://bit.ly/382Vmvi" alt="Back to top"></a>
_Best-of lists about machine learning, data engieering, data science, or other topics related to big data._
<details><summary><b><a href="https://github.com/ml-tooling/best-of-ml-python">best-of-ml-python</a></b> (🥇8 · ⭐ 42 · 🐣) - A ranked list of awesome machine learning python libraries... <code><img src="https://www.python.org/static/favicon.ico" style="display:inline;" width="13" height="13"></code></summary>
- [GitHub](https://github.com/ml-tooling/best-of-ml-python) (👨‍💻 1 · 🔀 1 · 📋 5 - 20% open · ⏱️ 05.01.2021):
```
git clone https://github.com/ml-tooling/best-of-ml-python
```
</details>
<details><summary><b><a href="https://github.com/ml-tooling/best-of-jupyter">best-of-jupyter</a></b> (🥇8 · ⭐ 10 · 📈) - A ranked list of awesome Jupyter Notebook, Hub and Lab projects.. <code><img src="https://www.python.org/static/favicon.ico" style="display:inline;" width="13" height="13"></code></summary>
- [GitHub](https://github.com/ml-tooling/best-of-jupyter) (⏱️ 05.01.2021):
```
git clone https://github.com/ml-tooling/best-of-jupyter
```
</details>
<br>
## Web Development
<a href="#contents"><img align="right" width="15" height="15" src="https://bit.ly/382Vmvi" alt="Back to top"></a>
_Best-of lists about react, vue, angular, html5, css, or other topics related to web development._
---
## Related Resources
- [**Awesome**](https://github.com/sindresorhus/awesome): Awesome lists about all kinds of interesting topics
## Contribution
Contributions are encouraged and always welcome! If you like to add or update projects, choose one of the following ways:
- Open an issue by selecting one of the provided categories from the [issue page](https://github.com/best-of-lists/best-of/issues/new/choose) and fill in the requested information.
- Modify the [projects.yaml](https://github.com/best-of-lists/best-of/blob/main/projects.yaml) with your additions or changes, and submit a pull request. This can also be done directly via the [GitHub UI](https://github.com/best-of-lists/best-of/edit/main/projects.yaml).
If you like to contribute to or share suggestions regarding the project metadata collection or markdown generation, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository. If you like to create your own best-of list, we recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/best-of-lists/best-of/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/best-of-lists/best-of/blob/main/.github/CODE_OF_CONDUCT.md).
## License
[![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/by-sa.svg)](https://creativecommons.org/licenses/by-sa/4.0/)

8
config/footer.md
View File

@ -3,18 +3,18 @@
## Related Resources
- [**Awesome**](https://github.com/sindresorhus/awesome): Awesome lists about all kinds of interesting topics
- [**Best-of lists**](https://best-of.org): Discover other best-of lists with awesome open-source projects on all kinds of topics.
## Contribution
Contributions are encouraged and always welcome! If you like to add or update projects, choose one of the following ways:
- Open an issue by selecting one of the provided categories from the [issue page](https://github.com/best-of-lists/best-of/issues/new/choose) and fill in the requested information.
- Modify the [projects.yaml](https://github.com/best-of-lists/best-of/blob/main/projects.yaml) with your additions or changes, and submit a pull request. This can also be done directly via the [Github UI](https://github.com/best-of-lists/best-of/edit/main/projects.yaml).
- Open an issue by selecting one of the provided categories from the [issue page](https://github.com/ml-tooling/best-of-python-dev/issues/new/choose) and fill in the requested information.
- Modify the [projects.yaml](https://github.com/ml-tooling/best-of-python-dev/blob/main/projects.yaml) with your additions or changes, and submit a pull request. This can also be done directly via the [Github UI](https://github.com/ml-tooling/best-of-python-dev/edit/main/projects.yaml).
If you like to contribute to or share suggestions regarding the project metadata collection or markdown generation, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository. If you like to create your own best-of list, we recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/best-of-lists/best-of/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/best-of-lists/best-of/blob/main/.github/CODE_OF_CONDUCT.md).
For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/ml-tooling/best-of-python-dev/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/ml-tooling/best-of-python-dev/blob/main/.github/CODE_OF_CONDUCT.md).
## License

8
config/header.md
View File

@ -1,22 +1,22 @@
<!-- markdownlint-disable -->
<h1 align="center">
best-of
best-of-python-dev
<br>
</h1>
<p align="center">
<strong>🏆&nbsp; Discover best-of lists with awesome open-source projects on all kinds of topics.</strong>
<strong>🏆&nbsp; A ranked list of awesome projects. Updated weekly.</strong>
</p>
<p align="center">
<a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
<a href="#Contents" title="Project Count"><img src="https://img.shields.io/badge/projects-{project_count}-blue.svg?color=5ac4bf"></a>
<a href="#Contribution" title="Contributions are welcome"><img src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
<a href="https://github.com/best-of-lists/best-of/releases" title="Best-of Updates"><img src="https://img.shields.io/github/release-date/best-of-lists/best-of?color=green&label=updated"></a>
<a href="https://github.com/ml-tooling/best-of-python-dev/releases" title="Best-of Updates"><img src="https://img.shields.io/github/release-date/ml-tooling/best-of-python-dev?color=green&label=updated"></a>
<a href="https://bestoflists.substack.com/subscribe" title="Subscribe for updates"><img src="http://bit.ly/2Md9rxM"></a>
<a href="https://twitter.com/best_of_lists" title="Best-of on Twitter"><img src="https://img.shields.io/twitter/follow/best_of_lists.svg?style=social&label=Follow"></a>
</p>
This curated list contains {project_count} best-of lists with a total of {stars_count} stars grouped into {category_count} categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from Github and different package managers. If you like to add or update projects, feel free to open an [issue](https://github.com/best-of-lists/best-of/issues/new/choose), submit a [pull request](https://github.com/best-of-lists/best-of/pulls), or directly edit the [projects.yaml](https://github.com/best-of-lists/best-of/edit/main/projects.yaml). Contributions are very welcome!
This curated list contains {project_count} awesome open-source projects with a total of {stars_count} stars grouped into {category_count} categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from GitHub and different package managers. If you like to add or update projects, feel free to open an [issue](https://github.com/ml-tooling/best-of-python-dev/issues/new/choose), submit a [pull request](https://github.com/ml-tooling/best-of-python-dev/pulls), or directly edit the [projects.yaml](https://github.com/ml-tooling/best-of-python-dev/edit/main/projects.yaml). Contributions are very welcome!
> 🧙‍♂️ Create your own best-of list in just 3 minutes with [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).

39
create-best-of-list.md
View File

@ -1,39 +0,0 @@
# Create your own best-of list
Welcome ❤️ It is awesome that you want to create your own best-of list! It will only take around 3-4 minutes to get you started ⏱️
1. **Create a new repository based on the [best-of template](https://github.com/best-of-lists/best-of/generate)**.
<details>
<summary>Screenshots (click to show...)</summary>
![](./template/docs/images/1-use-template-repo-framed.png)
![](./template/docs/images/2-create-new-repo-framed.png)
</details>
2. **Run the `setup-best-of-list` workflow**: `Actions` -> `setup-best-of-list` -> `Run workflow`
<details>
<summary>Screenshots (click to show...)</summary>
![](./template/docs/images/3-run-setup-workflow-framed.png)
</details>
3. **Select and merge the setup pull request**: After about one minute, a pull request should appear in the `Pull requests` section -> Select the `Initial setup for best-of list` pull request -> Select `Merge Pull Request` -> `Confirm Merge`
<details>
<summary>Screenshots (click to show...)</summary>
![](./template/docs/images/4-select-setup-pr-framed.png)
![](./template/docs/images/5-merge-setup-pr-framed.png)
</details>
4. **Run the `update-best-of-list` workflow**: `Actions` -> `update-best-of-list` -> `Run workflow` (you don't have to provide a version as input). The workflow will probably run for 2-3 minutes. Once it is finished, another pull request is created with the generated `README.md`. Merge the pull request and publish the draft release as instructed in the PR.
<details>
<summary>Screenshots (click to show...)</summary>
![](./template/docs/images/6-run-update-workflow-framed.png)
![](./template/docs/images/7-merge-update-pr-framed.png)
</details>
Congrats 🎉 You have created your own best-of list. Now you just need to fill it with some awesome projects by adding them to the `projects.yaml` as described in the [documentation](https://github.com/best-of-lists/best-of-generator#projects). After you added a few projects, you can either just manually rerun the `update-best-of-list` workflow to update the markdown page or wait for a few days until the scheduled action is run automatically. Keep in mind that the automated workflow also creates PRs for every update which you still need to merge manually. You can also start adapting the header and footer templates in `config/header.md` and `config/footer.md` to customize your list.
For more information on the `projects.yaml`, project properties or configuration, please refer to the [best-of-generator documentation](https://github.com/best-of-lists/best-of-generator#documentation).

2
history/2020-12-17_projects.csv
View File

@ -1,2 +0,0 @@
,name,github_id,labels,category,github_url,homepage,license,created_at,updated_at,last_commit_pushed_at,fork_count,open_issue_count,star_count,latest_stable_release_published_at,latest_stable_release_number,release_count,description,projectrank,contributor_count,show,projectrank_placing
0,best-of-ml-python,ml-tooling/best-of-ml-python,['python'],big-data,https://github.com/ml-tooling/best-of-ml-python,https://github.com/ml-tooling/best-of-ml-python,CC-BY-SA-4.0,2020-11-29 19:41:36+00:00,2020-12-17 21:20:37+00:00,2020-12-17 20:36:50+00:00,1,1,35,2020-12-17 21:27:24+00:00,2020.12.17-test.2,4,A ranked list of awesome machine learning python libraries. Updated weekly.,9,1,True,1
1 name github_id labels category github_url homepage license created_at updated_at last_commit_pushed_at fork_count open_issue_count star_count latest_stable_release_published_at latest_stable_release_number release_count description projectrank contributor_count show projectrank_placing
2 0 best-of-ml-python ml-tooling/best-of-ml-python ['python'] big-data https://github.com/ml-tooling/best-of-ml-python https://github.com/ml-tooling/best-of-ml-python CC-BY-SA-4.0 2020-11-29 19:41:36+00:00 2020-12-17 21:20:37+00:00 2020-12-17 20:36:50+00:00 1 1 35 2020-12-17 21:27:24+00:00 2020.12.17-test.2 4 A ranked list of awesome machine learning python libraries. Updated weekly. 9 1 True 1

1
history/2020-12-31_changes.md
View File

@ -1 +0,0 @@
Nothing changed from last update.

2
history/2020-12-31_projects.csv
View File

@ -1,2 +0,0 @@
,name,github_id,labels,category,github_url,homepage,license,created_at,updated_at,last_commit_pushed_at,fork_count,open_issue_count,star_count,latest_stable_release_published_at,latest_stable_release_number,release_count,description,projectrank,contributor_count,show,projectrank_placing
0,best-of-ml-python,ml-tooling/best-of-ml-python,['python'],big-data,https://github.com/ml-tooling/best-of-ml-python,https://github.com/ml-tooling/best-of-ml-python,CC-BY-SA-4.0,2020-11-29 19:41:36,2020-12-31 18:37:36,2020-12-28 10:56:52,1,1,39,2020-12-28 01:48:56,2020.12.28,7,A ranked list of awesome machine learning python libraries. Updated weekly.,9,1,True,1
1 name github_id labels category github_url homepage license created_at updated_at last_commit_pushed_at fork_count open_issue_count star_count latest_stable_release_published_at latest_stable_release_number release_count description projectrank contributor_count show projectrank_placing
2 0 best-of-ml-python ml-tooling/best-of-ml-python ['python'] big-data https://github.com/ml-tooling/best-of-ml-python https://github.com/ml-tooling/best-of-ml-python CC-BY-SA-4.0 2020-11-29 19:41:36 2020-12-31 18:37:36 2020-12-28 10:56:52 1 1 39 2020-12-28 01:48:56 2020.12.28 7 A ranked list of awesome machine learning python libraries. Updated weekly. 9 1 True 1

1
history/2021-01-02_changes.md
View File

@ -1 +0,0 @@
Nothing changed from last update.

3
history/2021-01-02_projects.csv
View File

@ -1,3 +0,0 @@
,name,github_id,labels,category,github_url,homepage,license,created_at,updated_at,last_commit_pushed_at,fork_count,open_issue_count,star_count,latest_stable_release_published_at,latest_stable_release_number,release_count,description,projectrank,contributor_count,show,projectrank_placing
0,best-of-ml-python,ml-tooling/best-of-ml-python,['python'],big-data,https://github.com/ml-tooling/best-of-ml-python,https://github.com/ml-tooling/best-of-ml-python,CC-BY-SA-4.0,2020-11-29 19:41:36,2021-01-01 23:14:34,2021-01-01 23:14:25,1.0,1.0,41,2021-01-01 13:09:20,2021.01.01,8,A ranked list of awesome machine learning python libraries. Updated weekly.,8,1.0,True,1
1,best-of-jupyter,ml-tooling/best-of-jupyter,['python'],big-data,https://github.com/ml-tooling/best-of-jupyter,https://github.com/ml-tooling/best-of-jupyter,CC-BY-SA-4.0,2021-01-01 22:25:48,2021-01-01 23:07:44,2021-01-01 23:07:38,,,1,2021-01-01 22:59:28,2021.01.01,1,"A ranked list of awesome Jupyter Notebook, Hub and Lab projects (extensions, kernels, tools). Updated weekly.",6,,True,3
1 name github_id labels category github_url homepage license created_at updated_at last_commit_pushed_at fork_count open_issue_count star_count latest_stable_release_published_at latest_stable_release_number release_count description projectrank contributor_count show projectrank_placing
2 0 best-of-ml-python ml-tooling/best-of-ml-python ['python'] big-data https://github.com/ml-tooling/best-of-ml-python https://github.com/ml-tooling/best-of-ml-python CC-BY-SA-4.0 2020-11-29 19:41:36 2021-01-01 23:14:34 2021-01-01 23:14:25 1.0 1.0 41 2021-01-01 13:09:20 2021.01.01 8 A ranked list of awesome machine learning python libraries. Updated weekly. 8 1.0 True 1
3 1 best-of-jupyter ml-tooling/best-of-jupyter ['python'] big-data https://github.com/ml-tooling/best-of-jupyter https://github.com/ml-tooling/best-of-jupyter CC-BY-SA-4.0 2021-01-01 22:25:48 2021-01-01 23:07:44 2021-01-01 23:07:38 1 2021-01-01 22:59:28 2021.01.01 1 A ranked list of awesome Jupyter Notebook, Hub and Lab projects (extensions, kernels, tools). Updated weekly. 6 True 3

6
history/2021-01-05_changes.md
View File

@ -1,6 +0,0 @@
## 📈 Trending Up
_Projects that have a higher project-quality score compared to the last update. There might be a variety of reasons, such as increased downloads or code activity._
- <b><a href="https://github.com/ml-tooling/best-of-jupyter">best-of-jupyter</a></b> (🥉7 · ⭐ 6 · 📈) - A ranked list of awesome Jupyter Notebook, Hub and Lab.. <code><img src="https://www.python.org/static/favicon.ico" style="display:inline;" width="13" height="13"></code>

3
history/2021-01-05_projects.csv
View File

@ -1,3 +0,0 @@
,name,github_id,labels,category,github_url,homepage,license,created_at,updated_at,last_commit_pushed_at,fork_count,closed_issue_count,star_count,latest_stable_release_published_at,latest_stable_release_number,release_count,description,projectrank,contributor_count,open_issue_count,show,projectrank_placing,trending
0,best-of-ml-python,ml-tooling/best-of-ml-python,['python'],data-engineering,https://github.com/ml-tooling/best-of-ml-python,https://github.com/ml-tooling/best-of-ml-python,CC-BY-SA-4.0,2020-11-29 19:41:36,2021-01-05 00:03:43,2021-01-05 00:03:37,1.0,4.0,41,2021-01-01 13:09:20,2021.01.01,8,A ranked list of awesome machine learning python libraries. Updated weekly.,8,1.0,1.0,True,1,
1,best-of-jupyter,ml-tooling/best-of-jupyter,['python'],data-engineering,https://github.com/ml-tooling/best-of-jupyter,https://github.com/ml-tooling/best-of-jupyter,CC-BY-SA-4.0,2021-01-01 22:25:48,2021-01-01 23:07:44,2021-01-01 23:07:38,,,6,2021-01-01 22:59:28,2021.01.01,1,"A ranked list of awesome Jupyter Notebook, Hub and Lab projects (extensions, kernels, tools). Updated weekly.",7,,,True,3,1.0
1 name github_id labels category github_url homepage license created_at updated_at last_commit_pushed_at fork_count closed_issue_count star_count latest_stable_release_published_at latest_stable_release_number release_count description projectrank contributor_count open_issue_count show projectrank_placing trending
2 0 best-of-ml-python ml-tooling/best-of-ml-python ['python'] data-engineering https://github.com/ml-tooling/best-of-ml-python https://github.com/ml-tooling/best-of-ml-python CC-BY-SA-4.0 2020-11-29 19:41:36 2021-01-05 00:03:43 2021-01-05 00:03:37 1.0 4.0 41 2021-01-01 13:09:20 2021.01.01 8 A ranked list of awesome machine learning python libraries. Updated weekly. 8 1.0 1.0 True 1
3 1 best-of-jupyter ml-tooling/best-of-jupyter ['python'] data-engineering https://github.com/ml-tooling/best-of-jupyter https://github.com/ml-tooling/best-of-jupyter CC-BY-SA-4.0 2021-01-01 22:25:48 2021-01-01 23:07:44 2021-01-01 23:07:38 6 2021-01-01 22:59:28 2021.01.01 1 A ranked list of awesome Jupyter Notebook, Hub and Lab projects (extensions, kernels, tools). Updated weekly. 7 True 3 1.0

6
latest-changes.md
View File

@ -1,6 +0,0 @@
## 📈 Trending Up
_Projects that have a higher project-quality score compared to the last update. There might be a variety of reasons, such as increased downloads or code activity._
- <b><a href="https://github.com/ml-tooling/best-of-jupyter">best-of-jupyter</a></b> (🥉7 · ⭐ 6 · 📈) - A ranked list of awesome Jupyter Notebook, Hub and Lab.. <code><img src="https://www.python.org/static/favicon.ico" style="display:inline;" width="13" height="13"></code>

37
projects.yaml
View File

@ -1,36 +1,19 @@
configuration:
min_stars: 0
min_projectrank: 0
require_github: True
allowed_licenses: ["all"]
hide_project_license: True
markdown_header_file: "config/header.md"
markdown_footer_file: "config/footer.md"
projects_history_folder: "history"
categories:
- category: "data-engineering"
title: "Machine Learning & Data Engineering"
subtitle: "Best-of lists about machine learning, data engieering, data science, or other topics related to big data."
- category: "web-dev"
title: "Web Development"
subtitle: "Best-of lists about react, vue, angular, html5, css, or other topics related to web development."
# - category: "data-engineering"
# title: "Machine Learning & Data Engineering"
# subtitle: "Best-of lists about machine learning, data engieering, data science, or other topics related to big data."
labels:
- label: "python"
image: "https://www.python.org/static/favicon.ico"
description: "Best-of list with Python projects"
# - label: "python"
# image: "https://www.python.org/static/favicon.ico"
# description: "Best-of list with Python projects"
projects:
- name: best-of-ml-python
github_id: ml-tooling/best-of-ml-python
labels: ["python"]
category: "data-engineering"
- name: best-of-jupyter
github_id: ml-tooling/best-of-jupyter
labels: ["python"]
category: "data-engineering"
- name: best-of-web-python
github_id: ml-tooling/best-of-web-python
labels: ["python"]
category: "web-dev"
# - name: best-of-ml-python
# github_id: ml-tooling/best-of-ml-python
# labels: ["python"]
# category: "data-engineering"

118
template/CONTRIBUTING.md
View File

@ -1,118 +0,0 @@
<!-- markdownlint-disable MD024 -->
# Contribution Guidelines
Thanks for your interest in contributing to our project. This page will give you a quick overview of how things are organized and, most importantly, how to get involved. Everyone is welcome to contribute, and we value everybody's contribution.
## Table of contents
1. [Add a project](#add-a-project)
2. [Update a project](#update-a-project)
3. [Improve metadata collection](#improve-metadata-collection)
4. [Improve markdown generation](#improve-markdown-generation)
5. [Create your own best-of list](#improve-markdown-generation)
6. [Code of conduct](#code-of-conduct)
## Add a project
If you like to suggest or add a project, choose one of the following ways:
- Suggest a project by opening an issue: Please use the suggest project template from the [issue page](https://github.com/best-of-lists/best-of-template/issues/new/choose) and fill in the requested information.
- Add a project by modifying the [projects.yaml](https://github.com/best-of-lists/best-of-template/blob/main/projects.yaml) and submitting a pull request with your addition. This can also be done directly via the [Github UI](https://github.com/best-of-lists/best-of-template/edit/main/projects.yaml).
Before opening an issue or pull request, please ensure that you adhere to the following guidelines:
- Please make sure that the project was not already added or suggested to this best-of list. You can ensure this by searching the projects.yaml, the Readme, and the issue list.
- Add the project to the `projects.yaml` and never to the `README.md` file directly. Use the yaml format and the properties documented in the [project properties](#project-properties) section below to add a new project, for example:
```yaml
- name: Tensorflow
github_id: tensorflow/tensorflow
pypi_id: tensorflow
conda_id: tensorflow
labels: ["tensorflow"]
category: ml-frameworks
```
- Please create an individual issue or pull request for each project.
- Please use the following title format for the issue or pull request: `Add project: project-name`.
- If a project doesn't fit into any of the pre-existing categories, it should go under the `Others` category by not assigning any category. You can also suggest a new category via the add or update category template on the [issue page](https://github.com/best-of-lists/best-of-template/issues/new/choose).
## Update a project
If you like to suggest or contribute a project update, choose one of the following ways:
- Suggest a project update by opening an issue: Please use the update project template from the [issue page](https://github.com/best-of-lists/best-of-template/issues/new/choose) and fill in the requested information.
- Update a project by modifying the [projects.yaml](https://github.com/best-of-lists/best-of-template/blob/main/projects.yaml) and submitting a pull request with your changes. This can also be done directly via the [Github UI](https://github.com/best-of-lists/best-of-template/edit/main/projects.yaml).
Before opening an issue or pull request, please ensure that you adhere to the following guidelines:
- Only update the project in the `projects.yaml` and never to the `README.md` file directly. Use the yaml format and the properties documented in the [project properties](#project-properties) section below to update a new project.
- Please create an individual issue or pull request for each project.
- Please use the following title format for the issue or pull request: `Update project: project-name`.
## Project properties
<table>
<tr>
<th>Property</th>
<th>Description</th>
</tr>
<tr>
<td><code>name</code></td>
<td>Name of the project. This name is required to be unique on the best-of list.</td>
</tr>
<tr>
<td><code>github_id</code></td>
<td>Github ID of the project based on user or organization and the repository name, e.g. <code>best-of-lists/best-of-generator</code>.</td>
</tr>
<tr>
<td colspan="2"><b>Optional Properties:</b></td>
</tr>
<tr>
<td><code>category</code></td>
<td>Category that this project is most related to. You can find all available category IDs in the <code>projects.yaml</code> file. The project will be sorted into the <code>Others</code> category if no category is provided.</td>
</tr>
<tr>
<td><code>labels</code></td>
<td>List of labels that this project is related to. You can find all available label IDs in the <code>projects.yaml</code> file.</td>
</tr>
<tr>
<td colspan="2"><b>Supported Package Managers:</b></td>
</tr>
<tr>
<td><code>pypi_id</code></td>
<td>Project ID on the python package index (<a href="https://pypi.org">PyPi</a>).</td>
</tr>
<tr>
<td><code>conda_id</code></td>
<td>Project ID on the <a href="https://anaconda.org">conda package manager</a>. If the main package is provided on a different channel, prefix the ID with the given channel: e.g. <code>conda-forge/tensorflow</code></td>
</tr>
<tr>
<td><code>npm_id</code></td>
<td>Project ID on the Node package manager (<a href="https://www.npmjs.com">npm</a>).</td>
</tr>
<tr>
<td><code>dockerhub_id</code></td>
<td>Project ID on the <a href="https://hub.docker.com">Docker Hub container registry</a>. </td>
</tr>
<tr>
<td><code>maven_id</code></td>
<td>Artifact ID on <a href="https://mvnrepository.com">Maven central</a>, e.g. <code>org.apache.flink:flink-core</code>. </td>
</tr>
</table>
Please refer to the [best-of-generator documentation](https://github.com/best-of-lists/best-of-generator#project-properties) for a complete and up-to-date list of supported project properties.
## Improve metadata collection
If you like to contribute to or share suggestions regarding the project metadata collection, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository.
## Improve markdown generation
If you like to contribute to or share suggestions regarding the markdown generation, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository.
## Create your own best-of list
If you want to create your own best-of list, we strongly recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md). With this guide, it will only take about 3 minutes to get you started. It is already set-up to automatically run the best-of generator via our Github Action and includes other useful template files.
## Code of Conduct
All members of the project community must abide by the [Contributor Covenant, version 2.0](./.github/CODE_OF_CONDUCT.md). Only by respecting each other we can develop a productive, collaborative community. Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting a project maintainer.

BIN
template/docs/images/1-use-template-repo-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 481 KiB

BIN
template/docs/images/2-create-new-repo-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 398 KiB

BIN
template/docs/images/3-run-setup-workflow-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 381 KiB

BIN
template/docs/images/4-select-setup-pr-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 325 KiB

BIN
template/docs/images/5-merge-setup-pr-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 490 KiB

BIN
template/docs/images/6-run-update-workflow-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 391 KiB

BIN
template/docs/images/7-merge-update-pr-framed.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 324 KiB

21
template/footer.md
View File

@ -1,21 +0,0 @@
---
## Related Resources
- [**Best-of lists**](https://best-of.org): Discover other best-of lists with awesome open-source projects on all kinds of topics.
## Contribution
Contributions are encouraged and always welcome! If you like to add or update projects, choose one of the following ways:
- Open an issue by selecting one of the provided categories from the [issue page](https://github.com/best-of-lists/best-of-template/issues/new/choose) and fill in the requested information.
- Modify the [projects.yaml](https://github.com/best-of-lists/best-of-template/blob/main/projects.yaml) with your additions or changes, and submit a pull request. This can also be done directly via the [Github UI](https://github.com/best-of-lists/best-of-template/edit/main/projects.yaml).
If you like to contribute to or share suggestions regarding the project metadata collection or markdown generation, please refer to the [best-of-generator](https://github.com/best-of-lists/best-of-generator) repository. If you like to create your own best-of list, we recommend to follow [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).
For more information on how to add or update projects, please read the [contribution guidelines](https://github.com/best-of-lists/best-of-template/blob/main/CONTRIBUTING.md). By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/best-of-lists/best-of-template/blob/main/.github/CODE_OF_CONDUCT.md).
## License
[![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/by-sa.svg)](https://creativecommons.org/licenses/by-sa/4.0/)

22
template/header.md
View File

@ -1,22 +0,0 @@
<!-- markdownlint-disable -->
<h1 align="center">
best-of-template
<br>
</h1>
<p align="center">
<strong>🏆&nbsp; A ranked list of awesome projects. Updated weekly.</strong>
</p>
<p align="center">
<a href="https://best-of.org" title="Best-of Badge"><img src="http://bit.ly/3o3EHNN"></a>
<a href="#Contents" title="Project Count"><img src="https://img.shields.io/badge/projects-{project_count}-blue.svg?color=5ac4bf"></a>
<a href="#Contribution" title="Contributions are welcome"><img src="https://img.shields.io/badge/contributions-welcome-green.svg"></a>
<a href="https://github.com/best-of-lists/best-of-template/releases" title="Best-of Updates"><img src="https://img.shields.io/github/release-date/best-of-lists/best-of-template?color=green&label=updated"></a>
<a href="https://bestoflists.substack.com/subscribe" title="Subscribe for updates"><img src="http://bit.ly/2Md9rxM"></a>
<a href="https://twitter.com/best_of_lists" title="Best-of on Twitter"><img src="https://img.shields.io/twitter/follow/best_of_lists.svg?style=social&label=Follow"></a>
</p>
This curated list contains {project_count} awesome open-source projects with a total of {stars_count} stars grouped into {category_count} categories. All projects are ranked by a project-quality score, which is calculated based on various metrics automatically collected from GitHub and different package managers. If you like to add or update projects, feel free to open an [issue](https://github.com/best-of-lists/best-of-template/issues/new/choose), submit a [pull request](https://github.com/best-of-lists/best-of-template/pulls), or directly edit the [projects.yaml](https://github.com/best-of-lists/best-of-template/edit/main/projects.yaml). Contributions are very welcome!
> 🧙‍♂️ Create your own best-of list in just 3 minutes with [this guide](https://github.com/best-of-lists/best-of/blob/main/create-best-of-list.md).

19
template/projects.yaml
View File

@ -1,19 +0,0 @@
configuration:
markdown_header_file: "config/header.md"
markdown_footer_file: "config/footer.md"
categories:
# - category: "data-engineering"
# title: "Machine Learning & Data Engineering"
# subtitle: "Best-of lists about machine learning, data engieering, data science, or other topics related to big data."
labels:
# - label: "python"
# image: "https://www.python.org/static/favicon.ico"
# description: "Best-of list with Python projects"
projects:
# - name: best-of-ml-python
# github_id: ml-tooling/best-of-ml-python
# labels: ["python"]
# category: "data-engineering"