cut 1.0.23

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global cut --version 1.0.23                
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local cut --version 1.0.23                
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=cut&version=1.0.23                
nuke :add-package cut --version 1.0.23                

Contentful Update Tool

image

Introduction

cut is a stand-alone cross-platform command line interface (CLI) that allows bulk downloads, editing and uploads to and from a Contentful space and supports the following :-

  • CSV - Contentful → Comma delimeted files → Contentful
  • TSV - Contentful → Tab delimeted files → Contentful
  • Excel - Contentful → Excel xlsx workbook → Contentful
  • Json - Contentful → Json → Contentful
  • Yaml - Contentful → Yaml → Contentful

Contentful is a headless content management system (CMS) that allows teams to store, manage and retrieve content for websites and apps.

Installation

Firstly, make sure you have the Dotnet SDK 8.0 package installed.

For windows (cmd or powershell):

winget install Microsoft.DotNet.SDK.8

Or, on linux and iOS

sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0

Then:

On windows you may have to close and re-open the command line propt (or Windows Terminal).

Install the cut cli by typing.

dotnet tool install -g cut

To test whether the installation worked

Simply type

cut

This will display the cut help. You are ready to go! 🚀

Getting Help

cut --help

cut help screenshot

Logging into Contentful

cut auth

cut auth screenshot

Display space summary

cut info

cut info screenshot

Downloading data

The default format is 'excel' so the following is equivelent.

cut download --content-type <contentType> 

cut download --content-type <contentType> --format excel

For comma seperated values:

cut download --content-type <contentType> --format csv

For tab seperated values:

cut download --content-type <contentType> --format tsv

For json output:

cut download --content-type <contentType> --format json

For downloading to Yaml:

cut download --content-type <contentType> --format yaml

cut download screenshot

Typing cut download --help will list all currently available options and usage

USAGE:
    cut download [OPTIONS]

OPTIONS:
    -h, --help            Prints help information
    -c, --content-type    Specifies the content type to download data for
    -f, --format          The output format for the download operation (Excel/Csv/Tsv/Json/Yaml)

Uploading/synchronizing data

You can upload content from a local file to contentful. The local file can be a previously downloaded and updated excel, sdv, tsv, json or yaml file.

cut upload progress screenshot

Changes are only applied to Contentful if --apply is specified. By default no changes will be applied so it works a bit like a "what-if" powershel switch without --apply.

cut upload screenshot

Typing cut upload --help will sow the full usage and options.

USAGE:
    cut upload [OPTIONS]

OPTIONS:
    -h, --help            Prints help information
    -c, --content-type    Specifies the content type to download data for
    -p, --path            The local path to the file containg the data to sync
    -f, --format          The format of the file specified in '--path' (Excel/Csv/Tsv/Json/Yaml)
    -a, --apply           Apply and publish all the calculated changes. The default behaviour is to only list the detected changes

For generating strong Javascript or Dotnet types

This feature will be coming soon...

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.0.25 121 6/13/2024 1.0.25 is deprecated because it is no longer maintained.
1.0.24 95 6/10/2024
1.0.23 101 6/7/2024
1.0.22 100 6/7/2024
1.0.19 125 6/6/2024
1.0.18 94 6/5/2024
1.0.17 103 6/1/2024
1.0.16 107 6/1/2024
1.0.15 106 6/1/2024
1.0.14 90 5/31/2024
1.0.13 111 5/28/2024
1.0.12 94 5/27/2024
1.0.11 101 5/27/2024
1.0.10 116 5/27/2024
1.0.9 110 5/27/2024
1.0.7 94 5/27/2024
1.0.6 95 5/27/2024
1.0.5 106 5/27/2024
1.0.4 114 5/25/2024
1.0.3 125 5/25/2024
1.0.2 121 5/25/2024
1.0.0 109 5/25/2024