Skip to content

digidem/mapeo-config-deconstructor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CoMapeo Configuration Deconstructor

.github/workflows/publish-npm.yml

Mapeo Configuration Deconstructor is a tool designed to simplify the process of creating and managing CoMapeo configurations. It provides a set of utilities to deconstruct a CoMapeo configuration into an config folder that can be re-built using mapeo-settings-builder.

Features

  • Deconstructs a .comapeocat (zip) configuration file to an output folder.
  • Deconstructs a .mapeosettings (tar) configuration file to an output folder.
  • Deconstructs SVG sprite from a configuration folder to an output folder.
  • Deconstructs translations.json into separate language files in the messages directory.
  • Creates a package.json file in the output folder, with the metadata.json name value.

Usage

You can use Mapeo Configuration Deconstructor via the command line or programmatically in your Node.js applications. outputFolder defaults to directory where program is executed from.

Command Line Usage

Using npx

npx mapeo-config-deconstructor [config] [outputFolder]

Installing globally

npm install -g mapeo-config-deconstructor

Then you can run it with:

mapeo-config-deconstructor [config] [outputFolder]

Programmatic Usage

You can also use Mapeo Configuration Deconstructor programmatically in your Node.js applications:

const { deconstruct } = require("mapeo-config-deconstructor");

async function run() {
  try {
    const result = await deconstruct({
      configPath: "/path/to/config.mapeosettings",
      outputFolder: "/path/to/output",
    });

    if (result.success) {
      console.log(
        `Successfully deconstructed ${result.configName} to ${result.outputFolder}`,
      );
    } else {
      console.error(`Error: ${result.error}`);
    }
  } catch (error) {
    console.error(`Unexpected error: ${error.message}`);
  }
}

run();

API Options

The deconstruct function accepts an options object with the following properties:

Option Type Required Description
configPath string Yes Path to the configuration file (.mapeosettings or .comapeocat) or directory
outputFolder string No Path to the output folder. If not provided, a temporary folder will be used
skipCleanup boolean No Whether to skip cleaning up unwanted files (default: false)
skipPackageJson boolean No Whether to skip creating package.json (default: false)

File Format Support

The tool supports both .mapeosettings (tar) and .comapeocat (zip) file formats. Both formats contain the same set of files:

  • icons (directory)
  • icons.json
  • icons.png
  • icons.svg
  • metadata.json
  • presets.json
  • style.css
  • translations.json
  • VERSION

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published