Skip to content

Commit d451f31

Browse files
added book related files
1 parent fa1f1b1 commit d451f31

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+4236
-18
lines changed

README.md

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,67 @@
11
# Practice Python Projects
22

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:
104

115
* [Enhance your CLI experience with a custom Python calculator](https://learnbyexample.github.io/practice_python_projects/calculator/calculator.html)
126
* [Analyzing poll data from a Reddit comment thread](https://learnbyexample.github.io/practice_python_projects/poll_data_analysis/poll_data_analysis.html)
137
* [Finding typos in plain text and Markdown files](https://learnbyexample.github.io/practice_python_projects/find_typos/find_typos.html)
148
* [Creating a GUI for evaluating multiple choice questions](https://learnbyexample.github.io/practice_python_projects/mcq/multiple_choice_questions.html)
159
* [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)
1610

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+
1719
<br>
1820

19-
## E-book
21+
# E-book
22+
23+
TODO: PDF/EPUB versions and sample chapters
2024

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.
2226

2327
For web version of the book, visit https://learnbyexample.github.io/practice_python_projects/
2428

2529
<br>
2630

27-
## Feedback and Contributing
31+
# Feedback and Contributing
2832

2933
Please open an [issue](https://github.com/learnbyexample/practice_python_projects/issues) if you spot any typo/errors.
3034

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.
3236

3337
I'd also highly appreciate your feedback about the book.
3438

3539
Twitter: https://twitter.com/learn_byexample
3640

3741
<br>
3842

39-
## Acknowledgements
43+
# Acknowledgements
4044

4145
* [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
4347
* [stackoverflow](https://stackoverflow.com/) and [unix.stackexchange](https://unix.stackexchange.com/) — for getting answers on Python, Bash and other pertinent questions
4448
* [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)
4754
* [pngquant](https://pngquant.org/) and [svgcleaner](https://github.com/RazrFalcon/svgcleaner) for optimizing images
55+
* [Inkscape](https://inkscape.org/) for favicon
4856
* [mdBook](https://github.com/rust-lang/mdBook) — for web version of the book
4957
* [mdBook-pagetoc](https://github.com/JorelAli/mdBook-pagetoc) — for adding table of contents for each page
5058
* [minify-html](https://github.com/wilsonzlin/minify-html) — for minifying html files
5159

5260
<br>
5361

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/)
5565

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
5767

58-
Code snippets are available under [MIT License](https://github.com/learnbyexample/practice_python_projects/blob/main/LICENSE)

Version_changes.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
<br>
2+
3+
### 1.0
4+
5+
* First version
6+

images/info.svg

Lines changed: 1 addition & 0 deletions
Loading

images/mcq/button_click.png

1.6 KB
Loading

images/mcq/buttons_and_labels.png

2.19 KB
Loading
2.27 KB
Loading

images/mcq/frame.png

1.82 KB
Loading
6.35 KB
Loading

images/mcq/mcq_gui_final_frame.png

2.43 KB
Loading
6.37 KB
Loading

0 commit comments

Comments
 (0)