Metadata-Version: 2.1
Name: memrise
Version: 1.2.0rc1
Summary: Scraping Vocabulary from the Memrise Course
Home-page: https://github.com/tquangsdh20/memrise
Author: Joseph Quang
Author-email: tquang.sdh20@hcmut.edu.vn
License: MIT
Keywords: memrise,memrise ipa,mem api,memrise scraping,vocabulary scraping,pymemrise,pymem
Platform: UNKNOWN
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Description-Content-Type: text/markdown
License-File: LICENSE

<p align="center">
  <img src="https://drive.google.com/uc?id=1WCwQC2sO9DZx7XeFUJbh0VEAUbIf1BXJ">
</p>

## Features:
- Support scraping the courses in MEM to take the vocabulary

## Appplication Requires

### Install DB Browser : [SQLite](https://sqlitebrowser.org/dl/)

### Install Library: 
<b>Window</b>
```
 python -m pip install memrise
```
<b>Linux</b>
  ```
  pip install memrise
  ```
 <b>macOS</b>
 ```
 sudo pip3 install memrise
```
## Guidelines

### How to take Course ID?

Access the Website: [Memrise](https://app.memrise.com/) and copy the Course ID as the following picture:

<p align="center">
  <img src="https://drive.google.com/uc?id=1WE0JGRDkPJh04Qldq0U4b7c1f9c0Wd8h">
</p>

### Import library and initialize database

```python
from memrise import Course,Database
#Create file database output
db = Database('English.sqlite') #Other format is .db
#Connect to file database and init
db.connect()
db.init()
```
The output will give you the List Language's ID of the Course, remember the ID for next step. 
```
Language IDs:        
    1. English UK    
    2. English US    
    3. Chinese       
    4. Janpanese     
    5. French        
    6. Spanish Mexico
    7. Italian
    8. German
    9. Russian
    10. Dutch
    11. Korean
    12. Arabic
    13. Spanish Spain

```

### Scraping course with ID
Regarding to Module Course with two paramemters:
- `CourseID`: Get the Course ID as above
- `LanguageID`: The Language ID of the Course which you study.
  
The following example is scraping the English course for Vietnamese with IPA of English US, so the Language ID is 2.
```python
from memrise import Course, Data
#Create file database output
db = Data('English.sqlite') #Other format is .db
#Connect to file database and init
db.init_database()
#Connect the course to scraping info this maybe take a few momment.
course = Course(1658724,2)
#Update information about the course
db.update_course(course)
```

### Update course with your language meaning (NOT WORKING NOW)

#### This function will be fixed in next release

Use the method `update_db_en()` if the LANGUAGE COURSE is **English** for scraping IPA.  
Use the method `update_db()` if the Language Course is the others.  
About the parameters of two above methods are the same:  
- `CourseID` : the ID of the course
- `Language` : your mother language with format <i>'en', 'fr', 'ko', 'vi'...</i>

```python
#If your Course is English language use `update_db_en()`, otherwise use `update_db()` method.
db.update_db_en(1658724,'fr')
```
### Check the output with SQLite

File output

<p align="center">
  <img src="https://drive.google.com/uc?id=1WF7apdbh4gGJLNc9RPFethChqR8cpcSH" height=200 width=550 "/>
</p>

Show the words table as the following steps: **Browse Data > Table > Word**

<p align="center">
  <img src="https://drive.google.com/uc?id=1WGAD-hIsLg-vamSRAYg219x89DqEzff3" height=500 width=800 />
</p>

If you want to choose the raw meaning, you could run the following SQL statement.

```SQL
SELECT word, sub, IPA FROM words
```
Steps : **Execute SQL > Typing SQL Statements > Run**

<p align="center">
  <img src="https://drive.google.com/uc?id=1WJTvpNUfZfY0EVgSaIOqs3u6jji3Qvr1" height=500 width=800 />
</p>

[<b>Github:</b> https://github.com/tquangsdh20/memrise](https://github.com/tquangsdh20/memrise)

### Log changes:

**v1.0.0**: Implementation Scrapping Vocabulary  
**v1.1.0**: Update IPA Function   
**v1.2.0rc1** : Release check for fixing ERROR IPA and update new TRANSLATE FUNCTION  


