Licensing and evaluation Leave feedback

To explore the system effectively, you may want immediate access to the API. GroupDocs.Assembly simplifies this by offering various purchase plans, along with a Free Trial and a 30-day Temporary License for evaluation.

Note

To learn more about licensing options, purchasing, and evaluation policies, refer to the Purchase Policies and FAQ section.

After purchasing GroupDocs.Assembly for Python via .NET, you will receive a license file that unlocks the full functionality of the API. A few rules apply:

• Apply the license only once per process, in your start-up code.
• Apply it before building the first report.
• A license can be applied from a file path, from a binary stream (handy when the license is an embedded resource), from an environment variable, or as a Metered License that bills by usage.

The license file contains details such as the product name, the number of developers it is licensed to, and the subscription expiry date. It carries a digital signature, so do not modify the file: even an inadvertent extra line break invalidates it.

Use the set_license method to license the component, and its is_licensed property to check the result. Calling it more than once is harmless - it simply wastes a little processor time. On Windows, the first license check in a process takes 15-30 seconds; later calls are immediate.

The example below applies a license from a file path. It reads the path from the GROUPDOCS_LIC_PATH environment variable and falls back to a local GroupDocs.Assembly.lic file. A relative path is resolved against the current working directory of the process, which may differ from your script’s folder (for example, in a service or a web application), so an absolute path is recommended:

import os

from groupdocs.assembly import License

def set_license_from_file():
    # Resolve the license path from the environment, with a local fallback
    license_path = os.environ.get("GROUPDOCS_LIC_PATH", "./GroupDocs.Assembly.lic")

    # Apply the license before building any report
    if os.path.exists(license_path):
        license = License()
        license.set_license(license_path)
        print("License set successfully:", license.is_licensed)
    else:
        print("License file not found. Running in evaluation mode.")

if __name__ == "__main__":
    set_license_from_file()

You can also apply a license from any readable binary stream - useful when the license ships as an embedded resource:

import os

from groupdocs.assembly import License

def set_license_from_stream():
    # Resolve the license path from the environment, with a local fallback
    license_path = os.environ.get("GROUPDOCS_LIC_PATH", "./GroupDocs.Assembly.lic")

    # Apply the license from an open binary stream
    if os.path.exists(license_path):
        with open(license_path, "rb") as stream:
            License().set_license(stream)
        print("License set successfully.")
    else:
        print("License file not found. Running in evaluation mode.")

if __name__ == "__main__":
    set_license_from_stream()

Set GROUPDOCS_LIC_PATH to the license file’s path, or to a URL that serves it, and the license is applied at the first call into the engine, with no licensing code:

$env:GROUPDOCS_LIC_PATH = "C:\licenses\GroupDocs.Assembly.lic"

export GROUPDOCS_LIC_PATH="/opt/licenses/GroupDocs.Assembly.lic"

A license that cannot be applied (a missing file, an expired subscription, a license for another product) raises LicenseError from the first call into the engine on, rather than letting the process run in evaluation mode unnoticed. The message names the variable and the engine’s reason. Set GROUPDOCS_LIC_STRICT=0 to get a LicenseWarning and evaluation mode instead.

A file that is not a license at all, passed to set_license(), raises GroupDocsAssemblyException (“Data at the root level is invalid”).

A Metered License lets you pay for what you use. Pass the public and private keys to set_metered_key before using the API, then read the consumption with Metered.get_consumption_quantity() and Metered.get_consumption_credit(). The example reads the keys from two environment variables:

import os

from groupdocs.assembly import Metered

def set_metered_license():
    public_key = os.environ.get("GROUPDOCS_METERED_PUBLIC_KEY")
    private_key = os.environ.get("GROUPDOCS_METERED_PRIVATE_KEY")

    # Skip the call until real keys are supplied
    if not (public_key and private_key):
        print("Set GROUPDOCS_METERED_PUBLIC_KEY and GROUPDOCS_METERED_PRIVATE_KEY to apply a metered license.")
        return

    # Apply the metered keys before building any report
    Metered().set_metered_key(public_key, private_key)
    print("Quantity:", Metered.get_consumption_quantity())
    print("Credit:", Metered.get_consumption_credit())

if __name__ == "__main__":
    set_metered_license()

You are not required to keep the license file name as GroupDocs.Assembly.lic. You can rename it to any preferred name and use that name when applying the license in your application.

When you download the license from the GroupDocs website it is saved as GroupDocs.Assembly.lic. However, some web browsers may automatically append .xml, resulting in GroupDocs.Assembly.lic.xml.

If your Windows settings are configured to hide file extensions (the default), the file may still appear as GroupDocs.Assembly.lic in File Explorer even though the actual name is GroupDocs.Assembly.lic.xml. This discrepancy can cause set_license to raise an exception. To fix it, manually rename the file to remove the .xml extension, or disable “Hide extensions for known file types” in Windows.

You can evaluate GroupDocs.Assembly for Python via .NET without purchasing a license by using one of the following options.

The evaluation version is identical to the purchased one; it becomes fully licensed once you set a license. Its usage and functionality are the same, but without a license the reports are marked and their size is limited:

The assemble_document call returns True and raises nothing in either case, so a report that looks incomplete in evaluation mode is the first thing to check when no license is set.

To experience the complete features of GroupDocs.Assembly without the limitations of the Free Trial, you can request a 30-day “Temporary License”.