Metadata-Version: 2.1
Name: mk1pass
Version: 0.0.5
Summary: Generate random strings for passwords.
Author-email: Mike Turkey <voice@miketurkey.com>
Maintainer-email: Mike Turkey <voice@miketurkey.com>
License: ######################################################################
        ####################  SOFTWARE LICENSE   #############################
        ######################################################################
        
        mk1pass, Generate random strings for passwords.
        Copyright (C) 2023-2024 Mike Turkey (real name: Takaaki Watanabe)
        contact: voice[ATmark]miketurkey.com
        license: GPLv3 License
        
        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 2023 Mike Turkey (real name: Takaaki Watanabe)
        contact: voice[ATmark]miketurkey.com
        license: GFDL1.3 License
        
        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.
        
        Additional Term: Documentation
        
        "Documentation" refers to any written or electronic materials,
        including but not limited to manuals, guides, help files, and any
        other accompanying explanatory materials, that are provided or made
        available along with the software. The Documentation may be in printed
        or digital format and is an integral part of the software package.
        
        The Documentation is licensed under the terms of the GNU Free
        Documentation License (GFDL) version 1.3, a copy of which can be found
        at [https://www.gnu.org/licenses/fdl-1.3.txt]. Users are granted the
        right to copy, distribute, and/or modify the Documentation under the
        terms of the GFDL, but not to modify it in any way that would cause
        the Documentation to become subject to any license other than the
        GFDL.
        
        Users are expressly prohibited from sublicensing or otherwise
        transferring their rights to the Documentation. Any reproduction,
        distribution, or modification of the Documentation must retain the
        notices and disclaimers of the GFDL.
        
        This Additional Term forms an integral part of the overall software
        document license and should be interpreted in conjunction with the
        main terms and conditions outlined in the license agreement.
        
        See also:
            GFDL1.3: https://www.gnu.org/licenses/fdl-1.3.txt
            Mike Turkey: https://miketurkey.com/
        
Project-URL: Homepage, https://miketurkey.com
Project-URL: Repository, https://github.com/MikeTurkey/mk1pass
Classifier: Topic :: Security
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"



mk1pass 
********************************

| mk1pass created by MikeTurkey
| Version 0.0.5, 14 Dec 2024
| 2023-2024, COPYRIGHT MikeTurkey, All Right Reserved.
| ABSOLUTELY NO WARRANTY. The Licence is based on GPLv3 Licence.
| URL: https://miketurkey.com

Summary
=======

Generate random strings for passwords.

Synopsis
========

| mk1pass [-alnsu] [-c COUNT] [-e PREFIX] [-f SUFFIX] [LENGTH] 
| mk1pass [--version --license [-h | --help]]

Description
=============

*  -a, --avoid: Avoid misleading letters. (l, I, O, o, 0) 
*  -c, --count: Count of random strings.
*  -e, --prefix: Add prefix string to random strings.
*  -f, --suffix: Add suffix string to random strings.
*  -l, --lower: Lowercase strings.
*  -n, --numeric: Numeric strings.
*  -s, --special: Special charactors.
*  -u, --upper: Uppercase strings.
*  -h, --help: Show Help message.
*  --version: Show version.
*  --license: Show License.

e.g.
  $ mk1pass 8
    Output 1 row of 8 random strings(--upper, --lower, --numeric, --avoid)
  $ mk1pass --lower 8
    Output 1 row of 8 random lowercase strings
  $ mk1pass --numeric 8
    Output 1 row of 8 random numeric strings
  $ mk1pass --lower --upper 8
    Output 1 row of 8 random lowercase and uppercase strings
  $ mk1pass --avoid --lower --upper 8
    Output 1 row of 8 random lowercase and uppercase strings, avoiding mis-leading letter.
  $ mk1pass -c 10 8
    Output 10 rows of 8 random strings(--upper, --lower, --numeric, --avoid)

Quick Install(Experimental)
============================

Install via pypi(python3)

.. code-block:: console

   $ python3 -m pip install mk1pass

Install via github

.. code-block:: console

   $ cd tmp
   $ git clone https://github.com/MikeTurkey/mk1pass.git
   $ sudo mk1pass/install.sh

Install via miketurkey.com

.. code-block:: console

  $ curl -O https://miketurkey.com/get-mk1pass.sh
  $ sh get-mk1pass.sh
  $ sudo mk1pass/install.sh

  
