Module encoding

django.utils.encoding

source link

Classes

class DjangoUnicodeDecodeError

Functions

▶ def escape_uri_path(path)
Escape the unsafe characters from the path portion of a Uniform Resource Identifier (URI).
source link
Reexports
- Imported in django.http.request.

▶ def filepath_to_uri(path)

Convert a file system path to a URI portion that is suitable for inclusion in a URL.

source link

Encode certain chars that would normally be recognized as special chars
for URIs. Do not encode the ' character, as it is a valid character
within URIs. See the encodeURIComponent() JavaScript function for details.

Reexports

Imported in django.core.files.storage.

▶ def force_bytes(s, encoding='utf-8', strings_only=False, errors='strict')
Similar to smart_bytes, except that lazy instances are resolved to strings, rather than kept as lazy objects.
source link
```
If strings_only is True, don't convert (some) non-string-like objects.
```
Reexports
- Imported in django.contrib.auth.forms.
- Imported in django.contrib.gis.gdal.datasource.
- Imported in django.contrib.gis.gdal.driver.
- Imported in django.contrib.gis.gdal.feature.
- Imported in django.contrib.gis.gdal.geometries.
- Imported in django.contrib.gis.gdal.layer.
- Imported in django.contrib.gis.gdal.raster.source.
- Imported in django.contrib.gis.gdal.srs.
- Imported in django.contrib.gis.geos.geometry.
- Imported in django.contrib.gis.geos.prototypes.io.
- Imported in django.core.signing.
- Imported in django.db.backends.oracle.base.
- Imported in django.db.backends.oracle.operations.
- Imported in django.test.client.
- Imported in django.utils.crypto.
▶ def force_str(s, encoding='utf-8', strings_only=False, errors='strict')
Similar to smart_str(), except that lazy instances are resolved to strings, rather than kept as lazy objects.
source link
```
If strings_only is True, don't convert (some) non-string-like objects.
```
Reexports
- Imported in django.contrib.gis.gdal.datasource.
- Imported in django.contrib.gis.gdal.driver.
- Imported in django.contrib.gis.gdal.feature.
- Imported in django.contrib.gis.gdal.field.
- Imported in django.contrib.gis.gdal.layer.
- Imported in django.contrib.gis.gdal.raster.band.
- Imported in django.contrib.gis.gdal.raster.source.
- Imported in django.contrib.gis.gdal.srs.
- Imported in django.contrib.gis.geos.geometry.
- Imported in django.contrib.gis.utils.layermapping.
- Imported in django.core.mail.message.
- Imported in django.db.backends.base.operations.
- Imported in django.db.backends.mysql.operations.
- Imported in django.db.backends.oracle.base.
- Imported in django.db.backends.oracle.operations.
- Imported in django.db.models.base.
- Imported in django.http.multipartparser.
- Imported in django.views.debug.
▷ def force_text(s, encoding='utf-8', strings_only=False, errors='strict')
source link
▷ def get_system_encoding()
The encoding of the default system locale. Fallback to 'ascii' if the #encoding is unsupported by Python or could not be determined. See tickets #10335 and #5846.
source link
▶ def iri_to_uri(iri)
Convert an Internationalized Resource Identifier (IRI) portion to a URI portion that is suitable for inclusion in a URL.
source link
```
This is the algorithm from section 3.1 of RFC 3987, slightly simplified
since the input is assumed to be a string rather than an arbitrary byte
stream.

Take an IRI (string or UTF-8 bytes, e.g. '/I ♥ Django/' or
b'/I â¥ Django/') and return a string containing the encoded
result with ASCII chars only (e.g. '/I%20%E2%99%A5%20Django/').
```
Reexports
- Imported in django.contrib.flatpages.models.
- Imported in django.contrib.syndication.views.
- Imported in django.http.request.
- Imported in django.http.response.
- Imported in django.template.defaultfilters.
- Imported in django.templatetags.static.
- Imported in django.utils.feedgenerator.
▶ def is_protected_type(obj)
Determine if the object instance is of a protected type.
source link
```
Objects of protected types are preserved as-is when passed to
force_str(strings_only=True).
```
Reexports
- Imported in django.core.serializers.python.
▶ def punycode(domain)
Return the Punycode of the given domain if it's non-ASCII.
source link
Reexports
- Imported in django.core.mail.message.
- Imported in django.core.mail.utils.
- Imported in django.core.validators.
- Imported in django.utils.html.
▶ def repercent_broken_unicode(path)
As per section 3.2 of RFC 3987, step three of converting a URI into an IRI, repercent-encode any octet produced that is not part of a strictly legal UTF-8 octet sequence.
source link
Reexports
- Imported in django.core.handlers.wsgi.
▶ def smart_bytes(s, encoding='utf-8', strings_only=False, errors='strict')
Return a bytestring version of 's', encoded as specified in 'encoding'.
source link
```
If strings_only is True, don't convert (some) non-string-like objects.
```
▶ def smart_str(s, encoding='utf-8', strings_only=False, errors='strict')
Return a string representing 's'. Treat bytestrings using the 'encoding' codec.
source link
```
If strings_only is True, don't convert (some) non-string-like objects.
```
▷ def smart_text(s, encoding='utf-8', strings_only=False, errors='strict')
source link

▶ def uri_to_iri(uri)

Convert a Uniform Resource Identifier(URI) into an Internationalized Resource Identifier(IRI).

source link

This is the algorithm from section 3.2 of RFC 3987, excluding step 4.

Take an URI in ASCII bytes (e.g. '/I%20%E2%99%A5%20Django/') and return
a string containing the encoded result (e.g. '/I%20♥%20Django/').