[APORTE] Chuleta de funciones!

[pateketrueke]

Que tal... apenas que estaba trabajando con un framework que estoy desarrollando me di cuenta que hay momentos que uno no recuerda ni sus propias funciones, incluso... el orden y uso de cada parámetro, cosas simples... pues

también, alguna ves vi una chuleta de CSS rondando por el foro, o algo así... y se me ocurrió hacer lo mismo, pero en una función para que pueda ser usada en cualquier archivo con funciones estándar... (parece que también funciona con clases, pero no esta implementado)



muestra el nombre del archivo a reportar, con cada una de sus funciones excepto las que empiecen con Mayúsculas y guion_bajo; también muestra los parámetros manualmente tal y como están escritos... puede ser de gran utilidad a veces, de veras!

igualmente, los estilos son configurables con CSS, el código es modificable 100% al gusto... no se, una buena idea es: imprimir el formato como PDF :D


--

Codigo fuente:

Código PHP:

  /**
 * (cadena[, devolver?[, ocultar?]])
 *
 * Crea una "chuleta" de reporte acerca de las funciones de un script.
 */
function report($text, $ret = true, $hid = true)
{
    $out = array();

    //preg_match_all('/function\s+([a-z0-9_]+)\s*\(([^\{]*)\)(?=\s*[^\)])/is', $text, $test);
    preg_match_all('/function\s+((?:&?\s*)?[a-z0-9_]+)\s*\(([^\{]*)\)/is', $text, $test);
    
    ksort($test[1]);
    foreach ($test[1] as $key => $val)
    { // evitamos..
        if (preg_match('/^([A-Z]|_)/', $val) && $hid)
        {
            continue;
        }

        // simple...
        $args = ents($test[2][$key]);

        $args = preg_replace('/([\'\"])[^=\\1]*\\1/', '<span style="color:green">\\0</span>', $args); // "cadena's"
        $args = preg_replace('/(true|false|null)/i', '<span style="color:purple;font-weight:bold">\\0</span>',$args); // bool's
        $args = preg_replace('/\b[0-9]+\b/', '<span style="color:black;font-weight:bold">\\0</span>',$args); // numeros
        $args = preg_replace('/\$[a-z0-9_]+/i', '<span style="color:darkblue">\\0</span>',$args); // $variables..
        $args = preg_replace('/[a-z0-9_]+\(.*?\)/i', '<span style="color:teal">\\0</span>',$args); // funciones

        $args = trim($args)? $args: $args.'<span style="color:black;font-weight:bold;font-style:italic">void</span>';
        $args = preg_replace('/\s+=\s+/', '&nbsp;=&nbsp;', $args);
        $args = preg_replace('/\s*,\s+/', ',&nbsp;', $args);
        
        $out[] = "\t<span style=\"color:orange\">[<span style=\"color:red;font-weight:bold\">$val</span>&nbsp;:&nbsp;$args]</span>";
    }

    $out = join("\n", $out);

    if ( ! $ret)
    {
        echo $ret;
    }
    return $out;
} 
   

Edito: actualizado y corregido

[pateketrueke]

hola, he actualizado el POST ... (espero que alguien lo lea)

[nicolaspar]

Muchas gracias por el aporte, he guardado el file. Podrás postear el CSS ya que estás así nos queda también. Gracias por el código!

[pato12]

Hola,
Muchisimas gracias por el aporte.
Suerte
Salu2

[pateketrueke]

okas.... pero como no hay [css][/css] :P

CSS

Código:

.cloud
{
	margin: .4em;
	font-size: .8em;
	font-family: arial;
	line-height: 1.1em
}
.cloud .name 
{
	float: right;
	margin: 1em;
	font-size: 1.4em;
	color: darkmagenta;
}
.cloud .function
{
	color: darkblue;
	font-style: italic;
	font-weight:bold;
}
.cloud .string
{
	color: orange;
}
.cloud .var
{
	color: green;
}
.cloud .const
{
	color: violet;
}
.cloud .void
{
	font-weight: bold;
	font-style: italic;
}
.cloud .par,
.cloud .mid
{
	color: red;
	font-weight: bold;
}
.cloud .key
{
	color: teal;
	font-style: italic;
}

...esos son los estilos que se ven en el screenshot (espero)

suerte!


PDTA: el enlace del archivo fue removido definitivamente, es mejor publicar directo aquí.... xD

[pateketrueke]

je... tenia unos bugs...

