|
1 | 1 | # Practice Python Projects |
2 | 2 |
|
3 | | -This is a **work-in-progress** book on basic to intermediate level Python projects. |
4 | | - |
5 | | -`Python version 3.9` and `GNU bash version 5.0.17` are used for the projects discussed in this book. |
6 | | - |
7 | | -<br> |
8 | | - |
9 | | -## Project list |
| 3 | +This book presents five beginner to intermediate level projects inspired by real world use cases: |
10 | 4 |
|
11 | 5 | * [Enhance your CLI experience with a custom Python calculator](https://learnbyexample.github.io/practice_python_projects/calculator/calculator.html) |
12 | 6 | * [Analyzing poll data from a Reddit comment thread](https://learnbyexample.github.io/practice_python_projects/poll_data_analysis/poll_data_analysis.html) |
13 | 7 | * [Finding typos in plain text and Markdown files](https://learnbyexample.github.io/practice_python_projects/find_typos/find_typos.html) |
14 | 8 | * [Creating a GUI for evaluating multiple choice questions](https://learnbyexample.github.io/practice_python_projects/mcq/multiple_choice_questions.html) |
15 | 9 | * [Square Tic Tac Toe — creating a GUI game with AI](https://learnbyexample.github.io/practice_python_projects/square_tic_tac_toe/square_tic_tac_toe.html) |
16 | 10 |
|
| 11 | +To test your understanding and to make it more interesting, you'll also be presented with exercises at the end of each project. Resources for further exploration are also mentioned throughout the book. |
| 12 | + |
| 13 | +<p align="center"> |
| 14 | + <img src="./images/py_projects.png" width="320px" height="400px" /> |
| 15 | +</p> |
| 16 | + |
| 17 | +See [Version_changes.md](./Version_changes.md) to keep track of changes made to the book. |
| 18 | + |
17 | 19 | <br> |
18 | 20 |
|
19 | | -## E-book |
| 21 | +# E-book |
| 22 | + |
| 23 | +TODO: PDF/EPUB versions and sample chapters |
20 | 24 |
|
21 | | -TODO: PDF/EPUB versions |
| 25 | +The book can also be [viewed as a single markdown file in this repo](./practice_python_projects.md). See my blogpost on [generating pdf/epub from markdown using pandoc](https://learnbyexample.github.io/customizing-pandoc/) if you are interested in the ebook creation process. |
22 | 26 |
|
23 | 27 | For web version of the book, visit https://learnbyexample.github.io/practice_python_projects/ |
24 | 28 |
|
25 | 29 | <br> |
26 | 30 |
|
27 | | -## Feedback and Contributing |
| 31 | +# Feedback and Contributing |
28 | 32 |
|
29 | 33 | Please open an [issue](https://github.com/learnbyexample/practice_python_projects/issues) if you spot any typo/errors. |
30 | 34 |
|
31 | | -**Please do not submit pull requests.** |
| 35 | +:warning: :warning: Please DO NOT submit pull requests. Main reason being any modification requires changes in multiple places. |
32 | 36 |
|
33 | 37 | I'd also highly appreciate your feedback about the book. |
34 | 38 |
|
35 | 39 | Twitter: https://twitter.com/learn_byexample |
36 | 40 |
|
37 | 41 | <br> |
38 | 42 |
|
39 | | -## Acknowledgements |
| 43 | +# Acknowledgements |
40 | 44 |
|
41 | 45 | * [Python documentation](https://docs.python.org/3/) — manuals and tutorials |
42 | | -* [/r/learnpython/](https://www.reddit.com/r/learnpython/) and [/r/Python/](https://www.reddit.com/r/Python/) — helpful forums for beginners and experienced programmers |
| 46 | +* [/r/learnpython/](https://www.reddit.com/r/learnpython/) and [/r/Python/](https://www.reddit.com/r/Python/) — helpful forums for Python programmers |
43 | 47 | * [stackoverflow](https://stackoverflow.com/) and [unix.stackexchange](https://unix.stackexchange.com/) — for getting answers on Python, Bash and other pertinent questions |
44 | 48 | * [tex.stackexchange](https://tex.stackexchange.com/) — for help on [pandoc](https://github.com/jgm/pandoc/) and `tex` related questions |
45 | | -* [Warning](https://commons.wikimedia.org/wiki/File:Warning_icon.svg) and [Info](https://commons.wikimedia.org/wiki/File:Info_icon_002.svg) icons by [Amada44](https://commons.wikimedia.org/wiki/User:Amada44) under public domain |
46 | | -* [Inkscape](https://inkscape.org/) for favicon |
| 49 | +* Cover image: |
| 50 | + * [Programming](https://illlustrations.co/static/69eb724751d1cc0977d48fcc5f0d8326/day93-programing.svg) illustration by [Vijay Verma](https://illlustrations.co/license/) |
| 51 | + * [command-window](https://www.svgrepo.com/svg/82541/command-window), [chart](https://www.svgrepo.com/svg/143589/chart), [game](https://www.svgrepo.com/svg/119527/game), [network](https://www.svgrepo.com/svg/130261/network), [question](https://www.svgrepo.com/svg/245858/question) and [snake](https://www.svgrepo.com/svg/70937/snake) icons from [svgrepo.com](https://www.svgrepo.com/page/licensing/) |
| 52 | + * [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) — background and title/author text |
| 53 | +* [Warning](https://commons.wikimedia.org/wiki/File:Warning_icon.svg) and [Info](https://commons.wikimedia.org/wiki/File:Info_icon_002.svg) icons by [Amada44](https://commons.wikimedia.org/wiki/User:Amada44) |
47 | 54 | * [pngquant](https://pngquant.org/) and [svgcleaner](https://github.com/RazrFalcon/svgcleaner) for optimizing images |
| 55 | +* [Inkscape](https://inkscape.org/) for favicon |
48 | 56 | * [mdBook](https://github.com/rust-lang/mdBook) — for web version of the book |
49 | 57 | * [mdBook-pagetoc](https://github.com/JorelAli/mdBook-pagetoc) — for adding table of contents for each page |
50 | 58 | * [minify-html](https://github.com/wilsonzlin/minify-html) — for minifying html files |
51 | 59 |
|
52 | 60 | <br> |
53 | 61 |
|
54 | | -## License |
| 62 | +# License |
| 63 | + |
| 64 | +The book is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/) |
55 | 65 |
|
56 | | -This work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/) |
| 66 | +The code snippets are licensed under MIT, see [LICENSE](./LICENSE) file |
57 | 67 |
|
58 | | -Code snippets are available under [MIT License](https://github.com/learnbyexample/practice_python_projects/blob/main/LICENSE) |
|
0 commit comments