Merge branch 'master' of https://github.com/vinta/awesome-python into add-pyvips

.github/ISSUE_TEMPLATE/add-new-library-to-this-list.md

@@ -0,0 +1,10 @@
+---
+name: Add new library to this list
+about: ''
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Please open a Pull Request instead.**

.github/ISSUE_TEMPLATE/add-xxx.md

@@ -0,0 +1,10 @@
+---
+name: Add XXX
+about: Add new item to the list
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Please open a Pull Request instead.**

.github/PULL_REQUEST_TEMPLATE.md

@@ -8,4 +8,4 @@ Enumerate comparisons.
 
 --
 
-Anyone who agrees with this pull request could vote for it by adding a :+1: to it, and usually, the maintainer will merge it when votes reach **20**.
+Anyone who agrees with this pull request could submit an *Approve* review to it.

.travis.yml

@@ -1,10 +1,17 @@
-language: ruby
+language: python
 
-rvm:
-  - 2.2
-
-before_script:
-  - gem install awesome_bot
+python:
+  - "3.6"
 
 script:
-  - awesome_bot README.md --allow-dupe --white-list pyparsing,graphviz.org
+  - cp README.md docs/index.md
+  - mkdocs build
+
+deploy:
+  provider: pages
+  local-dir: site
+  skip-cleanup: true
+  keep-history: true
+  github-token: $GITHUB_TOKEN
+  on:
+    branch: master

CONTRIBUTING.md

@@ -2,16 +2,19 @@
 
 Your contributions are always welcome!
 
-## Guidelines
+## Guideline
 
 * Add one link per Pull Request.
+    * Make sure the PR title is in the format of `Add project-name`.
+    * Write down the reason why the library is awesome.
 * Add the link: `* [project-name](http://example.com/) - A short description ends with a period.`
-    * Keep descriptions concise.
+    * Keep descriptions concise and **short**.
 * Add a section if needed.
     * Add the section description.
     * Add the section title to Table of Contents.
-* Search previous suggestions before making a new one, as yours may be a duplicate.
+* Search previous Pull Requests or Issues before making a new one, as yours may be a duplicate.
 * Don't mention `Python` in the description as it's implied.
 * Check your spelling and grammar.
 * Remove any trailing whitespace.
-* Send a Pull Request with the reason why the library is awesome.
+
+Just a gentle reminder: **Try not to submit your own project. Instead, wait for someone finds it useful and submits it for you.**

Makefile

@@ -1,6 +1,5 @@
 site_install:
-	pip install mkdocs==0.16.3
-	pip install mkdocs-material==1.12.2
+	pip install -r requirements.txt
 
 site_link:
 	ln -sf $(CURDIR)/README.md $(CURDIR)/docs/index.md
@@ -8,5 +7,8 @@ site_link:
 site_preview: site_link
 	mkdocs serve
 
+site_build: site_link
+	mkdocs build
+
 site_deploy: site_link
 	mkdocs gh-deploy --clean

docs/css/extra.css

@@ -1,37 +1,9 @@
-.bs-sidebar.well {
-    /* margin-bottom: 0; */
-}
-
-.bs-sidebar .nav > li > a:hover,
-.bs-sidebar .nav > li > a:focus {
-    border: none;
-    border-left: 2px solid;
-}
-
-.bs-sidebar .nav > .active > a,
-.bs-sidebar .nav > .active:hover > a,
-.bs-sidebar .nav > .active:focus > a {
-    border: none;
-    border-left: 2px solid;
-}
-
-@media (min-width: 992px) {
-    .bs-sidebar.affix {
-        /* top: 60px; */
-        /* bottom: 0px; */
-        top: 80px;
-        bottom: 23px;
-        overflow: auto;
-    }
-}
-
-@media (min-width: 1200px) {
-    .bs-sidebar.affix-bottom,
-    .bs-sidebar.affix {
-        width: 280px;
-    }
-
-    .container > .col-md-9 {
-        padding-left: 40px;
+@media (min-width: 960px) {
+    html {
+        scroll-behavior: smooth;
+    }
+    
+    .md-content__inner > ul:nth-child(5) {
+        display: none;
     }
 }

mkdocs.yml

@@ -1,27 +1,26 @@
-site_name: 'Awesome Python'
-site_url: 'https://awesome-python.com'
-site_description: 'A curated list of awesome Python frameworks, libraries and software'
-site_author: 'Vinta Chen'
-repo_name: 'vinta/awesome-python'
-repo_url: 'https://github.com/vinta/awesome-python'
-theme: 'material'
-extra:
-  feature:
-    tabs: false
+site_name: Awesome Python
+site_url: https://awesome-python.com
+site_description: A curated list of awesome Python frameworks, libraries and software
+site_author: Vinta Chen
+repo_name: vinta/awesome-python
+repo_url: https://github.com/vinta/awesome-python
+theme:
+  name: material
   palette:
-    primary: 'red'
-    accent: 'pink'
+    primary: red
+    accent: pink
+extra:
   social:
-    - type: 'github'
-      link: 'https://github.com/vinta'
-    - type: 'twitter'
-      link: 'https://twitter.com/vinta'
-    - type: 'linkedin'
-      link: 'https://www.linkedin.com/in/vinta'
+    - type: github
+      link: https://github.com/vinta
+    - type: twitter
+      link: https://twitter.com/vinta
+    - type: linkedin
+      link: https://www.linkedin.com/in/vinta
 google_analytics:
-  - 'UA-510626-7'
-  - 'auto'
+  - UA-510626-7
+  - auto
 extra_css:
     - css/extra.css
-pages:
+nav:
   - "Life is short, you need Python.": "index.md"

requirements.txt

@@ -0,0 +1,2 @@
+mkdocs==1.0.4
+mkdocs-material==4.0.2

sort.py

@@ -29,10 +29,10 @@ def sort_blocks():
 
     # Sorting the libraries
     inner_blocks = sorted(blocks[0].split('##'))
-    for i in range(1 , len(inner_blocks)):
+    for i in range(1, len(inner_blocks)):
         if inner_blocks[i][0] != '#':
             inner_blocks[i] = '##' + inner_blocks[i]
-    inner_blocks=''.join(inner_blocks)
+    inner_blocks = ''.join(inner_blocks)
 
     # Replacing the non-sorted libraries by the sorted ones and gathering all at the final_README file
     blocks[0] = inner_blocks
@@ -68,7 +68,9 @@ def main():
 
     with open('README.md', 'w+') as sorted_file:
         # Then all of the blocks are sorted individually
-        blocks = [''.join(sorted(block, key=lambda s: s.lower())) for block in blocks]
+        blocks = [
+            ''.join(sorted(block, key=str.lower)) for block in blocks
+        ]
         # And the result is written back to README.md
         sorted_file.write(''.join(blocks))