3 Usage

Introduction

Logicytics.py is a comprehensive tool designed to streamline and automate various tasks related to software development, system management, and data processing. It offers a wide range of functionalities through command-line flags, allowing users to customize their experience according to their needs.

Flags

General Usage

Flags are command-line arguments that modify the behaviour of the Logicytics.py script. They provide a flexible way to execute specific parts of the program or alter its default behaviour. To use a flag, include it after the script name when running it from the command line, preceded by two hyphens (--). For example:

.\Logicytics.py -h

This command would run help menu of Logicytics.

Specific Flags

Logicytics.py [-h] [--default] [--minimal] [--unzip-extra] [--backup]
                     [--restore] [--update] [--extra] [--dev] [--exe]
                     [--debug] [--modded] [--threaded] [--webhook] [--reboot]
                     [--shutdown]

• -h: show this help message and exit
• --default: Runs Logicytics default
• --minimal: Run Logicytics in minimal mode. Just bare essential scraping
• --unzip-extra: Unzip the extra directory zip File - Use on your own device only -.
• --backup: Backup Logicytics files to the ACCESS/BACKUPS directory - Use on your own device only -.
• --restore: Restore Logicytics files from the ACCESS/BACKUPS directory - Use on your own device only -.
• --update: Update Logicytics from GitHub - Use on your own device only -.
• --extra: Open the extra directory for more tools.
• --dev: Run Logicytics developer mod, this is only for people who want to register their contributions properly. - Use on your own device only -.
• --exe: Run Logicytics using its precompiled exe's, These may be outdated and not the best, use only if the device doesnt have python installed.
• --debug: Runs the Debugger, Will check for any issues, warning etc, useful for debugging and issue reporting
• --modded: Runs the normal Logicytics, as well as any File in the MODS directory, Useful for custom scripts
• --threaded: Runs Logicytics using threads, where it runs in parallel
• --webhook: Do Flag that will send zip File via webhook
• --reboot: Do Flag that will reboot the device afterward
• --shutdown: Do Flag that will shutdown the device afterward

Flags Compatibility and Restrictions

The following flags can only be used by themselves

• --unzip-extra
• --backup
• --restore
• --update
• --extra
• --dev
• --debug

The following flags are also unique and cant be used with each other, but can be used with the sub-action flags

• --default
• --minimal
• --extra
• --exe
• --modded
• --threaded

These flags cant be used with each other, and they are the sub-action flags, They cant be used by themselves

• --webhook
• --reboot
• --shutdown

Choosing multiple incompatible flags will result in an error, emphasizing the need for specificity in how you wish to execute the script.

Understanding the nuances of flag compatibility and the strict requirement for a single run flag is crucial for effectively leveraging the full potential of Logicytics.py. By carefully selecting the appropriate flags based on your current needs and ensuring compatibility, you can tailor the script's behaviour to fit your specific requirements, whether for development, debugging, system management, or data processing tasks.

File Structure

The Logicytics project is organized into several directories, each serving a distinct purpose:

• ACCESS: If the software is used, these are generated; Contains the BACKUP zips, DATA zips, The DATA zips hashes AND the logs of both the main code and the debugger.

• CODE: Houses the core codebase, including the wrapper, system executables, and all source code files and the custom libraries.

• MODS: Features third-party tools or scripts that extend the functionality of Logicytics.

/Logicytics
├─── /.github [You may ignore this]
│    ├─── /ISSUE_TEMPLATE
│    └─── /workflows
├─── /.idea [You may ignore this]
│    └─── inspectionProfiles
├─── /ACCESS [Here is the generated files output]
│    ├─── /BACKUP
│    ├─── /DATA
│    │    ├─── /Hashes
│    │    └─── /Zip
│    └─── /LOGS
│         └─── /DEBUG
├─── /CODE
│    ├─── /SysInternal_Suite
│    │    └─── # SYS INTERNAL EXE #
│    ├─── # THE CODE #
│    └─── /__pycache__ [You may ignore this]
├─── /EXTRA
│    └─── # ZIPPED EXTRA FEATURES #
├─── /IMG [You may ignore this]
└─── /MODS [You add your own mods]
└─── /WEB [Bunch of code to operate the github page - You may ignore this]

Access Directory

The ACCESS directory is crucial for monitoring the progress and results of Logicytics operations. The LOGS subdirectory contains the most recent debugger logs, which can be invaluable for diagnosing issues or understanding the behaviour of the script. The DATA subdirectory holds all compressed files produced by Logicytics as well as hashes, finally the subdirectory BACKUP has the backups required, providing a centralized location for managing these resources.

By thoroughly understanding and utilizing these sections and flags, users can maximize the efficiency and effectiveness of Logicytics.py, tailoring its capabilities to meet their specific needs and workflows.