no parseaba las funciones con el operador & de referencia..
tampoco los números enteros y con punto flotante
ahora separa (gracias a  ) cada función

lo siento por los CSS :(



bueno, se preguntaran ¿..y esto de que sirve ??

según yo, a veces olvidamos las funciones de nuestras (u otras) librerías, es como generar un cheat sheet de algún script que leamos ... solo eso, nos muestra el nombre y parámetros contenidos... con resaltado de sintaxis simple

por ejemplo, yo imprimo mis funciones así y los pego frente a mi área de trabajo ... se ve nerd, pero funciona! (al menos para mi)

[aldo1982]

buenas...che o estoy muy dormido o no se jeje. pero no entiendo que es eso que posteaste ejej. chuleta ? y ese termino ? bue me gustaria si me peudes decir un ejemplo de como uss eso y para que sirve, gracias.

[Pedro_valencia]

Chuleta es como decir un apunte sobre las diversas funciones.

[aldo1982]

bien muchas gracias.

[nicolaspar]

Iniciado por aldo1982

buenas...che o estoy muy dormido o no se jeje. pero no entiendo que es eso que posteaste ejej. chuleta ? y ese termino ? bue me gustaria si me peudes decir un ejemplo de como uss eso y para que sirve, gracias.

Iniciado por pateketrueke

bueno, se preguntaran ¿..y esto de que sirve ??

según yo, a veces olvidamos las funciones de nuestras (u otras) librerías, es como generar un cheat sheet de algún script que leamos ... solo eso, nos muestra el nombre y parámetros contenidos... con resaltado de sintaxis simple

por ejemplo, yo imprimo mis funciones así y los pego frente a mi área de trabajo ... se ve nerd, pero funciona! (al menos para mi)

[TaniaMaria]

Hola, disculpen pero que es CHULETA?, aveces sin darnos cuenta usamos modismos..y para gente de otros paises ....en este caso como yo xD me cuesta entender el contexto de lo que explican :(

[pateketrueke]

Iniciado por TaniaMaria

Hola, disculpen pero que es CHULETA?, aveces sin darnos cuenta usamos modismos..y para gente de otros paises ....en este caso como yo xD me cuesta entender el contexto de lo que explican :(

en inglés -y creo que ya se había dicho por aquí- significa cheat sheet, osea una hoja de trucos, de las cuales rondan varias en internet para Regex, jQuery, PHP, HTML, etc..

[bNd170]

pateketrueke, la funcion ents (Supongo que será de arguments) no está definida, la he buscado por internet pero no he logrado encontrar gran cosa, podrias decirme que hace?

[pateketrueke]

Iniciado por bNd170

pateketrueke, la funcion ents (Supongo que será de arguments) no está definida, la he buscado por internet pero no he logrado encontrar gran cosa, podrias decirme que hace?

lo siento, en realidad ents() es mi propia versión extendida de htmlentities() que tiene la ventaja de no romper entidades previamente codificadas...

Código PHP:

  /**
 * Reparar entidades
 *
 * @param  string  $text Cadena
 * @param  boolean $html Escapar xHTML?
 * @return string
 */
function ents($text, $html = FALSE)
{//--
    $hash = uniqid('--entity-backup');
    $text = preg_replace('/&([a-z0-9;_]+)=([a-z0-9_]+)/i', "{$hash}\\1=\\2", $text);

    $expr = array(
            '/(&#?[0-9a-z]{2,})([\x00-\x20])*;?/i' => '\\1;\\2',
            '/&#x([0-9a-f]+);?/ei' => 'chr(hexdec("\\1"))',
            '/(&#x?)([0-9A-F]+);?/i' => '\\1\\2;',
            '/&#(\d+);?/e' => 'chr("\\1")',
    );

    $text = preg_replace(array_keys($expr), $expr, $text);
    $text = preg_replace('/&(#?[a-z0-9]+);/i', "{$hash}\\1;", $text);
    $text = str_replace(array('&', chr(92), $hash), array('&', '&' . '#92;', '&'), $text);

    if ($html === TRUE)
    {
        $text = strtr($text, array(
                '<' => '&lt;',
                '>' => '&gt;',
                '"' => '&quot;',
                "'" => '&' . '#34;',
        ));
    }

    $text = preg_replace("/[\200-\237]|\240|[\241-\377]/", '\\0',$text);
    $text = preg_replace("/{$hash}(.+?);/", '&\\1;', $text);
  
    return $text;
} 
   

aunque básicamente funciona como htmlentites()