file-api: migrate file api

[Thunderbottom]

Migrated file doctype APIs to files.py for streamlined access

closes #2800

adds changes to the way file api functions. For example:

Pythonic Way

The old call to save a file would require one to do the following:

f = save_file(filename, filedata, doctype, docname,
              folder, decode_base64, is_private, docfield)

The new save function functions as an object of the File class:

_file = frappe.get_doc({"doctype": "File",
                        "file_name": filename,
                        "attached_to_doctype": doctype,
                        "attached_to_name": docname,
                        "attached_to_field": docfield,
                        "content": filedata,
                        "decode": decode_base64,
                        "folder": folder,
                        "is_private": is_private})
_file.save()

This allows easier manipulation on files using a single file object, as opposed to manually accessing files through separate function calls each time a file needs to be manipulated.

REST API

To consume File as a part of the REST API, create a session. I'll use requests as an example:

import requests

sess = requests.Session()
# login to the user account
s.post("http://sitename.whatever/",
       data={'cmd': 'login', 'pwd': 'password', "usr": "email_id"},
       headers={'accept': 'application/json'})

This will create a requests session which you can then use to POST or GET requests.

POST

After creating a session, you can POST a File using requests by doing:

s.post("http://sitename.whatever/api/resource/File",
       data=json.dumps({
                "file_name": filename,
                "attached_to_doctype": doctype,
                "attached_to_name": docname,
                "attached_to_field": docfield,
                "content": data,
                "decode": boolean,
                "folder": folder,
                "is_private": boolean}),
       headers={'accept': 'application/json'})

GET

Similarly, you can perform GET requests by doing:

s.get("http://sitename.whatever/api/resource/File")

For more information about consuming the API, refer the documentation.

[netchampfaris]

file.get_extension()

[netchampfaris]

frappe.delete_doc('File', fid)

[netchampfaris]

frappe.delete_doc should handle this

[netchampfaris]

.