]>
git.madduck.net Git - etc/taskwarrior.git/blobdiff - tasklib/task.py
madduck's git repository
Every one of the projects in this repository is available at the canonical
URL git://git.madduck.net/madduck/pub/<projectpath> — see
each project's metadata for the exact URL.
All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@ git. madduck. net .
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
SSH access, as well as push access can be individually
arranged .
If you use my repositories frequently, consider adding the following
snippet to ~/.gitconfig and using the third clone URL listed for each
project:
[url "git://git.madduck.net/madduck/"]
insteadOf = madduck:
PENDING = 'pending'
COMPLETED = 'completed'
PENDING = 'pending'
COMPLETED = 'completed'
+VERSION_2_1_0 = six.u('2.1.0')
+VERSION_2_2_0 = six.u('2.2.0')
+VERSION_2_3_0 = six.u('2.3.0')
+VERSION_2_4_0 = six.u('2.4.0')
+
logger = logging.getLogger(__name__)
logger = logging.getLogger(__name__)
- def __init__(self, warrior, data={}):
+ class NotSaved(Exception):
+ """
+ Raised when the operation cannot be performed on the task, because
+ it has not been saved to TaskWarrior yet.
+ """
+ pass
+
+ def __init__(self, warrior, data={}, **kwargs):
+
+ # We keep data for backwards compatibility
+ kwargs.update(data)
+
+ self._load_data(kwargs)
self._modified_fields = set()
def __unicode__(self):
self._modified_fields = set()
def __unicode__(self):
return ','.join(tags) if tags else ''
def delete(self):
return ','.join(tags) if tags else ''
def delete(self):
+ if not self.saved:
+ raise Task.NotSaved("Task needs to be saved before it can be deleted")
+
# Refresh the status, and raise exception if the task is deleted
self.refresh(only_fields=['status'])
if self.deleted:
# Refresh the status, and raise exception if the task is deleted
self.refresh(only_fields=['status'])
if self.deleted:
- raise self .DeletedTask("Task was already deleted")
+ raise Task .DeletedTask("Task was already deleted")
self.warrior.execute_command([self['uuid'], 'delete'], config_override={
'confirmation': 'no',
self.warrior.execute_command([self['uuid'], 'delete'], config_override={
'confirmation': 'no',
+ if not self.saved:
+ raise Task.NotSaved("Task needs to be saved before it can be completed")
+
# Refresh, and raise exception if task is already completed/deleted
self.refresh(only_fields=['status'])
if self.completed:
# Refresh, and raise exception if task is already completed/deleted
self.refresh(only_fields=['status'])
if self.completed:
- raise self .CompletedTask("Cannot complete a completed task")
+ raise Task .CompletedTask("Cannot complete a completed task")
- raise self .DeletedTask("Deleted task cannot be completed")
+ raise Task .DeletedTask("Deleted task cannot be completed")
self.warrior.execute_command([self['uuid'], 'done'])
self.warrior.execute_command([self['uuid'], 'done'])
self.refresh()
def add_annotation(self, annotation):
self.refresh()
def add_annotation(self, annotation):
+ if not self.saved:
+ raise Task.NotSaved("Task needs to be saved to add annotation")
+
args = [self['uuid'], 'annotate', annotation]
self.warrior.execute_command(args)
args = [self['uuid'], 'annotate', annotation]
self.warrior.execute_command(args)
- # TODO: This will not work with the tasks that are not yet saved
self.refresh(only_fields=['annotations'])
def remove_annotation(self, annotation):
self.refresh(only_fields=['annotations'])
def remove_annotation(self, annotation):
+ if not self.saved:
+ raise Task.NotSaved("Task needs to be saved to add annotation")
+
if isinstance(annotation, TaskAnnotation):
annotation = annotation['description']
args = [self['uuid'], 'denotate', annotation]
self.warrior.execute_command(args)
if isinstance(annotation, TaskAnnotation):
annotation = annotation['description']
args = [self['uuid'], 'denotate', annotation]
self.warrior.execute_command(args)
- # TODO: This will not work with the tasks that are not yet saved
self.refresh(only_fields=['annotations'])
def _get_modified_fields_as_args(self):
args = []
self.refresh(only_fields=['annotations'])
def _get_modified_fields_as_args(self):
args = []
+ def add_field(field):
+ # Task version older than 2.4.0 ignores first word of the
+ # task description if description: prefix is used
+ if self.warrior.version < VERSION_2_4_0 and field == 'description':
+ args.append(self._data[field])
+ else:
+ args.append('{0}:{1}'.format(field, self._data[field]))
+
# If we're modifying saved task, simply pass on all modified fields
if self.saved:
for field in self._modified_fields:
# If we're modifying saved task, simply pass on all modified fields
if self.saved:
for field in self._modified_fields:
- args.append('{0}:{1}'.format(field, self._data[field]) )
# For new tasks, pass all fields that make sense
else:
for field in self._data.keys():
if field in self.read_only_fields:
continue
# For new tasks, pass all fields that make sense
else:
for field in self._data.keys():
if field in self.read_only_fields:
continue
- args.append('{0}:{1}'.format(field, self._data[field]) )
return args
def refresh(self, only_fields=[]):
return args
def refresh(self, only_fields=[]):
- # Do not refresh for tasks that are not yet saved in the TW
+ # Raise error when trying to refresh a task that has not been saved
+ raise Task.NotSaved("Task needs to be saved to be refreshed")
# We need to use ID as backup for uuid here for the refreshes
# of newly saved tasks. Any other place in the code is fine
# We need to use ID as backup for uuid here for the refreshes
# of newly saved tasks. Any other place in the code is fine
# Replace the value with empty string, since that is the
# convention in TW for empty values
value = value if value is not None else ''
# Replace the value with empty string, since that is the
# convention in TW for empty values
value = value if value is not None else ''
- self.filter_params.append('{0}:{1}'.format(key, value))
+
+ # If we are filtering by uuid:, do not use uuid keyword
+ # due to TW-1452 bug
+ if key == 'uuid':
+ self.filter_params.insert(0, value)
+ else:
+ self.filter_params.append('{0}:{1}'.format(key, value))
def get_filter_params(self):
return [f for f in self.filter_params if f]
def get_filter_params(self):
return [f for f in self.filter_params if f]
'data.location': os.path.expanduser(data_location),
}
self.tasks = TaskQuerySet(self)
'data.location': os.path.expanduser(data_location),
}
self.tasks = TaskQuerySet(self)
+ self.version = self._get_version()
def _get_command_args(self, args, config_override={}):
command_args = ['task', 'rc:/']
def _get_command_args(self, args, config_override={}):
command_args = ['task', 'rc:/']
command_args.extend(map(str, args))
return command_args
command_args.extend(map(str, args))
return command_args
+ def _get_version(self):
+ p = subprocess.Popen(
+ ['task', '--version'],
+ stdout=subprocess.PIPE,
+ stderr=subprocess.PIPE)
+ stdout, stderr = [x.decode('utf-8') for x in p.communicate()]
+ return stdout.strip('\n')
+
def execute_command(self, args, config_override={}):
command_args = self._get_command_args(
args, config_override=config_override)
def execute_command(self, args, config_override={}):
command_args = self._get_command_args(
args, config_override=config_override)