ulordapi

udfs

• ulordapi.udfs
  • udfs

config

class ulordapi.config.Config(*args, **kwargs)

Bases: dict

config class.Based on the dict.Update key-value,including subdict.

edit(data)

read(init=True)

read config from config file and update config.

Parameters:init (bool) – check if the config is first save.Default is True, will save the config file.

save()

save config to the config file.Just for the config,not support for it’s sub config.

daemonCLI

class ulordapi.daemonCLI.client

ulordapi.daemonCLI.edit_config(*args, **kwargs)

ulordapi.daemonCLI.formatResult(func)

ulordapi.daemonCLI.main()

ulordapi.daemonCLI.show_config(*args, **kwargs)

errcode

ulordapi.errcode.return_result(errcode=0, reason=None, result=None)

update errcode,reason,result and then return

Parameters:

• errcode (int) – errcode
• reason (str/dict) – reason, change it to the dict and update original reason
• result (str/dict) – result, change it to the dict and update original result

Returns:

errcode result

manage

class ulordapi.manage.Ads(**kwargs)

Bases: ulordapi.manage.Resource

Advertisement.Viewer will get a few ulord from the author when they view it.

UPID

amount

body

claimID

date

description

id

resource_type

tags

title

userid

views

class ulordapi.manage.Content(**kwargs)

Bases: ulordapi.manage.Resource

Content,viewer need to pay a few ulord to view.

UPID

amount

body

claimID

date

description

id

resource

resource_type

tags

title

userid

views

class ulordapi.manage.Resource(**kwargs)

Bases: sqlalchemy.ext.declarative.api.Model

Resource table: create resource table

UPID

amount

body

claimID

date

description

id

resource

resource_type

tags

title

userid

views

class ulordapi.manage.Tag(**kwargs)

Bases: sqlalchemy.ext.declarative.api.Model

tag table

id

pre1

pre2

resource

tagname

class ulordapi.manage.User(**kwargs)

Bases: sqlalchemy.ext.declarative.api.Model

User table: create user database.

activity

balance

boughts

cellphone

email

hash_password(password)

Hash user’s password and save hash result.

Parameters:password (str) – user’s password

id

password_hash

pay_password

timestamp

token

username

verify_password(password)

verify password

Parameters:password (str) – user’s password Returns:True or False.

wallet

ulordapi.manage.create()

Create database.

up

class ulordapi.up.UlordHelper(appkey=None, ulord_secret=None)

Bases: object

a helper to request the ulord paltform

calculate_sign(dt=None)

encrypt the request data according to the secret

Parameters:dt (dict) – data need to be encrypted, Default is None Returns:Usign

checkisbought(payer, claim_ids)

query the personal balance from the ulord platform

Parameters:

• payer (str) – payer wallet name
• claim_ids (list) – resource claim id

Returns:

errcode.You can query from the errcode dict.

delete(id, password)

delete resource on the ulord-platform

Parameters:

• id (int) – resource ulord-platform DB ID
• password (str) – user wallet password

Returns:

errcode.You can query from the errcode dict.

get(url)

get from the ulord-platform

Parameters:url (str) – request’s url Returns:return result.You can query the errcode.

paytouser(username)

activity send some ulords to the user

Parameters:username (str) – user wallet name Returns:errcode.You can query from the errcode dict.

post(url, data)

post to the ulord-platform

Parameters:

• url (str) – request’s url
• data (dict) – post data

Returns:

return result.you can query the errcode

publish(data)

publish data to the ulord platform

Parameters:data (dict) – data needed to be published.Key includes author,title,tags,udfs_hash,price,content_type,des，pay_password Returns:errcode.You can query from the errcode dict.

queryBillingDetailByID(claim_id, page=1, num=10)

query all billing details according to the claimID

Parameters:

• claim_id (str) – resource on the ulord-chain ID
• page (int) – which page of result do you want to view?Default is 1.
• num (int) – how many pieces of data of result do you want to view?Default is 10.

Returns:

errcode.You can query from the errcode dict.

queryStatisticsByID(claim_ids)

query resource statistics information by ID

Parameters:claim_ids (list) – need to be query ID list. Returns:errcode.You can query from the errcode dict.

query_resourc_by_ID(ids)

query resource list according to the id list

Parameters:ids (list) – need to be query id list Returns:errcode.You can query from the errcode dict.

querybalance(payer, pay_password)

query the personal balance from the ulord platform

Parameters:

• payer (str) – payer wallet name
• pay_password (str) – payer wallet password

