หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

ใบสมัครเตือนวันเกิด


โปรแกรมตรวจสอบว่าบุคคลมีวันเกิดในหนึ่งสัปดาห์หรือไม่และเลือกส่งการแจ้งเตือนไปยังส่วนที่เหลือของกลุ่ม มันเกี่ยวข้องกับฟังก์ชันที่จำเป็นสำหรับการตรวจสอบอินพุตและการส่งอีเมล ที่เก็บนี้มี 2 โมดูล ที่ bdayReminder.py เกี่ยวข้องกับฟังก์ชันเหล่านี้ในขณะที่การทดสอบการทดสอบแพ็คเกจ โปรดดูข้อกำหนดสำหรับการนำเข้าไลบรารีแพ็คเกจและโมดูลเสริมก่อนที่จะดูการใช้แอพหรือฟังก์ชั่นการทดสอบงาน cron และสาขาอื่น ๆ

สารบัญ

  • สารบัญ
  • ความต้องการ
  • ตัวแปรสภาพแวดล้อม
  • การรับรองความถูกต้อง
  • การใช้งาน
  • ฟังก์ชั่น
  • ชุดข้อมูล
  • การทดสอบ
  • ข้อผิดพลาด
  • งาน cron
  • สาธารณะ
  • โลโก้
  • ใบอนุญาต

ความต้องการ

Python 3.9.12 จำเป็นต้องใช้โมดูลของแพ็คเกจอย่างถูกต้องไลบรารีที่นำเข้าและฟังก์ชั่นที่กำหนดไว้ การนำเข้าห้องสมุดหลายแห่งเช่น Dotnet, pytest เพื่อชื่อไม่กี่ก็จำเป็นเช่นกัน พบเวอร์ชันที่จำเป็นบางรุ่นที่นี่ในขณะที่รุ่นที่ไม่ได้กล่าวถึงมาพร้อมกับรุ่น Python ที่ใช้แล้ว ตรวจสอบตัวแปรสภาพแวดล้อมและการรับรองความถูกต้องก่อนดำเนินการต่อไป สำหรับการใช้งานโปรแกรมที่เหมาะสมคุณอาจต้องใช้ Python3 แทนที่จะเป็น Python ที่เสนอดังที่แสดงในการใช้งาน 1


1 Python หรือ Python3 ขึ้นอยู่กับวิธีการติดตั้ง Python บนเครื่องของคุณ

ตัวแปรสภาพแวดล้อม

เพื่อให้สามารถส่งอีเมลคุณจะต้องตั้งค่าตัวแปรสภาพแวดล้อม หากต้องการทำสิ่งนี้ในเครื่องโปรดสร้างไฟล์ .env และเพิ่มตัวแปร env สองตัวลงในนั้นด้วยค่าที่ถูกต้องเช่นนี้: 1 

 USR=<youremail>
PSW=<yourpassword> or <token>


1 หากคุณจะส่งจาก Gmail จากนั้นเพื่อตั้งค่ารหัสผ่านตัวแปรสภาพแวดล้อมที่เหมาะสมคุณจะต้องสร้างโทเค็น ข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้ภายใต้ส่วนการตรวจสอบ

การรับรองความถูกต้อง

เพื่อให้สามารถส่งอีเมลหลังจากตั้งค่าอีเมล Gmail ที่ตัวแปรสภาพแวดล้อมคุณจะต้องสร้างโทเค็น รายละเอียดเกี่ยวกับวิธีการทำสามารถพบได้ที่นี่

การใช้งาน

หลังจากตรงตามข้อกำหนดแล้วแพ็คเกจแอพจะถูกตั้งค่าที่ไดเรกทอรีและเทอร์มินัลของคุณคุณมีสี่ตัวเลือก 1,2,3 :

  1. เพื่อให้ตัวเองเรียกใช้ การตรวจสอบ หรือ ตรวจสอบและส่ง ไฟล์ Python และไฟล์ข้อมูลเป็นอาร์กิวเมนต์ จากนั้นคุณจะได้รับแจ้งให้เลือกตัวเลือก 1 (ตรวจสอบ) หรือ 2 (ตรวจสอบและส่ง): 
 >>> python bdayreminder.py <data_file_path>
