Missing .adoc files and docs folder plus others

[well-it-wasnt-me]

First Attempt

pip install git+https://github.com/0x48piraj/incarcero.git#egg=incarcero

gave the following error:

Collecting incarcero
  Cloning https://github.com/0x48piraj/incarcero.git to /tmp/pip-install-v6b47cd2/incarcero_e5f12709300d4f5794c6ad86839bcb51
  Running command git clone --filter=blob:none --quiet https://github.com/0x48piraj/incarcero.git /tmp/pip-install-v6b47cd2/incarcero_e5f12709300d4f5794c6ad86839bcb51
  Resolved https://github.com/0x48piraj/incarcero.git to commit 1233944c1a507d481bc2afb12ddb6e366c36c3e6
  Preparing metadata (setup.py) ... error
  error: subprocess-exited-with-error
  
  × python setup.py egg_info did not run successfully.
  │ exit code: 1
  ╰─> [8 lines of output]
      Traceback (most recent call last):
        File "<string>", line 2, in <module>
        File "<pip-setuptools-caller>", line 34, in <module>
        File "/tmp/pip-install-v6b47cd2/incarcero_e5f12709300d4f5794c6ad86839bcb51/setup.py", line 37, in <module>
          with open(path.join(here, 'README.adoc'), encoding='utf-8') as f:
        File "/usr/lib/python3.10/codecs.py", line 906, in open
          file = builtins.open(filename, mode, buffering)
      FileNotFoundError: [Errno 2] No such file or directory: '/tmp/pip-install-v6b47cd2/incarcero_e5f12709300d4f5794c6ad86839bcb51/README.adoc'
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

Second Attempt

$ git clone https://github.com/0x48piraj/incarcero.git
$ cd incarcero
$ pip install -r requirements.txt # All ok
$ python3 setup.py install # Fails for missing .adoc files
$ touch README.adoc
$ touch TODO.adoc
$ python3 setup.py install # Error for missing folder
$ mkdir docs
$ python3 install setup.py install # Give the error below

running install
/home/antonio/.local/lib/python3.10/site-packages/setuptools/command/install.py:34: SetuptoolsDeprecationWarning: setup.py install is deprecated. Use build and pip and other standards-based tools.
  warnings.warn(
/home/antonio/.local/lib/python3.10/site-packages/setuptools/command/easy_install.py:144: EasyInstallDeprecationWarning: easy_install command is deprecated. Use build and pip and other standards-based tools.
  warnings.warn(
error: can't create or remove files in install directory

The following error occurred while trying to add or remove files in the
installation directory:

    [Errno 13] Permission denied: '/usr/local/lib/python3.10/dist-packages/test-easy-install-891732.write-test'

The installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

    /usr/local/lib/python3.10/dist-packages/

Perhaps your account does not have write access to this directory?  If the
installation directory is a system-owned directory, you may need to sign in
as the administrator or "root" account.  If you do not have administrative
access to this machine, you may wish to choose a different installation
directory, preferably one that is listed in your PYTHONPATH environment
variable.

For information on other options, you may wish to consult the
documentation at:

  https://setuptools.pypa.io/en/latest/deprecated/easy_install.html

Please make the appropriate changes for your system and try again.

Not happy enough

sudo -H python3 setup.py install # and installation is a success