"""The :class:`Contents <Contents>` object. It holds the information

def _update_attributes(self, content):

# links

self._api = self._get_attribute(content, 'url')

#: Dictionary of links

self.links = self._get_attribute(content, '_links')

#: URL of the README on github.com

self.html_url = self._get_attribute(content, 'html_url')

#: URL for the git api pertaining to the README

self.git_url = self._get_attribute(content, 'git_url')

#: git:// URL of the content if it is a submodule

self.submodule_git_url = self._get_attribute(

content, 'submodule_git_url'

)

# should always be 'base64'

#: Returns encoding used on the content.

self.encoding = self._get_attribute(content, 'encoding')

# content, base64 encoded and decoded

#: Base64-encoded content of the file.

self.content = self._get_attribute(content, 'content')

#: Decoded content of the file as a bytes object. If we try to decode

#: to character set for you, we might encounter an exception which

#: will prevent the object from being created. On python2 this is the

#: same as a string, but on python3 you should call the decode method

#: with the character set you wish to use, e.g.,

#: ``content.decoded.decode('utf-8')``.

#: .. versionchanged:: 0.5.2

self.decoded = self.content

if self.encoding == 'base64' and self.content:

self.decoded = b64decode(self.content.encode())

# file name, path, and size

#: Name of the content.

self.name = self._get_attribute(content, 'name')

#: Path to the content.

self.path = self._get_attribute(content, 'path')

#: Size of the content

self.size = self._get_attribute(content, 'size')

#: SHA string.

self.sha = self._get_attribute(content, 'sha')

#: Type of content. ('file', 'symlink', 'submodule')

self.type = self._get_attribute(content, 'type')

#: Target will only be set of type is a symlink. This is what the link

#: points to

self.target = self._get_attribute(content, 'target')

self._uniq = self.sha

def _repr(self):

return '<Content [{0}]>'.format(self.path)

def __eq__(self, other):

return self.decoded == other

def __ne__(self, other):

return self.sha != other

@requires_auth

def delete(self, message, branch=None, committer=None, author=None):

"""Delete this file.

json = {}

if message:

data = {'message': message, 'sha': self.sha, 'branch': branch,

'committer': validate_commmitter(committer),

'author': validate_commmitter(author)}

self._remove_none(data)

json = self._json(self._delete(self._api, data=dumps(data)), 200)

if json and 'commit' in json:

json['commit'] = Commit(json['commit'], self)

if json and 'content' in json:

json['content'] = self._instance_or_null(Contents,

json['content'])

return json

@requires_auth

def update(self, message, content, branch=None, committer=None,

author=None):

"""Update this file.

if content and not isinstance(content, bytes):

raise ValueError( # (No coverage)

'content must be a bytes object') # (No coverage)

json = None

if message and content:

content = b64encode(content).decode('utf-8')

data = {'message': message, 'content': content, 'branch': branch,

'sha': self.sha,

'committer': validate_commmitter(committer),

'author': validate_commmitter(author)}

self._remove_none(data)

json = self._json(self._put(self._api, data=dumps(data)), 200)

if json and 'content' in json:

self._update_attributes(json['content'])

json['content'] = self

if json and 'commit' in json:

json['commit'] = Commit(json['commit'], self)