Merge pull request #13 from talkpython/master

Refresh a few of the docs and a small bit of the code for recent changes

Author: mikeckennedy

Diff for: README.md

@@ -2,6 +2,9 @@
 
 [![](https://raw.githubusercontent.com/mikeckennedy/mongodb-for-python-for-developers/master/readme_resources/mongo-course-sm.jpg)](https://training.talkpython.fm/courses/explore_mongodb_for_python_developers_course/mongodb-for-python-for-developers-featuring-orm-odm-mongoengine)
 
+## Downloading tools
+
+See the [tools-downloads.md](./tools-downloads.md) file for locating the latest tools and apps for this course.
 
 ## Course Summary
 

Diff for: data/README.md

@@ -12,4 +12,4 @@ If you are using an authenticated connection on another server, this more verbos
 mongorestore -u admin -p <mypassword> --authenticationDatabase 'admin' --ssl --host <my_hostname> --sslCAFile mongod.crt --sslPEMKeyFile mongod.pem --drop --db DATABASE /path/to/unziped/dir
 ```
 
-Note this references this two MongoDB certifications for connecting. You can altermantively use the `--sslAllowInvalidCertificates` flag to ignore them.
+Note this references this two MongoDB certifications for connecting. You can alternatively use the `--sslAllowInvalidCertificates` flag to ignore them.

Diff for: requirements.in

@@ -0,0 +1,4 @@
+pymongo
+mongoengine
+faker
+python-dateutil # for DateTimeField parsing

Diff for: requirements.txt

@@ -0,0 +1,20 @@
+#
+# This file is autogenerated by pip-compile with python 3.10
+# To update, run:
+#
+#    pip-compile requirements.in
+#
+faker==15.0.0
+    # via -r requirements.in
+mongoengine==0.24.2
+    # via -r requirements.in
+pymongo==4.2.0
+    # via
+    #   -r requirements.in
+    #   mongoengine
+python-dateutil==2.8.2
+    # via
+    #   -r requirements.in
+    #   faker
+six==1.16.0
+    # via python-dateutil

Diff for: src/05_pymongo/play_around_pymongo/program.py

@@ -5,12 +5,10 @@
 
 db = client.the_small_bookstore
 
-# NOTE: In the video we use db.books.count(), it's been deprecated for more explicit
-# versions. See
-# https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.estimated_document_count
+# NOTE: In the video we use db.books.count(), it's been deprecated for more explicit versions. See
+# https://pymongo.readthedocs.io/en/stable/api/pymongo/collection.html#pymongo.collection.Collection.count_documents
 # for details
-
-if db.books.estimated_document_count() == 0:
+if db.books.count_documents({}) == 0:
     print("Inserting data")
     # insert some data...
     r = db.books.insert_one({'title': 'The third book', 'isbn': '73738584947384'})
@@ -24,7 +22,13 @@
 # # print(book, type(book))
 # # book['favorited_by'] = []
 # book['favorited_by'].append(100)
+
+# Updated from recording, was:
 # db.books.update({'_id': book.get('_id')}, book)
+#
+# pymongo now requires update_one with the $set operator:
+# db.books.update_one({'_id': book.get('_id')}, {"$set": book})
+
 # book = db.books.find_one({'isbn': '73738584947384'})
 # print(book)
 

Diff for: src/07_mongoengine/service_central_starter/.idea/dictionaries/screencaster.xml

@@ -21,4 +21,5 @@ def main():
     print("Each car has an average of {:.2f} service records.".format(service_histories / len(cars)))
 
 
-main()
+if __name__ == '__main__':
+    main()

Diff for: src/08_perf/big_dealership/db_stats.py

@@ -10,7 +10,7 @@ def timed(msg, func):
     func()
 
     dt = datetime.now() - t0
-    print("{} Time: {:,.3f} ms".format(msg, dt.total_seconds() * 1000.0), flush=True)
+    print("{} Time: {:,.0f} ms".format(msg, dt.total_seconds() * 1000.0), flush=True)
 
 
 mongo_setup.init()

Diff for: src/08_perf/big_dealership/q_and_a.py

@@ -21,4 +21,5 @@ def main():
     print("Each car has an average of {:.2f} service records.".format(service_histories / len(cars)))
 
 
-main()
+if __name__ == '__main__':
+    main()

Diff for: src/08_perf/starter_big_dealership/db_stats.py

@@ -10,7 +10,7 @@ def timed(msg, func):
     func()
 
     dt = datetime.now() - t0
-    print("{} Time: {:,.3f} ms".format(msg, dt.total_seconds() * 1000.0), flush=True)
+    print("{} Time: {:,.0f} ms".format(msg, dt.total_seconds() * 1000.0), flush=True)
 
 
 mongo_setup.init()

Diff for: src/08_perf/starter_big_dealership/q_and_a.py

@@ -0,0 +1,21 @@
+# Tools Downloads
+
+Since the recording, some tool's download locations have changed. Use this list to locate the newest edition
+or find the new location of that tool.
+
+# mongo binary (mongo.exe on Windows)
+
+The mongo application/shell has been deprecated and a slightly better version called `mongosh` replaces it.
+`mongosh` is largely the same other than the command to run it now is `mongosh` rather than `mongo` of course.
+
+You can download `mongosh` as part of the [**MongoDB Shell**](https://www.mongodb.com/try/download/shell) 
+download from their website.
+
+# Robomongo
+
+Robomongo was acquired by Studio3T. It's official name was changed to Robo3T and just recently the download
+location was removed from the website. But you can still download the exact same file from the GitHub repository:
+
+https://github.com/Studio3T/robomongo/releases
+
+(Open source for the win). Find your platform's version there and download it.