Metadata-Version: 2.1
Name: snakeland
Version: 0.0.3
Summary: Instant Python3 script installer.
Author-email: MikeTurkey <voice@miketurkey.com>
Maintainer-email: MikeTurkey <voice@miketurkey.com>
License: ######################################################################
        ####################  SOFTWARE LICENSE   #############################
        ######################################################################
        
        SNAKELAND, Instant python script installer.
        Copyright (C) 2023-2024 Mike Turkey(real name: Takaaki Watanabe)
        contact: voice[ATmark]miketurkey.com
        
        This program is free software: you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation, either version 3 of the License, or
        (at your option) any later version.
        
        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.
        
        You should have received a copy of the GNU General Public License
        along with this program.  If not, see <https://www.gnu.org/licenses/>.
        
        ADDITIONAL MACHINE LEARNING PROHIBITION CLAUSE
        
        In addition to the rights granted under the applicable license(GPL-3),
        you are expressly prohibited from using any form of machine learning,
        artificial intelligence, or similar technologies to analyze, process,
        or extract information from this software, or to create derivative
        works based on this software.
        
        This prohibition includes, but is not limited to, training machine
        learning models, neural networks, or any other automated systems using
        the code or output of this software.
        
        The purpose of this prohibition is to protect the integrity and
        intended use of this software. If you wish to use this software for
        machine learning or similar purposes, you must seek explicit written
        permission from the copyright holder.
        
        see also 
            GPL-3 Licence, https://www.gnu.org/licenses/gpl-3.0.html.en
            Mike Turkey.com, https://miketurkey.com
        
        ######################################################################
        ####################  DOCUMENT LICENSE   #############################
        ######################################################################
        
        Copyright 2024 Mike Turkey(real name: Takaaki Watanabe)
        contact: voice[ATmark]miketurkey.com
        
        Permission is granted to copy, distribute and/or modify this document
        under the terms of the GNU Free Documentation License, Version 1.3
        or any later version published by the Free Software Foundation;
        with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
        A copy of the license is included in the section entitled "GNU
        Free Documentation License".
        
        ADDITIONAL MACHINE LEARNING PROHIBITION CLAUSE
        
        In addition to the rights granted under the GNU Free Documentation
        License, Version 1.3, you are expressly prohibited from using any form
        of machine learning, artificial intelligence, or similar technologies
        to analyze, process, or extract information from this document, or to
        create derivative works based on this document.
        
        This prohibition includes, but is not limited to, training machine
        learning models, neural networks, or any other automated systems using
        the content of this document.
        
        The purpose of this prohibition is to protect the integrity and
        intended use of this document. If you wish to use this document for
        machine learning or similar purposes, you must seek explicit written
        permission from the copyright holder.
        
        See also:
            GFDL1.3: https://www.gnu.org/licenses/fdl-1.3.txt
            Mike Turkey: https://miketurkey.com
        
Classifier: Topic :: Software Development
Classifier: Environment :: Console
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: <=4.0,>=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: importlib-metadata; python_version < "3.8"


snakeland
********************************

 | snakeland created by MikeTurkey
 | Version 0.0.2, 26 Nov 2024
 | 2023-2024, COPYRIGHT MikeTurkey, All Right Reserved.
 | ABSOLUTELY NO WARRANTY. The Licence is based on GPLv3.
 | URL: https://miketurkey.com

Summary
=======

 Instant Python3 script installer.

Synopsis
========

 | snakeland --version | --help | --license'
 | snakeland install-byconf [CONFIG]
 | snakeland uninstall [PKGNAME]
 | snakeland findpy3 [--later 3.xx] | [--older 3.xx] | --latest | [--range 3.xx-3.yy] | [--order 3.x,..,3.yy]