Returns:

errcode.You can query from the errcode dict.

querybillings(username, start, end)

get billings info

Parameters:

• username (str) – current user wallet name
• start (str) – start time.2018-03-29
• end (str) – end time.2018-03-29

Returns:

errcode.You can query from the errcode dict.

querybillingsdetail(author, page=1, num=10)

query the billings detail.Union the income and outgo

Parameters:

• author (str) – current user wallet name
• page (int) – which page of result do you want to view?Default is 1.
• num (int) – how many pieces of data of result do you want to view?Default is 10.

Returns:

errcode.You can query from the errcode dict.

queryincomebillings(author, start, end, page=1, num=10, category=2)

get income billings info

Parameters:

• author (str) – current user wallet name
• start (str) – start time.2018-03-29
• end (str) – end time.2018-03-29
• page (int) – which page of result do you want to view?Default is 1.
• num (int) – how many pieces of data of result do you want to view?Default is 10.
• category (int) – resource type. 0—-common resource,1—-ads,2—–all

Returns:

errcode.You can query from the errcode dict.

queryoutgobillings(author, start, end, page=1, num=10, category=2)

get outgo billings info

Parameters:

• author (str) – current user wallet name
• start (str) – start time.2018-03-29
• end (str) – end time.2018-03-29
• page (int) – which page of result do you want to view?Default is 1.
• num (int) – how many pieces of data of result do you want to view?Default is 10.
• category (int) – resource type. 0—-common resource,1—-ads,2—–all

Returns:

errcode.You can query from the errcode dict.

querypublishnum(author, start, end)

query the number of resourced which has published

Parameters:

• author (str) – current user wallet name
• start (str) – start time.2018-03-29
• end (str) – end time.2018-03-29

Returns:

errcode.You can query from the errcode dict.

queryresource(page=1, num=10, **kwargs)

query the resource list from the ulord platform.method is get

Parameters:

• page (int) – which page do you want to view?Default is 1.
• num (int) – how many pieces of datas in one page?.Default is 10.
• kwargs (key-value) – key-value query

Returns:

errcode.You can query from the errcode dict.

queryuserpublished(wallet_username, page=1, num=10)

query user published from ulort platform

Parameters:

• wallet_username (str) – auther wallet name
• page (int) – which page of result do you want to view?Default is 1.
• num (int) – how many pieces of data of result do you want to view?Default is 10.

Returns:

errcode.You can query from the errcode dict.

regist(username, password)

regist wallet address from the ulord platform

Parameters:

• username (str) – wallet name
• password (str) – wallet password

Returns:

errcode.You can query from the errcode dict

transaction(payer, claim_id, pay_password, isads=False)

record the transaction to the ulord platform

Parameters:

• payer (str) – payer wallet name
• claim_id (str) – resource claim id
• pay_password (str) – payer wallet password
• isads (bool) – check the resource if a Ad.

Returns:

errcode.You can query from the errcode dict.

update(data)

update data from the ulord-platform

Parameters:data (dict) – data needed to be updated.Key includes id,pay_password,title,tags,udfs_hash,price,content_type,des，pay_password Returns:errcode.You can query from the errcode dict.

user

class ulordapi.user.Developer(appkey, secret)

Bases: ulordapi.up.UlordHelper

basic develoer class to execute some functions

config_edit(args=None)

config operations

Parameters:args (list/dict) – a list or a dict.Update config Returns:args dict

config_show(args=None)

show config.Default show all.

Parameters:args (list/dict) – keys Returns:config according to the keys

decrypt(args)

check if the arg is encrypted.If encrypted return decrypted arg,else return None.

Parameters:args (str/str list) – arg need to be checked, Returns:decrypted arg or arg(unicode)

request(method, url, data=None)

advanced command. request to the ulord-platform

Parameters:

• method (str) – request method,like post,get and so on.
• url (str) – request url
• data (dict) – request data

Returns:

return result.you can query the errcode

udfs_cat(udfshashs)

view the udfs hash comment

Parameters:udfshashs (list) – udfs hashes Returns:dict udfshash - True/False

udfs_download(udfshashs)

download file from ulord.udfses is a udfs list

Parameters:udfshashs (list) – udfs hashes Returns:udfshash - True/False

udfs_upload(fileinfos)

upload file into ulord.fileinfo is a file list

Parameters:fileinfos (list/str) – file need to upload to the ulord-platform Returns:dict fileinfo - True/False

class ulordapi.user.Junior(appkey, secret)

Bases: ulordapi.user.Developer

