Generating wildcard ACL and URL tokens for Akamai

[evgkirov]

Related issues: #263 and #264.

This pull request introduces the ability to generate secure URLs with the same signature valid not only for the base URL of the file (e.g., https://cdn.yourdomain.com/52da3bfc-7cd8-4861-8b05-126fef7a6994/) but also for all of its transformations (#264). This is optional by default.

Also, AkamaiSecureUrlBuilderWithUrlToken class has been implemented (#263).

A new method called generate_secure_url_token is exposed for Uploadcare. Instead of full URL it will return just the token (unlike the generate_secure_url method).

Added

• For Uploadcare:

  • added generate_secure_url_token method.
  • added optional wildcard parameter to generate_secure_url method.

• For AkamaiSecureUrlBuilderWithAclToken:

  • added get_token method.
  • added optional wildcard parameter to build method.

• AkamaiSecureUrlBuilderWithUrlToken class.

Changed

• AkamaiSecureUrlBuilder has been renamed to AkamaiSecureUrlBuilderWithAclToken. It is still available under the old name and works as before, but it will give you a deprecation warning when you use it.

[dmitry-mukhin]

I think that AkamaiBuilder should have a method to get only token, now it's inside _build_token.

Intended usage, probably is something like:

original_url = "https://acme.ucarecdn.com/:uuid/"
builder = AkamaiSecureUrlBuilder(original_url, secret)
token = builder.get_token()

secure_preview = f"{original_url}-/preview/100x100/?token={token}"

added