Choose 1 to validate if input data file is correct or 2 to check for upcoming birthdays and send respective emails
>>> 1
ERROR: Invalid email for Laura Dreyfuss at row 6 
ERROR: Empty name field is for email [email protected] at row 7 
ERROR: Invalid date for Anna Higgins at row 11. Date given is 02-30 
ERROR: Date is in the future for Tom Brady at row 12. Date given is 2075-10-22 
ERROR: Invalid email for Ching Yeung Michael Tam at row 19
'''
'''
>>> python bdayreminder.py <data_file_path>
Choose 1 to validate if input data file is correct or 2 to check for upcoming birthdays and send respective emails
>>> 2
Kai Yuen Leung will have birthday in a week.
Patrick Kienzle will have birthday in a week.
Emails sent successfully.
  1. ในการเรียกใช้ การตรวจสอบความถูกต้อง หรือ ตรวจสอบและส่ง ให้ไฟล์ Python ไฟล์ข้อมูลและหมายเลขใด ๆ นอกเหนือจาก 1 หรือ 2 เป็นอาร์กิวเมนต์ จากนั้นคุณจะได้รับแจ้งให้เลือกตัวเลือก 1 (ตรวจสอบ) หรือ 2 (ตรวจสอบและส่ง) เนื่องจากไม่มีหมายเลขอื่นเป็นตัวเลือก: 
 >>> python bdayreminder.py <data_file_path> 3
Choose 1 to validate if input data file is correct or 2 to check for upcoming birthdays and send respective emails
>>> 3
Please choose either 1 or 2
>>> 1
ERROR: Invalid email for Laura Dreyfuss at row 6 
ERROR: Empty name field is for email [email protected] at row 7 
ERROR: Invalid date for Anna Higgins at row 11. Date given is 02-30 
ERROR: Date is in the future for Tom Brady at row 12. Date given is 2075-10-22 
ERROR: Invalid email for Ching Yeung Michael Tam at row 19
  1. คุณสามารถหลีกเลี่ยงการแสดงให้เห็นพร้อมกับคุณโดยสิ้นเชิง เพื่อ ตรวจสอบ ไฟล์ข้อมูล บุคคลวันเกิดสำหรับข้อผิดพลาดตั้งค่าอาร์กิวเมนต์ที่สองเป็น 1 : 
 >>> python bdayreminder.py <data_file_path> 1
ERROR: Invalid email for Laura Dreyfuss at row 6 
ERROR: Empty name field is for email [email protected] at row 7 
ERROR: Invalid date for Anna Higgins at row 11. Date given is 02-30 
ERROR: Date is in the future for Tom Brady at row 12. Date given is 2075-10-22 
ERROR: Invalid email for Ching Yeung Michael Tam at row 19
  1. หากต้องการ ตรวจสอบ ไฟล์ข้อมูล บุคคลวันเกิดและ ส่งอีเมล ตั้งค่าอาร์กิวเมนต์ที่สองเป็น 2 : 
 >>> python bdayreminder.py <data_file_path> 2
Kai Yuen Leung will have birthday in a week.
Patrick Kienzle will have birthday in a week.
Emails sent successfully.


1 <data_file_path> ควรมีลักษณะเช่นนี้ - ชุดข้อมูล/data_20.csv แต่ในไดเรกทอรีของคุณ เส้นทางเต็มสำหรับฉันคือ /users/aurimasnausedas/documents/python/birthdayreminderapp/datasets/data_20.csv

2 โมดูลหลักใช้สองอาร์กิวเมนต์เมื่อเรียกใช้จากคอนโซล

3 ข้อมูลที่ใช้สำหรับตัวอย่างคือ data_20.csv เมื่อ วันที่ 23 มิถุนายน 2565