Junior programmer to develop his application.Using default database.

create_database(path=None)

create database

Parameters:path (str) – database path.Warining:It’a a dir Returns:True/False

pay_ads(wallet, claim_id, authername)

user view ads

Parameters:

• wallet (str) – user wallet name
• claim_id (str) – resource claim id
• authername (str) – resource auther name

Returns:

errcode.You can query from the errcode.

pay_resources(payer, claim_id, password, encrypted=False)

user pay resource

Parameters:

• payer (User) – payer
• claim_id (str) – resource claim id
• password (str) – payer password

Returns:

errcode.You can query from the errcode.

query(sql)

advanced command self query

Parameters:sql (str) – sql sentence Returns:query result

resouce_views(claim_id)

add resource view

Parameters:claim_id (str) – resource claim_id Returns:resource current view

resource_publish(title, udfshash, amount, tags, des, usercondition)

user publish resource

Parameters:

• title (str) – resource title
• udfshash (str) – resource uplorded to the UDFS hash
• amount (float) – resource price
• tags (list) – resource tag
• des (str) – resource description
• usercondition (dict) – a condition which need to query user

Returns:

errcode.You can query from the errcode.

resource_update(id, pay_password, encrypted=True, title=None, body=None, price=None, tags=None, des=None)

user update data to the ulord-platform

Parameters:

• id (str) – data id
• pay_password (str) – auther wallet pay password
• encrypted (bool) – if encrypt password
• title (str) – resource title
• body (str) – resource
• price (float) – resource price
• tags (list) – resource tags
• des (str) – resource description

Returns:

errcode.You can query from the errcode.

start_web()

start web server

user_activity(token=None, username=None)

activity.App developer send some ulords to the user.

Parameters:

• token (str) – user token
• username (str) – user name

Returns:

True or False.

user_info_query(username=None, token=None)

user information

Parameters:

• username (str) – username.Default is none.
• token (str) – user token.Default is none.

Returns:

dict.User info

user_infor_modify(password, username=None, token=None, encrypted=False, cellphone=None, email=None, new_password=None)

user information

Parameters:

• username (str) – username.Default is none.
• token (str) – user token.Default is none.
• encrypted (bool) – if encrypted password.If ture,all password will be decrypted.
• password (str) – user passowrd to confirm account
• cellphone (str) – user new cellphone
• email (str) – user new email
• new_password (str) – user new password

Returns:

dict.User info

user_login(username, password, encrypted=False)

user login

Parameters:

• username (str) – user name
• password (str) – user password
• encrypted (bool) – check if the password is encrypted

Returns:

user token

user_logout(token=None, username=None)

user logout.Change user’s timestamp

Parameters:

• token (str) – user token
• username (str) – user name

Returns:

username or errcode.You can query the errcode dict.

user_regist(username, password, cellphone=None, email=None, wallet=None, pay_password=None, encrypted=False)

user regist

Parameters:

• username (str) – user name
• password (str) – user password
• cellphone (str) – user cellphone.Default is None.
• email (str) – user email.Default is None.
• wallet (str) – user wallet name.Default is username.
• pay_password (str) – user wallet password.Default is hash password.
• encrypted (bool) – check if the password encrypted

Returns:

user token

class ulordapi.user.Senior(appkey, secret)

Bases: ulordapi.user.Developer

Senior programmer to develop his application.

utils

class ulordapi.utils.FileHelper

file helper to operate the files

changeName(originalname, newname)

change file name from a hash to filename

Parameters:

• originalname (str) – a file path, old file name.
• newname (str) – a file path, new file name.

Returns:

True or False

getName(filename)

get file name,including type

Parameters:filename (str) – a file path Returns:file name

getPureName(filename)

get file name.Doesn’t contain type.

Parameters:filename (str) – a file path Returns:file name

getSize(filename)

get file size

Parameters:filename (str) – a file path Returns:file size

getType(filename)

get file type

Parameters:filename (str) – a file path Returns:file type

mergeFile(filepath, chunks)

merge chunks into a file.Used for the multi-threading download

Parameters:

• filepath (str) – a file path.Final file.
• chunks (list) – chunk path list

Returns:

True or False

readFile(filepath)

read file comment

Parameters:filepath (str) – a file path Returns:file comment

saveFile(filepath, source)

save source into a filepath. Create path if dir is not existed.

Parameters:

• filepath (str) – a file path
• source (unicode) – message

Returns:

True or False

ulordapi.utils.ListToDict(args)

change a list to dict

