-Ph{dZddlZddlZddlZddlZddlZddlZddl Z dZ dZ e j Z e j Z dddddZedZd ZGd d eZd ZGd dZdZdZdZdZdZdZdZdZ GddejddZGddejddZ ejddZ!ejddZ"ee!e"fZ#Gd d!ejd!d"Z$Gd#d$ejd$d%Z%Gd&d'ejd'd%Z&Gd(d)ej'j(Z)dS)*aR:mod:`sass` --- Binding of ``libsass`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This simple C extension module provides a very simple binding of ``libsass``, which is written in C/C++. It contains only one function and one exception type. >>> import sass >>> sass.compile(string='a { b { color: blue; } }') 'a b { color: blue; } ' N)MODES OUTPUT_STYLESSOURCE_COMMENTS CompileError SassColor SassError SassFunctionSassListSassMap SassNumber SassWarningand_joincompilelibsass_versionz0.23.0)none line_numbersdefaultmap)stringfilenamedirnamecZt|tr|dS|SNUTF-8) isinstancebytesdecode)ss D/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sass.py to_native_sr"/s+!Uxx   c"eZdZdZfdZxZS)rzqThe exception type that is raised by :func:`compile()`. It is a subtype of :exc:`exceptions.ValueError`. cdtt|dSN)super__init__r")selfmsg __class__s r!r(zCompileError.__init__;s) S))*****r#)__name__ __module__ __qualname____doc__r( __classcell__r+s@r!rr6sB+++++++++r#rc tj|dS#t$r$tj|rYdSwxYwr&)osmakedirsOSErrorpathisdir)r6s r!mkdirpr8?sX D  7==    FF s)AAcjeZdZdZdZedZedZdZe dZ dZ dZ d S) r aCustom function for Sass. It can be instantiated using :meth:`from_lambda()` and :meth:`from_named_function()` as well. :param name: the function name :type name: :class:`str` :param arguments: the argument names :type arguments: :class:`collections.abc.Sequence` :param callable_: the actual function to be called :type callable_: :class:`collections.abc.Callable` .. versionadded:: 0.7.0 )name arguments callable_ctj|}|j|j|j|jf\}}}}|s|s|s|r#t d|||||j|S)aMake a :class:`SassFunction` object from the given ``lambda_`` function. Since lambda functions don't have their name, it need its ``name`` as well. Arguments are automatically inspected. :param name: the function name :type name: :class:`str` :param lambda_: the actual lambda function to be called :type lambda_: :class:`types.LambdaType` :returns: a custom function wrapper of the ``lambda_`` function :rtype: :class:`SassFunction` z1functions cannot have starargs or defaults: {} {}) inspectgetfullargspecvarargsvarkwdefaults kwonlyargs TypeErrorformatargs)clsr:lambda_ar@rArBrCs r! from_lambdazSassFunction.from_lambdaYs  "7 + + Iqw AL0 ,*  e x : CJJ'  s4)))r#cxt|ddstd||j|S)a_Make a :class:`SassFunction` object from the named ``function``. Function name and arguments are automatically inspected. :param function: the named function to be called :type function: :class:`types.FunctionType` :returns: a custom function wrapper of the ``function`` :rtype: :class:`SassFunction` r,zfunction must be named)getattrrDrJr,)rGfunctions r!from_named_functionz SassFunction.from_named_functionts>xR00 6455 5x0(;;;r#ct|tstdt|zt|tjjstdt|zt|stt|dz||_td|D|_ ||_ dS)Nzname must be a string, not z"arguments must be a sequence, not z is not callablec3NK|] }|dr|nd|zV!dS)$N) startswith.0args r! z(SassFunction.__init__..sO  >>#&& 5CCC#I      r#) rstrrDrepr collectionsabcSequencecallabler:tupler;r<)r)r:r;r<s r!r(zSassFunction.__init__s$$$ B9DJJFGG GI{'?@@ B4Y  )$$ BDOO.@@AA A         #r#chd|jd|jS)z!Signature string of the function.z{}({}), )rEr:joinr;r)s r! signaturezSassFunction.signatures(ty$))DN*C*CDDDr#c|j|i|Sr&)r<r)rFkwargss r!__call__zSassFunction.__call__st~t.v...r#c|jSr&)rcrbs r!__str__zSassFunction.__str__s ~r#N) r,r-r.r/ __slots__ classmethodrJrOr(propertyrcrgrir#r!r r Hs  1I**[*4 < <[ <###"EEXE///r#r cH||Sdtfd|DS)Nct|}t|dvr0tdt||dtfd|DS)N)rrzKExpected importer result to be a tuple of length (1, 2, 3) but got {}: {!r}cZt|ts|dS|Sr)rrencode)objs r! _to_byteszP_normalize_importer_return_value.._to_importer_result.._to_bytess+c5)) zz'*** r#c3.K|]}|VdSr&rm)rUr rts r!rWzP_normalize_importer_return_value.._to_importer_result..s+99aYYq\\999999r#)r^len ValueErrorrE) single_resultrts @r!_to_importer_resultz=_normalize_importer_return_value.._to_importer_resultsm,, }  Y . .##)6#m*<*.s/88A$$Q''888888r#r^)resultrys @r! _normalize_importer_return_valuer~sC~ ::: 8888888 8 88r#cfdS)NcF|d|d}}tdd}|7 ||}d_n@#t$rd_|}Yn"wxYw|dkr ||}n |}t |S)Nr _num_argsrr)rrMrrDr~)r6prevnum_argsretfuncinners r!rz)_importer_callback_wrapper..inners[[))4;;w+?+?d5+t44   $d4&& #$  ! ! !"#d4jj ! ]]$tT""CC$t**C/444s AA32A3rm)rrs`@r!_importer_callback_wrapperrs)555555 Lr#cH|dSdtfd|DS)zWValidates the importers and decorates the callables with our output formatter. Nct|ts J|t|s J||t|fSr&)rintr]r)priorityrs r! _to_importerz)_validate_importers.._to_importersN(C((22(222~~##t###4T::;;r#c36K|]\}}||VdSr&rm)rUrrrs r!rWz&_validate_importers..s3NN.(Dh--NNNNNNr#r|) importersrs @r!_validate_importersrsD t<<< NNNNINNN N NNr#c|r&rm)es r!_raisers Gr#c 4tjptj} tj|t D]T\} }}d|D}|D]=}tj| |}tj||}tj||}tj dd|}| | }tj |||||d||d|| | | \}}}|r|d}ttj|t#|ddd5}||dddn #1swxYwY7d |fccSVd S) N)onerrorcfg|].}|d|d,|/S))z.scssz.sass_)endswithrS)rUrs r! z#compile_dirname..sU   !  !344 ##C((    r#z .s[ac]ss$z.cssrwrL)encodingnewlineF)TN)sysgetfilesystemencodinggetdefaultencodingr3walkrr6rarelpathresubrr_sasscompile_filenamerr8ropenwrite) search_path output_path output_stylesource_comments include_paths precisioncustom_functionsrsource_map_contentssource_map_embedomit_source_map_urlsource_map_root fs_encodingdirpathr filenamesrinput_filenamerelpath_to_fileoutput_filenamer v output_files r!compile_dirnamers +--I1G1I1IK!#f!E!E!E  I  %.   "  HW\\'8<. s*??*c***??????r#)rDrEr,rasorted)rrfs r!_check_no_remaining_kwargsrsb   8 ? ?  ??v?????       r#c j ttD]}|vr|s$tdt tzt dkrtt dzdd}dd}t|tstdt|z t|}nC#t$r6td |t twxYwd d }|tvrE|d krd }d }n|dvrdt|z}d}nd}d }tjd|zt"t|t$stdt|zt'jpt'jfd}|d}|d}dd } dd } dd } dd} t| tr| d} t/jf} | t3ddpdz } t.j| } t| tr| } dd}t|t8jjrd |D}net|t8jj t8jj!fr d!|D}n(td" tD|d#dtjd$t"tGd%d}d&vrىd&}t|tr|d}d'd }t|t$std(t|ztItJtMj'|||| ||||| | | | \}}|r|(dSnd)vrd)}t|tstd*t|zt.j)*|stW|d+t|tr|}tItJtMj,|||| |||||| | | | \}}}|r2|(d}|r|(d}||f}|Snd,vrn d,\}}n#tZ$rt[d-wxYwtItJt]||||| |||| | | | \}}|rdSntd.|rJt|)/a/There are three modes of parameters :func:`compile()` can take: ``string``, ``filename``, and ``dirname``. The ``string`` parameter is the most basic way to compile Sass. It simply takes a string of Sass code, and then returns a compiled CSS string. :param string: Sass source code to compile. it's exclusive to ``filename`` and ``dirname`` parameters :type string: :class:`str` :param output_style: an optional coding style of the compiled result. choose one of: ``'nested'`` (default), ``'expanded'``, ``'compact'``, ``'compressed'`` :type output_style: :class:`str` :param source_comments: whether to add comments about source lines. :const:`False` by default :type source_comments: :class:`bool` :param source_map_contents: embed include contents in map :type source_map_contents: :class:`bool` :param source_map_embed: embed sourceMappingUrl as data URI :type source_map_embed: :class:`bool` :param omit_source_map_url: omit source map URL comment from output :type omit_source_map_url: :class:`bool` :param source_map_root: base path, will be emitted in source map as is :type source_map_root: :class:`str` :param include_paths: an optional list of paths to find ``@import``\ ed Sass/CSS source files :type include_paths: :class:`collections.abc.Sequence` :param precision: optional precision for numbers. :const:`5` by default. :type precision: :class:`int` :param custom_functions: optional mapping of custom functions. see also below `custom functions `_ description :type custom_functions: :class:`set`, :class:`collections.abc.Sequence`, :class:`collections.abc.Mapping` :param custom_import_extensions: (ignored, for backward compatibility) :param indented: optional declaration that the string is Sass, not SCSS formatted. :const:`False` by default :type indented: :class:`bool` :returns: the compiled CSS string :param importers: optional callback functions. see also below `importer callbacks `_ description :type importers: :class:`collections.abc.Callable` :rtype: :class:`str` :raises sass.CompileError: when it fails for any reason (for example the given Sass has broken syntax) The ``filename`` is the most commonly used way. It takes a string of Sass filename, and then returns a compiled CSS string. :param filename: the filename of Sass source code to compile. it's exclusive to ``string`` and ``dirname`` parameters :type filename: :class:`str` :param output_style: an optional coding style of the compiled result. choose one of: ``'nested'`` (default), ``'expanded'``, ``'compact'``, ``'compressed'`` :type output_style: :class:`str` :param source_comments: whether to add comments about source lines. :const:`False` by default :type source_comments: :class:`bool` :param source_map_filename: use source maps and indicate the source map output filename. :const:`None` means not using source maps. :const:`None` by default. :type source_map_filename: :class:`str` :param source_map_contents: embed include contents in map :type source_map_contents: :class:`bool` :param source_map_embed: embed sourceMappingUrl as data URI :type source_map_embed: :class:`bool` :param omit_source_map_url: omit source map URL comment from output :type omit_source_map_url: :class:`bool` :param source_map_root: base path, will be emitted in source map as is :type source_map_root: :class:`str` :param include_paths: an optional list of paths to find ``@import``\ ed Sass/CSS source files :type include_paths: :class:`collections.abc.Sequence` :param precision: optional precision for numbers. :const:`5` by default. :type precision: :class:`int` :param custom_functions: optional mapping of custom functions. see also below `custom functions `_ description :type custom_functions: :class:`set`, :class:`collections.abc.Sequence`, :class:`collections.abc.Mapping` :param custom_import_extensions: (ignored, for backward compatibility) :param importers: optional callback functions. see also below `importer callbacks `_ description :type importers: :class:`collections.abc.Callable` :returns: the compiled CSS string, or a pair of the compiled CSS string and the source map string if ``source_map_filename`` is set :rtype: :class:`str`, :class:`tuple` :raises sass.CompileError: when it fails for any reason (for example the given Sass has broken syntax) :raises exceptions.IOError: when the ``filename`` doesn't exist or cannot be read The ``dirname`` is useful for automation. It takes a pair of paths. The first of the ``dirname`` pair refers the source directory, contains several Sass source files to compiled. Sass source files can be nested in directories. The second of the pair refers the output directory that compiled CSS files would be saved. Directory tree structure of the source directory will be maintained in the output directory as well. If ``dirname`` parameter is used the function returns :const:`None`. :param dirname: a pair of ``(source_dir, output_dir)``. it's exclusive to ``string`` and ``filename`` parameters :type dirname: :class:`tuple` :param output_style: an optional coding style of the compiled result. choose one of: ``'nested'`` (default), ``'expanded'``, ``'compact'``, ``'compressed'`` :type output_style: :class:`str` :param source_comments: whether to add comments about source lines. :const:`False` by default :type source_comments: :class:`bool` :param source_map_contents: embed include contents in map :type source_map_contents: :class:`bool` :param source_map_embed: embed sourceMappingUrl as data URI :type source_map_embed: :class:`bool` :param omit_source_map_url: omit source map URL comment from output :type omit_source_map_url: :class:`bool` :param source_map_root: base path, will be emitted in source map as is :type source_map_root: :class:`str` :param include_paths: an optional list of paths to find ``@import``\ ed Sass/CSS source files :type include_paths: :class:`collections.abc.Sequence` :param precision: optional precision for numbers. :const:`5` by default. :type precision: :class:`int` :param custom_functions: optional mapping of custom functions. see also below `custom functions `_ description :type custom_functions: :class:`set`, :class:`collections.abc.Sequence`, :class:`collections.abc.Mapping` :param custom_import_extensions: (ignored, for backward compatibility) :raises sass.CompileError: when it fails for any reason (for example the given Sass has broken syntax) .. _custom-functions: The ``custom_functions`` parameter can take three types of forms: :class:`~set`/:class:`~collections.abc.Sequence` of \ :class:`SassFunction`\ s It is the most general form. Although pretty verbose, it can take any kind of callables like type objects, unnamed functions, and user-defined callables. .. code-block:: python sass.compile( ..., custom_functions={ sass.SassFunction('func-name', ('$a', '$b'), some_callable), ... } ) :class:`~collections.abc.Mapping` of names to functions Less general, but easier-to-use form. Although it's not it can take any kind of callables, it can take any kind of *functions* defined using :keyword:`def`/:keyword:`lambda` syntax. It cannot take callables other than them since inspecting arguments is not always available for every kind of callables. .. code-block:: python sass.compile( ..., custom_functions={ 'func-name': lambda a, b: ..., ... } ) :class:`~set`/:class:`~collections.abc.Sequence` of \ named functions Not general, but the easiest-to-use form for *named* functions. It can take only named functions, defined using :keyword:`def`. It cannot take lambdas sinc names are unavailable for them. .. code-block:: python def func_name(a, b): return ... sass.compile( ..., custom_functions={func_name} ) .. _importer-callbacks: Newer versions of ``libsass`` allow developers to define callbacks to be called and given a chance to process ``@import`` directives. You can define yours by passing in a list of callables via the ``importers`` parameter. The callables must be passed as 2-tuples in the form: .. code-block:: python (priority_int, callback_fn) A priority of zero is acceptable; priority determines the order callbacks are attempted. These callbacks can accept one or two string arguments. The first argument is the path that was passed to the ``@import`` directive; the second (optional) argument is the previous resolved path, where the ``@import`` directive was found. The callbacks must either return ``None`` to indicate the path wasn't handled by that callback (to continue with others or fall back on internal ``libsass`` filesystem behaviour) or a list of one or more tuples, each in one of three forms: * A 1-tuple representing an alternate path to handle internally; or, * A 2-tuple representing an alternate path and the content that path represents; or, * A 3-tuple representing the same as the 2-tuple with the addition of a "sourcemap". All tuple return values must be strings. As a not overly realistic example: .. code-block:: python def my_importer(path, prev): return [(path, '#' + path + ' { color: red; }')] sass.compile( ..., importers=[(0, my_importer)] ) Now, within the style source, attempting to ``@import 'button';`` will instead attach ``color: red`` as a property of an element with the imported name. .. versionadded:: 0.4.0 Added ``source_comments`` and ``source_map_filename`` parameters. .. versionchanged:: 0.6.0 The ``source_comments`` parameter becomes to take only :class:`bool` instead of :class:`str`. .. deprecated:: 0.6.0 Values like ``'none'``, ``'line_numbers'``, and ``'map'`` for the ``source_comments`` parameter are deprecated. .. versionadded:: 0.7.0 Added ``precision`` parameter. .. versionadded:: 0.7.0 Added ``custom_functions`` parameter. .. versionadded:: 0.11.0 ``source_map_filename`` no longer implies ``source_comments``. .. versionadded:: 0.17.0 Added ``source_map_contents``, ``source_map_embed``, ``omit_source_map_url``, and ``source_map_root`` parameters. .. versionadded:: 0.18.0 The importer callbacks can now take a second argument, the previously- resolved path, so that importers can do relative path resolution. zchoose one at least in rz3 are exclusive each other; cannot be used at a timerrnestedz#output_style must be a string, not z0{} is unsupported output_style; choose one of {}rFrz>you can simply pass False to source_comments instead of 'none')rrz7you can simply pass True to source_comments instead of Tz\you don't have to pass 'map' to source_comments but just need to specify source_map_filenamez`values like 'none', 'line_numbers', and 'map' for the source_comments parameter are deprecated; z"source_comments must be bool, not c.|d}|)t|tst|d|t|tr|}|r&dvr"t d||S)Nz must be a string, not rzP{} is only available with filename= keyword argument since has to be aware of it)poprrXrDrrrrE)keyrrrfmodess r! _get_file_argzcompile.._get_file_argXsjjd## ?:c3#7#7?sBB3BBCC C S ! ! ***[))C  :U**((.s   r#source_map_filenameoutput_filename_hintrrrrNzutf-8rrmrcJg|] \}}t||!Srm)r rJ)rUr:rHs r!rzcompile..ys<   g  $ $T7 3 3   r#cpg|]3}t|tr|nt|4Srm)rr rO)rUrs r!rzcompile..sN   t\22 8DD11$77   r#zcustom_functions must be one of: - a set/sequence of {0.__module__}.{0.__name__} objects, - a mapping of function name strings to lambda functions, - a set/sequence of named functions, not {1!r}custom_import_extensionszQ`custom_import_extensions` has no effect and will be removed in a future version.rrindentedzindented must be bool, not rzfilename must be a string, not z seems not a filerz2dirname must be a pair of (source_dir, output_dir)zsomething went wrong)/setraddrDrrvrrrXrYrKeyErrorrrErwarningswarn FutureWarningboolrrrrrr3getcwdr^pathseprarZr[MappingitemsSetr\r rrrrcompile_stringrr6isfiler5rrwr)rf mode_namerrrdeprecation_messagerrrrrrrrrrrrr rr source_maprrrrs` @@r!rrsX EEE!!    IIi  1HUOOCDDD Ua UOO' '    ;**I::nh77L lC ( (  1        $\2     vlH]$;$;<<    jj!2E::O/)) f $ $4 $OO  ; ; ;._%%& #OO. $O  =       ot , ,  0  ! ! "   +--I1G1I1IK       (-(=>>(=)?@@ **%:EBBzz"4e<< **%:EBBjj!2D99O/3'':)0099Y[[NMU6::or::@bAAAMJOOM22M-%%:%,,[99 zz"4b99"KO$;<<   !1!7!7!9!9      _ +/": ;     )     |-=>>    zz,d33?     $FJJ{D$A$ABBI5H%% fc " " ,]]7++F::j%00(D)) -_%%&  #7F333# L/=) h !13F    1  %88G$$ $ % u  ::j))(C(( 4=XNOO O)) 4X:::;; ; # & & 4{33H"7F333 1 lO]I !19 !13F    1j  !!A" "'..w77 zMH   e   '-zz)'<'< $K      #7F333 lO 9&6 !13F    1   F .///LLL q//s. C<>> and_join(['Korea', 'Japan', 'China', 'Taiwan']) 'Korea, Japan, China, and Taiwan' :param strings: a list of words to join :type string: :class:`collections.abc.Sequence` :returns: a joined string :rtype: :class:`str`, :class:`basestring` rrrLr`c38K|]\}}|krd|zn|VdS)zand Nrm)rUir lasts r!rWzand_join..s7II1199VaZZ!IIIIIIr#)rv enumeratera)stringsiteratorrs @r!rrsj w<#s## &**W%%CwwsC(((r#rr1s@r!rr#8)))))))))r#r)r*ceZdZfdZxZS)r ct|ts|d}t||Srrrs r!rzSassWarning.__new__-rr#rr1s@r!r r +rr#r cHeZdZdZdZdZdZdZdZdZ dZ d Z e xZ Z d S) r zBecause sass maps can have mapping types as keys, we need an immutable hashable mapping type. .. versionadded:: 0.7.0 )_dict_hashct|i||_tt|j|_dSr&)dictrhash frozensetrrres r!r(zSassMap.__init__=s?4*6** )DJ$4$4$6$67788 r#c|j|Sr&)r)r)rs r! __getitem__zSassMap.__getitem__Dsz#r#c*t|jSr&)iterrrbs r!__iter__zSassMap.__iter__GsDJr#c*t|jSr&)rvrrbs r!__len__zSassMap.__len__Js4:r#ctt|jdt|dS)N())typer,rrrbs r!__repr__zSassMap.__repr__Os2t**%BB $**,,(?(?BBBBr#c|jSr&)rrbs r!__hash__zSassMap.__hash__Rs zr#c td)NzSassMaps are immutable.)rD)r)rs r! _immutablezSassMap._immutableUs1222r#N)r,r-r.r/rjr(r r rrrr __setitem__ __delitem__rmr#r!r r 3s!I999    CCC333!+*K+++r#r )*r/collections.abcrZr>os.pathr3rrrr__all__ __version__rrrrrr"rwrr8r r~rrrrrrr namedtupler rrrrr rr r[rr rmr#r!rs[       ' # aAaHH  344+++++:+++UUUUUUUUp9992(OOO"   !!!H   EEEPJJJ*"11111'' 6GHH11100000& &{4HII000J-{-.DbIIKKI-{-.DbIIKK Y,.BC D D  A A A A AK7 A A A)))))& &{H==))))))))(+(AA)))%+%+%+%+%+ko%%+%+%+%+%+r#