<gh_stars>1-10
# -*- coding: utf-8 -*-
import datetime
import logging

import requests
from lxml import objectify, etree
from requests.auth import HTTPBasicAuth

from .custom_exceptions import (HighriseRequestException, ParseTimeException,
                                FieldException, XMLRequestException)
from .classes.person import Person
from .classes.category import DealCategory, TaskCategory
from .classes.company import Company
from .classes.case import Case
from .classes.deal import Deal
from .classes.task import Task
from .classes.note import Note
from .classes.email import Email
from .classes.deletions import Deletion
from .classes.custom_field import SubjectData
from .classes.user import User
from .classes.tools import to_datetime

logger = logging.getLogger(__name__)


class Highton(object):
    """
        Highton-API is just a really simple Python library which helps you to
        get information about your Highrise data
    """

    def __init__(self, api_key, user):
        self.user = user
        self.api_key = api_key
        self.api_key_password = 'X'

    def _get_request(self, endpoint, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(self.user, endpoint)
        request = requests.get(
            url,
            auth=HTTPBasicAuth(self.api_key, self.api_key_password),
            headers={'User-Agent': 'Highton-API: (<EMAIL>)'},
            params=params,
        )

        if 'text/html' in request.headers['content-type']:
            raise XMLRequestException(url)

        return request

    def get_account(self, params={}):
        """
        Set the account on the Highton instance. There really isn't a reason
        not to since there should be only one account here.
        """
        account = objectify.fromstring(
            self._get_request('account', params).content
        )
        self.account = {}
        self.account['highrise_id'] = account['id'].pyval
        self.account['created_at'] = to_datetime(account['created-at'].pyval)
        self.account['updated_at'] = to_datetime(account['updated-at'].pyval)
        for attr in [
            'name',
            'subdomain',
            'plan',
            'color_theme',
            'ssl_enabled',
            'people-count',
            'storage'
        ]:
            self.account[attr.replace('-', '_')] = account[attr].pyval

    def get_current_auth_user(self, params={}):
        """
        Gives you the currently authenticated user as an object.
        :return: task object on Highton instance.
        """
        user = objectify.fromstring(
            self._get_request('me', params).content
        )

        self.me = {}
        self.me['highrise_id'] = user['id'].pyval
        self.me['created_at'] = to_datetime(user['created-at'].pyval)
        self.me['updated_at'] = to_datetime(user['updated-at'].pyval)

        for attr in [
            'name',
            'email-address',
            'token',
            'dropbox',
            'admin'
        ]:
            self.me[attr.replace('-', '_')] = user[attr].pyval

    def _get_single_data(self, endpoint, params={}):
        data = []
        try:
            data = objectify.fromstring(
                self._get_request(endpoint, params).content
            )
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing data from Highrise caused a failure'
                )
        return data

    def _get_data(self, endpoint, params={}, fail_counter=0):
        data = []
        try:
            content = self._get_request(endpoint, params).content
            data = objectify.fromstring(
                content
            ).getchildren()
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing data from Highrise caused a failure'
                )
        except etree.XMLSyntaxError:
            if fail_counter < 3:
                self._get_data(endpoint=endpoint, params=params, fail_counter=fail_counter+1)
            return False
        return data

    def _get_paged_data(self, endpoint, params={}):
        data = []
        try:
            page = 500
            counter = 0
            while True:
                params.update({'n': page * counter})
                objects = objectify.fromstring(
                    self._get_request(endpoint, params).content
                ).getchildren()
                if objects:
                    data += objects
                else:
                    break
                counter += 1
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing people from Highrise caused a failure'
                )
        return data

    def _get_object_data(self, data, highrise_class):
        """
        Return a formatted highrise_class list or False if there is an error
        """
        data_list = []
        if data:
            for d in data:
                temp = highrise_class()
                temp.save_data(d)
                data_list.append(temp)
        else:
            logger.debug(
                'No data found for your Request (Class: {}). Here is some data: {}'.format(
                    data, highrise_class
                )
            )
            return False
        return data_list

    def _post_request(self, endpoint, highrise_class, data=None, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(
            self.user, endpoint, params)
        try:
            request = requests.post(
                url,
                auth=HTTPBasicAuth(self.api_key, self.api_key_password),
                headers={
                    'User-Agent': 'Highton-API: (<EMAIL>)',
                    'content-type': 'application/xml'
                },
                params=params,
                data=data
            )

            data = objectify.fromstring(request.content)
            model = highrise_class()
            model.save_data(data)

            if 'text/html' in request.headers['content-type']:
                raise XMLRequestException(url)

        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Posting data to Highrise failed'
                )

        return {'response': request, 'model': model}

    def _put_request(self, endpoint, highrise_class, data=None, params={}):
        try:
            url = 'https://{}.highrisehq.com/{}.xml'.format(
                self.user, endpoint, params)
            request = requests.put(
                url,
                auth=HTTPBasicAuth(self.api_key, self.api_key_password),
                headers={
                    'User-Agent': 'Highton-API: (<EMAIL>)',
                    'content-type': 'application/xml'
                },
                params=params,
                data=data
            )
            
            if 'text/html' in request.headers['content-type']:
                raise XMLRequestException(url)

        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint, 'Updating to Highrise failed'
                )

        if params['reload'] and request.status_code is 200:
            data = objectify.fromstring(request.content)
            model = highrise_class()
            model.save_data(data)
            return {'response': request, 'model': model}

        else:
            return request

    def _delete_request(self, endpoint, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(
            self.user, endpoint, params)
        request = requests.delete(
            url,
            auth=HTTPBasicAuth(self.api_key, self.api_key_password),
            headers={
                'User-Agent': 'Highton-API: (<EMAIL>)',
            },
            params=params,
        )

        if 'text/html' in request.headers['content-type']:
            raise XMLRequestException(url)

        return request

    def get_person(self, subject_id):
        """
        Gives you a chosen person as an object.
        :param subject_id: the highrise_id of the person
        :return: person object
        """
        return self._get_object_data(self._get_single_data('people/{}'.format(
            subject_id)), Person)[0]

    def get_people(self):
        """
        Just run this Method and you get a Person object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(self._get_paged_data('people'), Person)

    def get_people_since(self, since):
        """
        Gives you all people since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all people since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_paged_data(
            'people', params={'since': since}), Person)

    def _get_categories(self, category_type):
        return self._get_data(category_type + '_categories')

    def get_task_categories(self):
        """
        Get all Task-Categories
        :return: all Task-Categories
        """
        return self._get_object_data(
            self._get_categories('task'), TaskCategory)

    def get_deal_categories(self):
        """
        Get all Deal-Categories
        :return: all Deal-Categories
        """
        return self._get_object_data(
            self._get_categories('deal'), DealCategory)

    def get_company(self, subject_id):
        """
        Gives you a chosen company as an object.
        :param subject_id: the highrise_id of the company
        :return: company object
        """
        return self._get_object_data(self._get_single_data(
            'companies/{}'.format(subject_id)), Company)[0]

    def get_companies(self):
        """
        Just run this Method and you get a Company object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(
            self._get_paged_data('companies'), Company)

    def get_companies_since(self, since):
        """
        Gives you all companies since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all companies since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_paged_data(
            'companies', params={'since': since}), Company)

    def get_case(self, subject_id):
        """
        Gives you a chosen case as an object.
        :param subject_id: the highrise_id of the case
        :return: case object
        """
        return self._get_object_data(self._get_single_data('kases/{}'.format(
            subject_id)), Case)[0]

    def get_cases(self):
        """
        Just run this Method and you get a Case object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(self._get_paged_data('kases'), Case)

    def get_cases_since(self, since):
        """
        Gives you all Cases since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all cases since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException(since)
        return self._get_object_data(self._get_paged_data(
            'kases', params={'since': since}), Case)

    def get_deal(self, subject_id):
        """
        Gives you a chosen deal as an object
        :param subject_id: the highrise_id of the deal
        :return: deal object
        """
        return self._get_object_data(self._get_single_data('deals/{}'.format(
            subject_id)), Deal)[0]

    def get_deals(self):
        """
        Gives you all Deals, but handle them wisely!
        :return: returns you all the Deals you have
        """
        return self._get_object_data(self._get_paged_data('deals'), Deal)

    def get_deals_since(self, since):
        """
        Gives you all deals since the parameter since
        :param since: Have to be String in format YYYYMMDDHHMMSS
        :return: returns you all Deals which were updated since the parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_data(
            'deals', params={'since': since}), Deal)

    def get_deals_by_status(self, status):
        fields = ['won', 'lost', 'pending']
        if status not in fields:
            raise FieldException(fields)
        return self._get_object_data(self._get_paged_data(
            'deals', params={'status': status}), Deal)

    def get_task(self, subject_id):
        """
        Gives you a chosen task as an object.
        :param subject_id: the highrise_id of the task
        :return: task object
        """
        return self._get_object_data(self._get_single_data('tasks/{}'.format(
            subject_id)), Task)[0]

    def _get_tasks(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/tasks'.format(
            highrise_type, subject_id)), Task)

    def get_tasks(self):
        return self._get_object_data(self._get_data('tasks/all'), Task)

    def get_person_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'people')

    def get_company_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'companies')

    def get_case_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'kases')

    def get_deal_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'deals')

    def _get_notes(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/notes'.format(
            highrise_type, subject_id)), Note)

    def get_person_notes(self, subject_id):
        return self._get_notes(subject_id, 'people')

    def get_company_notes(self, subject_id):
        return self._get_notes(subject_id, 'companies')

    def get_case_notes(self, subject_id):
        return self._get_notes(subject_id, 'kases')

    def get_deal_notes(self, subject_id):
        return self._get_notes(subject_id, 'deals')

    def _get_emails(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/emails'.format(
            highrise_type, subject_id)), Email)

    def get_person_emails(self, subject_id):
        return self._get_emails(subject_id, 'people')

    def get_company_emails(self, subject_id):
        return self._get_emails(subject_id, 'companies')

    def get_case_emails(self, subject_id):
        return self._get_emails(subject_id, 'kases')

    def get_deal_emails(self, subject_id):
        return self._get_emails(subject_id, 'deals')

    def get_user(self, subject_id, params={}):
        """
        Gives you a chosen user as an object
        :param subject_id: the highrise_id of the user
        :return: user object
        """
        return self._get_object_data(self._get_single_data('users/{}'.format(
            subject_id)), User)[0]

    def get_users(self, params={}):
        """
        Gives you all Users attached to this domain.
        :return: returns you all the Users you have.
        """
        return self._get_object_data(
            self._get_data('users', params), User)

    def get_deletions(self, params={}):
        # Get the xml data in an etree obj since we have lxml.
        # This object type is odd since the `type` attr is attached
        # to the xml at a parent level relative to the placement
        # of the rest of the data.
        _deletions = etree.fromstring(
            self._get_request('deletions', params).content)
        deletions = []
        for deletion in _deletions:
            data = {}
            data['type'] = list(deletion.attrib.values())[0]
            for sub in deletion:
                data[sub.tag] = sub.text
            temp = Deletion()
            temp.save_data(data)
            deletions.append(temp)
        return deletions

    def get_deletions_since(self, since):
        """
        Gives you all deletions since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all deletions since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self.get_deletions(params={'since': since})

    # Search Methods:
    def search_people(self, criteria):
        """
        Just run this Method and you get a Person object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people matching the supplied search criteria (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        params = {}
        for key, value in list(criteria.items()):
            params['criteria['+key+']'] = value
        return self._get_object_data(self._get_paged_data('people/search', params=params), Person)
    
    # Create Methods:
    def post_case(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            cases.md#create-case
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('kases', Case, data, params)

    # TODO: Add a Comment class.
    # def post_comment(self, data, params={}):
    #     req = self._post_request('comments', data, params)
    #     temp = Comment()
    #     temp.save_data(objectify.fromstring(req.content))
    #     return {'model': temp, 'status': req.headers['Status']}

    def post_company(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            companies.md#create-company
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('companies', Company, data, params)

    def post_custom_field(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            custom_fields.md#create-custom-field
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('subject_fields', SubjectData, data, params)

    def post_deal(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            deals.md#create-deal
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('deals', Deal, data, params)

    def post_email(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            emails.md#create-email
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('emails', Email, data, params)

    def post_subject_email(self, subject_type, subject_id, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            emails.md#create-email
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('{}/{}/emails'.format(
            subject_type, subject_id), Email, data, params)

    # TODO: Add Group class.
    # def post_group(self, data, params={}):
    #     """
    #     Post a given (xml string) to Highrise.
    #     :param data: Highrise HQ data format see:
    #         https://github.com/basecamp/highrise-api/blob/master/sections/
    #         groups.md#create-group
    #     :param params: see:
    #         https://pypi.python.org/pypi/requests/2.3.0
    #     """
    #     return self._get_object_data(
    #         self._post_request('groups', data, params), Group)[0]

    def post_note(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            notes.md#create-note
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('notes', Note, data, params)

    def post_subject_note(self, subject_type, subject_id, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            notes.md#create-note
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('{}/{}/notes'.format(
            subject_type, subject_id), Note, data, params)

    def post_person(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            people.md#create-person
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('people', Person, data, params)

    def post_task(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            tasks.md#create-task
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('tasks', Task, data, params)

    # Update Methods:
    def put_case(self, highrise_id, data, params={}):
        return self._put_request(
            'kases/{}'.format(highrise_id), Case, data, params)

    # def put_comment(self, highrise_id, data, params={}):
    #     return self._put_request(
    #         'comments/{}'.format(highrise_id), data, params)

    def put_company(self, highrise_id, data, params={}):
        return self._put_request(
            'companies/{}'.format(highrise_id), Company, data, params)

    def put_custom_field(self, highrise_id, data, params={}):
        return self._put_request(
            'subject_field/{}'.format(highrise_id), SubjectData, data, params)

    def put_deal(self, highrise_id, data, params={}):
        return self._put_request('deals/{}'.format(highrise_id), Deal, data, params)

    def put_email(self, highrise_id, data, params={}):
        return self._put_request('emails/{}'.format(highrise_id), Email, data, params)

    # def put_group(self, highrise_id, data, params={}):
    #     return self._put_request(
    #         'groups/{}'.format(highrise_id), data, params)

    def put_note(self, highrise_id, data, params={}):
        return self._put_request('notes/{}'.format(highrise_id), Note, data, params)

    def put_person(self, highrise_id, data, params={}):
        return self._put_request('people/{}'.format(highrise_id), Person, data, params)

    def put_task(self, highrise_id, data, params={}):
        return self._put_request('tasks/{}'.format(highrise_id), Task, data, params)

    # Destroy Methods
    def delete_case(self, highrise_id, params={}):
        return self._delete_request('kases/{}'.format(highrise_id), params)

    def delete_category(self, model_type, highrise_id, params={}):
        return self._delete_request(
            '{}_categories/{}'.format(model_type, highrise_id), params)

    def delete_comment(self, highrise_id, params={}):
        return self._delete_request('comments/{}'.format(highrise_id), params)

    def delete_company(self, highrise_id, params={}):
        return self._delete_request(
            'companies/{}'.format(highrise_id), params)

    def delete_custom_field(self, highrise_id, params={}):
        return self._delete_request(
            'subject_field/{}'.format(highrise_id), params)

    def delete_deal(self, highrise_id, params={}):
        return self._delete_request('deals/{}'.format(highrise_id), params)

    def delete_email(self, highrise_id, params={}):
        return self._delete_request('emails/{}'.format(highrise_id), params)

    def delete_group(self, highrise_id, params={}):
        return self._delete_request('groups/{}'.format(highrise_id), params)

    def delete_membership(self, highrise_id, params={}):
        return self._delete_request(
            'memberships/{}'.format(highrise_id), params)

    def delete_note(self, highrise_id, params={}):
        return self._delete_request('notes/{}'.format(highrise_id), params)

    def delete_person(self, highrise_id, params={}):
        return self._delete_request('people/{}'.format(highrise_id), params)

    def delete_tag(self, subject_type, subject_id, highrise_id, params={}):
        """
        A delete call for a tag requires a specific path.
        DELETE /#{subject_type}/#{subject_id}/tags/#{id}.xml
        """
        return self._delete_request('{}/{}/tags/{}'.format(
            subject_type, subject_id, highrise_id), params)

    def delete_task(self, highrise_id, params={}):
        return self._delete_request('tasks/{}'.format(highrise_id), params)

# -*- coding: utf-8 -*-
import datetime
import logging

import requests
from lxml import objectify, etree
from requests.auth import HTTPBasicAuth

from .custom_exceptions import (HighriseRequestException, ParseTimeException,
                                FieldException, XMLRequestException)
from .classes.person import Person
from .classes.category import DealCategory, TaskCategory
from .classes.company import Company
from .classes.case import Case
from .classes.deal import Deal
from .classes.task import Task
from .classes.note import Note
from .classes.email import Email
from .classes.deletions import Deletion
from .classes.custom_field import SubjectData
from .classes.user import User
from .classes.tools import to_datetime

logger = logging.getLogger(__name__)


class Highton(object):
    """
        Highton-API is just a really simple Python library which helps you to
        get information about your Highrise data
    """

    def __init__(self, api_key, user):
        self.user = user
        self.api_key = api_key
        self.api_key_password = 'X'

    def _get_request(self, endpoint, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(self.user, endpoint)
        request = requests.get(
            url,
            auth=HTTPBasicAuth(self.api_key, self.api_key_password),
            headers={'User-Agent': 'Highton-API: (<EMAIL>)'},
            params=params,
        )

        if 'text/html' in request.headers['content-type']:
            raise XMLRequestException(url)

        return request

    def get_account(self, params={}):
        """
        Set the account on the Highton instance. There really isn't a reason
        not to since there should be only one account here.
        """
        account = objectify.fromstring(
            self._get_request('account', params).content
        )
        self.account = {}
        self.account['highrise_id'] = account['id'].pyval
        self.account['created_at'] = to_datetime(account['created-at'].pyval)
        self.account['updated_at'] = to_datetime(account['updated-at'].pyval)
        for attr in [
            'name',
            'subdomain',
            'plan',
            'color_theme',
            'ssl_enabled',
            'people-count',
            'storage'
        ]:
            self.account[attr.replace('-', '_')] = account[attr].pyval

    def get_current_auth_user(self, params={}):
        """
        Gives you the currently authenticated user as an object.
        :return: task object on Highton instance.
        """
        user = objectify.fromstring(
            self._get_request('me', params).content
        )

        self.me = {}
        self.me['highrise_id'] = user['id'].pyval
        self.me['created_at'] = to_datetime(user['created-at'].pyval)
        self.me['updated_at'] = to_datetime(user['updated-at'].pyval)

        for attr in [
            'name',
            'email-address',
            'token',
            'dropbox',
            'admin'
        ]:
            self.me[attr.replace('-', '_')] = user[attr].pyval

    def _get_single_data(self, endpoint, params={}):
        data = []
        try:
            data = objectify.fromstring(
                self._get_request(endpoint, params).content
            )
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing data from Highrise caused a failure'
                )
        return data

    def _get_data(self, endpoint, params={}, fail_counter=0):
        data = []
        try:
            content = self._get_request(endpoint, params).content
            data = objectify.fromstring(
                content
            ).getchildren()
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing data from Highrise caused a failure'
                )
        except etree.XMLSyntaxError:
            if fail_counter < 3:
                self._get_data(endpoint=endpoint, params=params, fail_counter=fail_counter+1)
            return False
        return data

    def _get_paged_data(self, endpoint, params={}):
        data = []
        try:
            page = 500
            counter = 0
            while True:
                params.update({'n': page * counter})
                objects = objectify.fromstring(
                    self._get_request(endpoint, params).content
                ).getchildren()
                if objects:
                    data += objects
                else:
                    break
                counter += 1
        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Parsing people from Highrise caused a failure'
                )
        return data

    def _get_object_data(self, data, highrise_class):
        """
        Return a formatted highrise_class list or False if there is an error
        """
        data_list = []
        if data:
            for d in data:
                temp = highrise_class()
                temp.save_data(d)
                data_list.append(temp)
        else:
            logger.debug(
                'No data found for your Request (Class: {}). Here is some data: {}'.format(
                    data, highrise_class
                )
            )
            return False
        return data_list

    def _post_request(self, endpoint, highrise_class, data=None, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(
            self.user, endpoint, params)
        try:
            request = requests.post(
                url,
                auth=HTTPBasicAuth(self.api_key, self.api_key_password),
                headers={
                    'User-Agent': 'Highton-API: (<EMAIL>)',
                    'content-type': 'application/xml'
                },
                params=params,
                data=data
            )

            data = objectify.fromstring(request.content)
            model = highrise_class()
            model.save_data(data)

            if 'text/html' in request.headers['content-type']:
                raise XMLRequestException(url)

        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint,
                    'Posting data to Highrise failed'
                )

        return {'response': request, 'model': model}

    def _put_request(self, endpoint, highrise_class, data=None, params={}):
        try:
            url = 'https://{}.highrisehq.com/{}.xml'.format(
                self.user, endpoint, params)
            request = requests.put(
                url,
                auth=HTTPBasicAuth(self.api_key, self.api_key_password),
                headers={
                    'User-Agent': 'Highton-API: (<EMAIL>)',
                    'content-type': 'application/xml'
                },
                params=params,
                data=data
            )
            
            if 'text/html' in request.headers['content-type']:
                raise XMLRequestException(url)

        except TypeError:
            if not data:
                raise HighriseRequestException(
                    endpoint, 'Updating to Highrise failed'
                )

        if params['reload'] and request.status_code is 200:
            data = objectify.fromstring(request.content)
            model = highrise_class()
            model.save_data(data)
            return {'response': request, 'model': model}

        else:
            return request

    def _delete_request(self, endpoint, params={}):
        url = 'https://{}.highrisehq.com/{}.xml'.format(
            self.user, endpoint, params)
        request = requests.delete(
            url,
            auth=HTTPBasicAuth(self.api_key, self.api_key_password),
            headers={
                'User-Agent': 'Highton-API: (<EMAIL>)',
            },
            params=params,
        )

        if 'text/html' in request.headers['content-type']:
            raise XMLRequestException(url)

        return request

    def get_person(self, subject_id):
        """
        Gives you a chosen person as an object.
        :param subject_id: the highrise_id of the person
        :return: person object
        """
        return self._get_object_data(self._get_single_data('people/{}'.format(
            subject_id)), Person)[0]

    def get_people(self):
        """
        Just run this Method and you get a Person object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(self._get_paged_data('people'), Person)

    def get_people_since(self, since):
        """
        Gives you all people since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all people since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_paged_data(
            'people', params={'since': since}), Person)

    def _get_categories(self, category_type):
        return self._get_data(category_type + '_categories')

    def get_task_categories(self):
        """
        Get all Task-Categories
        :return: all Task-Categories
        """
        return self._get_object_data(
            self._get_categories('task'), TaskCategory)

    def get_deal_categories(self):
        """
        Get all Deal-Categories
        :return: all Deal-Categories
        """
        return self._get_object_data(
            self._get_categories('deal'), DealCategory)

    def get_company(self, subject_id):
        """
        Gives you a chosen company as an object.
        :param subject_id: the highrise_id of the company
        :return: company object
        """
        return self._get_object_data(self._get_single_data(
            'companies/{}'.format(subject_id)), Company)[0]

    def get_companies(self):
        """
        Just run this Method and you get a Company object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(
            self._get_paged_data('companies'), Company)

    def get_companies_since(self, since):
        """
        Gives you all companies since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all companies since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_paged_data(
            'companies', params={'since': since}), Company)

    def get_case(self, subject_id):
        """
        Gives you a chosen case as an object.
        :param subject_id: the highrise_id of the case
        :return: case object
        """
        return self._get_object_data(self._get_single_data('kases/{}'.format(
            subject_id)), Case)[0]

    def get_cases(self):
        """
        Just run this Method and you get a Case object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        return self._get_object_data(self._get_paged_data('kases'), Case)

    def get_cases_since(self, since):
        """
        Gives you all Cases since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all cases since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException(since)
        return self._get_object_data(self._get_paged_data(
            'kases', params={'since': since}), Case)

    def get_deal(self, subject_id):
        """
        Gives you a chosen deal as an object
        :param subject_id: the highrise_id of the deal
        :return: deal object
        """
        return self._get_object_data(self._get_single_data('deals/{}'.format(
            subject_id)), Deal)[0]

    def get_deals(self):
        """
        Gives you all Deals, but handle them wisely!
        :return: returns you all the Deals you have
        """
        return self._get_object_data(self._get_paged_data('deals'), Deal)

    def get_deals_since(self, since):
        """
        Gives you all deals since the parameter since
        :param since: Have to be String in format YYYYMMDDHHMMSS
        :return: returns you all Deals which were updated since the parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self._get_object_data(self._get_data(
            'deals', params={'since': since}), Deal)

    def get_deals_by_status(self, status):
        fields = ['won', 'lost', 'pending']
        if status not in fields:
            raise FieldException(fields)
        return self._get_object_data(self._get_paged_data(
            'deals', params={'status': status}), Deal)

    def get_task(self, subject_id):
        """
        Gives you a chosen task as an object.
        :param subject_id: the highrise_id of the task
        :return: task object
        """
        return self._get_object_data(self._get_single_data('tasks/{}'.format(
            subject_id)), Task)[0]

    def _get_tasks(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/tasks'.format(
            highrise_type, subject_id)), Task)

    def get_tasks(self):
        return self._get_object_data(self._get_data('tasks/all'), Task)

    def get_person_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'people')

    def get_company_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'companies')

    def get_case_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'kases')

    def get_deal_tasks(self, subject_id):
        return self._get_tasks(subject_id, 'deals')

    def _get_notes(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/notes'.format(
            highrise_type, subject_id)), Note)

    def get_person_notes(self, subject_id):
        return self._get_notes(subject_id, 'people')

    def get_company_notes(self, subject_id):
        return self._get_notes(subject_id, 'companies')

    def get_case_notes(self, subject_id):
        return self._get_notes(subject_id, 'kases')

    def get_deal_notes(self, subject_id):
        return self._get_notes(subject_id, 'deals')

    def _get_emails(self, subject_id, highrise_type):
        return self._get_object_data(self._get_data('{}/{}/emails'.format(
            highrise_type, subject_id)), Email)

    def get_person_emails(self, subject_id):
        return self._get_emails(subject_id, 'people')

    def get_company_emails(self, subject_id):
        return self._get_emails(subject_id, 'companies')

    def get_case_emails(self, subject_id):
        return self._get_emails(subject_id, 'kases')

    def get_deal_emails(self, subject_id):
        return self._get_emails(subject_id, 'deals')

    def get_user(self, subject_id, params={}):
        """
        Gives you a chosen user as an object
        :param subject_id: the highrise_id of the user
        :return: user object
        """
        return self._get_object_data(self._get_single_data('users/{}'.format(
            subject_id)), User)[0]

    def get_users(self, params={}):
        """
        Gives you all Users attached to this domain.
        :return: returns you all the Users you have.
        """
        return self._get_object_data(
            self._get_data('users', params), User)

    def get_deletions(self, params={}):
        # Get the xml data in an etree obj since we have lxml.
        # This object type is odd since the `type` attr is attached
        # to the xml at a parent level relative to the placement
        # of the rest of the data.
        _deletions = etree.fromstring(
            self._get_request('deletions', params).content)
        deletions = []
        for deletion in _deletions:
            data = {}
            data['type'] = list(deletion.attrib.values())[0]
            for sub in deletion:
                data[sub.tag] = sub.text
            temp = Deletion()
            temp.save_data(data)
            deletions.append(temp)
        return deletions

    def get_deletions_since(self, since):
        """
        Gives you all deletions since the set parameter
        :param since: string with %Y%m%d%H%M%S - Format
        :return: return all deletions since the given parameter
        """
        try:
            datetime.datetime.strptime(since, '%Y%m%d%H%M%S')
        except ValueError:
            raise ParseTimeException
        return self.get_deletions(params={'since': since})

    # Search Methods:
    def search_people(self, criteria):
        """
        Just run this Method and you get a Person object with all objects and
        attributes inside it. Get Lucky
        :return: returns all people matching the supplied search criteria (of course it iterates over all pages, so
            you dont get only the first 500)
        """
        params = {}
        for key, value in list(criteria.items()):
            params['criteria['+key+']'] = value
        return self._get_object_data(self._get_paged_data('people/search', params=params), Person)
    
    # Create Methods:
    def post_case(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            cases.md#create-case
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('kases', Case, data, params)

    # TODO: Add a Comment class.
    # def post_comment(self, data, params={}):
    #     req = self._post_request('comments', data, params)
    #     temp = Comment()
    #     temp.save_data(objectify.fromstring(req.content))
    #     return {'model': temp, 'status': req.headers['Status']}

    def post_company(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            companies.md#create-company
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('companies', Company, data, params)

    def post_custom_field(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            custom_fields.md#create-custom-field
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('subject_fields', SubjectData, data, params)

    def post_deal(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            deals.md#create-deal
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('deals', Deal, data, params)

    def post_email(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            emails.md#create-email
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('emails', Email, data, params)

    def post_subject_email(self, subject_type, subject_id, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            emails.md#create-email
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('{}/{}/emails'.format(
            subject_type, subject_id), Email, data, params)

    # TODO: Add Group class.
    # def post_group(self, data, params={}):
    #     """
    #     Post a given (xml string) to Highrise.
    #     :param data: Highrise HQ data format see:
    #         https://github.com/basecamp/highrise-api/blob/master/sections/
    #         groups.md#create-group
    #     :param params: see:
    #         https://pypi.python.org/pypi/requests/2.3.0
    #     """
    #     return self._get_object_data(
    #         self._post_request('groups', data, params), Group)[0]

    def post_note(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            notes.md#create-note
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('notes', Note, data, params)

    def post_subject_note(self, subject_type, subject_id, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            notes.md#create-note
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('{}/{}/notes'.format(
            subject_type, subject_id), Note, data, params)

    def post_person(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            people.md#create-person
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('people', Person, data, params)

    def post_task(self, data, params={}):
        """
        Post a given (xml string) to Highrise.
        :param data: Highrise HQ data format see:
            https://github.com/basecamp/highrise-api/blob/master/sections/
            tasks.md#create-task
        :param params: see:
            https://pypi.python.org/pypi/requests/2.3.0
        """
        return self._post_request('tasks', Task, data, params)

    # Update Methods:
    def put_case(self, highrise_id, data, params={}):
        return self._put_request(
            'kases/{}'.format(highrise_id), Case, data, params)

    # def put_comment(self, highrise_id, data, params={}):
    #     return self._put_request(
    #         'comments/{}'.format(highrise_id), data, params)

    def put_company(self, highrise_id, data, params={}):
        return self._put_request(
            'companies/{}'.format(highrise_id), Company, data, params)

    def put_custom_field(self, highrise_id, data, params={}):
        return self._put_request(
            'subject_field/{}'.format(highrise_id), SubjectData, data, params)

    def put_deal(self, highrise_id, data, params={}):
        return self._put_request('deals/{}'.format(highrise_id), Deal, data, params)

    def put_email(self, highrise_id, data, params={}):
        return self._put_request('emails/{}'.format(highrise_id), Email, data, params)

    # def put_group(self, highrise_id, data, params={}):
    #     return self._put_request(
    #         'groups/{}'.format(highrise_id), data, params)

    def put_note(self, highrise_id, data, params={}):
        return self._put_request('notes/{}'.format(highrise_id), Note, data, params)

    def put_person(self, highrise_id, data, params={}):
        return self._put_request('people/{}'.format(highrise_id), Person, data, params)

    def put_task(self, highrise_id, data, params={}):
        return self._put_request('tasks/{}'.format(highrise_id), Task, data, params)

    # Destroy Methods
    def delete_case(self, highrise_id, params={}):
        return self._delete_request('kases/{}'.format(highrise_id), params)

    def delete_category(self, model_type, highrise_id, params={}):
        return self._delete_request(
            '{}_categories/{}'.format(model_type, highrise_id), params)

    def delete_comment(self, highrise_id, params={}):
        return self._delete_request('comments/{}'.format(highrise_id), params)

    def delete_company(self, highrise_id, params={}):
        return self._delete_request(
            'companies/{}'.format(highrise_id), params)

    def delete_custom_field(self, highrise_id, params={}):
        return self._delete_request(
            'subject_field/{}'.format(highrise_id), params)

    def delete_deal(self, highrise_id, params={}):
        return self._delete_request('deals/{}'.format(highrise_id), params)

    def delete_email(self, highrise_id, params={}):
        return self._delete_request('emails/{}'.format(highrise_id), params)

    def delete_group(self, highrise_id, params={}):
        return self._delete_request('groups/{}'.format(highrise_id), params)

    def delete_membership(self, highrise_id, params={}):
        return self._delete_request(
            'memberships/{}'.format(highrise_id), params)

    def delete_note(self, highrise_id, params={}):
        return self._delete_request('notes/{}'.format(highrise_id), params)

    def delete_person(self, highrise_id, params={}):
        return self._delete_request('people/{}'.format(highrise_id), params)

    def delete_tag(self, subject_type, subject_id, highrise_id, params={}):
        """
        A delete call for a tag requires a specific path.
        DELETE /#{subject_type}/#{subject_id}/tags/#{id}.xml
        """
        return self._delete_request('{}/{}/tags/{}'.format(
            subject_type, subject_id, highrise_id), params)

    def delete_task(self, highrise_id, params={}):
        return self._delete_request('tasks/{}'.format(highrise_id), params)
# -*- coding: utf-8 -*- Highton-API is just a really simple Python library which helps you to         get information about your Highrise data Set the account on the Highton instance. There really isn't a reason         not to since there should be only one account here. Gives you the currently authenticated user as an object.         :return: task object on Highton instance. Return a formatted highrise_class list or False if there is an error Gives you a chosen person as an object.         :param subject_id: the highrise_id of the person         :return: person object Just run this Method and you get a Person object with all objects and         attributes inside it. Get Lucky         :return: returns all people (of course it iterates over all pages, so             you dont get only the first 500) Gives you all people since the set parameter         :param since: string with %Y%m%d%H%M%S - Format         :return: return all people since the given parameter Get all Task-Categories         :return: all Task-Categories Get all Deal-Categories         :return: all Deal-Categories Gives you a chosen company as an object.         :param subject_id: the highrise_id of the company         :return: company object Just run this Method and you get a Company object with all objects and         attributes inside it. Get Lucky         :return: returns all people (of course it iterates over all pages, so             you dont get only the first 500) Gives you all companies since the set parameter         :param since: string with %Y%m%d%H%M%S - Format         :return: return all companies since the given parameter Gives you a chosen case as an object.         :param subject_id: the highrise_id of the case         :return: case object Just run this Method and you get a Case object with all objects and         attributes inside it. Get Lucky         :return: returns all people (of course it iterates over all pages, so             you dont get only the first 500) Gives you all Cases since the set parameter         :param since: string with %Y%m%d%H%M%S - Format         :return: return all cases since the given parameter Gives you a chosen deal as an object         :param subject_id: the highrise_id of the deal         :return: deal object Gives you all Deals, but handle them wisely!         :return: returns you all the Deals you have Gives you all deals since the parameter since         :param since: Have to be String in format YYYYMMDDHHMMSS         :return: returns you all Deals which were updated since the parameter Gives you a chosen task as an object.         :param subject_id: the highrise_id of the task         :return: task object Gives you a chosen user as an object         :param subject_id: the highrise_id of the user         :return: user object Gives you all Users attached to this domain.         :return: returns you all the Users you have. # Get the xml data in an etree obj since we have lxml. # This object type is odd since the `type` attr is attached # to the xml at a parent level relative to the placement # of the rest of the data. Gives you all deletions since the set parameter         :param since: string with %Y%m%d%H%M%S - Format         :return: return all deletions since the given parameter # Search Methods: Just run this Method and you get a Person object with all objects and         attributes inside it. Get Lucky         :return: returns all people matching the supplied search criteria (of course it iterates over all pages, so             you dont get only the first 500) # Create Methods: Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             cases.md#create-case         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 # TODO: Add a Comment class. # def post_comment(self, data, params={}): #     req = self._post_request('comments', data, params) #     temp = Comment() #     temp.save_data(objectify.fromstring(req.content)) #     return {'model': temp, 'status': req.headers['Status']} Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             companies.md#create-company         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             custom_fields.md#create-custom-field         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             deals.md#create-deal         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             emails.md#create-email         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             emails.md#create-email         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 # TODO: Add Group class. # def post_group(self, data, params={}): #     """ #     Post a given (xml string) to Highrise. #     :param data: Highrise HQ data format see: #         https://github.com/basecamp/highrise-api/blob/master/sections/ #         groups.md#create-group #     :param params: see: #         https://pypi.python.org/pypi/requests/2.3.0 #     """ #     return self._get_object_data( #         self._post_request('groups', data, params), Group)[0] Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             notes.md#create-note         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             notes.md#create-note         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             people.md#create-person         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 Post a given (xml string) to Highrise.         :param data: Highrise HQ data format see:             https://github.com/basecamp/highrise-api/blob/master/sections/             tasks.md#create-task         :param params: see:             https://pypi.python.org/pypi/requests/2.3.0 # Update Methods: # def put_comment(self, highrise_id, data, params={}): #     return self._put_request( #         'comments/{}'.format(highrise_id), data, params) # def put_group(self, highrise_id, data, params={}): #     return self._put_request( #         'groups/{}'.format(highrise_id), data, params) # Destroy Methods A delete call for a tag requires a specific path.         DELETE /#{subject_type}/#{subject_id}/tags/#{id}.xml