QUICK START
--------------

 Install by config

 .. code-block:: console

   $ snakeland install snakeland-APP.conf
   $ APP --help 
     -- help message --

 Uninstall

 .. code-block:: console
		
   $ snakeland uninstall APP
   
 Find python3 command.

 .. code-block:: console

   $ snakeland findpy3 --later 3.8
     /usr/bin/python3.12
   $ snakeland findpy3 --older 3.11
     /usr/bin/python3.9
   $ snakeland findpy3 --latest
     /usr/bin/python3.12
   $ snakeland range 3.5-3.10
     /usr/bin/python3.9
   $ snakeland range --order 3.13,3.12,3.11,3.10,3.9
     /usr/bin/python3.12   
     
DESCRIPTION
------------

 | snakeland is instant python3 script installer.
 | The script wrapper is make on /usr/local/bin as cui command.

ARGUMENT
------------

  --version, --help, --license

      | Print version, help message, license.

  --latest

      | findpy3 sub command only
      | Print latest python3 command path.
	    
  --later [PYTHONVERSION]

      | findpy3 sub command only
      | Print PYTHONVERSION later command path.

  --older [PYTHONVERSION]

      | findpy3 sub command only
      | Print PYTHONVERSION older command path.

  --range 3.xx-3.yy

      | findpy3 sub command only
      | Print latest python command path in 3.xx - 3.yy.

  --order 3.x,...,3.yy

      | findpy3 sub command only
      | Print first matched python command path.

CONFIG
------------

  The Config is in restricted toml format.

  OSCHECK:  

      | Describe OS names. The string is similar to 'uname -s' cmd.
      | default section, optional key.
      | Darwin: Mac OS
      | Linux: Linux based OS
      | FreeBSD: FreeBSD OS
      | OpenBSD: OpenBSD
      | e.g.
      |   OSCHECK = ['Darwin', 'Linux', 'FreeBSD']

     
  DSTBASEDIR:

      | Destination Base Directory.
      | Recommend path is '/usr/local/libexec/CMDNAME'.
      | default section, essential key.

  INSTALLCMD:

      | Install command path. default path is '/usr/local/bin'.
      | default section, optional key.

  CMDNAME001-CMDNAME999:

      | The command name. The command file is made on INSTALLCMD directory.
      | default section, essential key.

  PY3TARGET001-PY3TARGET999:

      | The python3 script path. The script is executed by python3.xx cmd.
      | default section, optional key.
      | (Either of TARGETPY3, TARGETCMD is always required.)

  SHEBANG:

      | The shebang of CMDNAME file. default path is '/bin/sh'.
      | default section, optional key.

  PY3VERSION:

      | Execute python3 of the version.
      | The string is similar to 'findpy3' options.
      | default section, optional key.
      
        | '3.x later'  : python 3.x later.
        | '3.x older'  : python 3.x older.
        | 'latest'     : Latest python3 
        | '3.xx - 3.yy': Latest python3 in 3.xx - 3.yy.
        | '3.6 3.7 3.8': First found python3 in 3.6, 3.7, 3.8.
   
  DSTDIR:

      | Relative path of DSTBASEDIR.
      | You cannot set it to a directory above the DSTBASEDIR.
      | source file section, essential key.
	 
  FMODE:

      | File mode of the section file. default mode is 644.
      | source file section, optional key.

  Example of config

      .. code-block:: text

	 DSTBASEDIR = '/usr/local/libexec/CMDNAMEAPP/'
	 PKGNAME    = 'CMDNAMEAPP'
	 CMDNAME001   = 'CMDNAMEAPP'
	 PY3TARGET001 = '/usr/local/libexec/CMDNAMEAPP/CMDNAMEAPP.py'

	 [script/CMDNAMEAPP.py]
             DSTDIR = '.'

BUGS
------

  | Please report bugs to the issue tracker:
  | https://github.com/MikeTurkey/snakeland/issues
  | or by e-mail: <voice[ATmark]miketurkey.com>

Author
--------

  MikeTurkey <voice[ATmark]miketurkey.com>

LICENSE
----------

  GPLv3 License including a prohibition clause for AI training.


COPYRIGHT
-------------
  
  | 2023-2024, COPYRIGHT MikeTurkey, All Right Reserved.
  | ABSOLUTELY NO WARRANTY.
  | Document: GFDL1.3 License including a prohibition clause for AI training.
  | URL: https://miketurkey.com

