freckles.context package

Submodules

freckles.context.config module

class freckles.context.config.ContextConfig(alias, config_chain=None, extra_repos=None, use_community=False, config_unlocked=False)

Bases: object

add_cnf_interpreter(interpreter_name, schema)

cnf

config(interpreter_name, *overlays)

config_unlocked

config_value(key, interpreter_name=None)

class freckles.context.config.ContextConfigTingCast

Bases: ting.ting_cast.TingCast

A TingCast to create freckles profiles by reading yaml files.

CNF_PROFILE_ATTRIBUTES = [<ting.ting_attributes.FileStringContentAttribute object>, <ting.ting_attributes.FrontmatterAndContentAttribute object>, <ting.ting_attributes.ValueAttribute object>, <ting.ting_attributes.DictContentAttribute object>]

class freckles.context.config.ContextConfigs(repo_name, tingsets, cnf, **kwargs)

Bases: ting.tings.TingTings

A class to manage freckles profiles.

This reads all ‘*.profile’ files in the freckles config folder. Those are later used to create a freckles context (per profile). It also checks whether there exists a ‘default.profile’ file with the ‘accept_freckles_license’ value set to ‘true’. Only if that is the case will it allow custom profiles (mainly for security reasons - the user should explicitely accept that certain configurations can be insecure).

DEFAULT_TING_CAST

alias of ContextConfigTingCast

create_context_config(context_name, config_chain=None, extra_repos=None, use_community=False)

classmethod load_configs()

freckles.context.freckles_context module

class freckles.context.freckles_context.FrecklesContext(context_name, config)

Bases: object

adapters

add_config_interpreter(interpreter_name, schema)

add_dynamic_frecklet(path_or_frecklet_content, validate=False, check_path=True)

augment_repo(repo_orig)

augment_repos(repo_list)

callbacks

check_repo(repo)

config(interpreter_name, *overlays)

config_value(key, interpreter_name=None)

context_name

create_frecklecutable(frecklet_name, only_from_index=True)

create_run_environment(adapter, env_dir=None)

download_repo(repo, task_parent)

ensure_local_repos(repo_list)

execute_external_command(command, args=None, parent_task=None)

frecklet_index

frkl_pkg

get_frecklet(frecklet_name, validate=False)

get_frecklet_names()

load_frecklet(frecklet_full_path_or_name_or_content, validate=False)

Loads a frecklet.

First, checksi if argument is a path and exists. If that is the case, uses that to create the frecklet. If not, tries to find a frecklet with the provided name. If that doesn’t exists either, it tries to interprete the string as frecklet content.

save_run_info_file(new_data=None)

Save the run info file, optionally merge it with new data beforehand.

Parameters:new_data (dict) – new data to be merged on top of current dict, will be ignored if None

unlock_config(user_accepts=False, use_community=False, save=True)

update_pull_cache(path)

update_repos(force=False, timeout=-1)

freckles.context.freckles_context.startup_housekeeping()

Module contents