ฟังก์ชั่น

ภาพรวมของฟังก์ชั่นที่พบภายในโมดูล - bdayReminder.py :

  • validate_data_and_send_emails (input_file, send_emails) ตรวจสอบความถูกต้องของ input_file และวันเกิดเป็นในหนึ่งสัปดาห์และทางเลือกส่งอีเมลที่เกี่ยวข้อง ( send_emails )
  • parse_date (วันที่) วิเคราะห์ วันที่
  • is_valid_input (date_format, รายการ, ดัชนี, to_print) ตรวจสอบอินพุต ( date_format , รายการ , ดัชนี , to_print )
  • send_multiple_emails (วันเกิด _individuals, to_send) ส่งอีเมลไปยังผู้รับรายการ to_send
  • IS_DATE_IN_PAST (วันที่, วันที่ _format) ดูว่า วันที่ อยู่ในอดีต
  • is_valid_email (อีเมล) ตรวจสอบว่าอีเมลนั้นถูกต้องหรือไม่
  • send_email (ชื่อ, bday_name, bday_date, days_left, to_email) ส่งอีเมลไปยังผู้รับ ( ชื่อ , to_email ) เป็นเครื่องเตือนความจำวันเกิด ( bday_name , bday_date ) ล่วงหน้า ( Days_left )
  • run (read_path, cron_value) ใช้ไฟล์ข้อมูล CSV และเรียกใช้สคริปต์โดยไม่ต้องเป็นตัวเลือกจะถูกส่งผ่านเป็นอาร์กิวเมนต์ ( read_path , cron_value )
  • เลือก _options (read_path) ขออินพุต ( read_path ) และเลือกตัวเลือกในการรัน

ในคำอธิบายเชิงลึกของฟังก์ชั่นสามารถพบได้ภายในโมดูล - bdayReminder.py

ชุดข้อมูล

มีชุดข้อมูลที่เป็นไปได้สามชุดที่จะใช้ เหล่านี้คือ DATA_20 จาก 20 ผู้รับ DATA_50 จาก 50 ผู้รับและ DATA_80 จาก 80 ผู้รับ

การทดสอบ

ภาพรวมของฟังก์ชั่นที่พบภายในโมดูล - tests.py:

  • test_correct_parse_date_ymd () ทดสอบหากวันที่ที่ถูกต้องถูกแยกวิเคราะห์
  • test_correct_parse_date_md () ทดสอบหากวันที่ที่ถูกต้องถูกแยกวิเคราะห์
  • test_is_date_in_past_old () ทดสอบว่าวันที่เก่าเป็นในอดีต
  • Test_IS_DATE_IN_PAST_FUTURE () ทดสอบว่าวันที่ในอนาคตเป็นวันที่ผ่านมา
  • test_is_date_in_past_past_month_day () ทดสอบว่าวันที่เก่า ๆ อยู่ในอดีต
  • test_is_valid_email_good () การทดสอบหากที่อยู่อีเมลถูกต้อง
  • test_is_valid_email_bad () ทดสอบหากที่อยู่อีเมลไม่ถูกต้อง

โดยการนำทางไปยังโฟลเดอร์โปรแกรม/แอพที่สกัด - BirthdayReminderApp - หนึ่งโฟลเดอร์ก่อนที่การทดสอบจะถูกจัดขึ้นและหนึ่งสามารถเรียกใช้คำสั่งทดสอบเหล่านี้:

  1. ในการตรวจสอบไฟล์ต้นฉบับสำหรับข้อผิดพลาดในโฟลเดอร์โครงการ: 
 >>> pyflakes .
  1. เพื่อตรวจสอบไฟล์ต้นฉบับสำหรับข้อผิดพลาดในไฟล์ทดสอบ: 
 >>> pyflakes Tests/tests.py
  1. เพื่อตรวจสอบการพิมพ์สำหรับไฟล์ทดสอบ: 
 >>> python -m pytest Tests/tests.py

