Skip to content

Commit 9a4af39

Browse files
committed
v2.0.0
1 parent 2726597 commit 9a4af39

File tree

2 files changed

+43
-30
lines changed

2 files changed

+43
-30
lines changed

README.md

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
# Tele-Tracker Bot
2-
A python telegram bot to help track daily expenses onto google sheet
2+
A python telegram bot to help track daily expenses onto google sheet, hosted on Vercel using Flask.
3+
[Version 1](https://github.com/brucewzj99/tele-tracker) was hosted locally with a different version of python-telegram-bot
34

45
## Release Notes
5-
You can find the release notes over [here](https://github.com/brucewzj99/tele-tracker/blob/master/release_notes.md)
6+
You can find the release notes over [here](https://github.com/brucewzj99/tele-tracker-v2/blob/master/release_notes.md).
67

78
## Table of Contents
89
- [Getting Started (Users)](#getting-started-users)
@@ -16,13 +17,13 @@ You can find the release notes over [here](https://github.com/brucewzj99/tele-tr
1617
1. Access the bot on [telegram](https://t.me/telefinance_tracker_bot)
1718
2. Use the /start command and follow the instructions given.
1819
4. Remember to edit the `Dropdown` sheet on Google Sheet to get started.
19-
![image](https://github.com/brucewzj99/tele-tracker/assets/24997286/ddf879be-69f4-4e33-a517-3b5628055e6f)
20+
![image](https://github.com/brucewzj99/tele-tracker-v2/assets/24997286/bfc9a244-19d5-4521-88bd-088c87f3418c)
2021
5. Happy using!
2122

2223
## Getting Started (Developers)
2324
### Step 1
2425
* Fork the repo and run the code below to installed the required dependencies
25-
```python
26+
``` python
2627
pip install -r requirements.txt
2728
```
2829
* Install [ngrok](https://ngrok.com/download)
@@ -34,8 +35,8 @@ pip install -r requirements.txt
3435
* Set up Firebase Realtime Database, download service account key
3536
* Retrieve your firebase database url
3637
* Set up telegram bot via [BotFather](https://t.me/BotFather)
37-
* Insert all of them into .env as follows
38-
```.env
38+
* Insert all of them into .env as follows, you can use py dotenv or set it as env variable in your venv
39+
``` .env
3940
BOT_TOKEN=your_bot_token
4041
DATABASE_URL=firebase_url
4142
GOOGLE_API_EMAIL=google_api_email
@@ -45,47 +46,45 @@ GOOGLE_JSON=service_account_key
4546

4647
### Step 3
4748
* Run ngrok
48-
```terminal
49+
``` terminal
4950
ngrok http 5000
5051
```
5152
* Copy the link, it should look something like this 'https://<address>.ap.ngrok.io'
5253
* Set up web hook by opening this link:
53-
```url
54+
``` url
5455
https://api.telegram.org/bot<bot_token>/setwebhook?url=https://<address>.ap.ngrok.io/webhook
5556
```
5657
* You should see this:
57-
```json
58+
``` json
5859
{"ok":true,"result":true,"description":"Webhook was set"}
5960
```
6061
* Proceed to project directory and run:
61-
```python
62+
``` python
6263
python3.9 test.py
6364
```
6465

6566
## Usage
66-
/start - Start the bot and configure your Google Sheet for tracking expenses and other entries.
67+
/start - Initialize and Configure Sheet
6768

68-
/config - Update your Google Sheet settings or configure quick settings for adding transport and other entries.
69+
/config - Update Sheet Settings
6970

70-
/addentry - Add a new entry to your expense tracking system.
71+
/addentry - Add Expense Entry
7172

72-
/addtransport - Quickly add a new transport entry to your expense tracker.
73+
/addtransport - Quick Add Transport Entry
7374

74-
/addothers - Quickly add another type of entry to your expense tracker.
75+
/addothers - Quick Add Other Entry
7576

76-
/addincome - Add a new entry to your income.
77+
/addincome - Add Income Entry
7778

78-
/retrievetransaction - Retrieve a transaction from past date.
79+
/retrievetransaction - Retrieve transaction from dates
7980

80-
/cancel - Cancel the previous conversation with the bot and start fresh.
81+
/cancel - Cancel Conversation
8182

82-
/help - Show help message
83+
/help - Show Help
8384

8485
## Contributing
85-
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
86-
87-
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue or work on issues that are currently open.
88-
Don't forget to give the project a star! Thanks again!
86+
If you want to contribute or have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue or work on issues that are currently open.
87+
Don't forget to give the project a ⭐! Thanks again!
8988

9089
1. Fork the Project
9190
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
@@ -94,7 +93,7 @@ Don't forget to give the project a star! Thanks again!
9493
5. Open a Pull Request
9594

9695
## License
97-
Distributed under the MIT License. See `LICENSE.txt` for more information.
96+
Distributed under the MIT License. See `LICENSE` for more information.
9897

9998
## Contact
10099
Bruce Wang: [email protected]

release_notes.md

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,22 +4,36 @@
44
- Initial Launch
55

66
## Version 1.1.0 - Date: 21 May 2023
7-
### New Features
7+
### New Features 🆕
88
- Back button
99
- Added help command
1010

11-
### Bug Fixes
11+
### Bug Fixes 🛠️
1212
- Remove 'Transport' category from others
1313
- Fixed others and transport row tracker
1414
- Fixed first row tracker
1515

16-
### Enhancement
16+
### Enhancement 🔥
1717
- Refactor file structure
1818

1919
## Version 1.2.0 - Date: 24 May 2023
20-
### New Features (Planned deployment: 27 May 2023)
20+
### New Features 🆕 (Planned deployment: 27 May 2023)
2121
- Retrieve past transaction with /retrievetransaction command
2222
- Add income with /addincome command
2323

24-
### Enhancement
25-
- Increase number of options for add others
24+
### Enhancement 🔥
25+
- Increase number of options for add others
26+
27+
## Version 2.0.0 - Date 28 May 2023
28+
### Enhancement 🔥
29+
- Cloud hosting w Flask & Vercel 🎉
30+
- Move string to text_str.py
31+
32+
### Bug Fix 🛠️
33+
- Allow negative price entry
34+
35+
### To note ❗
36+
- Remove sql functions
37+
- python-telegram-bot library changed to 13.7
38+
- Move services account to environment variable
39+
- Please read the new README for developer

0 commit comments

Comments
 (0)