Giter Club home page Giter Club logo

make_junction's Introduction

Blender Addon Junction Creator

This Python script facilitates the quick setup of Blender addons by creating a directory junction (a symbolic link on Windows) from an addon's source directory to a targeted Blender version's addons folder. It's beneficial for developers who frequently update their addon repository in one location and must test it within multiple Blender versions.

Requirements

  • Windows Operating System
  • Python 3 (tested with Python 3.11)

The script is designed for Windows due to its reliance on mklink, a command-line utility specific to Windows.

Usage

To create a junction for your Blender addon, you need to specify the Blender version and the name of the addon. Optionally, you can also specify the source location of the addon directory. If not provided, the default source location is L:\BLENDER\ADDONS\, which is the location of my own add-on source repositories.

You can use either flags or positional arguments for blender_version, addon_name, and source.

Command-line Arguments

  • -b or --blender-version: The Blender version string corresponding to the addons folder name (e.g., "3.4").
  • -a or --addon-name: The name of the addon folder to which you want to create the junction.
  • -s or --source: The full path to the addon's source directory. If not provided, it defaults to L:\BLENDER\ADDONS\.

Building the Script into a Standalone Executable

To build the script into a standalone executable, you can use PyInstaller. Run the following command to create a single executable file in the dist directory:

pyinstaller --onefile make_junction.py

Or download the latest release from the Releases page. Then move the executable to a directory in your PATH environment variable to use it from anywhere.

Examples

  • To create a junction for an addon named "MyAddon" within the Blender 4.0 addons directory using flags:

    make_junction -b 4.0 -a MyAddon
  • To specify a custom source location for the addon using flags:

    make_junction -b 4.0 -a MyAddon -s C:\MyAddon\
  • To create a junction using positional arguments:

    make_junction 4.0 MyAddon C:\MyAddon\
  • To create a junction with a default source directory using positional arguments:

    make_junction 4.0 MyAddon

Support

For bug reporting and feature requests, please open an issue in this repository.

License

This project is open-source and available under the MIT License

make_junction's People

Contributors

robesantoro avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.