Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/coskundeniz/eksisozluk

A command line reader for https://eksisozluk.com/
https://github.com/coskundeniz/eksisozluk

beautifulsoup4 eksisozluk mongodb python selenium web-scraping

Last synced: 1 day ago
JSON representation

A command line reader for https://eksisozluk.com/

Host: GitHub
URL: https://github.com/coskundeniz/eksisozluk
Owner: coskundeniz
License: gpl-3.0
Created: 2016-05-10T14:59:44.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2023-09-30T14:55:33.000Z (about 1 year ago)
Last Synced: 2023-09-30T15:44:50.028Z (about 1 year ago)
Topics: beautifulsoup4, eksisozluk, mongodb, python, selenium, web-scraping
Language: Python
Homepage:
Size: 2.99 MB
Stars: 2
Watchers: 2
Forks: 3
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        eksisozluk

==========

A command line reader for https://eksisozluk.com/

### Supported Functionalities

* Read entries from titles of default channel(gundem)

* Read entries from titles of other channels

* Read entries of an author

* Save selected titles as favourite

* Get today's entries from favourite titles

* Save selected entries as favourite

* Show entries saved as favourite

* Change console output theme

---

## How to setup

If you will use MongoDB to save titles/entries, install it from [here](https://docs.mongodb.com/manual/administration/install-community/).

Otherwise SQLite database will be used.

You can check the running status after installation and start the database server with the following commands on Linux.

* `sudo service mongod status`

* `sudo service mongod start`

Run one of the followings to install required packages

* `pipenv install && pipenv shell`

* `pip install -r requirements.txt`

### How to create Docker image manually

Install docker from [here](https://docs.docker.com/get-docker/) and run the following commands in the project directory.

* `docker build -t eksisozluk .`

* `docker volume create eksisozluk_db`

---

## How to use

```

usage: python eksisozluk.py [-h] [-ch] [-ae] [-ft] [-lfte] [-fe] [-lfe] [-th THEME]

optional arguments:

  -h, --help                 show this help message and exit

  -ch, --channels            Get titles from other channels

  -ae, --author_entries      Get author entries

  -ft, --favtitle            Add selected titles to favourites

  -lfte, --listfavtitleentry Get today's entries from favourite titles

  -fe, --faventry            Add selected entries to favourites

  -lfe, --listfaventry       Show entries saved as favourite

  -th THEME, --theme THEME   Change theme

```

### How to run Docker image

If you created the image manually according to above commands, run the following command.

* `docker run --rm -it -v eksisozluk_db:/src eksisozluk`

You can add options as normal.

* `docker run --rm -it -v eksisozluk_db:/src eksisozluk -ch -fe`

If you want to use prebuilt image from DockerHub, you can use the following commands.

* `docker pull codenineeight/eksisozluk`

* `docker run --rm -it -v eksisozluk_db:/src codenineeight/eksisozluk`

---

## Screenshots

**Listing channels**

![Channels](images/channels.png)

**Getting author entries**

![Author Entries](images/author_entries.png)

**Show entries from a title**

![Show entries from a title](images/title_entries.png)

**Save entry to favourites**

![Save entry](images/save_entry.png)

**Show favourite entries**

![Show favourite entries](images/saved_entries.png)

**Save titles to favourites**

![Save title](images/save_title_1.png)

**Save duplicate title**

![Save duplicate title](images/save_title_2.png)

**Get entries from favourite titles**

![Get entries from favourite titles](images/fav_title_entries.png)

**Load more dialog for titles**

![Load more dialog for titles](images/titles_load_more.png)

**Secondary theme with green variants**

![secondary theme 1](images/change_theme_1.png)

![secondary theme 2](images/change_theme_2.png)

![secondary theme 3](images/change_theme_3.png)

**Invalid input errors**

![Invalid input errors](images/error_2.png)

![Invalid input errors](images/error_1.png)