Docs for IS_SLUG

[ Python Tutorial ] [ Python Libraries ] [ web2py epydoc ]

Description


<type 'type'> extends (<class 'gluon.validators.Validator'>,)












































converts arbitrary text string to a slug::

>>>
IS_SLUG()('abc123')
(
'abc123', None)
>>>
IS_SLUG()('ABC123')
(
'abc123', None)
>>>
IS_SLUG()('abc-123')
(
'abc-123', None)
>>>
IS_SLUG()('abc--123')
(
'abc-123', None)
>>>
IS_SLUG()('abc 123')
(
'abc-123', None)
>>>
IS_SLUG()('abc _123')
(
'abc-123', None)
>>>
IS_SLUG()('-abc-')
(
'abc', None)
>>>
IS_SLUG()('--a--b--_ -c--')
(
'a-b-c', None)
>>>
IS_SLUG()('abc&amp;123')
(
'abc123', None)
>>>
IS_SLUG()('abc&amp;123&amp;def')
(
'abc123def', None)
>>>
IS_SLUG()('ñ')
(
'n', None)
>>>
IS_SLUG(maxlen=4)('abc123')
(
'abc1', None)
>>>
IS_SLUG()('abc_123')
(
'abc-123', None)
>>>
IS_SLUG(keep_underscores=False)('abc_123')
(
'abc-123', None)
>>>
IS_SLUG(keep_underscores=True)('abc_123')
(
'abc_123', None)
>>>
IS_SLUG(check=False)('abc')
(
'abc', None)
>>>
IS_SLUG(check=True)('abc')
(
'abc', None)
>>>
IS_SLUG(check=False)('a bc')
(
'a-bc', None)
>>>
IS_SLUG(check=True)('a bc')
(
'a bc', 'must be slug')


Attributes


IS_SLUG.__call__ <type 'instancemethod'> belongs to class <type 'instancemethod'>

IS_SLUG.__class__ <type 'type'> extends (<type 'object'>,) belongs to class <type 'type'>
type(object) -> the object's type type(name, bases, dict) -> a new type

IS_SLUG.__delattr__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__delattr__('name') <==> del x.name

IS_SLUG.__dict__ <type 'dictproxy'> belongs to class <type 'dictproxy'>

IS_SLUG.__doc__ <type 'str'> belongs to class <type 'str'>
str(object='') -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object.

IS_SLUG.__format__ <type 'method_descriptor'> belongs to class <type 'method_descriptor'>
default object formatter

IS_SLUG.__getattribute__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__getattribute__('name') <==> x.name

IS_SLUG.__hash__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__hash__() <==> hash(x)

IS_SLUG.__init__ <type 'instancemethod'> belongs to class <type 'instancemethod'>

IS_SLUG.__module__ <type 'str'> belongs to class <type 'str'>
str(object='') -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object.

IS_SLUG.__new__ <type 'builtin_function_or_method'> belongs to class <type 'builtin_function_or_method'>
T.__new__(S, ...) -> a new object with type S, a subtype of T

IS_SLUG.__reduce__ <type 'method_descriptor'> belongs to class <type 'method_descriptor'>
helper for pickle

IS_SLUG.__reduce_ex__ <type 'method_descriptor'> belongs to class <type 'method_descriptor'>
helper for pickle

IS_SLUG.__repr__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__repr__() <==> repr(x)

IS_SLUG.__setattr__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__setattr__('name', value) <==> x.name = value

IS_SLUG.__sizeof__ <type 'method_descriptor'> belongs to class <type 'method_descriptor'>
__sizeof__() -> int size of object in memory, in bytes

IS_SLUG.__str__ <type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'>
x.__str__() <==> str(x)

IS_SLUG.__subclasshook__ <type 'builtin_function_or_method'> belongs to class <type 'builtin_function_or_method'>
Abstract classes can override this to customize issubclass(). This is invoked early on by abc.ABCMeta.__subclasscheck__(). It should return True, False or NotImplemented. If it returns NotImplemented, the normal algorithm is used. Otherwise, it overrides the normal algorithm (and the outcome is cached).

IS_SLUG.__weakref__ <type 'getset_descriptor'> belongs to class <type 'getset_descriptor'>
list of weak references to the object (if defined)

IS_SLUG.formatter <type 'instancemethod'> belongs to class <type 'instancemethod'>
For some validators returns a formatted version (matching the validator) of value. Otherwise just returns the value.

IS_SLUG.urlify <type 'function'> belongs to class <type 'function'>