Parameters:args (list) – a list Returns:dict

>>> a = [1,2,3,4]
>>> print(ListToDict(a))
{1: {2: {3: 4}}}

class ulordapi.utils.RSAHelper(public_path, private_path)

Bases: object

rsa helper.Create private key and public key.

decrypt(prikey, message)

using private key to decrypt message

Parameters:

• prikey (Crypto.PublicKey.RSA.RsaKey) – private key
• message (str) – need to be decrypted

Returns:

decrypted message

encry(pubkey, comment)

using pubkey to encrypt comment

Parameters:

• pubkey (Crypto.PublicKey.RSA.RsaKey) – public key
• comment (str) – information

Returns:

encrypted data

generate()

generate public key and private key

load()

read key from the path

ulordapi.utils.Update(orgin_dict, dict_father)

update dict dict_father to dict orgin_dict

Parameters:

• orgin_dict (dict) – base dict
• dict_father (dict) – need to update

Returns:

dict orgin_dict which updates orgin_dict

In [8]: dictb = {
   ...: "t":2,
   ...: "ttt":{
   ...: "123":1,
   ...: "a":2
   ...: }
   ...:
   ...: }

In [9]: dicta = {
   ...: "test": 1,
   ...: "ttt":{
   ...: "a":1
   ...: }
   ...: }

In [10]: Update(dictb, dicta)
Out[10]: {'t': 2, 'test': 1, 'ttt': {'123': 1, 'a': 1}}

ulordapi.utils.generateMD5(value)

generate value’s md5

Parameters:value (str) – need to encrypt Returns:value’s md5 or “”

ulordapi.utils.isCellphone(number)

check if a cellphone

Parameters:number (str) – cellphone Returns:True of False

ulordapi.utils.isMail(mail)

check if a mail

Parameters:mail (str) – mail Returns:True of False

ulordapi.utils.isUdfsHash(udfshash)

check the string if a udfs hash simple check, TODO advanced check

Parameters:udfshash (str) – a string Returns:True or False

ulordapi.utils.json_load_byteified(file_handle)

encode a json file handle :param file_handle: a json file handle :type file_handle: handle :return: encoded json(utf-8)

ulordapi.utils.require(required, tag)

a decorator function.current function need required function.Tag is a marker which mark the required function is running.

Parameters:

• required (function) – required function
• tag (bool) – mark the required function if has been running.

Returns:

decorator

version

webServer

ulordapi.webServer.activity()

activity.Send 10 ulord to new user.

ulordapi.webServer.add_views()

add views according to the resource’s title

Returns:current views

ulordapi.webServer.auth_login_required()

check token

Returns:current user

ulordapi.webServer.blog_delete()

delete blog :return: errcode.You can query from the errcode dict.

ulordapi.webServer.blog_list()

list all blog

Returns:blog list

ulordapi.webServer.blog_list_by_ID()

list blogs by ID

Returns:blog list

ulordapi.webServer.blog_publish()

publish blog

Returns:claim id,ulord-platform DB ID

ulordapi.webServer.blog_update()

update blog

Returns:claim id,ulord-platform DB id

ulordapi.webServer.check_bought()

check the resource if has been bought

Returns:if has bought return resource hash,if not existed return null,if hasn’t bought return none.

ulordapi.webServer.encrypt()

ulordapi.webServer.get_billings()

query user’s billing

ulordapi.webServer.get_billingsdetail()

query user billing detail

ulordapi.webServer.get_expensebillings()

get user expense billing information

ulordapi.webServer.get_incomebillings()

get user income billing information

ulordapi.webServer.get_pubkey()

Get:generate publikey to fronted-end.Post:Check the message if crypted.

Returns:get-publickey/post-decrypted message

ulordapi.webServer.get_userbalance()

get user balance

Returns:user balance

ulordapi.webServer.get_userinfo()

get user infor

Returns:dict.User information

ulordapi.webServer.get_userpublished()

get blog list the user has published

ulordapi.webServer.get_userpublishednum()

get the num of the blogs that user has published

ulordapi.webServer.login()

user login

Returns:user token

ulordapi.webServer.logout()

user logout

Returns:success

ulordapi.webServer.modify_userinfo()

Delete modify username.It will make publish error

ulordapi.webServer.pay_ads()

get ulord from ads

Returns:ads hash

ulordapi.webServer.pay_blogs()

user pay blogs to view

Returns:blog hash

ulordapi.webServer.regist()

user regist

Returns:user token

ulordapi.webServer.start()