LARC Core Toolset

Collection of utilities for use across LARC projects.

Installation

pip3 install larc

How to Use

The larc library provides a number of utilities:

• larc.common: Collection of general-purpose functions and types, patterned after the toolz functional programming library
• larc.yaml: A few simple wrapper functions around ruamel.yaml that provides a standard interface for reading/writing YAML files
• larc.markdown: Collection of Python Markdown extensions
  • MetaYamlExtension (meta_yaml): A slight tweak to the Meta-Data extension for providing YAML metadata at the beginning of a markdown file
  • SimpleTableExtension (simpletable): A <table>-parsing extension for markdown that allows you to provide CSS classes for table elements within the markdown
  • YamlDataExtension (yaml_data): A more general YAML-parsing extension that allows you to provide chunks of YAML data throughout the markdown file (not just at the beginning)
• larc.rest: A ReST client-building tool that attempts to be more functional
• larc.logging: Some logging utility functions that relies on coloredlogs for log coloring
• larc.parallel: Some functional parallelization utility functions designed for use within the toolz-ish functional idiom
• larc.signature: Functions to construct a host signature, for use when "fingerprinting" clients is necessary
• larc.shell: Shell command functions

The library also provides the following command-line tools:

• diffips: Given two files with IPs (A and B), get difference A - B
• intips: Given two files with IPs (A and B), get intersection A & B
• difflines: Given two files with lines of text (A and B), get difference A - B
• intlines: Given two files with lines of text (A and B), get intersection A & B
• sortips: Given text content (from clipboard, file, or stdin), extract IPs sort them
• getips: Given text content (from clipboard, file, or stdin), extract IPs and print them