ข้อผิดพลาด

อาจเกิดข้อผิดพลาดเล็กน้อยเช่น:

  1. ข้อผิดพลาดอาร์กิวเมนต์ครั้งที่ 1 หากอาร์กิวเมนต์ที่ 1 ที่มีอยู่นั้นมีรูปแบบที่แตกต่างกันในรูปแบบ CSV: 
 >>> python bdayreminder.py Datasets/data_20.json 1      
Traceback (most recent call last):
  File "/Users/aurimasnausedas/Documents/Python/BirthdayReminderApp/bdayreminder.py", line 237, in <module>
    run(arg_path, cron_input)
  File "/Users/aurimasnausedas/Documents/Python/BirthdayReminderApp/bdayreminder.py", line 215, in run
    raise Exception('ERROR: Wrong data format file')
Exception: ERROR: Wrong data format file
  1. ข้อผิดพลาดอาร์กิวเมนต์ครั้งที่ 1 หากอาร์กิวเมนต์ที่ 1 ที่ให้ไว้ของไฟล์ข้อมูลไม่มีอยู่: 
 >>> python bdayreminder.py Datasets/data_13.csv 1 
Traceback (most recent call last):
  File "/Users/aurimasnausedas/Documents/Python/BirthdayReminderApp/bdayreminder.py", line 237, in <module>
    run(arg_path, cron_input)
  File "/Users/aurimasnausedas/Documents/Python/BirthdayReminderApp/bdayreminder.py", line 199, in run
    raise Exception('ERROR: File doesn't exist')
Exception: ERROR: File doesn't exist
  1. ข้อผิดพลาดอาร์กิวเมนต์ที่ 2 หากอาร์กิวเมนต์ที่ 2 ที่ให้คือสตริง: 
 >>>  python bdayreminder.py Datasets/data_20.csv versada
Argument passed not an integer

ยังมีสิ่งเหล่านี้มากที่สุด

งาน cron

เพื่อสร้างงาน cron ใน Mac Terminal Run: 

 >>> crontab -e

ไวยากรณ์สำหรับ Cronjob เมื่อเข้าสู่เทอร์มินัลอาจมีลักษณะเช่นนี้: 1,2,3 

 >>> 0 6 * * * cd <directory_to_app> && <directory_to_python> bdayreminder.py <data_file_path> 2
[Optional] >>> 0 6 * * * cd <directory_to_app> && <directory_to_python> bdayreminder.py <data_file_path> 2 >> Public/birthdays.txt


1 <directory_to_app> - ควรเป็นไดเรกทอรีที่โฟลเดอร์วันเกิด reminderapp เป็นเหมือน/ผู้ใช้/aurimasnausedas/เอกสาร/python/วันเกิด reminderapp

2 <directory_to_python> ควรเป็นที่ที่คุณติดตั้ง python บนเครื่องของคุณเช่น/ผู้ใช้/aurimasnausedas/opt/miniconda3/envs/symmetric/bin/python

3 <data_file_path> ควรเป็นชุดข้อมูลในไดเรกทอรีของแอพเช่นใน/ผู้ใช้/aurimasnausedas/documents/python/วันเกิด reminderApp โดยการตั้งค่าเป็นชุดข้อมูล/data_20.csv

การปรับแต่งไวยากรณ์สำหรับงาน cron สามารถตรวจสอบได้ที่นี่

สาธารณะ

โฟลเดอร์สาธารณะมีสามไฟล์:

  • วันเกิด. txt - ผลลัพธ์ของงาน cron หลังจากใช้คำสั่ง [ไม่บังคับ] ตามที่กำหนดในฟิลด์งาน cron
  • Todolist - รายการสิ่งที่ต้องทำ

โลโก้

โลโก้ของแอปพลิเคชันเตือนวันเกิดสามารถพบได้ที่นี่

ใบอนุญาต

ใบอนุญาต MIT

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด