https://github.com/taralas209/xkcd-comic-to-vk-publication-dvmn

Automated tool to fetch and publish random comics from XKCD website to a VKontakte group's wall
https://github.com/taralas209/xkcd-comic-to-vk-publication-dvmn

comics python vk-api xkcd

Last synced: 4 days ago
JSON representation

Automated tool to fetch and publish random comics from XKCD website to a VKontakte group's wall

• Host: GitHub
• URL: https://github.com/taralas209/xkcd-comic-to-vk-publication-dvmn
• Owner: Taralas209
• License: mit
• Created: 2023-07-19T20:13:04.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-03T11:34:25.000Z (over 1 year ago)
• Last Synced: 2024-11-07T13:56:59.876Z (about 2 months ago)
• Topics: comics, python, vk-api, xkcd
• Language: Python
• Homepage:
• Size: 14.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Comic Publication

This project is an automated tool for publishing random comics from the XKCD website on the wall of a VKontakte group.

### How to Install

1. Clone the repository to your local computer using: `git clone https://github.com/yourusername/your-repo-name.git`

2. Install the necessary packages using `pip install -r requirements.txt` (assuming you have a requirements.txt file with all dependencies).

3. Create a `.env` file in the root directory of the project.

4. Add the following variables to the `.env` file:

    - `API_ID` - your VKontakte app ID.

    - `ACCESS_TOKEN` - your access key for the VKontakte app.

    - `USER_ID` - your VKontakte user ID.

    - `GROUP_ID` - the VKontakte group ID, on the wall of which the comics will be published.

### How to Run

Run the script using the command: `python main.py`

If everything was successful, you will see the following output: `Comix posted successfully!`

### Project Objective

The code is written for educational purposes on an online course for web developers [dvmn.org](https://dvmn.org/).

---

### Code Description

1. Import of necessary libraries.

2. Loading environment variables from the `.env` file.

3. The `get_last_comic_number` function gets the number of the latest comic on the XKCD website.

4. The `fetch_comic_info` function retrieves information about a random comic, including the image URL and comment.

5. The `get_vk_upload_id` function gets the URL for uploading photos to VKontakte servers.

6. The `upload_photo_to_vk_server` function uploads the comic to the VKontakte server.

7. The `save_photo_to_vk_wall` function saves the comic photo on the wall of the VKontakte group.

8. The `public_post_to_wall` function publishes the comic on the wall of the VKontakte group along with a comment.

9. The main code that calls all of the above functions in the necessary order.