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:

cd Logicytics/CODE
python Logicytics.py --help

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]

Click to expand for the Flag Explanation

• -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: A Extra Flag that will send zip File via webhook - Use with another valid flag
• --reboot: A Extra Flag that will reboot the device afterward - Use with another valid flag
• --shutdown: A Extra Flag that will shut down the device afterward - Use with another valid flag

Flags Compatibility and Restrictions

Standalone System flags (cannot be combined with others - Are part of the System tools of Logicytics):

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

Unique flags (cannot be combined with each other, but can be used with sub-action flags):

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

Sub-action flags (cannot be used alone, must be paired with another flag):

• --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.

• EXTRA: Contains additional resources, such as extra features or tools that can be used in conjunction with Logicytics.

Click to expand for projects structure

/Logicytics
├─── /ACCESS
│    ├─── /BACKUP
│    │    └─── # Contains the backups of the project in case of restoration later on #
│    ├─── /DATA
│    │    ├─── /Hashes
│    │    │    └─── # Contains the hashes of the zipped files #
│    │    └─── /Zip
│    │         └─── # Contains the zipped extracted data - Sorted by time as well #
│    └─── /LOGS
│         ├─── /DEBUG
│         │    └─── # Contains your debug logs #
│         └─── # Contains your normal logs #
├─── /CODE
│    ├─── /__pycache__ [You may ignore this]
│    ├─── /SysInternal_Suite
│    │    ├─── # SYS INTERNAL EXE - ZIPPED #
│    │    └─── # You may add your .sys.ignore file here to not use the EXE #
│    └─── # THE ACTUAL CODE #
├─── /EXTRA
│    └─── # ZIPPED EXTRA FEATURES #
├─── /IMG
│    └─── # You may ignore this - Includes images for the README #
├─── /MODS
│    └─── # Contains the mods for the project [You can add your own mods here] #
└─── /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.